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, isso pode incluir comandos acionados por uma variedade de condições.

Nota: Antes de adicionar uma cadeia, certifique-se de que sua organização configure 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 esperando o comando anterior terminar — ou simultaneamente em paralelo, ou para ter uma cadeia falhando se um comando de vários 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 Conectores disponíveis, clique na conexão e mova o comando para onde ele deve ocorrer na cadeia.
   • Para duplicar um comando existente, selecione seu nó, clique em Copiar  file_copy e mova o novo nó para onde ele deve ocorrer na cadeia.

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

2. Para vincular o comando aos nós anteriores e seguintes na cadeia, clique e arraste as linhas entre as portas dos nós.

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

3. Selecione o novo nó e clique em Editar  criar.
4. Insira os parâmetros do comando:
   • Em Informações básicas, insira um nome e uma descrição exclusivos para ajudar a identificar o comando e sua intenção.
   • Alterne o ícone de olho se desejar mascarar saídas de dados confidenciais .
   • Para executar o comando várias vezes, para cada item na lista, habilite Iterator repeat, e insira os valores de iteração.
   • Em Propriedades do comando, 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 à medida que você cria cadeias, você pode executar um único comando ou grupo de comandos dentro de uma cadeia.

1. Em Chain Builder, na aba Chains , selecione Execute  flight_takeoff no menu da cadeia.
2. Para que o comando ou grupo seja executado, clique em Executar este comando  play_circle_outline.
3. Clique em Executar Cadeia.

Pular um comando

Para desenvolver lógica de ramificação, ou como parte do desenvolvimento de uma cadeia, pode ser necessário pular 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 Editar  criar e selecione Ignorar skip_next.
2. Escolha se deseja retornar automaticamente um resultado de info  check_circle,  warning  warningou error  error para o comando quando ignorado.
3. Para pular o comando somente se critérios específicos forem atendidos, especifique quando. Crie a lógica condicional como um grupo ao qual você adiciona regras e outros grupos de regras, cada um unido com um booleano AND ou OR.
   • Se todas as condições de devem ser verdadeiras para pular, selecione AND.
   • Se apenas uma condição deve 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 de um comando:

1. Na cadeia, clique no nó do comando, clique em Editar criar e selecione Erro ao lidar com aviso.
2. Em Ações de erro  repetir, 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, como para resolver o problema, selecione Pausar cadeia. Para reiniciar a cadeia após o problema ser resolvido, selecione o comando na cadeia e clique em Retomar.
   • Para parar a cadeia completamente, selecione Sair da cadeia.
3. Para interromper o comando se ele demorar mais do que deveria, em Condições de tempo limite  alarme, insira sua duração máxima em segundos.
   
4. Para tentar novamente um comando se sua fonte de dados estiver intermitente ou indisponível, insira o número de tentativas e quantos segundos aguardar entre elas.
5. Em Condições de erro  prioridade_alta, selecione quaisquer 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ídae defina a regra (ou grupo de regras) para interpretar seu status.Por exemplo, com a variável Status da saída Detalhes do comando , você pode definir uma regra para resultar em um aviso quando o comando for bem-sucedido.
   
7. Em Interpretação de log, selecione se o comando deve falhar com base no resultado de saídas específicas.
   • Para não falhar o comando com base em saídas específicas, selecione Não interpretar.
   • Para falhar o comando quando saídas específicas forem encontradas, selecione Falha se saída(s) for(em) encontrada(s) e insira as saídas a serem procuradas.
   • Para falhar o comando quando saídas específicas não forem encontradas, selecione Falha se saída(s) não forem encontradas e insira a saída a ser procurada.
   • Várias linhas de texto precisarão ser separadas por \n
8. Clique em Salvar.

Ver a saída de um comando

Em Monitor flight_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 visualizar e selecione o comando.
2. Na guia Saídas , clique em Visualizar a saída visibilidade para a saída a ser visualizada.
   

Nota: Você só pode visualizar saídas de comandos executados por meio do CloudRunner, 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  excluire, em seguida, clique em Excluir.

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