Editores de parámetros

Cada parámetro de una actividad se edita en el panel de Propiedades (a la derecha del canvas). No eliges el editor: el Designer muestra el más adecuado según el tipo y el uso del parámetro. La mayoría son un campo de texto/expresión, pero algunos abren editores visuales para que no tengas que escribir estructuras a mano.

Editores de colecciones

Cuando un parámetro acepta una lista, un diccionario o una tabla literal —un valor que escribes tú, no la salida de otra actividad— el panel muestra un botón Editar que abre un editor visual:

Tipo	Icono	Editor
Lista	[]	Añades, quitas y reordenas ítems, uno por fila.
Diccionario	{}	Filas de clave → valor.
DataTable	⊞	Defines columnas y filas, como en una hoja de cálculo.

En los tres, cada celda admite un valor fijo (texto, número) o una expresión (empezando por =), igual que cualquier parámetro.

Modo Expresión

Todos tienen también un modo Expresión: en vez de diseñar el valor celda a celda, pegas una sola expresión que devuelva la colección completa — por ejemplo, la salida de otra actividad (= clientes). Útil cuando el valor es dinámico.

Valores de fila: por columna o por posición

La actividad Add Data Row usa un editor especial para el parámetro Values, con un interruptor entre dos modos:

• Por columna — un diccionario { columna: valor }. Independiente del orden y valida el nombre de columna. Recomendado.
• Por posición — una lista de valores en el orden de las columnas. Más rápido si conoces el orden; debes dar exactamente un valor por columna.

Al alternar entre modos no se pierden los datos: se conserva lo que tenías en cada uno.

Por qué el modo por posición no muestra nombres de columna

El editor no conoce las columnas de la tabla en tiempo de diseño, porque la tabla es una expresión que solo se resuelve al ejecutar. Por eso el modo por posición es una lista ordenada de valores y tú debes conocer el orden.

Editor de condiciones

Las actividades que filtran o buscan filas — Filter DataTable y Find Data Row — usan el editor de condiciones: construyes una o varias condiciones de forma visual, sin escribir la expresión a mano.

Cada condición es columna · operador · valor, y se combinan con lógica AND (todas) u OR (cualquiera). Operadores disponibles: igual, distinto, contiene, empieza/termina con, mayor/menor (o igual) que, está vacío / no está vacío.

El valor de cada condición admite a su vez una expresión (= …), así que puedes comparar contra una variable.

Otros editores del panel

Según el parámetro, el panel también puede mostrar:

• Selector de credenciales — para parámetros sensibles, eliges un secreto guardado en Nexus sin escribirlo en el playbook.
• Nombre de variable — para parámetros que nombran una variable de salida (no su valor), en vez de una expresión.
• Parámetros ocultos — algunos parámetros internos que la actividad gestiona sola no se muestran.

Recuerda: el editor lo determina cada actividad según el tipo de dato del parámetro; no es una elección manual.

Siguientes pasos

• Tipos de datos — listas, diccionarios, DataTable y DataRow.
• Expresiones — el modo Expresión y los valores = ….
• Add Data Row · Find Data Row — actividades que usan estos editores.