ALTU
Search…
Ações Personalizadas
Personalizar o assistente no Builder é muito simples: Para criar uma ação, ou nó, dê dois cliques em qualquer lugar da tela e pronto! A barra principal oferece diversas ferramentas de configuração e outras facilidades, como opção de copiar e colar nós, Biblioteca (Moment), Elipses para criar links entre fluxos e o Minimap, que a ajuda a navegar no fluxo com agilidade.

Estrutura

Acesse a página de listagem e criação pelo menu lateral > Build > Ações personalizadas Lá é possível criar, editar ou deletar uma ação.
Criação
Edição
Delete
Para a criação de ações personalizadas é requisito apenas o nome da ação e identificador, que será utilizado para acessar a ação através do builder.
A página de ações personalizadas possui duas áreas: desenvolvimento e testes. A barra de status indica o status atual do código e da publicação da ação.
Status do código:
  • Em desenvolvimento
  • Publicada
Os campo editáveis da área de desenvolvimento são:
  • Identificador: identificador que será usado para utilização da ação
  • Nome: Nome descritivo para a ação
  • Código em desenvolvimento:
    Editor de código javascript. Além das funções nativas do javascript, é possível fazer o uso de funções de duas bibliotecas adicionais:
    • Moment
    • Axios
  • Payload de teste: Editor de código JSON, onde deverá ser especificados os parâmetros
Para deletar, basta clicar em "sim" nos pop-ups de confirmação.

Área de testes

Os parâmetros setados para o teste poderão ser utilizados pela função através da variável "params", ou seja, para o payload abaixo, os valores podem ser acessados por "params.var1" ou "params.var2", por exemplo:
  • Parâmetros de teste: Editor onde os parâmetros devem ser setados no formato JSON.
  • Resultado do teste: Campo de leitura contendo o resultado da ação programada utilizando os parâmetros de teste.

Atributos

A estrutura do retorno de uma ação é a seguinte:
1
{
2
"code":"200/404/500",
3
"result":"retorno programado da ação"
4
}
Copied!
Atributos de um evento:
Atributo
descrição
code
Código de execução da ação:
  • 200 - Em caso de sucesso
  • 404 - Caso a ação não seja encontrada (por erro de escrita ou por não estar publicada, por exemplo)
  • 500 - Caso ocorra erros inesperados de execução.
result
Retorno da função criada. retornará exatamente o que foi programado pelo ser criador no altu
Para uso no builder, acessar através da result_variable da ação (result_variable.code ou result_variable.result), como no exemplo abaixo:

Modelo de homologação e produção

Toda as alterações feitas nas ações personalizadas só terão reflexos em versões publicas caso a ações personalizada seja publicada também. Dessa forma, temos um ambiente de homologação melhor definido para as ações personalizadas.
No ambiente de desenvolvimento as ações personalizadas serão executadas com todas as mudanças feitas antes mesmo de publicar.
Ao publicar uma versão no builder, não publicará as ações personalizadas, elas devem ser publicadas separadamente.

Helpers de Exemplo

Edição do nome, identificador e código da action:
Área de testes:
1
{
2
"var1":"value1",
3
"var2":{
4
"v1":"valuev1",
5
"v2":"value2"
6
}
7
}
Copied!
O teste é efetuado a partir do valor atual dos editores de código (ação e payload), portanto não é preciso salvar uma mudança no código para realizar um teste. Mas lembre-se de salvar sempre que for solicitar uma aprovação.

Aplicar no Assistente

Para aplicá-la no seu assistente vá em > configuração do nó > componente de ações ƒ > acesse o helper ? > busque por ação personalizada.
Ao editar, o ALTU irá trazer uma lista com todos as opções de ações personalizadas disponíveis. Exemplo:
Para ver uma lista com todas as opções disponíveis para usar o autocomplete use o atalhoCTRL + ESPAÇO
Last modified 5mo ago