Sessions: vincular el diseño con su ejecución

Objetivo y modelo

Una Session enlaza un Mapping con un contexto ejecutable: entorno, selección de worker, perfil, recuperación, parámetros y rutas de archivos. No redefine el algoritmo de transformación. El Mapping conserva formato y esquema; la Session resuelve dónde se leen y escriben los archivos en el worker.

Esta separación permite reutilizar un Mapping para pruebas y operación sin mezclar ubicaciones. También exige revisar las versiones: una Session puede referenciar una versión anterior del Mapping aunque ya exista otra publicada.

Requisitos y ciclo de vida

Necesita acceso a la ubicación y al Mapping que desea usar. Las acciones New session, Save draft, Publish session, deshabilitar o eliminar están condicionadas por permisos. Para configurar File paths, la interfaz solicita un Mapping publicado. La existencia de un worker en un selector no reemplaza las comprobaciones de elegibilidad.

En el gestor, use búsqueda, filtros de entorno, estado y runtime, además de Columns, Export CSV y paginación. Las tarjetas de resumen ayudan a filtrar; no cambian el estado de las Sessions. Antes de una acción masiva, confirme la cantidad seleccionada y los nombres incluidos.

Campos por pestaña

Environment ofrece Development, Test, Stage y Production. Es una clasificación del contexto; elegir Production no publica por sí solo el objeto ni otorga permisos adicionales.

En Runtime, la opción normal es Use tenant default. Override worker permite elegir un worker explícito cuando se autoriza y resulta compatible. Execution profile puede heredar del Workflow. Las políticas de Recovery visibles incluyen fallo inmediato, un reintento, hasta tres reintentos y reanudación desde checkpoint; la recuperación efectiva depende del motor, la tarea y el checkpoint disponible.

La región y el proveedor cloud mostrados se derivan del worker y son de sólo lectura. No intente corregir una región editando la Session: revise el worker seleccionado.

Procedimiento de configuración

1. Cree s_ClientesDemo_Test mediante New session.
2. En General, seleccione el Mapping publicado de la POC de Mappings y una Folder de laboratorio.
3. Elija Test y revise el aviso de versión del Mapping.
4. En Runtime, conserve el worker del tenant o active un override compatible. Seleccione la política de recuperación que quiere comprobar.
5. En File paths, complete cada binding requerido con rutas accesibles desde el worker. Una ruta del equipo que ejecuta el navegador no es automáticamente una ruta del worker.
6. En Parameters, introduzca únicamente overrides definidos y compatibles con el diseño.
7. Guarde el borrador, revise los mensajes de validación y publique cuando corresponda.

Ejemplo de estructura de un override tipado, sólo si el Mapping define ese parámetro:

{
  "batchSize": {
    "type": "integer",
    "value": 5000
  }
}

La vista Parameter preview ayuda a comprobar nombre, tipo y valor antes de continuar.

POC: mismo diseño, dos contextos

Prepare dos directorios de laboratorio accesibles por el mismo worker. Copie el mismo archivo sintético de entrada en ambos. Cree dos Sessions que usen la misma versión publicada del Mapping: una con Environment Test y otra con Stage. Asigne destinos distintos para evitar sobrescritura.

Ejecute cada Session mediante un Workflow de laboratorio y compare las salidas. Resultado esperado: igualdad de los datos transformados si entradas y parámetros son equivalentes, con archivos de salida independientes. La distinción de entorno debe conservarse en las definiciones; no constituye una migración automática de archivos.

Como prueba negativa, use temporalmente una ruta de origen inexistente en la Session de Test. Observe el error en Monitor, restaure la ruta y valide un nuevo intento. No altere Stage para resolver un fallo exclusivo del laboratorio de Test.

Errores, versiones y recuperación

Un worker inelegible puede indicar capacidad, estado, perfil o exclusiones incompatibles. Revise Configuration antes de seleccionar otro al azar. Un JSON inválido debe corregirse sin reemplazar los demás campos del borrador.

Si aparece un aviso de versión, registre el Mapping y la versión referenciados. Guardar una actualización puede cambiar el vínculo conforme al aviso mostrado; revise también los Workflows que consumen la Session. No presuponga que publicar un Mapping republique todas las Sessions y todos sus consumidores.

El timestamp de destino puede heredarse, habilitarse o deshabilitarse. La plantilla opcional resuelve %RUN_TIMESTAMP% conservando el directorio de destino; compruebe el nombre resultante en una prueba pequeña antes de cargas repetidas.

Relaciones y límites

La ejecución se sigue en Monitor y la orquestación se define en Workflows. La POC anterior establece un criterio de aceptación reproducible; no informa de una ejecución realizada durante la preparación de esta documentación.