Actualizar un blueprint en Zoho CRM te permite perfeccionar tus flujos de proceso automatizados sin interrumpir los registros activos — una capacidad que se ha vuelto significativamente más flexible con la introducción de la edición basada en borradores.
Por qué esto es importante
Los blueprints controlan cómo los registros avanzan por las etapas definidas en Zoho CRM, por lo que cualquier cambio en las transiciones, condiciones o acciones puede afectar a negocios o contactos activos en medio de un proceso. Comprender cómo actualizar un blueprint de forma segura — incluyendo el uso de Client Scripts para actualizar campos antes de una transición o bloquearla según una condición — es esencial para los administradores que necesitan iterar sobre procesos sin interrumpir los flujos de trabajo en curso. [2] Como equipo de soporte experto independiente (no el soporte oficial de Zoho), Beam Help ha recopilado el enfoque más fiable basado en la documentación disponible de la plataforma.
---
Paso a paso
Paso 1. Guarda tu blueprint como borrador antes de realizar cambios.
Una de las capacidades más importantes disponibles es la posibilidad de guardar un blueprint como borrador mientras la versión publicada actualmente permanece activa y en uso. Esto significa que puedes revisar el flujo del proceso, probar tus cambios y publicarlos solo cuando estés listo — sin pausar ni interrumpir ningún proceso automatizado que ya esté en ejecución. [3]
Paso 2. Navega al editor de Blueprint en la configuración de Zoho CRM.
Desde tu cuenta de Zoho CRM, ve a Configuración → Gestión de procesos → Blueprint. Localiza el blueprint que deseas modificar y ábrelo en el editor. Desde aquí puedes ajustar los estados, las transiciones y las acciones o condiciones asociadas a cada transición.
Paso 3. Usa Client Scripts para actualizar campos antes de que se ejecute una transición.
Si necesitas actualizar valores de campo de forma programática como parte de una transición de blueprint — o evitar que una transición se complete según una condición específica — los Client Scripts son el enfoque recomendado. La serie Zoho CRM Kaizen aborda específicamente la cuestión de cómo actualizar campos antes de una transición de blueprint y cómo bloquear una transición de forma condicional usando Client Script. [2]
Paso 4. Aprovecha la función onBeforeUpdate() para la lógica basada en condiciones.
Al escribir Client Scripts vinculados a transiciones de blueprint, la función onBeforeUpdate() es especialmente útil. Expone un parámetro value que captura la *nueva* selección del usuario en lugar del valor guardado anteriormente, lo que te permite evaluar los datos entrantes y activar advertencias o bloquear la transición según corresponda. [1] Esto es especialmente útil cuando deseas aplicar reglas de calidad de datos antes de que se confirme un cambio de etapa.
Paso 5. Abre plantillas de correo electrónico desde las transiciones de blueprint usando Client Scripting.
Si tu blueprint actualizado necesita activar una plantilla de correo electrónico prellenada y editable cuando un usuario hace clic en un botón de transición, esto también se puede lograr mediante Client Scripting. Los enfoques verificados por la comunidad usando Client Script permiten que una plantilla se abra con el contenido precargado, dándole al usuario la oportunidad de revisar y editar antes de enviar. [1]
Paso 6. Publica el blueprint actualizado.
Una vez que hayas realizado tus cambios en modo borrador y validado la lógica — incluidas las funciones de Client Script — publica el blueprint actualizado. La nueva versión reemplazará a la que estaba activa anteriormente, y los registros seguirán el flujo de proceso actualizado a partir de ese momento. [3]
Paso 7. Verifica el comportamiento de los tooltips y las transiciones en dispositivos móviles.
Si tu equipo utiliza la aplicación móvil de Zoho CRM, ten en cuenta que las transiciones de blueprint en Android ahora admiten tooltips de campo, incluyendo tanto tooltips estáticos (texto dentro del campo) como tooltips informativos (mostrados como un icono de información). Después de actualizar tu blueprint, confirma que cualquier guía de tooltip que hayas añadido a los campos de transición se muestre correctamente tanto en dispositivos móviles como en escritorio. [8]
---
Errores comunes
- Editar un blueprint activo sin usar el modo borrador puede causar comportamientos inesperados en los registros que se encuentran en medio de una transición. Utiliza siempre la función de borrador para preparar tus cambios antes de publicarlos. [3]
- Extraer valores de retorno de funciones Client Script independientes puede ser complicado. Si la transición de tu blueprint depende de un Client Script que llama a una función independiente, asegúrate de capturar correctamente el valor de retorno — este es un desafío conocido en la comunidad, y hay ejemplos de código funcional disponibles en los foros de desarrolladores de Zoho CRM. [1]
- Usar el parámetro incorrecto en
onBeforeUpdate()— específicamente leer el valor guardado anterior en lugar del parámetrovalueentrante — hará que tu lógica de condición evalúe datos obsoletos, lo que significa que las advertencias o bloqueos pueden no activarse correctamente. [1]
---
Qué verificar
- Estado borrador vs. publicado: Confirma que tu blueprint revisado ha sido completamente publicado y que ya no está en borrador, especialmente si los usuarios informan que las transiciones siguen la lógica anterior.
- Vinculación de Client Script: Verifica que los Client Scripts que has escrito estén correctamente asociados al evento de transición de blueprint correcto (p. ej.,
onBeforeUpdate) y que los valores de retorno se gestionen según lo esperado. [1] [2] - Compatibilidad móvil: Si tu organización utiliza la aplicación de Zoho CRM para Android, comprueba que las páginas de transición de blueprint muestren correctamente los tooltips de campo y las opciones de transición actualizadas después de la actualización del blueprint. [8]