> For the complete documentation index, see [llms.txt](https://docs.violetlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.violetlabs.com/es/funciones/workflows/flujos-de-trabajo-de-sincronizacion-de-datos/como-empezar.md). # Cómo empezar ## **Conceptos clave** Antes de construir un flujo de trabajo de sincronización, ayuda entender algunos términos: * **Origen** — el sistema y el tipo de registro que estás sincronizando *desde* (p. ej., Duro – Revisión de pieza) * **Destino** — el sistema y el tipo de registro que estás sincronizando *a* (p. ej., ION – Revisión de pieza) * **Activador** — lo que hace que la sincronización genere Cambios pendientes: ya sea un programa de tiempo, o cuando Violet identifica cambios después de obtener nuevos datos de la aplicación de origen * **Filtros** — condiciones opcionales que limitan qué registros de origen se sincronizan (p. ej., sincronizar solo piezas con Estado = "Released") * **Mapeos** — cómo las propiedades en el origen corresponden a las propiedades en el destino (p. ej., origen "Part Number" → destino "Item Name") * **Dependencias** — registros relacionados sincronizados junto con el registro principal (p. ej., archivos adjuntos a una pieza) * **Cambios pendientes** — una vista previa preparada de lo que se creará, actualizará o eliminará antes de que se aplique nada a tu sistema de destino * **Lote de sincronización** — a medida que se identifican los Cambios pendientes, se agrupan en un lote de sincronización. Estos lotes contienen todos los Cambios pendientes de un flujo de trabajo desde que se ejecutó la última sincronización. * **Ejecución de cambios** - la ejecución real de los cambios en el sistema de destino: ya sea una aprobación manual, un programa de tiempo o una Ejecución de cambios en vivo “al crearse”. Todos los cambios en un Lote de sincronización se ejecutarán juntos. ## **Creación de un flujo de trabajo** ### **Paso 1 — Abre el generador de flujos de trabajo** Ve a la **Flujos de trabajo** pestaña y haz clic en **+ Flujo de trabajo de sincronización**.

Si iniciaste previamente un flujo de trabajo y no lo terminaste, aparecerá un indicador **Borrador disponible** — el generador restaurará automáticamente donde lo dejaste. ### **Paso 2 — Asigna un nombre a tu flujo de trabajo** Ingresa un nombre descriptivo en la parte superior del lienzo. Elige algo que sea fácil de identificar más adelante, como *"Sincronización de orden de compra ION → Ramp"*. Recomendamos incluir los nombres de las aplicaciones de origen y destino y el tipo de registros que se están sincronizando en el flujo de trabajo. ### **Paso 3 — Configura el origen y el destino** Haz clic en el **Origen** nodo en el lienzo y selecciona: * La **integración de origen** (el sistema desde el que sincronizas) * La **tipo de entidad de origen** (el tipo de registro — p. ej., Pieza, Orden de compra, Tarea) Luego haz clic en el **Destino** nodo y selecciona: * La **integración de destino** (el sistema al que sincronizas) * La **tipo de entidad de destino**

### **Paso 4 — Configura un activador** Haz clic en el **Activador** nodo y elige cómo el flujo de trabajo genera cambios pendientes:


Tipo de activador	Cuándo se ejecuta
Actividad	Automáticamente cuando se obtiene o actualiza la integración de origen
Programado	En un intervalo de tiempo que elijas: cada 15 min, 30 min, 1 h, 2 h, 4 h, 6 h, 12 h, diario o semanal

### **Paso 5 — Agrega filtros *****(opcional)*** Haz clic en el **Filtros** nodo para limitar qué registros de origen se incluyen en la sincronización. Para cada filtro, elige: 1. Una **propiedad** del registro de origen (p. ej., Estado, Fase del ciclo de vida) 2. Un **operador** (igual a, comienza con, termina con, está en, la fecha es posterior a, coincidencia con regex y más) 3. Una **valor** con el que coincidir (ten en cuenta que los valores distinguen entre mayúsculas y minúsculas) Puedes agregar varios filtros. Los filtros marcados **deben cumplirse** actúan como condiciones AND — todas deben cumplirse. Los demás actúan como condiciones OR.

### **Paso 6 — Asigna mapeos a las propiedades** Haz clic en el **Mapeos** nodo para definir cómo se traducen las propiedades del origen a propiedades del destino. Violet completará automáticamente los mapeos de propiedades más probables entre los sistemas de origen y destino, pero debes confirmar que sean correctos. * Las propiedades marcadas con \* son obligatorias — deben asignarse antes de que puedas guardar * Las propiedades opcionales pueden asignarse o dejarse en blanco según sea necesario. Si se dejan en blanco, las sincronizaciones no crearán ni actualizarán datos en esa propiedad de destino durante una sincronización * Para **propiedades de selección/desplegable**, también puedes asignar valores de opción individuales (p. ej., estado de origen "Released" → estado de destino "Active") **Opciones de mapeo:**


Opción	Descripción
Mapeo directo	Asignar una propiedad de origen directamente a una propiedad de destino
Valor literal	Establecer un valor fijo de texto en la propiedad de destino, independientemente del origen
Concatenación	Combinar varias propiedades de origen con separadores (p. ej., `{Part Number} / {Revision}`)
Transformador	Aplicar una transformación integrada (p. ej., convertir a minúsculas, extraer una fecha, eliminar caracteres no numéricos)

### **Paso 7 — Configura dependencias *****(si se muestra)*** Algunos tipos de entidad de destino tienen relaciones obligatorias o subentidades relacionadas. Por ejemplo, si estás sincronizando una Orden de compra, el sistema de destino puede requerir que se vincule con un Proveedor en ese sistema. Del mismo modo, las Líneas de orden de compra son una subentidad de la Orden de compra, y se sincronizarán juntas. Estas sincronizaciones dependientes aparecen como filas adicionales debajo de la sincronización principal en el lienzo. Si tu sincronización tiene dependencias obligatorias, debes configurar tu integración para obtener esos tipos de entidad junto con la entidad principal que deseas sincronizar (p. ej., debes obtener tanto Órdenes de compra como Proveedores/Vendedores en la misma integración para ambos sistemas, de Origen y Destino). Las subentidades, como las Líneas de orden de compra, se obtienen automáticamente junto con su entidad principal; no tienes que hacer ninguna configuración especial para habilitar esto. Para cada dependencia: 1. **Selecciona la relación de origen** — si pueden aplicarse varias relaciones de origen, elige cuál usar 2. Agrega opcionalmente **Filtros** y **Mapeos** específico para esa dependencia

### **Paso 8 — Guardar** Haz clic en **Guardar flujo de trabajo** cuando hayas terminado. Si falta algo obligatorio, los nodos afectados mostrarán un **borde rojo con un indicador de error**. Haz clic en el nodo para ver qué debe completarse. Si todo sale bien, se te redirigirá a la lista de Flujos de trabajo y el nuevo flujo de trabajo aparecerá allí. ### **Paso 9 — Elige el método de ejecución y configura las notificaciones** Una vez que hayas guardado tu flujo de trabajo de sincronización, el par de integración Destino > Origen aparecerá en la **Todas las integraciones** lista. Haz clic en el par de integraciones y luego haz clic en el engranaje en el **Configuración de ejecución:** bloque para configurar el método de ejecución de cambios de sincronización.

Puedes elegir ejecutar los cambios de sincronización en un **Temporizador**, o **En actividad**. Si deseas ejecutar los cambios de sincronización **En actividad**, puedes elegir entre una *manual* *aprobación*, o *ejecución automática* cada vez que se complete el flujo de trabajo de creación de cambios de sincronización.

#### Notificaciones Activa la opción Notificaciones para expandir el menú de configuración. *** ## **Gestión de flujos de trabajo de sincronización** En la lista de Flujos de trabajo, cada tarjeta de flujo de trabajo muestra su nombre, las integraciones de origen y destino, y su estado actual. * **Editar:** Para editar un flujo de trabajo, haz clic en cualquier parte de la tarjeta del flujo de trabajo. * **Preparar cambios manualmente (**

**):** Haz clic en el icono "Crear cambios para la integración completa" para preparar de inmediato los cambios de sincronización pendientes para todos los registros del sistema de origen. Puedes usar esto para los cambios iniciales cuando estés configurando por primera vez tu flujo de trabajo, si no quieres esperar a la siguiente obtención de la integración de origen. * **Ver historial de ejecuciones (**

**):** Haz clic en el icono de historial para ver sincronizaciones históricas. Puedes ver el estado de cada ejecución histórica, así como los cambios sincronizados y el estado de cada cambio. * **Ver historial de cambios del flujo de trabajo (**

)**:** Haz clic en el icono de historial del flujo de trabajo para ver los cambios históricos en la configuración del flujo de trabajo (activadores, mapeos de atributos, método de ejecución) * **Eliminar (**

**):** Haz clic en el icono de eliminar para borrar el flujo de trabajo. ### **Borradores** El generador guarda automáticamente tu trabajo como borrador en tu navegador a medida que avanzas — no se necesita guardar manualmente. * Una **Borrador disponible** aparece una insignia en la pestaña Flujos de trabajo si tienes un borrador sin guardar * Si navegas fuera de la página, se te preguntará si deseas **conservar el borrador**, **descartarlo**, o **volver** * Puedes borrar un borrador manualmente en cualquier momento usando el **Borrar borrador** botón dentro del generador > ***Nota:** Los borradores se almacenan en tu navegador y no aparecerán en otros dispositivos ni después de borrar los datos de tu navegador.* --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.violetlabs.com/es/funciones/workflows/flujos-de-trabajo-de-sincronizacion-de-datos/como-empezar.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.