Comment mettre à jour un blueprint dans Zoho CRM

La mise à jour d'un blueprint dans Zoho CRM vous permet d'affiner vos flux de processus automatisés sans perturber les enregistrements actifs — une capacité devenue nettement plus flexible grâce à l'introduction de l'édition basée sur les brouillons.

Pourquoi c'est important

Les blueprints régissent la façon dont les enregistrements progressent à travers les étapes définies dans Zoho CRM. Toute modification apportée aux transitions, aux conditions ou aux actions peut donc affecter des affaires ou des contacts en cours de traitement. Comprendre comment mettre à jour un blueprint en toute sécurité — notamment en utilisant les Client Scripts pour mettre à jour des champs avant une transition ou bloquer une transition selon une condition — est essentiel pour les administrateurs qui doivent faire évoluer leurs processus sans interrompre les workflows en cours. ^[2] En tant qu'équipe d'assistance experte indépendante (et non le support officiel de Zoho), Beam Help a compilé l'approche la plus fiable sur la base de la documentation disponible de la plateforme.

---

Étape par étape

Étape 1. Enregistrez votre blueprint en tant que brouillon avant d'effectuer des modifications.

L'une des fonctionnalités les plus importantes disponibles est la possibilité d'enregistrer un blueprint en tant que brouillon pendant que la version actuellement publiée reste active et en cours d'utilisation. Cela signifie que vous pouvez réviser le flux de processus, tester vos modifications et ne les mettre en ligne que lorsque vous êtes prêt — sans interrompre ni perturber les processus automatisés déjà en cours d'exécution. ^[3]

Étape 2. Accédez à l'éditeur de Blueprint dans les paramètres de Zoho CRM.

Depuis votre compte Zoho CRM, accédez à Configuration → Gestion des processus → Blueprint. Localisez le blueprint que vous souhaitez modifier et ouvrez-le dans l'éditeur. À partir de là, vous pouvez ajuster les états, les transitions ainsi que les actions ou conditions associées à chaque transition.

Étape 3. Utilisez les Client Scripts pour mettre à jour les champs avant le déclenchement d'une transition.

Si vous devez mettre à jour des valeurs de champs par programmation dans le cadre d'une transition de blueprint — ou empêcher une transition de se terminer selon une condition spécifique — les Client Scripts constituent l'approche recommandée. La série Zoho CRM Kaizen aborde spécifiquement la question de la mise à jour des champs avant une transition de blueprint et du blocage conditionnel d'une transition à l'aide d'un Client Script. ^[2]

Étape 4. Exploitez la fonction onBeforeUpdate() pour la logique conditionnelle.

Lors de la rédaction de Client Scripts liés aux transitions de blueprint, la fonction onBeforeUpdate() est particulièrement utile. Elle expose un paramètre value qui capture la *nouvelle* sélection de l'utilisateur plutôt que la valeur précédemment enregistrée, ce qui vous permet d'évaluer les données entrantes et de déclencher des avertissements ou de bloquer la transition en conséquence. ^[1] Cela est particulièrement utile lorsque vous souhaitez appliquer des règles de qualité des données avant qu'un changement d'étape ne soit validé.

Étape 5. Ouvrez des modèles d'e-mail depuis les transitions de blueprint à l'aide du Client Scripting.

Si votre blueprint mis à jour doit déclencher un modèle d'e-mail pré-rempli et modifiable lorsqu'un utilisateur clique sur un bouton de transition, cela peut également être réalisé via le Client Scripting. Des approches validées par la communauté utilisant le Client Script permettent d'ouvrir un modèle avec le contenu pré-rempli, offrant à l'utilisateur la possibilité de le vérifier et de le modifier avant l'envoi. ^[1]

Étape 6. Publiez le blueprint mis à jour.

Une fois vos modifications effectuées en mode brouillon et la logique validée — y compris les fonctions Client Script — publiez le blueprint mis à jour. La nouvelle version remplacera la version précédemment active, et les enregistrements suivront le flux de processus mis à jour à partir de ce moment. ^[3]

Étape 7. Vérifiez le comportement des info-bulles et des transitions sur mobile.

Si votre équipe utilise l'application mobile Zoho CRM, notez que les transitions de blueprint sur Android prennent désormais en charge les info-bulles de champ, y compris les info-bulles statiques (texte à l'intérieur du champ) et les info-bulles d'information (affichées sous forme d'icône d'information). Après la mise à jour de votre blueprint, vérifiez que les indications d'info-bulles que vous avez ajoutées aux champs de transition s'affichent correctement sur mobile comme sur ordinateur. ^[8]

---

Erreurs courantes

• Modifier un blueprint actif sans utiliser le mode brouillon peut entraîner un comportement inattendu pour les enregistrements actuellement en cours de transition. Utilisez toujours la fonctionnalité de brouillon pour préparer vos modifications avant de les publier. ^[3]
• Extraire les valeurs de retour de fonctions Client Script autonomes peut s'avérer délicat. Si votre transition de blueprint repose sur un Client Script qui appelle une fonction autonome, assurez-vous de capturer correctement la valeur de retour — il s'agit d'un problème connu dans la communauté, et des exemples de code fonctionnels sont disponibles dans les forums développeurs de Zoho CRM. ^[1]
• Utiliser le mauvais paramètre dans onBeforeUpdate() — en lisant spécifiquement l'ancienne valeur enregistrée au lieu du paramètre value entrant — entraînera l'évaluation de données obsolètes par votre logique conditionnelle, ce qui signifie que les avertissements ou les blocages pourraient ne pas se déclencher correctement. ^[1]

---

Ce qu'il faut vérifier

• État brouillon ou publié : Confirmez que votre blueprint révisé a été entièrement publié et n'est plus en brouillon, surtout si les utilisateurs signalent que les transitions suivent encore l'ancienne logique.
• Association des Client Scripts : Vérifiez que les Client Scripts que vous avez rédigés sont correctement associés au bon événement de transition de blueprint (par exemple, onBeforeUpdate) et que les valeurs de retour sont gérées comme prévu. ^{[1] [2]}
• Compatibilité mobile : Si votre organisation utilise l'application Zoho CRM sur Android, vérifiez que les pages de transition de blueprint affichent correctement les info-bulles de champ et les options de transition mises à jour après la mise à jour du blueprint. ^[8]