Para automatizar os fluxos de trabalho na plataforma Workiva e em outras fontes de dados, os proprietários de espaços de trabalho podem criar e gerenciar sequências lineares de tarefas como cadeias. Por exemplo, você pode criar uma cadeia para atualizar automaticamente as informações financeiras de uma fonte de dados em uma tabela e, em seguida, enviar esses dados para outra fonte de dados para gerar um relatório.
Treinamento adicional disponível
Descubra o poder das cadeias com nosso curso individualizado no Workiva Learning Hub! Este curso abrangente o orienta no processo de criação de uma cadeia do início ao fim, proporcionando experiência prática e um profundo conhecimento da plataforma Construtor de Cadeia.
Visite o centro de aprendizagem da Workiva
Requisitos
As seguintes funções de usuário Wdata podem criar e gerenciar cadeias:
- Proprietário do espaço de trabalho com a função Editor, Profissional, ou Padrão
- Proprietário da cadeia com a função Editor, Profissional, ou Padrão
- Criador de cadeias com as permissões apropriadas
Acesso às cadeias
Clique em Chains => Chain Builder no Wdata para visualizar e gerenciar suas cadeias. Em Admin => Security, você pode rastrear eventos de auditoria sobre a criação e o gerenciamento de cadeias.
Criar uma cadeia
Para definir a sequência de comandos e eventos que ocorrerão com uma cadeia, você pode:
- Criar a cadeia a partir do zero
- Crie a corrente a partir de um modelo
- Comece com uma cópia de uma cadeia semelhante
Em Chain Builder, você pode arrastar e vincular as etapas - ou nós- dentro de uma cadeia.
Etapa 1: Adicionar a cadeia e configurar seus detalhes
- Em Chains, clique em Create => Create Chain.
Nota: Você também pode criar uma cadeia diretamente na guia Cadeias, passando o mouse sobre o ícone Build no canto superior direito.
- Em Setup, digite um nome e uma descrição exclusivos para ajudar a identificar a cadeia e sua intenção.
- Para permitir que a cadeia seja executada várias vezes simultaneamente, como, por exemplo, com diferentes entradas de tempo de execução para cada instância, selecione Permitir execuções simultâneas.
- Para impedir que a cadeia seja executada, por exemplo, para adiar seu uso, selecione Disable execution.
- Defina quaisquer valores compartilhados ou dinâmicos usados na cadeia:
- Em Variáveis , defina os valores que aparecem em vários comandos e muitos mudam com frequência.
- Em Dynamic Variables , defina os valores a serem definidos quando a cadeia começar a ser executada ou durante sua execução, como, por exemplo, com base nas saídas de comandos anteriores.
Nota: Para solicitar que os colaboradores insiram valores para variáveis dinâmicas, inclua um evento Runtime Inputs trigger ou Set Dynamic Chain Variables event.
- Para executar automaticamente a cadeia em intervalos regulares ou durante um intervalo de datas específico, em Schedules , especifique quando e com que frequência ela deve ser iniciada.
- Clique em Salvar.
Etapa 2: Definir os nós da cadeia
Ao criar uma cadeia, você inclui e vincula seus vários nós:
- Comandos, ou as tarefas executadas pela cadeia para interagir com a plataforma Workiva ou outra fonte de dados.
- Eventos de cadeia que ocorrem dentro da cadeia, 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 a cadeia, ou para iniciar automaticamente a cadeia com base em alterações nas origens conectadas.
Adição de nós
Quando você adicionar um nó, mova-o para o local em que ele ocorre na cadeia e vincule-o às etapas seguinte e anterior.
- Para adicionar o primeiro nó da cadeia, 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 da cadeia ao primeiro nó dos vários ramos.
- Para executar comandos em paralelo entre si ou juntos como parte de um processo serial, mova-os um sobre o outro para e 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 , falha , aviso , ou qualquer .
Depois que você definir os nós da cadeia, clique em Publicar para permitir que ela seja executada.
Nota: Embora você possa publicar uma cadeia com nós não vinculados, somente aqueles vinculados uns aos outros - começando com o nó Start - são executados quando você executa a cadeia.
Para facilitar a criação de uma cadeia, você pode começar com um modelo que forneça a estrutura de seus comandos, eventos e variáveis.
Etapa 1. Criar a cadeia
- Em Construtor de cadeias, na guia Modelos ou Cadeias , crie a cadeia a partir do modelo:
- Em Templates, clique no nome do modelo e, em seguida, clique em New Chain no canto superior direito.
- Em Chains, clique no ícone Build e, em seguida, em Create Chain from Template. Você pode então selecionar o modelo a ser usado.
- Em Templates, clique no nome do modelo e, em seguida, clique em New Chain no canto superior direito.
- Digite um nome exclusivo para ajudar a identificar a cadeia.
- Selecione o espaço de trabalho e o ambiente para usar a cadeia e clique em Next.
Etapa 2. Mapeie as variáveis e conexões do modelo
- Para cada variável de modelo, selecione o valor que a substituirá na cadeia:
- Para um conjunto de valores de variável na cadeia , selecione Variable Type of Chain e digite um nome para a nova variável de cadeia.
- Para um valor de variável definido no espaço de trabalho, selecione Variable Type de Workspace e selecione a variável do espaço de trabalho a ser usada.
- Para um arquivo carregado como um recurso dentro do espaço de trabalho, selecione Variable Type de Workspace Resource e selecione o recurso a ser usado.
- Para um valor de variável dinâmica definido quando a cadeia for executada, selecione Variable Type de Chain Dynamic e digite um nome para a nova variável de cadeia dinâmica.
- Para um valor gerado quando a cadeia é executada, selecione um Tipo de variável de Tempo de execução e selecione a variável de tempo de execução a ser usada.
Nota: Se você selecionar Dynamic ou Resource ao adicionar a variável ao modelo, não será possível selecionar um tipo diferente de variável.
- Depois que você mapear as variáveis do modelo para as novas variáveis ou recursos, clique em Next.
- Para cada conexão usada no modelo, selecione o conector e o executor para executar seus comandos e clique em Submit.
Etapa 3. Finalize a cadeia
- Clique em View Your New Chain.
- Personalize a nova corrente conforme necessário:
- Atualize todas as variáveis de cadeia usadas pelas variáveis do modelo.
- Adicione quaisquer comandos ou eventos adicionais para iniciar ou concluir a cadeia.
- Clique em Publicar.
Para criar uma cadeia semelhante a outra cadeia no espaço de trabalho, você pode usar uma cópia como ponto de partida.
Dica: Se você usa frequentemente uma cadeia como ponto de partida para outras cadeias, crie um modelo com base em sua sequência de nós.
- Em Construtor de Cadeias, na guia Cadeias , selecione Copiar no menu da cadeia existente.
- Para a nova cópia, clique em Edit e atualize seus nós ou propriedades conforme necessário.
Você pode promover uma cadeia para um ambiente diferente
Como parte do seu ciclo de vida de desenvolvimento, você pode criar cadeias em um ambiente separado daquele em que os colaboradores as executam. Por exemplo, você pode criar cadeias em um ambiente DEV até que estejam prontas para uso em um ambiente PROD. Para mover uma cadeia de um ambiente para outro, você pode promovê-la.
- Em Construtor de cadeias, na guia Cadeias , selecione Promover no menu da cadeia.
- Em Name, edite o nome da cadeia para seu novo ambiente, conforme necessário.
- Em Promote to, selecione o novo ambiente da cadeia.
- Selecione se você deseja ativar as programações na cadeia promovida e clique em Próximo.
- Para cada conexão na cadeia, escolha a conexão a ser usada no novo ambiente e clique em Next.
- Revise o mapeamento da conexão e clique em Promote.
Editar uma cadeia
Para atualizar as etapas ou as propriedades de uma cadeia, você pode clicar em Editar:
- Em Construtor de cadeias, na guia Cadeias , clique em Edição para a cadeia e atualizar seus comandos e eventos conforme necessário.
- Para atualizar as propriedades da cadeia, clique em Configurações da cadeia e ajuste suas programações, variáveis e notificações conforme necessário.
- Para atualizar em massa as conexões de comando da cadeia, clique no menu de três pontos e ajuste seus Comandos.
Dica: Você pode organizar facilmente as cadeias selecionando vários nós de uma só vez. Basta pressionar Shift e arrastar o cursor do mouse pela tela. Saiba mais.
Reverter uma cadeia para uma versão anterior
Para retornar uma cadeia a uma versão publicada anteriormente, por exemplo, para desfazer alterações ou criar uma nova cadeia a partir de uma versão anterior de outra:
- No Construtor de cadeias, na guia Cadeias , selecione Versões no menu da cadeia.
- Em Past Versions, selecione a versão a ser revertida e clique em Revert Chain.
- Selecione o conector e o executor de cada conexão e defina as variáveis.
- Clique em Enviar, Ver Cadeia Revertida, e Publicar.
Tags de cadeias
As tags de cadeia permitem que você agrupe cadeias relacionadas e forneça informações sobre o conteúdo da cadeia. Depois que uma tag é criada, ela pode ser usada como um filtro para cadeias na visualização da lista de cadeias e na Agenda.
Adição de uma tag de cadeia
- Selecione a cadeia para expandir a visualização
- Clique no ícone de mais (+) para inserir um novo nome de etiqueta ou selecionar uma etiqueta existente
- Opcionalmente, defina a cor da etiqueta clicando nela e escolhendo uma cor
Remoção de uma tag de corrente
- Selecione a cadeia para expandir a visualização
- Passe o mouse sobre a tag e clique no (x) cinza