Centro de suporte da Workiva

Ao criar um modelo, você pode usar uma cadeia publicada como base ou criar uma nova sequência de comandos e eventos a partir do zero.

Esses modelos permitirão que você crie uma sequência pré-construída de comandos e eventos para uso em outras cadeias. Por exemplo, com os modelos, você pode:

• Fornecer um ponto de partida para facilitar a criação da cadeia.
• Padronize fluxos de trabalho comuns, como a extração de dados do seu sistema de registro.

Observação: Você pode usar um modelo com várias cadeias, espaços de trabalho e ambientes em Chain Builder.

Você pode criar um modelo a partir de uma cadeia existente

A criação de um modelo a partir de uma cadeia existente oferece vários benefícios:

• Você pode usar a primeira cadeia como ponto de partida para criar outras cadeias.
• Você pode compartilhar a cadeia com outras pessoas usando o Chain Builder- incluindo as de outras organizações, como a Workiva Community. 

Para criar um modelo a partir de uma cadeia existente:

1. Em Cadeias, clique em Construtor de Cadeia.
2. Selecione a guia Chains device_hub e, em seguida, selecione Edit create para a cadeia.
3. No menu de três pontos da cadeia, no canto superior direito, selecione Criar modelo.
   
4. Digite um nome e uma descrição exclusivos para ajudar a identificar o modelo.
   
5. Em Folders, selecione onde você deseja salvar o modelo.
6. Clique em Salvar.
7. Se a cadeia tiver variáveis, configure cada variável de modelo:
   

   • Digite o nome padrão da variável de modelo.

     Dica: Para ajudar a identificar o valor a ser usado com uma variável, recomendamos que você inclua um prefixo em seu nome. Por exemplo, WSV- para uma variável de espaço de trabalho, CV- para uma variável de cadeia, DCV- para uma variável de cadeia dinâmica ou Resource- para um recurso de espaço de trabalho.

   • Para facilitar a portabilidade e a reutilização, exclua os valores padrão.

   • Selecione se uma variável de cadeia dinâmica ou um recurso de espaço de trabalho fornecerá o valor.

     Nota: Se uma variável de cadeia, variável de espaço de trabalho|workspace ou variável de tempo de execução fornecer o valor, não selecione Dynamic nem Resource.

8. Clique em Salvar e Publicar.

Criar um modelo do zero

Para criar uma nova sequência de comandos e eventos como uma estrutura reutilizável para cadeias, siga estas sequências de etapas.

Etapa 1: Adicionar o modelo

1. Em Chain Builder, na guia Templates dynamic_feed , clique em Create => Template no canto superior direito.
2. Para criar o modelo em outro local que não seja a pasta Default, clique em Edit edit para a respectiva pasta, selecione a pasta para salvar o modelo e clique em Move.

3. Digite um nome e uma descrição exclusivos para ajudar a identificar o modelo e sua intenção.

   Dica: Para ajudar a identificar se um modelo fornece uma sequência para uma cadeia completa ou parcial, inclua um prefixo em seu nome. Por exemplo, Full- para uma cadeia completa, ou Part- para uma cadeia parcial ou snippet.

Etapa 2: Configurar as variáveis do modelo

Para facilitar a personalização e a reutilização, os modelos contêm variáveis como espaços reservados para os valores necessários para as variáveis de seus comandos ou recursos do espaço de trabalho. Quando você cria uma cadeia a partir do modelo, as variáveis e os recursos da cadeia substituem as variáveis do modelo.

Para cada variável que você deseja incluir no modelo:

1. Em Template Variables, clique em Add.

2. Digite o nome da variável e o valor padrão.

   Dica: Para ajudar a identificar o valor a ser usado com uma variável de modelo, recomendamos que você inclua um prefixo em seu nome. Por exemplo, WSV- para uma variável de espaço de trabalho, CV- para uma variável de cadeia, DCV- para uma variável de cadeia dinâmica ou Resource- para um recurso de espaço de trabalho.

3. Em Tipo, selecione se uma variável de cadeia dinâmica ou um recurso de espaço de trabalho fornecerá o valor da variável.

   Nota: Se uma variável de cadeia, variável de espaço de trabalho|workspace ou variável de tempo de execução fornecer o valor, não selecione Dynamic nem Resource.

Depois que você adicionar todas as variáveis ao modelo, clique em Save.

