Conseils d'utilisation de valeurs de liste de sélection et de liste à sélection multiple dans des formules

Salesforce stocke les valeurs de liste de sélection différemment des autres types de champ. Par conséquent, l'utilisation de ces valeurs dans des formules nécessite des fonctions spécialisées. L'utilisation de la plupart des fonctions de formule ou opérateurs de comparaison standard (tels que = ou !=) entraîne des erreurs.

Listes de sélection

Pour référencer des valeurs de liste de sélection dans des formules, utilisez uniquement les trois fonctions ci-dessous.

• ISPICKVAL : Détermine si un champ de liste de sélection contient une valeur spécifique.
  • Exemple de cas d'utilisation : Créez une formule de règle de validation qui affiche une alerte si une liste de sélection Statut de la requête est égale à Escalated.
• CASE : Attribue une valeur spécifique à chaque option de votre liste de sélection.
  • Exemple de cas d'utilisation : Calculez un champ de formule Date d'échéance en attribuant une valeur numérique à chaque option d'une liste de sélection Priorité, où High convertit en 1 jour et Low convertit en 7 jours.
• TEXTE : Convertit la valeur sélectionnée d'une liste de sélection en texte standard, où le texte est le nom d'API de la valeur. Après avoir converti une valeur de liste de sélection en texte, vous pouvez la combiner à d'autres champs. Disponible uniquement dans les ressources de formule de flux, les champs de formule, les règles de validation et les mises à jour de champ de workflow.
  • Exemple de cas d'utilisation : Créez un champ de formule ID d'enregistrement unique en combinant une valeur de liste de sélection de Region à un champ Année.

Pour des conseils sur la syntaxe de ces fonctions, plus des conseils et des exemples, consultez ISPICKVAL, CASE et TEXT.

Listes à sélection multiple

Pour référencer des valeurs de liste à sélection multiple dans des formules, utilisez uniquement les fonctions ci-dessous.

