Antes de comenzar
Un Mapping define el algoritmo de transformación. La Session aporta el contexto de ejecución y el Workflow coordina tareas. Selecciona el tenant correcto y una ubicación autorizada en Repository. Necesitas permisos de edición; publicar y ejecutar son acciones adicionales. Prepara una muestra sintética con entrada y resultado esperados, sin credenciales ni datos de clientes.
La presencia de un componente en la paleta no garantiza compatibilidad de cualquier worker. Comprueba el runtime, especialmente para conexiones externas y grafos con Join.
Procedimiento
- Abre Mappings y crea un borrador en el Domain y Folder adecuados. Usa un nombre descriptivo.
- Añade los componentes desde sus categorías y conecta la salida de cada paso con la entrada siguiente. Selecciona el componente para configurar el inspector.
- Ajusta cabecera, nombres y tipos del origen antes de configurar transformaciones. Revisa las claves de Join y las columnas que recibirá el destino.
- Usa Validate para resolver problemas del grafo. Save guarda el borrador persistente. El indicador de guardado local no sustituye esta acción.
- Publica únicamente después de guardar todos los cambios. Publish requiere un borrador guardado sin cambios pendientes; no ejecuta el Mapping.
Field selector: conservar solo campos elegidos
Para conservar solo dos columnas de un CSV, conecta Flat File input → Field selector → Flat File output. Configura hasHeader=true, delimiter=, y fields=["name","amount"]. El selector conserva los valores y las filas, pero elimina las demás columnas del esquema. El destino usa ese esquema; fileName no controla selección de campos.
Comprobar el resultado
Reabre el borrador para comprobar persistencia. Revisa la versión publicada antes de enlazarla a una Session. Ejecuta una muestra mediante capacidad autorizada y compara cabecera, filas y valores con el resultado esperado. Una validación estructural correcta no demuestra que el archivo exista en el worker ni que el resultado responda a la regla de negocio.
Puedes pedir a DovaAI los componentes, conexiones y valores que convienen al objetivo. El asistente ofrece instrucciones breves; tú realizas la configuración, guardas, publicas y ejecutas desde los controles normales de Dova.
Resolver problemas
Si Publish está desactivado, comprueba guardado, cambios pendientes, ubicación y permisos o bloqueo de edición. Si aparecen columnas extra, revisa la configuración guardada de Field selector, la rama conectada y la versión usada por la Session. Si faltan archivos, corrige los bindings del runtime. Ante incompatibilidad de streaming, revisa el adaptador: el genérico exige una ruta lineal compatible. No elimines pasos necesarios solo para hacer pasar la validación.
Modificar campos distintos con operaciones distintas
Conecta dos componentes Clean text en serie:
Raw file → Clean text 1 → Clean text 2 → Destino
- Clean text 1: Fields =
first_name; Operations =trim. - Clean text 2: Fields =
last_name; Operations =upper.
Ambos campos viajan juntos. Cada componente modifica únicamente el campo indicado y conserva los demás. No dividas el flujo ni añadas Field mapper para aplicar estas dos operaciones.
Eliminar una selección del canvas
Selecciona el elemento y presiona Supr (Delete) con el foco dentro del canvas. El atajo no debe borrar componentes mientras escribes en un input, textarea u otro editor. Revisa las conexiones afectadas y valida el grafo después de eliminar; el cambio pertenece al borrador hasta que lo guardes y publiques.
Columnas para revisar dependencias y publicación
En Columns puedes elegir Used by (Sessions), Location, Last published y Description. Used by (Sessions) muestra la cantidad de Sessions que utilizan el Mapping; pulsa el número para consultar sus nombres y las versiones del Mapping referenciadas. Location combina Domain y Folder. Last published muestra fecha y responsable de la última publicación, por separado de Updated, que puede corresponder a cambios del borrador. Description resume el propósito del Mapping. Si falta evidencia histórica, la tabla lo indica en lugar de inventar una fecha o un usuario.
Para una configuración nueva, la tabla muestra Mapping, Version, Status, Used by (Sessions), Location y Updated. Conserva las columnas que ya hubieras elegido; activa las adicionales desde Columns. El filtro Status ofrece Draft y Published, de acuerdo con el ciclo de edición y publicación.
Pantalla completa sin perder el trabajo
Full Screen amplía el canvas de Mappings o de Workflows en el mismo editor. La entrada y la salida actualizan el diseño de inmediato y conservan selección, zoom y posición. Usa el mismo botón o Escape para volver. DovaAI continúa disponible en esta vista; ampliar el canvas no guarda ni publica el borrador.
Acciones de la tabla
Al iniciar una opción de Actions, el indicador de progreso aparece en el control y bloquea las demás acciones de esa tabla mientras la solicitud está pendiente. Espera el resultado antes de repetir. Que la solicitud haya comenzado no demuestra que el guardado, la publicación o la operación hayan terminado.
Contexto de entorno
Antes de utilizar este módulo confirma Tenant, Domain y Environment en el menú de usuario. El entorno inicial es Development. Las capacidades del módulo, el Domain y el entorno se aplican juntas; Production queda de solo lectura sin autorización explícita. Cambiar el selector no mueve artefactos ni publica o ejecuta sus datos. Consulta entornos y recuperación y promoción entre entornos.
Lista compacta y botones con íconos
La lista reúne Search, Status y las acciones en una barra compacta. Refresh, Columns, Export CSV, Delete selected, New Mapping y Clear filters usan íconos; coloca el puntero sobre un botón o llévale el foco con Tab para identificar su acción. Las acciones siguen respetando selección, permisos y estados deshabilitados.
La lista de Mappings no incluye filtros Environment ni Runtime. El entorno procede del contexto activo de la barra inferior; el worker y su capacidad se configuran en la Session. Usa Search, Status y los filtros de columnas para revisar los objetos de ese contexto.
Diseñar, guardar y publicar desde el editor
Advanced, Validate, Save draft y Publish se presentan como botones con íconos y nombres accesibles. La ayuda del botón identifica la acción y, cuando corresponde, el entorno del guardado o la publicación. El encabezado no repite el distintivo DEV: confirma Tenant, Domain y Environment en la barra inferior.
Mappings no ofrece un botón Run. Un Mapping define la transformación; para ejecutarla, guarda y publica la versión revisada, selecciónala en una Session y configura sus entradas, destinos y worker compatible. Ejecuta la Session directamente o mediante un Workflow autorizado. Publicar el Mapping no inicia una ejecución ni asigna capacidad.
Configuration del componente
Selecciona un componente para revisar sus secciones y campos en Configuration. Las etiquetas, controles y ayudas se distribuyen dentro del ancho disponible. En los orígenes con Header mapping, los botones para cargar una muestra, agregar un campo y eliminar mantienen su propio espacio junto al título. Revisa Source, Output y Type en la tabla; desplázala horizontalmente si sus columnas no caben en el panel. Una muestra de encabezados configura el esquema y no sustituye el archivo que la Session leerá en el worker.