Créer des règles de validation à l'aide de fonctions

Créer des règles de validation à l'aide de fonctions

Cette page a été traduite à l'aide d'outils d'IA et peut contenir des erreurs. Pour les informations les plus exactes et à jour, veuillez consulter la version anglaise originale.
En utilisant une fonction, vous pouvez créer une règle de validation où la valeur saisie par l'utilisateur doit être vérifiée en dehors de la base de données CRM. Vous pouvez même valider des champs tels que les numéros de téléphone, les codes postaux, etc. selon un modèle particulier en mentionnant le modèle approprié dans la fonction. Par exemple, vous pouvez écrire une fonction pour valider le champ numéro de compte, de sorte qu'il n'accepte les valeurs que si elles respectent ce modèle : xxx-999-x00. Comme les numéros de compte sont confidentiels et très probablement stockés dans une base de données gouvernementale ou un référentiel bancaire, vous devez permettre à CRM de vérifier le modèle dans ces bases de données tierces et déclencher une alerte chaque fois qu'il y a une discordance.

Scénario
Vous exercez une activité de vente au détail et faites appel à une entreprise de logistique tierce pour gérer les livraisons porte-à-porte et les envois en vrac. Chaque envoi est suivi à l'aide d'un numéro de référence à 10 chiffres stocké dans la base de données de cette entreprise. Chaque fois qu'un représentant commercial saisit un numéro de référence erroné dans CRM, vous souhaitez empêcher l'enregistrement d'être sauvegardé afin d'éviter les problèmes inutiles et les retards de suivi des envois lors des demandes de renseignements des clients. Vous pouvez valider le champ « numéro de référence » à l'aide d'une fonction, de sorte que la valeur sera vérifiée dans la base de données de l'entreprise de logistique pour une correspondance exacte. L'enregistrement ne sera sauvegardé que si le représentant saisit une valeur à 10 chiffres au format approprié (xxx-9999999999) mentionné dans la règle de validation, sinon une erreur s'affichera indiquant des données invalides.



/* L'extrait ci-dessous montre comment obtenir une liste de champs, leurs valeurs à partir d'un objet MAP. Les valeurs des champs peuvent être obtenues à partir du même objet MAP. */
entityMap = crmAPIRequest.toMap().get("record");
/* L'exemple ci-dessous montre comment obtenir la valeur d'un champ (email) à partir d'un objet MAP. Ici, entityMap - Objet Map, Email - Nom API du champ
Exemple entityMap= {'Email': 'xxx@xxx.com', 'Last_Name': 'xxx'}; */
referenceField= entityMap.get("Reference_Number"); // Reference_Number est le nom API du champ « Numéro de référence ».
response = Map();
/* ---------------------------------------------------------------------------------------------- */
Commencez à écrire votre code ici pour effectuer la validation de champ nécessaire */
/* ---------------------------------------------------------------------------------------------- */
/* Si le code identifie une erreur de validation, définissez le statut et le message d'alerte comme montré ci-dessous : */
if(referenceField.matches("[A-Z]{3}-[0-9]{10}")) {
response.put('status','error');
response.put('message', 'Invalid Reference Number');
} else {
/* S'il n'y a pas d'erreurs détectées lors de la validation, définissez le statut comme montré ci-dessous : */
response.put('status','success');
}
/* ---------------------------------------------------------------------------------------------- */
return response.toString();
Notes
Remarque
Notes
  1. Vous pouvez convertir la règle de validation basée sur les critères des enregistrements existants en règle de validation basée sur des fonctions en écrivant une fonction qui facilite la règle de validation.
  2. Le nombre total de règles de validation pouvant être créées dépend de l'édition à laquelle vous êtes abonné. Sur le nombre total de règles/modules, vous pouvez créer 3 règles de validation à l'aide de fonctions dans l'édition Enterprise, et 5 règles à l'aide de fonctions dans l'édition Ultimate. Pour connaître le nombre total de règles pour chaque édition, consultez la page Disponibilité des fonctionnalités.
  3. Seuls les champs pris en charge dans la règle de validation basée sur les critères seront également disponibles dans la règle basée sur les fonctions.
  4. Pour éviter l'échec de la fonction, il est recommandé d'effectuer des vérifications de valeur vide, car parfois les champs sont vides (champs sans valeur).
  5. La valeur retournée par la fonction doit être comme mentionné dans l'exemple de code. Toute valeur autre que la valeur de retour mentionnée sera considérée comme une erreur.
  6. Les valeurs de champ seront disponibles à l'intérieur de la fonction au format API uniquement. Pour accéder aux valeurs, vous pouvez utiliser le nom API du champ.
  7. L'exécution de la validation s'appliquera également à l'application mobile Zoho CRM. Cependant, vous ne pourrez pas créer de règle depuis l'application mobile.
  8. En cas d'échec de l'exécution de la fonction, vous serez invité à vérifier les raisons possibles suivantes :
    1. Erreurs logiques dans votre code.
    2. Expiration du délai d'exécution entraînant l'échec de la fonction.
    3. Si le problème persiste, veuillez contacter support@zohocrm.com pour obtenir une assistance.

Pour créer une règle de validation à l'aide de fonctions
  1. Survolez le module requis dans la barre latérale et cliquez sur l'icône plus (...). Sélectionnez Règles de validation.

    Vous pouvez également accéder à Configuration > Personnalisation > Modules et champs. Sélectionnez le module pour lequel vous souhaitez créer la règle de validation.     Dans la page [Module], cliquez sur l'onglet Règles de validation. Cliquez sur Créer une nouvelle règle de validation.
  2. Dans la page Créer une règle de validation s'affiche. Effectuez les actions suivantes :
    1. Sélectionnez la mise en page à laquelle appartient le champ que vous souhaitez valider.
    2. Sélectionnez la champ à valider.
    3. Sélectionnez le type de validation comme Utiliser une fonction.
    4. Sélectionnez soit Enregistrement uniquement ou Vérification du champ et enregistrement dans le menu déroulant Valider lors de.

    5. Cliquez sur Suivant.
  3. Sur la page Configurer la fonction, effectuez l'une des opérations suivantes :
    1. Cliquez sur Fonctions > Sélectionner une fonction > Configurer > Enregistrer.
    2. Cliquez sur Créer votre propre fonction > Saisir la fonction > Enregistrer.
  4. Cliquez sur Enregistrer pour enregistrer la règle de validation.


Notes
Remarque
Les fonctions créées dans l'onglet Fonctions peuvent être associées à une règle de validation.
  1. Accédez à Configuration > Centre de développement > Fonctions > + Nouvelle fonction.
  2. Dans la fenêtre Créer une nouvelle fonction, sélectionnez Règle de validation dans le menu déroulant Catégorie dans le menu déroulant.