Montar o dataset
Ao abrir um dataset, o Proton mostra os Componentes do Dataset: os passos em ordem. Aqui você inclui, reordena e retira passos e preenche os parâmetros de cada um.
A tela tem duas visões: Visualizar em lista, para editar, e Visualizar em canvas, o fluxo dos passos para ver de longe (dois cliques num passo abrem os parâmetros dele).
Passos
- Adicionar Componente: escolha os componentes na ordem desejada (a busca procura por nome e sistema). Eles entram no fim, na ordem do clique. O mesmo componente pode aparecer mais de uma vez.
- Reordenar: arraste os passos para mudar a sequência e clique em Finalizar ordem.
- Desassociar: tira o passo deste dataset, com os valores dele. O componente continua cadastrado. Para tirar vários de uma vez, use Selecionar.
Ao reordenar, confira as referências: um passo que usa a saída de outro precisa vir depois dele.
Detalhes do passo
Selecionar um passo mostra o componente, o sistema, a documentação e o Resultado esperado neste dataset: o que este dataset espera do passo, além do resultado esperado do componente (que vale para todos os datasets). Esse texto entra no documento da automação.
Parâmetros
Editar parâmetros abre os parâmetros do passo:
- Adicionar inclui os parâmetros do componente (Adicionar padrões traz todos de uma vez).
- Clique num parâmetro para escolher o tipo do valor e preencher.
As saídas do próprio passo aparecem só para leitura: o valor delas vem da execução.
Tipos de valor
| Tipo | O que é |
|---|---|
| Normal | Um texto fixo. Pode ser criptografado com Encriptar valor. |
| Output | A saída de um passo anterior deste dataset. É assim que um passo passa dados para outro, como o número do pedido criado. |
| Variável do Dataset | Uma variável deste dataset, compartilhada entre os passos. Dá para criar a variável na hora. |
| Referência | A saída de um passo de outro dataset, inclusive de outra automação. |
| Geral | Um parâmetro geral da organização. Mudar o parâmetro geral muda todos os datasets que o usam. |
| Lista | Uma tabela, com colunas e linhas, que chega ao componente como JSON. Útil para itens de um pedido, por exemplo. |
Valores criptografados
Senhas, tokens e chaves vão com Encriptar valor. O valor fica cifrado e não aparece mais na tela, nem na lista de datasets, nem na planilha: só a execução recebe. Para trocar, desmarque Encriptar valor, digite o valor novo, marque de novo e salve.
Lista
O editor da lista tem dois modos, Tabela e JSON:
- em Colunas, as chaves (sem espaço e em minúsculas);
- em Valores, as linhas;
- numa célula, digite
{{para inserir uma variável do dataset, um parâmetro geral ou a saída de um passo.
Uma lista não pode ser criptografada.
Permissões
Incluir, reordenar e tirar passos e preencher os parâmetros exigem as permissões de componente do dataset e de parâmetro do dataset no perfil. Numa automação privada, vale também o nível de acesso da sua equipe.