Parámetros, plantillas y condiciones

Antes de comenzar

Los parámetros tipados, las plantillas de Calculated field y las condiciones JSON del Workflow son mecanismos distintos. Ninguno convierte texto arbitrario en código ejecutable. Define tipos y alcance antes de introducir overrides. Usa valores sintéticos y nunca pongas secretos en parámetros de texto.

Los tipos admitidos son string, integer, number, boolean, datetime, json y secret. Un parámetro sensible debe usar secret, con una referencia protegida válida, no un valor claro marcado como sensible.

Procedimiento

Declara un parámetro con nombre único, tipo y restricciones. Se admiten hasta 100 definiciones. El nombre comienza por letra y tiene hasta 64 caracteres; permite letras, números, puntos, guiones y guiones bajos. sys. y dova. están reservados.
Revisa required, overridable, scopes, valor por defecto y restricciones. Booleano requiere JSON true/false; no uses texto equivalente. Los números deben ser finitos.
Comprueba la resolución por capas: valor por defecto → global → environment → worker → task. Una capa posterior permitida reemplaza la anterior; no anula restricciones de alcance.
Para texto derivado usa ${name} y ${param.region}. El resultado es texto de hasta 4.000 caracteres; un identificador reconocido ausente se sustituye por vacío.
Para decidir una rama, usa una condición JSON con referencias autorizadas, no una fórmula SQL.

Ejemplo sintético

Plantilla de Calculated field:

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

Con name=Ana y parámetro region=NORTH, produce Ana-NORTH. No realiza suma ni extracción de primera letra.

Condición True de una Decision:

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

Declara RUN_MODE antes de usarlo. Ejecuta intentos separados con full y sample; revisa la rama False complementaria que muestra la interfaz.

Comprobar el resultado

Las referencias de condición admiten parameters.name, variables.name, tasks.id.status y tasks.id.outputs.name. Usa el identificador real de tarea y salidas documentadas; no inventes un contador universal. Operadores: eq, ne, gt, gte, lt, lte, in, not_in, contains, exists, truthy. Los grupos all/any reúnen de 1 a 20 expresiones; not niega una expresión.

Confirma valores y procedencia en el preview autorizado. Luego comprueba la rama tomada en Monitor. Las comparaciones de tipos incompatibles no prometen conversiones automáticas.

Resolver problemas

Si un override no cambia el resultado, revisa scope, Overridable y la capa de procedencia. Si aparece texto vacío, revisa el nombre del campo o parámetro de la plantilla. Un nombre con puntos no equivale a navegación general por objetos anidados. Los árboles de condiciones rechazan profundidad superior a cinco, más de 40 nodos y valores de comparación de más de 4.096 bytes. Una referencia ausente hace falsas las comparaciones ordinarias. Corrige el contrato, no debilites restricciones para aceptar un valor no autorizado.

Variables operativas de Runtime

Consulta Sessions → Session → Runtime → Available runtime variables para ver tokens disponibles, significado, ejemplo y último valor resuelto autorizado. %RUN_TIMESTAMP% sirve para el nombre de salida cuando Target filename timestamp está efectivo como Enabled. El ejemplo del formulario es una vista previa; el valor real se asocia al identificador y fecha del intento. Estas variables operativas no sustituyen ${field} ni permiten código arbitrario. Los parámetros sensibles permanecen ocultos.