Configurar os parâmetros, as etapas e a lógica de uma ação do usuário no assistente

O assistente de criação de ações do usuário tem telas para definir os parâmetros que a ação pede, o planejamento das etapas do preenchimento e a lógica JavaScript que roda no servidor. O caminho informado para o assistente é Administração › Ações do usuário.

O uso do assistente é o mesmo de antes: a ordem das etapas, os botões e as validações não mudaram. O que mudou é o idioma. Essas telas agora aparecem no idioma escolhido para o sistema (português, inglês ou espanhol); antes aparecíam sempre em português. Este artigo cita os textos em português; em inglês e em espanhol você vê o texto equivalente traduzido. Para trocar o idioma, veja usar o Kryia One em inglês ou espanhol.

Definir os parâmetros da ação

A tela Parâmetros da Ação lista o que a ação vai pedir a quem a executa. O botão Adicionar Parâmetro inclui uma linha. Cada linha tem os campos:

Campo	O que é
Nome (Chave)	O nome do parâmetro
Origem	De onde vem o valor: Usuário (Tela), Valor Fixo ou Sistema
Campo Origem (NOMECAMPO)	O campo da tabela escolhida na Etapa 1 de onde o valor vem
Obrigat.	Se o parâmetro é obrigatório

Sem nenhum parâmetro, a tela diz: “Nenhum parâmetro configurado. A ação não solicitará inputs do usuário.”

Na origem Sistema, os valores disponíveis são CODUSU, TODAY, NOW, Schema/Tenant e Gerar UUID; os textos que os acompanham também seguem o idioma. As mensagens da lista de campos também são traduzidas: “Selecione uma tabela na Etapa 1”, “Carregando campos…” e “Nenhum campo encontrado para {table}”, em que {table} é a tabela escolhida.

Configurar os parâmetros do formulário

Na tela de parâmetros com formulário, cada parâmetro tem um tipo e, se quiser, um auto-preenchimento. Os campos que aparecem, entre outros:

• Nome Parâmetro (Amigável) e CHAVE;
• Tipo de Parâmetro, com as opções Texto, Inteiro, Decimal, Data, DataHora, Bool, Pesquisa e Opções;
• Casas Decimais *, quando o tipo pede;
• Opções (LABEL=VALUE, uma por linha) *, para o tipo Opções;
• Tabela Lookup, Campo Value e Campo Label, para o tipo Pesquisa;
• Auto-preencher parâmetro, com as origens Sistema, Valor Fixo e Campo;
• Visível quando e Obrigatório quando.

O que você vê nos tipos e nas origens muda com o idioma, mas o valor gravado na ação não: continua TEXTO, INTEIRO, DECIMAL, DATA, DATAHORA, BOOL, PESQUISA e OPCOES, e SISTEMA, VALOR_FIXO e CAMPO. Uma ação criada antes da tradução, ou por alguém que usa outro idioma, continua igual.

As descrições das variáveis de sistema têm uma particularidade. Elas só são traduzidas quando a lista vem do conjunto reserva do próprio sistema. Quando a lista vem do servidor, aparece a descrição que o servidor devolve, no idioma em que ele a enviou.

Escolher a tabela de uma pesquisa

No tipo Pesquisa, o campo Tabela Lookup tem a ajuda “Use a busca para selecionar a tabela do lookup.” A busca abre a janela Buscar Tabela Lookup, com a orientação “Digite ao menos 3 caracteres.” e o exemplo “Ex: TBLPARC”. Sem resultado, a janela diz “Nenhuma tabela encontrada.” O botão Cancelar fecha a janela.

A regra da busca não mudou: ela só lista tabelas depois de 3 caracteres e compara o que você digitou com o nome ou a descrição da tabela.

Planejar as etapas do preenchimento

A tela Planejamento de Etapas tem o subtítulo “Defina a ordem, nome e instrução de cada etapa do preenchimento.” O botão Adicionar Etapa inclui uma etapa, e cada etapa tem os campos Ordem, Step, Nome da Etapa e Descrição da Etapa. Os exemplos dos campos são “Ex: Parcelamento” e “Ex: Informe aqui as características do parcelamento.”

Sem etapa nenhuma, a tela diz: “Nenhuma etapa planejada. Adicione pelo menos uma etapa.” O assistente também avisa, ao validar, “Cadastre pelo menos uma etapa no Planejamento de Etapas.” e “Toda etapa deve ter nome.”

A Dica prática - Planejamento de Etapas traz 6 dicas, todas traduzidas.

O título que a etapa nova recebe

A etapa nova nasce com o título padrão “Etapa {n}” (por exemplo, “Etapa 1”), no idioma de quem a cria. A primeira etapa de uma ação nova e as etapas que faltarem ao reabrir uma ação existente recebem o título do mesmo jeito.

Esse título fica gravado na ação como um texto comum, e você pode trocá-lo no campo Nome da Etapa. Se a ação foi criada em inglês, o título gravado está em inglês, mesmo que outra pessoa a abra depois em português.

Escrever a lógica JavaScript

A tela Lógica JavaScript (Ambiente Isolado) pede: “Escreva a função run que será executada no backend.” O editor é descrito como Editor Monaco (Simulado para este MVP). Abaixo dele, Contexto Injetado: lista cada item do contexto com sua descrição: params, selectedRows, currentRow, metadata e user.

O botão Gerar Template preenche o editor com um código inicial. O código é JavaScript e fica gravado na ação, por isso só uma parte dele é traduzida:

• vem traduzida a mensagem de retorno quando nenhum registro está selecionado (“Nenhum registro selecionado.”);
• no template inicial de uma ação nova, a mensagem de sucesso também é traduzida (“Ação executada com sucesso.”);
• o restante continua como estava: comentários em português, os nomes tabela, usuario, selecionados e resumo, e a mensagem de sucesso do código gerado (“Ação executada com sucesso!”, ou o texto da mensagem da ação, quando você a preencheu).

Não espere, portanto, um código inteiramente em inglês ou em espanhol. Depois de gerado, o código é seu e pode ser editado.

O Guia do Consultor

Cada tela tem o botão Guia do Consultor, que abre uma janela com as seções Conceitos e Dicas e Casos de Uso Reais. O botão, a descrição e os títulos das seções são traduzidos, e o título e o conteúdo do guia de cada tela também:

• Guia do Consultor: Parâmetros (Formulário), com 5 dicas e 2 exemplos;
• Guia do Consultor: Lógica JavaScript, com 3 dicas e 1 exemplo.

Problemas comuns

Uma tela do assistente continua em português. Confira o idioma escolhido nas preferências da conta. Lembre também dos textos que ficam gravados na ação, como o título das etapas e o código gerado, que não mudam sozinhos quando você troca de idioma.

A descrição de uma variável de sistema aparece em outro idioma. Quando a lista vem do servidor, a descrição é a que ele devolve, sem tradução.

Para acompanhar o que acontece quando a ação roda, veja consultar o histórico de execuções de uma ação. Se a ação for recusada, veja resolver uma ação recusada.