Parâmetros, modelos e condições

Antes de começar

Parâmetros tipados, modelos de Calculated field e condições JSON de Workflow são mecanismos diferentes. Nenhum transforma texto arbitrário em código executável. Defina tipos e escopo antes de inserir overrides. Use valores sintéticos e nunca coloque segredos em parâmetros de texto.

Os tipos admitidos são string, integer, number, boolean, datetime, json e secret. Um parâmetro sensível deve usar secret, com referência protegida válida, não texto claro marcado como sensível.

Procedimento

Declare um parâmetro com nome único, tipo e restrições. São permitidas até 100 definições. O nome começa por letra, tem até 64 caracteres e permite letras, números, pontos, hífens e sublinhados. sys. e dova. são reservados.
Revise required, overridable, scopes, valor padrão e restrições. Booleano exige JSON true/false, não texto equivalente. Números precisam ser finitos.
Confira a resolução por camadas: padrão → global → environment → worker → task. Uma camada posterior permitida substitui a anterior sem anular restrições de escopo.
Para texto derivado, use ${name} e ${param.region}. O resultado é texto de até 4.000 caracteres; identificador reconhecido ausente vira texto vazio.
Para decidir um ramo, use condição JSON com referências autorizadas, não fórmula SQL.

Exemplo sintético

Modelo de Calculated field:

{
  "field": "label",
  "template": "${name}-${param.region}"
}

Com name=Ana e parâmetro region=NORTH, produz Ana-NORTH. Não soma números nem extrai a primeira letra.

Condição True de uma Decision:

{
  "ref": "parameters.RUN_MODE",
  "op": "eq",
  "value": "full"
}

Declare RUN_MODE antes de usar. Execute tentativas separadas com full e sample; confira o ramo False complementar mostrado pela interface.

Conferir o resultado

As referências de condição admitem parameters.name, variables.name, tasks.id.status e tasks.id.outputs.name. Use identificadores reais de tarefa e saídas documentadas; não invente um contador universal. Operadores: eq, ne, gt, gte, lt, lte, in, not_in, contains, exists, truthy. Grupos all/any reúnem de 1 a 20 expressões; not nega uma expressão.

Confirme valores e procedência no preview autorizado. Depois confira o ramo selecionado no Monitor. Tipos incompatíveis não garantem conversão automática.

Resolver problemas

Se um override não mudar o resultado, confira scope, Overridable e camada de origem. Para texto vazio, confira o nome do campo ou parâmetro do modelo. Nomes com pontos não fornecem navegação geral em objetos aninhados. Árvores de condições rejeitam profundidade superior a cinco, mais de 40 nós e valores de comparação com mais de 4.096 bytes. Referência ausente torna comparações ordinárias falsas. Corrija o contrato em vez de enfraquecer restrições para aceitar um valor não autorizado.

Variáveis operacionais de Runtime

Consulte Sessions → Session → Runtime → Available runtime variables para ver tokens, significado, exemplos e último valor resolvido autorizado. %RUN_TIMESTAMP% compõe o nome de saída quando Target filename timestamp está efetivamente Enabled. O exemplo do formulário é uma prévia; o valor real pertence ao identificador e à data da tentativa. Essas variáveis operacionais não substituem ${field} nem permitem código arbitrário. Parâmetros sensíveis permanecem ocultos.