Entender os avisos do passo de operações e o modelo de código do assistente de ações

O assistente de criação de ações do usuário (em Administração, Ações do usuário) mostra avisos no passo de operações e monta um modelo de código no passo Lógica. Este artigo explica o que cada um diz. Os textos seguem o idioma escolhido no sistema, como em usar o Kryia One em inglês ou espanhol; onde não há tradução, o assistente usa a mensagem em português.

Como o assistente numera as etapas

O cabeçalho do assistente mostra “Etapa X de Y”. Neste artigo as etapas são chamadas pelo nome, operações e Lógica, porque o número na tela muda: em ações com integração, o catálogo de integrações vem antes das operações, e as operações passam a ter um número de etapa maior. O comentário do modelo de código, que cita o “passo 4”, sempre se refere à etapa de operações, qualquer que seja o número mostrado no cabeçalho.

O aviso que impede de avançar no passo de operações

Ao avançar a partir do passo de operações, o assistente verifica o fluxo. Se encontra um erro crítico, mostra o primeiro erro como um aviso na tela e não avança. O texto do aviso aparece no idioma do sistema.

Um exemplo é a operação sem tabela:

OP #1: targetTable não informada.

O “OP #1” é o número da operação na lista, que começa em #1. Para corrigir, volte à operação com esse número e complete o que o aviso diz que falta. Depois tente avançar de novo: o assistente verifica o fluxo a cada vez que você avança.

O aviso de saída da integração não consumida

Quando a integração da ação produz uma saída que nenhuma operação usa, o assistente avisa:

Integração: saída CTX não consumida no fluxo.

A saída da integração não é uma operação da lista, por isso o aviso usa o rótulo “Integração” e não cita um número de operação (antes, ele aparecia como “OP #0”, embora as operações comecem em #1).

Este é um aviso de atenção e não bloqueia o avanço: você pode seguir com ele.

A origem de cada saída também aparece no idioma do sistema: “Integração”, “Seed/Entrada”, “Gate”, “Branch”, “Consulta”, “Loop” e “Operação”.

O modelo de código do passo Lógica

No passo Lógica, o botão Gerar Template monta um modelo de código. Nele:

• a mensagem de nenhum registro selecionado vem no idioma de quem gera o modelo. Em português, é “Nenhum registro selecionado.”;
• o comentário “Operações declarativas (passo 4)” explica que a persistência é feita pelas operações declarativas da etapa de operações, e que o JavaScript serve só para orquestração: “não escreva SQL aqui”.

Só a mensagem de nenhum registro selecionado é traduzida. Os comentários do modelo e a mensagem de sucesso padrão, “Ação executada com sucesso!” (usada quando o campo de mensagem da ação está vazio), continuam em português.

Depois de gerado, o modelo é texto na caixa de código da ação e não muda sozinho se você trocar o idioma do sistema.