Deluge est le langage de script de Zoho CRM qui vous permet d'automatiser les mises à jour de champs et les opérations de données complexes par programmation. Vous pouvez utiliser des fonctions Deluge pour modifier des champs personnalisés sur des enregistrements, valider des données avant de les enregistrer et déclencher des mises à jour dans des modules associés.
Pourquoi c'est important
Les mises à jour de champs personnalisés via Deluge sont essentielles lorsque vous devez automatiser des changements de données qui vont au-delà des flux de travail standard, synchroniser des données entre modules ou appliquer une logique métier que l'interface utilisateur seule ne peut pas gérer. Cette approche est particulièrement utile lors de migrations de données, d'opérations en masse ou lors de l'intégration de Zoho CRM avec des systèmes externes.
Étapes
Étape 1. Accédez à l'éditeur Deluge dans Zoho CRM.
Accédez à votre espace de travail Zoho CRM et ouvrez la section d'automatisation où les fonctions personnalisées sont gérées. Deluge est le langage de script interne disponible dans tous les produits Zoho pour effectuer des opérations telles que des appels API, des requêtes de base de données et des manipulations de données [3].
Étape 2. Écrivez une fonction pour cibler le champ personnalisé.
Créez une fonction Deluge qui référence le champ personnalisé par son nom d'API. Vous pouvez trouver le nom d'API en cliquant avec le bouton droit de la souris sur le champ dans votre module CRM et en sélectionnant l'option pour afficher les détails du champ. Utilisez le bon identifiant de champ (metaApiName ou inputApiName) pour vous assurer que le système reconnaît le champ que vous souhaitez mettre à jour [2].
Étape 3. Utilisez la syntaxe Deluge appropriée pour mettre à jour la valeur du champ.
Structurez votre script pour attribuer une nouvelle valeur au champ personnalisé. La syntaxe exacte dépend si vous mettez à jour un seul enregistrement, plusieurs enregistrements ou si vous extrayez des données de modules associés. Par exemple, si vous devez mettre à jour un champ de date d'un module à un autre, vous devrez peut-être d'abord récupérer la valeur source, puis l'appliquer au champ cible [5].
Étape 4. Testez la fonction avec des données d'exemple.
Avant de déployer en production, exécutez votre fonction Deluge sur un enregistrement de test pour vérifier que le champ personnalisé est mis à jour correctement. Vérifiez que la valeur apparaît dans le champ et qu'aucune erreur de validation ne se produit. Si vous rencontrez une erreur "PATTERNNOTMATCHED", vérifiez que vous utilisez le bon nom d'API du champ [2].
Étape 5. Intégrez la fonction dans votre flux de travail ou votre règle d'automatisation.
Une fois testée, déclenchez la fonction Deluge à partir d'une règle de flux de travail, d'une action de bouton ou d'une tâche planifiée. Cela garantit que la mise à jour du champ personnalisé s'exécute automatiquement lorsque les conditions spécifiées sont remplies, plutôt que de nécessiter une exécution manuelle à chaque fois [4].
Pièges courants
Les noms d'API des champs sont sensibles à la casse et doivent correspondre exactement à leur apparence dans votre configuration CRM. Si votre champ personnalisé n'apparaît pas dans la réponse de l'API ou si vous recevez une erreur de correspondance de modèle, vérifiez le nom de l'API en inspectant les propriétés du champ directement dans les paramètres du module [2].
Lors de la mise à jour de champs dans des modules associés, assurez-vous d'avoir le bon ID d'enregistrement et que la relation entre les modules est correctement définie. Tenter de mettre à jour un champ sur un type d'enregistrement qui n'a pas accès à ce champ entraînera l'échec silencieux de l'opération ou une erreur [5].
Ce qu'il faut vérifier
- Confirmez que le nom d'API du champ personnalisé correspond exactement à ce que vous avez entré dans votre script Deluge.
- Vérifiez que l'ID d'enregistrement ciblé existe et appartient au bon module.
- Testez la fonction sur un enregistrement non critique d'abord pour vous assurer que la mise à jour produit le résultat attendu avant de l'exécuter sur des données de production.
---
Remarque : Cet article est fourni par Beam Help, une assistance experte indépendante pour Zoho — et non par le support officiel de Zoho. Pour la documentation officielle, consultez directement le portail d'aide de Zoho.