Crear propiedades de sincronización que copien datos en registros asociados

Para que un cambio en un campo del Negocio actualice un campo del Contacto, se usa un Script: código JavaScript que Prolibu ejecuta cuando se crea o se actualiza un registro de los objetos que eliges. Se escribe en Desarrollo → Scripts. Hace falta programar.

Cómo llegar

1. Abre el menú lateral con la flecha de la esquina superior izquierda, si lo tienes plegado.
2. Baja hasta el grupo Desarrollo y pulsa Scripts.

La tabla muestra de cada script su nombre, si está Activo, sus Hooks de ciclo de vida, sus Variables, su Tarea programada y su repositorio Git.

Crear el script que sincroniza

1. En Desarrollo → Scripts, pulsa el botón + de la esquina inferior derecha. Se abre el panel Crear Script.
2. En Script, escribe el nombre. En Readme, explica para qué sirve.
3. Deja Activo apagado. Viene así y conviene que siga apagado hasta que lo hayas probado.
4. Abre Hooks de ciclo de vida y elige los objetos que participan. Puedes buscar y marcar varios, por ejemplo Deal y Contact.

Si el script solo debe reaccionar a contactos, deja únicamente Contact en la lista:

5. En Code, escribe la lógica que lee el campo de origen y escribe el de destino. Es obligatorio.

El código puede comprobar qué evento lo disparó (eventName) y qué registro llegó (eventData.doc) para actuar solo cuando corresponde. Aquí el código empieza con if (eventName === 'Contact.beforeUpdate' && eventData && eventData.doc …, así que solo entra cuando se va a actualizar un contacto:

6. Pulsa Crear.
7. Prueba con registros de ejemplo DOC-* y revisa cada ejecución en Sistema → Registros, donde el tipo de registro Script indica si terminó bien o falló.
8. Cuando el resultado sea el esperado, edita el script y enciende Activo.

Para comprobar el resultado, abre la ficha del registro de prueba y mira el campo que debía cambiar. Aquí Cargo quedó con el valor que escribió el script:

Un hook se dispara para todos los registros del objeto

Enganchar un script a Contact significa que corre en cada alta o edición de contacto del workspace, no solo en las tuyas. Mientras lo pruebas, limita su efecto con una condición sobre tus datos de ejemplo y déjalo apagado hasta que estés seguro.

Qué más ofrece un script

Además de los hooks de ciclo de vida, el panel tiene:

• Run on quote calculate: si lo enciendes, el script corre una vez por cada cálculo de una cotización (Quote.calculate), con la cotización completa.
• Git → Repository url: un repositorio para versionar el código fuera de Prolibu.
• Variables: valores propios del script, separados del código.
• Tarea programada: para ejecutar el script con horario, además de por evento o en su lugar. Pide Periodicidad (una expresión cron), Zona horaria y Timeout, el tiempo máximo de ejecución en milisegundos.

Qué cubre este artículo

Explica dónde se crea el script y qué hace cada campo. El código de la sincronización depende de los campos que quieras copiar, así que no hay una plantilla única: pruébalo siempre con registros de ejemplo antes de activarlo.