For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Última actualización

¿Te fue útil?