Centro de suporte da Workiva

Comandos são as tarefas executadas dentro da cadeia, com base em uma conexão com uma fonte de dados. Para cadeias mais complexas, você pode incluir comandos acionados por uma variedade de condições.

Nota: Antes de você adicionar uma cadeia, certifique-se de que sua organização defina as conexões necessárias para habilitar comandos com suas fontes de dados.

Para executar comandos específicos em série- um após o outro, com cada um aguardando a conclusão do comando anterior - ou simultaneamente em paralelo, ou para que uma cadeia falhe se um dos vários comandos falhar, agrupe-os.

Adicionar um comando a uma cadeia

1. Na cadeia, selecione o comando a ser executado:
   • Para adicionar um novo comando à cadeia, em Available Connectors, clique em sua conexão e, em seguida, mova o comando para o local onde ele deve ocorrer na cadeia.
   • Para duplicar um comando existente, selecione seu nó, clique em Copy file_copy e mova o novo nó para o local onde ele deve ocorrer na cadeia.

   Dica: Para adicionar um comando como o primeiro nó da cadeia, mova-o para Start.

2. Para vincular o comando a seus nós anterior e seguinte na cadeia, clique e arraste linhas entre as portas de seus nós.

   Observação: Para alterar a posição de um nó na cadeia, desvincule-o de outros nós e, em seguida, mova-o para o local onde ele deve ocorrer. Para mover vários nós de uma vez, mantenha pressionada a tecla SHIFT enquanto você os seleciona.

3. Selecione o novo nó e clique em Edit create.
4. Digite os parâmetros do comando:
   • Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o comando e sua intenção.
   • Ative o ícone de olho se você quiser mascarar saídas de dados confidenciais.
   • Para executar o comando várias vezes, para cada item na lista, ative Iteratorrepeat, e insira os valores de iteração.
   • Em Command Properties, insira as entradas do comando, com base no conector.
5. Clique em Salvar.

Execute apenas um único comando ou grupo

Para facilitar os testes e as iterações rápidas ao criar cadeias, você pode executar um único comando ou grupo de comandos dentro de uma cadeia.

1. No Chain Builder, na guia Chains, selecione Execute flight_takeoff no menu da cadeia.
2. Para o comando ou grupo a ser executado, clique em Execute este comando play_circle_outline.
3. Clique em Run Chain.

Ignorar um comando

Para desenvolver a lógica de ramificação ou como parte do desenvolvimento de uma cadeia, talvez você precise ignorar um comando para forçar um resultado específico. Você também pode configurar a lógica condicional para retornar automaticamente um resultado específico com base em regras definidas.

1. Na cadeia, selecione o nó do comando, clique em Edit create e selecione Skipskip_next.
2. Escolha se você deseja retornar automaticamente um resultado de info check_circle, warning warning, ou error error para o comando quando ignorado.
3. Para ignorar o comando somente se critérios específicos forem atendidos, especifique when. Crie a lógica condicional como um grupo ao qual você adiciona regras e outros grupos de regras, cada um deles associado a um booleano E ou OU.
   • Se todas as condições de devem ser verdadeiras para pular, selecione AND.
   • Se apenas uma condição tiver que ser verdadeira para pular, selecione OU.

   Você pode adicionar regras com base em vários tipos de dados:

   Tipo de dados	Descrição
   String	Dois ou mais caracteres
   Inteiro	Qualquer valor numérico inteiro, não decimal
   Data	Qualquer string de data ou variável Date
   Flutuação	Qualquer valor numérico
   JSON	Notação de objeto JavaScript; use Variável Transformation para analisar objetos

   Para verificar se os dados atendem aos critérios para ignorar o comando, combine-os com um operador e um valor:

   • Está em branco ou Não está em branco
   • Contém
   • Corresponde a RegExp, para expressão regular
   • Começa com ou Termina com
   • = ou ! =
   • < ou >
   • <= ou >=
4. Clique em Salvar.

Gerenciar o tratamento de erros de um comando

Para detectar ou ignorar erros em um comando:

1. Na cadeia, clique no nó do comando, clique em Editar criar e selecione Erro ao lidar com aviso.
2. Em Error actions repeat, selecione o que fazer se o comando falhar.
   
   • Para seguir a lógica de ramificação da cadeia, selecione Continuar com a cadeia.
   • Para interromper a cadeia temporariamente, por exemplo, para solucionar o problema, selecione Pause chain. Para reiniciar a cadeia depois que o problema for resolvido, selecione o comando na cadeia e clique em Resume.
   • Para interromper completamente a cadeia, selecione Exit chain.
3. Para interromper o comando se ele demorar mais do que deveria, em Timeout conditions alarm, insira a duração máxima em segundos.
   
4. Para tentar novamente um comando se a fonte de dados estiver intermitente ou indisponível, digite o número de tentativas e quantos segundos você deve esperar entre elas.
5. Em Condições de erro priority_high, selecione os erros a serem ignorados, como ao criar uma pasta que já existe.
6. Para definir o status do comando com base em sua saída, clique em Adicionar em Interpretação de saída e defina a regra - ou o grupo de regras - para interpretar seu status.  Por exemplo, com a variável Status da saída Command Details, você pode definir uma regra para resultar em um aviso quando o comando for bem-sucedido.
   
7. Em Log interpretation, selecione se você deseja reprovar o comando com base no fato de ele resultar em saídas específicas.
   • Para e não reprovar o comando com base em saídas específicas, selecione Não interpretar.
   • Para que o comando falhe quando saídas específicas forem encontradas, selecione Fail if output(s) found (Falhar se saídas forem encontradas) e digite as saídas a serem pesquisadas.
   • Para que o comando falhe quando saídas específicas não forem encontradas em, selecione Fail if output(s) not found (Falhar se a(s) saída(s) não for(em) encontrada(s) e digite a saída a ser pesquisada.
   • Várias linhas de texto precisarão ser separadas por \n
8. Clique em Salvar.

Exibir a saída de um comando

Em Monitorflight_takeoff, você pode visualizar a saída de um comando executado pelo CloudRunner. 

1. Em Chain Builder, em Monitor, abra a execução com a saída para visualização e selecione o comando.
2. Na guia Outputs, clique em Preview the outputvisibility para que você possa exibir a saída.
   

Nota: Você só pode visualizar saídas de comandos executados por meio do CloudRunner, e não de um GroundRunner.

Remover um comando de uma cadeia

Para remover um comando de uma cadeia, clique em seu nó, clique em Excluir excluir e, em seguida, clique em Excluir.

Nota: Para ajudar a garantir a lógica da cadeia, você não pode excluir um comando se o pai dele tiver vários irmãos ou ramificações no mesmo nível.