• COMPREND : Vérifie si une liste à sélection multiple contient une valeur spécifique (même si d'autres valeurs sont également choisies).
  • Exemple de cas d'utilisation : Créez un champ de formule qui définit automatiquement un type de retour de case à cocher (appelé Membre VIP) lorsqu'un utilisateur sélectionne l'option Golf dans la liste de sélection Intérêts.
• ISBLANK : Vérifie si l'utilisateur n'a sélectionné aucune option dans la liste de sélection.
  • Exemple de cas d'utilisation : Créez une formule de règle de validation qui empêche un utilisateur d'enregistrer un enregistrement lorsqu'un champ de liste à sélection multiple est vide.
• ISCHANGED : Vérifie si l'utilisateur a modifié la liste des sélections de liste de sélection pendant la session de modification actuelle. Disponible uniquement dans les règles d'attribution, les règles de validation, les mises à jour de champ de workflow et les règles de workflow qui utilisent les critères d'évaluation : Évaluez la règle lorsqu'un enregistrement est : créé, et chaque fois qu’il est modifié.
  • Exemple de cas d'utilisation : Créez une formule de règle de validation qui empêche les utilisateurs de modifier les sélections dans une liste de sélection Fournisseurs approuvés si le compte est actif.
• PRIORVALUE : Vérifie quelles étaient les sélections d'une liste de sélection avant les modifications d'un utilisateur. Disponible uniquement dans les règles d'attribution, les règles de validation, les mises à jour de champ de workflow et les règles de workflow qui utilisent les critères d'évaluation : Évaluez la règle lorsqu'un enregistrement est : créé, et chaque fois qu’il est modifié.
  • Exemple de cas d'utilisation : Créez une formule de règle de validation qui demande à l'utilisateur de fournir un motif s'il désélectionne l'option Critical dans la liste de sélection Balises.

Ces fonctions s'appliquent également aux valeurs de liste à sélection multiple dans les formules, mais avec quelques considérations.

• CONTIENT : Vérifie si une chaîne de texte spécifique est affichée dans les valeurs sélectionnées d'une liste à sélection multiple. Fonctionne uniquement dans le Générateur de processus ou les formules de flux qui utilisent les critères Conditions sont remplies pour exécuter des actions. Il est préférable d'utiliser INCLUDES à la place.
  • Exemple de cas d'utilisation : Créez une formule du Générateur de processus qui déclenche une action si l'une des sélections de l'utilisateur dans la liste de sélection Intérêts contient le Golf de texte.

  Cette fonction correspond aux mots partiels. Dans l'exemple, si l'utilisateur sélectionne Mini-Golf, la formule déclenche l'action, car cette valeur inclut le texte « Golf ». Soyez prudent avec les mots courts, la recherche de Dix correspond à la fois à « Tennis » et à « Tente ».

• ISNULL: Vérifie si un champ est vide. Cette fonction est ancienne et ne gère pas correctement les champs de texte vides ou les listes de sélection. Utilisez ISBLANK pour les nouvelles formules.

Pour des conseils sur la syntaxe de ces fonctions, plus des conseils et des exemples, consultez INCLUS, ISBLANK, ISCHANGED, PRIORVALUE, CONTAINS et ISNULL.

Champs de case à cocher standard (booléens)

Certains objets standard contiennent des champs de case à cocher spéciaux (booléens) qui résument le statut d'un enregistrement. Par exemple : IsEscaladé sur les requêtes, IsWon et IsClosed sur les opportunités, IsClosed sur les tâches et les événements et IsConverted sur les pistes.

Ces champs ne sont pas des listes de sélection. Bien qu'elles soient associées à un statut, ce sont en fait des cases à cocher qui contiennent une valeur TRUE ou FALSE. Le système gère ces cases à cocher. Vous pouvez utiliser ces champs directement dans des formules sans les fonctions spécialisées, telles que ISPICKVAL, requises par les listes de sélection. Par exemple, pour identifier une opportunité fermée, vous pouvez simplement utiliser :

IsClosed = TRUE

Lors de l'élaboration de formules basées sur le statut, vérifiez si un champ de case à cocher standard tel que IsWon répond à vos besoins. C'est souvent plus simple que d'écrire une instruction logique complexe pour un champ de liste de sélection tel que StageName.

Dépannage des erreurs courantes lors du référencement de valeurs de liste de sélection dans des formules

• Erreur : Les champs de liste de sélection ne sont pris en charge que dans certaines fonctions
  • Cause probable : Vous avez essayé de comparer un champ de liste de sélection directement à un texte (par exemple, Status = "Open" ou utilisé une fonction mathématique ou de texte non destinée aux listes de sélection).
  • Solution : Remplacez les comparaisons directes par ISPICKVAL.
    • Incorrect : Status__c = “Open"
    • Correct : ISPICKVAL( Status__c, "Open" )
• Erreur : Nombre incorrect de paramètres pour la fonction ‘ISPICKVAL()’ ou erreurs de syntaxe génériques
  • Cause probable : Vous avez inclus un signe égal à (=) entre parenthèses.
  • Solution : Utilisez une virgule pour séparer le champ de la valeur.
    • Incorrect : ISPICKVAL( Status__c = "Open" )
    • Correct : ISPICKVAL( Status__c, "Open" )
• Erreur : La formule est valide, mais ne fonctionne pas (renvoie FALSE alors qu'elle devrait être TRUE)
  • Cause probable : Vous avez utilisé l'étiquette de la liste de sélection (ce que l'utilisateur affiche) au lieu du nom d'API (ce que le système utilise). Les étiquettes de liste de sélection sont souvent différentes du nom d'API sous-jacent.
  • Solution : Vérifiez les valeurs de liste de sélection dans les paramètres de champ et assurez-vous que votre formule utilise le nom d'API exact (par exemple, En_Progrès au lieu de En cours).

Pour plus d'informations

• Opérateurs de formule et fonctions par contexte pour la bibliothèque de références de fonctions complète, avec une syntaxe et des exemples pour chaque fonction.
• Exemples de champs de formule avancés pour des exemples de formule complexes organisés par cas d'utilisation métier.
• Exemples de règles de validation pour des exemples de règles de validation, dont de nombreuses utilisent des données de champ de liste de sélection.