Parâmetros

Os parâmetros são os dados que os componentes recebem e devolvem. O Proton tem três tipos de dado reaproveitável:

Tipo	Onde vale	Para quê
Parâmetro	Nos componentes	As entradas (in_) e saídas (out_) de cada passo.
Variável do dataset	Num dataset	Um valor compartilhado entre os passos de um dataset.
Parâmetro geral	Na organização inteira	Um valor usado por muitas automações, como um endereço ou um código fixo.

Os valores que mudam de um ambiente para outro (endereço, usuário, senha de homologação e de produção) ficam melhor nas variáveis do ambiente.

Parâmetros dos componentes

Um parâmetro é de entrada (o passo recebe) ou de saída (o passo devolve, e outro passo pode usar).

Regras do nome

• Entrada começa com in_; saída, com out_. Por exemplo, in_cliente e out_numero_pedido.
• Sem espaço. O nome vira chave no código da automação.
• Até 100 caracteres.
• Único na organização, entre entradas e saídas, sem diferenciar maiúsculas. O mesmo parâmetro pode ser usado por vários componentes.

O código lê o parâmetro exatamente pelo nome cadastrado, então in_Cliente e in_cliente não batem.

Criar e ligar

Os parâmetros são criados e ligados na tela do componente, com Criar parâmetro ou Adicionar parâmetros. Depois, cada dataset preenche os valores ao montar o dataset.

Renomear

O lápis do parâmetro abre a edição, com Onde é usado: os componentes, quantos datasets e automações e a última execução.

• O tipo (entrada ou saída) não muda. Para trocar, crie outro parâmetro.
• Dentro do Proton nada quebra: componentes e datasets continuam ligados ao parâmetro.
• O código precisa mudar junto. O código lê o parâmetro pelo nome: depois de renomear, até o código mudar, as execuções não encontram o parâmetro. A edição mostra o nome antigo e o novo para copiar a troca.

Variáveis do dataset

As variáveis do dataset ficam em Variável do Dataset, nas ações do dataset. Elas valem para todos os passos do dataset: um parâmetro do tipo Variável do Dataset usa o valor dela.

• O nome é único no dataset.
• Duplicar o dataset leva as variáveis.

Parâmetros gerais

Em Automações > Parâmetro Geral ficam os valores compartilhados por toda a organização. Um parâmetro do tipo Geral num dataset usa o valor dele: mudar o parâmetro geral muda todos os datasets que o usam.

• Adicionar pede o nome (único na organização), o valor, a categoria e, se for o caso, Encriptar valor.
• As Categorias, em árvore, organizam os parâmetros (por exemplo, Credenciais, URLs). Apagar uma categoria deixa os parâmetros dela sem categoria.
• Um valor criptografado não aparece mais. Para trocar, desmarque Encriptar valor na edição e digite o valor novo.

Permissões

Parâmetros, variáveis do dataset, parâmetros gerais e as categorias dos parâmetros gerais têm permissões próprias no perfil (ver, criar, alterar e apagar).