Crear la estructura de las entradas o salidas del escenario
Antes de intercambiar datos con un escenario, define qué campos espera y qué devuelve. La estructura documenta los tipos y permite marcar entradas obligatorias.
Definir los campos
- En el editor del escenario, abre el icono de entradas y salidas.
- Selecciona Scenario inputs o Scenario outputs y pulsa Add item.
- Escribe Name, el identificador obligatorio. La guía usa letras, números y guiones bajos, sin espacios ni caracteres especiales; no comienza con un número ni con un guion bajo seguido de un número.
- Añade una Description que explique qué contiene el campo o para qué se usa.
- Selecciona Type, también obligatorio.
- Si procede para la entrada, configura Default como valor cuando falte el original y Required para indicar si es necesaria al iniciar el escenario.
- Configura Multi-line para la presentación del texto cuando aparezca en tipos como Text, Array, Collection o JSON.
- Repite el proceso con los demás campos y guarda tanto la configuración como el escenario.
Ajustes según el tipo
| Tipo | Configuración descrita en la fuente |
|---|---|
| Array | Selecciona el tipo de los elementos en el campo Type anidado. |
| Collection | Define los campos en Specification si necesitas validar su estructura. La guía advierte que dejarla vacía acepta cualquier colección de entrada. |
| Select | Añade las alternativas del desplegable en Options. |
| Dynamic collection | Permite mapear una colección o una cadena JSON a la salida; Return output analiza el JSON y lo devuelve como paquetes de datos. |
Consulta los tipos de entradas y salidas para ampliar la definición de cada tipo. La fuente menciona Create JSON para preparar una salida personalizada.
Conectar la estructura con el escenario
La guía utiliza Scenarios > Start scenario para trabajar con entradas y Scenarios > Return output para devolver salidas.
Comprobación editorial: prueba una entrada válida y otra sin un campo obligatorio. Verifica también que el valor devuelto tenga el tipo declarado; definir la estructura no sustituye esa comprobación.