Observação: Para remover uma variável do modelo, clique em X em Actions.

Etapa 3: Definir os nós do modelo

À medida que você cria um modelo, configure e vincule os nós em sua sequência:

• Comandos ou tarefas executadas por cadeias criadas a partir do modelo, como, por exemplo, para interagir com a plataforma Workiva ou outra fonte de dados.
• Eventos que ocorrem no modelo, por exemplo, para ativar um fluxo de trabalho de aprovação ou upload manual de arquivos.
• Eventos de acionamento, como entradas de tempo de execução para definir variáveis - como contas, regiões ou períodos de tempo específicos - quando você executa cadeias criadas a partir do modelo ou para iniciar automaticamente a cadeia com base em alterações nas origens conectadas.

Observação: Para permitir a personalização e a reutilização, os comandos de um modelo não usam conexões, executores ou variáveis definidas na cadeia ou no espaço de trabalho; você os especificará quando criar uma cadeia a partir do modelo.

Adição de nós

Quando você adicionar um nó, mova-o para o local onde ele ocorre na sequência e vincule-o às etapas seguinte e anterior.

• Para adicionar o primeiro nó do modelo, mova-o para Start.
• Para adicionar um nó como o início de um novo ramo de uma árvore lógica, vincule a etapa anterior no modelo ao primeiro nó dos vários ramos.
• Para executar comandos em paralelo entre si ou em conjunto como parte de um processo serial, crie um grupo de comandos como a etapa.

Observação: Por padrão, um nó é executado quando o nó anterior vinculado é bem-sucedido. Para ativar a lógica condicional, por exemplo, para executar um nó somente quando o nó anterior falhar, clique duas vezes no linking e selecione sua condição - sucesso check_circle, falha erro, aviso aviso, ou qualquer check_circle.

Depois que você definir os nós do modelo, clique em Publicar.

Editar as configurações de um modelo

Para ajustar o nome ou a descrição de um modelo ou para gerenciar suas variáveis, você deve clicar no nome do modelo e na guia

1. Em Chain Builder, na guia Templates dynamic_feed, clique no nome do modelo e em Template Settings.
2. Edite o nome, a descrição ou as variáveis do modelo, conforme necessário.
3. Clique em Salvar e Publicar.

Exibir cadeias que usam um modelo

Para ver quais cadeias são criadas a partir de um modelo, acesse a guiaTemplates dynamic_feed e clique em View para o modelo em Chains Using.

No painel Em uso, são exibidas as cadeias criadas a partir do modelo. Para abrir uma cadeia, clique em seu nome. 

Dica: Para localizar uma cadeia específica, você deve pesquisar pelo nome dela.

Copiar modelos

Para usar um modelo como ponto de partida para um novo modelo, crie uma cópia dele. Em Chain Builder, na guia Templates dynamic_feed, clique em Copy file_copy para o modelo.

Compartilhe modelos com outras pessoas

Para ajudar outras pessoas a criarem cadeias, você pode compartilhar links para modelos publicados com outras pessoas usando o Chain Builder- incluindo aqueles em outras organizações, como na Workiva Community. 

1. Em Chain Builder, na guia Templates dynamic_feed, clique no link Get shareable link open_in_new.
   
2. Clique em Copiar para a área de transferência file_copy e Fechar.
3. Cole e compartilhe o link com outras pessoas, conforme necessário.

Lembre-se de que os modelos dependem de que ambos os espaços de trabalho tenham acesso aos mesmos conectores e comandos. Ao compartilhar um modelo com outro espaço de trabalho, a cadeia importada não funcionará a menos que todos os conectores necessários estejam ativados.

Ao importar uma cadeia, você terá a oportunidade de configurar os conectores que faltam:

Revogar o acesso a um modelo compartilhado

Para revogar o acesso de outras pessoas a um modelo compartilhado, atualize o URL para criar um novo link:

1. Em Chain Builder, na guia Templates dynamic_feed, clique em Get shareable link open_in_new para o modelo.
2. Clique em Regenerate token refresh e Close.

Arquivar modelos

Se você não precisar mais de um modelo, poderá arquivá-lo. Em Chain Builder, clique em Templates dynamic_feed e clique em Archive archive para obter o modelo.

Observação: Para visualizar um modelo arquivado em Templates, clique em Archived.