Primer flujo completo: de la fuente al resultado verificado

Esta guía propone un recorrido de laboratorio que une organización, transformación, ejecución y observación. El objetivo es obtener un CSV cuyo contenido pueda comprobarse, dejando claras las versiones y las condiciones de ejecución. Utilice datos sintéticos y destinos separados de cualquier proceso operativo. La POC de normalización ofrece una entrada y un resultado conocido para completar el recorrido.

Preparar el espacio de trabajo

Entre con una identidad autorizada y compruebe el tenant y el rol activos en el menú de cuenta. Una misma persona puede disponer de contextos diferentes; el nombre del objeto por sí solo no identifica su ámbito. Antes de crear nada, abra Repository y localice un Domain y una Folder destinados al laboratorio. Si su rol no permite crearlos, solicite que un administrador prepare ese espacio.

Defina nombres reconocibles, por ejemplo un prefijo lab_, y conserve la relación entre Mapping, Session y Workflow. No reutilice identificadores de objetos productivos. Prepare también una carpeta de entrada y otra de salida accesibles para el entorno de ejecución elegido. Una ruta disponible en su portátil no necesariamente existe en el worker remoto. Las credenciales y conexiones deben configurarse mediante Connections, nunca dentro de la muestra o del nombre de archivo.

Diseñar y validar el Mapping

El Mapping describe las operaciones sobre los datos. Para comenzar, utilice una fuente CSV con encabezado, una transformación sencilla y un destino CSV. Revise delimitador, codificación, nombres de columnas y representación de valores vacíos. Introduzca después la cadena de ocho transformaciones de la primera POC si desea un ejercicio más completo.

Conecte los componentes en el orden necesario. Un filtro colocado antes de una conversión puede producir un comportamiento diferente al mismo filtro después de convertir; el dibujo debe reflejar la regla de negocio. Valide la definición, examine cada advertencia y guarde el borrador. Publique sólo cuando el esquema, las expresiones y los campos de salida sean coherentes. El guardado del borrador y la publicación son pasos diferentes dentro del ciclo de vida.

Asociar la Session

La Session conecta el Mapping con sus condiciones de ejecución. Seleccione la versión prevista y revise sus bindings de entrada y salida. Para la POC, source_csv debe recibir el archivo de clientes y target_csv debe producir el CSV normalizado. Conserve los identificadores de los nodos al trasladar la definición; un nombre de archivo correcto no compensa un binding asociado al nodo equivocado.

Revise worker, perfil de ejecución y opciones disponibles. El worker debe ser compatible, estar habilitado y disponer de capacidad. Compruebe por separado su estado operativo y sus slots en Workers. Evite interpretar una VM encendida como garantía de que el agente puede ejecutar el trabajo. Valide y publique la Session después de verificar estas condiciones.

Orquestar y ejecutar manualmente

Cree un Workflow que invoque la Session publicada. Un primer flujo puede contener una sola tarea. Añada decisiones o temporizadores cuando la ejecución básica tenga un resultado estable. Si utiliza las definiciones de muestra, examine las condiciones complementarias y las variables antes de ejecutarlas: el temporizador forma parte del diseño y no debe confundirse con una programación recurrente.

Valide y publique el Workflow, y lance una ejecución manual en el laboratorio. Registre su identificador. Si la interfaz acepta overrides, conserve qué valores pertenecen a ese intento; no los considere cambios permanentes de la definición. Todavía no habilite una programación: primero necesita comprobar el comportamiento manual, la ubicación del resultado y la evidencia que produce.

Comprobar el resultado y cerrar el ensayo

Abra Monitor y siga la ejecución hasta un estado terminal. Una solicitud aceptada o una fila en cola no demuestra que exista una salida correcta. Revise tareas, errores y registros disponibles. Después compare el archivo generado con el resultado esperado de la POC. El conteo de filas es una comprobación útil, pero debe acompañarse de valores, esquema y orden; el wrapper de muestras realiza una comparación byte por byte.

Documente tenant, Domain, Folder, versiones, identificador de ejecución, cantidad de filas y ubicación autorizada de la salida. Mantenga esa evidencia sin secretos. Si el resultado difiere, revise primero parsing, bindings y transformaciones; no vuelva a ejecutar repetidamente contra un destino compartido. Corrija el borrador correspondiente, publique la nueva versión y realice un intento identificable.

Cuando el recorrido sea estable, defina si necesita una programación en Configuration, con una zona horaria explícita y una política de recuperación entendida. Limpie las salidas de laboratorio cuando dejen de ser necesarias, sin borrar evidencia requerida por su equipo. Para trasladar el flujo a otro entorno, vuelva a comprobar permisos, rutas, conexiones y capacidad: una POC local valida sus reglas, pero no certifica la infraestructura de destino.