# Creación de flujos de trabajo de sincronización ### **Conceptos clave** Antes de construir un flujo de trabajo de sincronización, ayuda comprender 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 una programación temporal, 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 = "Liberado") * **Asignaciones** — cómo las propiedades del origen corresponden a las propiedades del destino (p. ej., "Número de pieza" del origen → "Nombre del elemento" del destino) * **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 algo se aplique 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 la última vez que se ejecutó la sincronización. * **Ejecución de cambios** - la ejecución real de los cambios en el sistema de destino: ya sea una aprobación manual, una programación temporal o una ejecución de cambios en vivo "al crear". Todos los cambios de un lote de sincronización se ejecutarán juntos. ### **Creación de un flujo de trabajo de sincronización** #### **Paso 1 — Abre el generador de flujos de trabajo** Ve a la pestaña **Flujos de trabajo** y haz clic en **+ Flujo de trabajo de sincronización**.

Si iniciaste previamente un flujo de trabajo y no lo terminaste, aparecerá un indicador de **borrador disponible** — el generador restaurará automáticamente donde lo dejaste. #### **Paso 2 — Nombra tu flujo de trabajo** Introduce un nombre descriptivo en la parte superior del lienzo. Elige algo que facilite identificarlo más tarde, como *"ION → Sincronización de orden de compra 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 nodo **Origen** del 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 nodo **Destino** y selecciona: * La **integración de destino** (el sistema al que sincronizas) * La **tipo de entidad de destino**

#### **Paso 4 — Establece un activador** Haz clic en el nodo **Activador** nodo y elige cómo el flujo de trabajo generará 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 — Añade filtros *****(opcional)*** Haz clic en el nodo **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, coincidencia con expresión regular, y más) 3. Una **valor** con el que comparar Puedes añadir varios filtros. Los filtros marcados **deben cumplirse** actúan como condiciones AND — todos deben satisfacerse. Los demás actúan como condiciones OR.

#### **Paso 6 — Asigna propiedades** Haz clic en el nodo **Asignaciones** nodo para definir cómo las propiedades del origen se traducen en propiedades del destino. Violet rellenará automáticamente las asignaciones de propiedades más probables entre los sistemas de origen y destino, pero debes confirmar que sean correctas. * 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 "Liberado" → estado de destino "Activo") **Opciones de asignación:**


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

#### **Paso 7 — Configura las 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 esté asociada a 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 los 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 necesitas 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. Opcionalmente añade **Filtros** y **Asignaciones** específicos 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 aparecerá allí. #### **Paso 9 — Elige el método de ejecución de cambios de sincronización** Una vez que hayas guardado tu flujo de trabajo de sincronización, el par de integraciones Destino > Origen aparecerá en la lista de **Todas las integraciones** . Haz clic en el par de integraciones y luego haz clic en el engranaje de **Configuración de ejecución:** para configurar el método de ejecución de cambios de sincronización.

Puedes elegir ejecutar los cambios de sincronización con un **temporizador**, o **al actividad**. Si deseas ejecutar los cambios de sincronización **al actividad**, puedes elegir entre una *aprobación* *manual*, o *ejecución automática* cada vez que finaliza el flujo de trabajo de creación de cambios de sincronización.

*** ### **Administración de flujos de trabajo de sincronización** Desde la lista de Flujos de trabajo, cada tarjeta de flujo muestra su nombre, las integraciones de origen y destino, y el 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 inmediatamente los cambios de sincronización pendientes para todos los registros del sistema de origen. Puedes usar esto para los cambios iniciales cuando configures tu flujo de trabajo por primera vez 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 anteriores. Puedes ver el estado de cada ejecución histórica, así como los cambios sincronizados y el estado de cada cambio. * **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 mientras 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, se te preguntará si deseas **conservar el borrador**, **descartarlo**, o **volver** * Puedes borrar un borrador manualmente en cualquier momento usando el botón **Borrar borrador** 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.*