Campos das ações
Os campos que forem criados devem ser mapeados de acordo com os respectivos dados da solicitação.
Para criar, clique no botão "Adicionar campo" e preencha os campos no pop-up. A lista de campos na criação contempla:
Código do campo - ID interno do campo. Este campo não permite apenas números nem espaços. Textos com números são permitidos. Ele não é acessível para edição posterior.
Nome - o nome do campo que estará aparecendo na interface para usuários finais.
Nome Alternativo - o nome do campo que vai aparecer na interface para usuários finais, podendo ser o mesmo do campo anterior. É exibido nas interfaces de outros países.
Dica - o texto curto explicativo que será mostrado embaixo do campo a ser preenchido. É exibido na interface da Albato em português do Brasil.
Dica alternativa - o texto curto explicativo que será mostrado embaixo do campo a ser preenchido, podendo ser o mesmo do campo anterior. É exibido nas interfaces de outros países.
Lista - a lista criada no aplicativo que é selecionada e vinculada a este campo.
Tipo - selecionado conforme as configurações da documentação API.
Campo editável - um parâmetro que indica que o campo aparecerá nas configurações da etapa de ação. Se não houver marca de seleção, o campo não participa das configurações, mas você pode salvar o valor da variável da resposta quando solicitado, na guia Response. Em termos mais simples, é um “campo de resposta”.
Campo obrigatório - um parâmetro que indica que o preenchimento do campo será obrigatório na hora de configurar o passo da ação. A Albato não permitirá salvar a configuração do passo e executar a automação sem que este campo esteja configurado.
Após criado, os campos são editáveis. Basta clicar no botão de edição:
Cada campo tem seu próprio tipo. Ele indica como será o campo na hora de editar o passo e quais dados teremos nele.
Tipos suportados:
String - String ””
Int - Número inteiro
Decimal - Número fracionário
Boolean - Lista com valores “Verdadeiro” e “Falso”
dateTime - Tipo de data e hora, especificamente. Este campo precisa ser processado e/ou convertido no formato necessário posteriormente.
Phone - Tipo interno que especifica que o campo terá o número de telefone.
Todos os campos podem ter um tipo adicional com array no final. Isso significa que os dados virão em uma matriz de elementos (como a matriz de strings). Veja um exemplo considerando o JSON no seguinte formato:
Nesse caso, ao criar um campo que será mapeado para tags com o tipo igual a StringArray, na hora de preencher o campo, é possível definir vários valores diferentes separando-os com uma vírgula. Posteriormente, a requisição HTTP formará uma matriz (array) de elementos.
Criar campos
Para criar, clique no botão "Adicionar campo" e preencha os campos no pop-up. A lista de campos na criação contempla:
Código do campo - ID interno do campo. Este campo não permite apenas números nem espaços. Textos com números são permitidos. Ele não é acessível para edição posterior.
Nome - o nome do campo que estará aparecendo na interface para usuários finais.
Nome Alternativo - o nome do campo que vai aparecer na interface para usuários finais, podendo ser o mesmo do campo anterior. É exibido nas interfaces de outros países.
Dica - o texto curto explicativo que será mostrado embaixo do campo a ser preenchido. É exibido na interface da Albato em português do Brasil.
Dica alternativa - o texto curto explicativo que será mostrado embaixo do campo a ser preenchido, podendo ser o mesmo do campo anterior. É exibido nas interfaces de outros países.
Lista - a lista criada no aplicativo que é selecionada e vinculada a este campo.
Tipo - selecionado conforme as configurações da documentação API.
Campo editável - um parâmetro que indica que o campo aparecerá nas configurações da etapa de ação. Se não houver marca de seleção, o campo não participa das configurações, mas você pode salvar o valor da variável da resposta quando solicitado, na guia Response. Em termos mais simples, é um “campo de resposta”.
Campo obrigatório - um parâmetro que indica que o preenchimento do campo será obrigatório na hora de configurar o passo da ação. A Albato não permitirá salvar a configuração do passo e executar a automação sem que este campo esteja configurado.
Após criado, os campos são editáveis. Basta clicar no botão de edição:
Tipos de campos
Cada campo tem seu próprio tipo. Ele indica como será o campo na hora de editar o passo e quais dados teremos nele.
Tipos suportados:
String - String ””
Int - Número inteiro
Decimal - Número fracionário
Boolean - Lista com valores “Verdadeiro” e “Falso”
dateTime - Tipo de data e hora, especificamente. Este campo precisa ser processado e/ou convertido no formato necessário posteriormente.
Phone - Tipo interno que especifica que o campo terá o número de telefone.
Matrizes de elementos
Todos os campos podem ter um tipo adicional com array no final. Isso significa que os dados virão em uma matriz de elementos (como a matriz de strings). Veja um exemplo considerando o JSON no seguinte formato:
{"tags":[ "tag", "tag2", "tag3"]}Nesse caso, ao criar um campo que será mapeado para tags com o tipo igual a StringArray, na hora de preencher o campo, é possível definir vários valores diferentes separando-os com uma vírgula. Posteriormente, a requisição HTTP formará uma matriz (array) de elementos.
Atualizado em: 01/12/2022
Obrigado!