Utilisation de champs de formule

Objectifs de formation

Une fois cette unité terminée, vous pourrez :

• Créer un champ de formule personnalisé et utiliser l'éditeur de formules
  
• Expliquer en quoi les champs de formule sont utiles
  
• Présenter au moins un cas d'utilisation de champs de formule
  
• Créer des formules simples
  

Remarque

Vous souhaitez apprendre en français ? Commencez le défi dans un Trailhead Playground en français et utilisez les traductions fournies entre crochets pour naviguer. Copiez et collez uniquement les valeurs en anglais, car les validations de défi reposent sur les données en anglais. Si vous ne réussissez pas le défi dans votre organisation en français, nous vous recommandons (1) de définir le paramètre régional sur les États-Unis, (2) de définir la langue sur l’anglais en suivant les instructions ici, puis (3) de cliquer à nouveau sur le bouton « Vérifier le défi ».

Consultez le badge Trailhead dans votre langue pour découvrir comment profiter de l’expérience Trailhead traduite.

Accessibilité

Cette unité nécessite des instructions supplémentaires pour les utilisateurs de lecteurs d’écran. Pour accéder à une version détaillée du lecteur d’écran de cet appareil, cliquez sur le lien ci-dessous :

Ouvrir les instructions du lecteur d’écran Trailhead.

Présentation des champs de formule

Votre organisation contient de nombreuses données. Vos utilisateurs doivent pouvoir accéder à ces données et les comprendre en un coup d’œil, sans calcul mental excessif. Saisissez des champs de formule, un outil puissant qui permet de contrôler l'affichage de vos données.

Vous souhaitez diviser deux champs numériques d'un enregistrement pour créer un pourcentage, convertir un champ en lien hypertexte pour faciliter l'accès à des informations importantes à partir de la présentation de page d'un enregistrement, ou calculer le nombre de jours qui séparent deux dates ? Toutes ces opérations et davantage sont possibles à l'aide de champs de formule.

Prenons un exemple. Imaginons que vous souhaitez calculer le nombre de jours restant avant la date de clôture d’une opportunité. Vous pouvez créer un simple champ de formule qui calcule automatiquement cette valeur. En ajoutant la valeur à la présentation de page Opportunité, les utilisateurs peuvent accéder rapidement à cette information importante. Vous pouvez aussi ajouter ce champ aux rapport et aux vues de liste pour un accès instantané.

Lorsque vous apprenez à utiliser des formules, il est préférable de commencer par de simples calculs avant de passer à des scénarios plus complexes. Toutefois, même des formules simples peuvent fournir des informations précieuses.

Dans cette unité, nous allons vous présenter les concepts de base de l’éditeur de formules ainsi que la syntaxe de formules à l’aide de plusieurs exemples simples. Nous évoquerons également le dépannage des problèmes dans les champs de formule. Nous pouvons commencer !

Utilisation pratique des formules

À présent, créez un Trailhead Playground pour suivre les étapes de ce module et tenter de les répéter. Faites défiler cette page vers le bas, cliquez sur le nom du Playground, puis sélectionnez Créer un Playground. Il faut généralement 2 à 3 minutes à Salesforce pour créer votre Trailhead Playground. Vous utilisez également le Playground au moment de relever les défis pratiques.

Oui, il faut vraiment un Trailhead Playground complètement nouveau ! Si vous utilisez une organisation ou un Playground existant, vous pourriez rencontrer des difficultés pour effectuer les défis.

Recherche de l’éditeur de formule

Avant de commencer à écrire des formules, vous devez rechercher l'éditeur et connaître ses fonctionnalités.

Vous pouvez créer des champs de formules personnalisés dans n'importe quel objet standard ou personnalisé. Pour commencer, nous allons créer une formule dans l'objet Opportunité. Pour accéder à l’éditeur de formules, procédez comme suit :

1. Dans Setup (Configuration), ouvrez Object Manager (Gestionnaire d’objet), puis cliquez sur Opportunity (Opportunité).
   
2. Dans le menu latéral gauche, cliquez sur Fields & Relationships (Champs et relations).
   
3. Cliquez sur New (Nouveau).
   
4. Sélectionnez Formula (Formule), puis cliquez sur Next (Suivant).
   
5. Dans Field Label (Étiquette du champ), saisissez My Formula Field (Mon champ de formule). Notez que Field Name (Nom du champ) est automatiquement renseigné.
   
6. Sélectionnez le type de données que votre formule doit renvoyer. Par exemple, si vous souhaitez créer une formule qu'il calcule la commission d'un commercial sur une vente, sélectionnez Devise. Pour le moment, sélectionnez Text (Texte).
   
7. Cliquez sur Next (Suivant). Vous êtes dans l'éditeur de formules ! Il est temps de le présenter.
   

Utilisation de l’éditeur de formules

L’image ci-dessous met en évidence les parties les plus importantes de l’éditeur de formules :

1. L'éditeur de formules se présente sous deux versions : simple et avancé. Il est tentant d'utiliser l'éditeur Simple, mais nous recommandons de toujours utiliser l'éditeur Avancé. Avancé ne signifie pas plus complexe. Cela signifie qu'il contient davantage d'outils de création de formules puissantes.
   
2. Le bouton Insert Field (Insérer un champ) ouvre un menu qui permet de sélectionner les champs à utiliser dans votre formule. L'insertion via ce menu génère automatiquement la syntaxe correcte pour accéder aux champs.
    
   
3. Le bouton Insert Operator (Insérer un opérateur) ouvre une liste déroulante qui contient les opérateurs mathématiques et logiques disponibles.
   
   
4. Le menu Functions (Fonctions) est l'endroit où vous affichez et insérez des fonctions de formule. Les fonctions sont des opérations plus complexes qui sont pré-implémentées par Salesforce. Certaines fonctions peuvent être utilisées en l’état (par exemple, la fonction TODAY() renvoie la date actuelle), tandis que d’autres nécessitent des informations supplémentaires, appelées paramètres. Par exemple, la fonction LEN(text) analyse la longueur du texte que vous saisissez en tant que paramètre. La formule LEN("Hello") renvoie la valeur 5.
   
   
5. La zone de texte est l'endroit où vous saisissez votre formule. Lors de l'écriture de formules, notez les points suivants :
   

• Les espaces ne sont pas significatifs. Vous pouvez insérer autant d'espaces et de sauts de ligne que vous le souhaitez sans affecter l'exécution de la formule.
  
• Certains aspects des formules tiennent compte de la casse. Saisissez les noms de champ et d'objet en respectant la casse.
  
• Lors de l'utilisation de valeurs numériques, l'ordre standard des opérations s'applique.
  

6. Une fois la formule écrite, vous pouvez cliquer sur le bouton Check Syntax (Vérifier la syntaxe) pour vous assurer que les exigences sont respectées avant d'enregistrer la formule. Si votre formule contient des erreurs, le vérificateur de syntaxe vous informe des problèmes spécifiques.
   

Si vous ne souhaitez pas continuer la création de ce champ de formule, cliquez sur Cancel (Annuler). Vous connaissez maintenant l'éditeur de formules, nous pouvons l'utiliser avec quelques exemples.

Exemple 1 : affichage d’un champ de compte dans la page de détail d’un contact

Les pages de détail d'enregistrement contiennent une multitude d'informations, mais elles ne sont pas toujours suffisantes. Des informations supplémentaires sont parfois nécessaires ! Pour votre première formule, commençons par un simple champ. Prenons un champ dans un Compte pour l'afficher dans un contact à l'aide d'une formule inter-objets. Examinons-la de plus près.

Commencez par créer un Contact. Si vous n’avez jamais créé de contact, depuis l’outil App Launcher (Lanceur d’application) (), recherchez et ouvrez Contacts. Cliquez sur Nouveau. Saisissez une valeur quelconque pour Last Name (Nom de famille). Pour Account Name (Nom du compte), saisissez un compte existant, comme United Oil & Gas Corp. Cliquez sur Save (Enregistrer). Nous allons ensuite créer une formule pour afficher le numéro du compte sur la page Contact :

1. Dans Setup (Configuration), ouvrez Object Manager (Gestionnaire d’objet), puis cliquez sur Contact.
   
2. Dans le menu latéral gauche, cliquez sur Fields & Relationships (Champs et relations).
   
3. Cliquez sur New (Nouveau).
   
4. Sélectionnez le type de champ Formula (Formule), puis cliquez sur Next (Suivant).
   
5. Nommez votre champ Account Number (Numéro de compte), puis sélectionnez Text (Texte) comme type de renvoi de formule. Cliquez sur Next (Suivant).
   
6. Dans l’éditeur de formule avancée, cliquez sur Insert Field (Insérer un champ). Sélectionnez Contact | Account (Compte) | Account Number (Numéro de compte), puis cliquez sur Insert (Insérer). Cliquez sur Check Syntax (Vérifier la syntaxe). Si aucune erreur de syntaxe n’est trouvée, cliquez sur Next (Suivant). Il est peu probable que vous trouviez une erreur de syntaxe dans une formule aussi simple, mais il vaut mieux prendre l’habitude de vérifier la syntaxe de chaque formule.
   
   
7. Cliquez sur Next (Suivant) pour accepter les paramètres de sécurité au niveau du champ, puis cliquez sur Save (Enregistrer).
   

Félicitations, vous avez écrit votre première formule ! Examinons maintenant ce que vous avez fait. Ouvrez la page de détail de l’objet Contact que vous venez de créer et recherchez votre nouveau champ de formule Account Number (Numéro de compte). Très bien !

Exemple 2 : affichage du nombre de jours restant avant la clôture d’une opportunité dans un rapport

Vous pouvez également utiliser des champs de formule dans des rapports afin d'augmenter la visibilité des informations importantes. Supposons que vous souhaitez afficher le nombre de jours restant avant la clôture d'une opportunité dans une colonne de rapport. Pour commencer, créez une Opportunité afin de tester la formule.

Si vous n’avez jamais créé d’opportunité, depuis l’outil App Launcher (Lanceur d’application) (), recherchez et ouvrez Opportunities (Opportunités). Cliquez sur Nouveau. Renseignez le champ Opportunity Name (Nom de l’opportunité), sélectionnez une étape, puis définissez une date de clôture dans trois jours au minimum. Cliquez sur Save (Enregistrer).

Suivez ensuite les étapes ci-après pour créer un champ de formule personnalisé appelé Days to Close on the Opportunities (Jours avant la clôture dans l’objet Opportunités) avec un type de renvoi Number (Numéro) :

1. Dans Setup (Configuration), ouvrez Object Manager (Gestionnaire d’objet), puis cliquez sur Opportunity (Opportunité).
   
2. Dans le menu latéral gauche, cliquez sur Fields & Relationships (Champs et relations).
   
3. Cliquez sur New (Nouveau).
   
4. Sélectionnez Formula (Formule), puis cliquez sur Next (Suivant).
   
5. Dans la zone de texte Field Label (Étiquette du champ), saisissez Days to Close (Jours avant la clôture).
   
6. Sélectionnez la case d'option Number (Numéro).
   
7. Cliquez sur Next (Suivant) pour ouvrir l'éditeur de formules.
   
8. Pour calculer le nombre de jours séparant la date de clôture d’une opportunité et la date du jour, soustrayez l’une de l’autre.
   

• Cliquez sur Insert Field (Insérer un champ), sélectionnez Opportunity | Close Date (Opportunité | Date de fermeture), puis cliquez sur Insert (Insérer).
  
• Dans le menu Insert Operator (Insérer un opérateur), sélectionnez - Subtract (- Soustraire).
  

9. Comment indiquer à notre formule que nous avons besoin de la date du jour ? Heureusement, nous disposons d’une fonction appelée TODAY() qui se met à jour pour correspondre à la date actuelle.
   

• Dans le menu Functions (Fonctions) sur le côté droit de l’éditeur, sélectionnez TODAY.
  
• Cliquez sur Insert Selected Function (Insérer la fonction sélectionnée). 
  

10. Cliquez sur Check Syntax (Vérifier la syntaxe). Si aucune erreur de syntaxe n’est trouvée, cliquez sur Next (Suivant).
    
    
11. Cliquez sur Next (Suivant) pour accepter les paramètres de sécurité au niveau du champ, puis cliquez sur Save (Enregistrer).
    

Le moment est venu d’insérer votre nouveau champ de formule dans un rapport. 

1. Depuis l’outil App Launcher (Lanceur d’application) (), recherchez et ouvrez Reports (Rapports) et cliquez sur New Report (Nouveau rapport).
   
2. Dans le champ Search Report Types (Recherchez des types de rapports…), saisissez Opportunities (Opportunités). Sélectionnez Opportunities (Opportunités) et cliquez sur Start Report (Démarrer le rapport). Votre opportunité est affichée dans le panneau Report Preview (Aperçu du rapport).
   
3. Vérifiez que l’option Update Preview Automatically (Mettre automatiquement à jour l’aperçu) est activée.
   
4. Dans le champ Add column... (Ajouter une colonne…) à gauche de la page, saisissez Days to Close (Jours avant la clôture).  Il s'agit du champ de formule que vous venez de créer. Une colonne où figure le champ contenant la valeur calculée est automatiquement ajoutée au rapport.
   

Vous n’aurez pas besoin du rapport pour suivre le reste de l’unité. Vous pouvez le supprimer et passer à l’exemple suivant.

Débogage des formules

Les erreurs de syntaxe sont inévitables lors l'utilisation de formules. Le bouton Check Syntax (Vérifier la syntaxe) de l'éditeur est un outil important pour déboguer vos formules. Le vérificateur de syntaxe indique les erreurs existantes et leur emplacement dans votre formule. Voici quelques erreurs de syntaxe fréquentes :

1. Parenthèses manquantes : cette erreur est signalée lorsque le nombre de parenthèses ouvrantes ne correspond pas au nombre de parenthèses fermantes. Elle peut s'avérer particulièrement difficile à éviter lorsque vous utilisez plusieurs fonctions à la fois. Essayez de rédiger votre fonction sur plusieurs lignes, ce qui facilite le regroupement des éléments entre parenthèses.
   
   Cette erreur est également signalée si vous oubliez une virgule entre deux paramètres de fonction. Elle peut prêter à confusion, car le problème ne correspond pas au vérificateur de syntaxe. Si vous êtes sûr(e) que les parenthèses sont correctes, assurez-vous également que les virgules de votre fonction sont valides.
   
   
2. Type de paramètre incorrect : si vous associez un paramètre numérique à une fonction qui attend un texte (ou une autre combinaison de types de données), cette erreur vous sera renvoyée. Consultez toujours le texte d'aide ou la documentation pour connaître le type de paramètre accepté par une fonction.
   
   
3. Nombre de paramètres incorrect pour une fonction : si vous saisissez un nombre de paramètres excessif ou insuffisant dans une fonction, le vérificateur de syntaxe vous alerte. De la même façon, consultez le texte d'aide ou la documentation pour connaître les paramètres de saisie spécifiques aux fonctions.
   
   
4. Résultat incompatible avec le type de renvoi de la formule : cette erreur est signalée lorsque la formule renvoie un type de données différent de celui que vous avez sélectionné lors de la création du champ de formule. Dans l’exemple ci-dessous, vous pouvez constater que My Account Formula doit renvoyer une valeur numérique (indiquée entre parenthèses en regard du nom de la formule), mais que la fonction TODAY() renvoie une date. L'erreur indique le type de données attendu. Vous pouvez éviter cette erreur en consultant au préalable à la documentation.
   
   
5. Champ inexistant : cette erreur indique que vous avez inclus dans votre formule un champ que votre objet ne prend pas en charge. Dans ce cas, vérifiez l'orthographe et la casse. si vous ne trouvez aucune erreur, essayez d’insérer le champ une nouvelle fois à partir du menu Insérer un champ pour vous assurer qu’il est correctement référencé.
   
    
   Une autre raison peut expliquer cette erreur : un texte littéral ou un lien hypertexte qui n'est pas placé entre guillemets.
   
   
6. Fonction inconnue : dans ce cas, assurez-vous que Salesforce prend en charge les fonctions que vous utilisez. Cette erreur vous sera également renvoyée pour les fonctions mal orthographiées.
   
   

Autres exemples

Examinons quelques exemples supplémentaires. Vous pouvez créer ces formules ou vous contentez de lire.

1. Cette formule crée un lien hypertexte vers un site Web externe à l’aide de la fonction HYPERLINK(). L'ajout de liens hypertextes à des présentations de page permet à vos utilisateurs d'accéder rapidement à des informations importantes à partir de pages de détail.
   
   
2. Si vous souhaitez appliquer une remise au montant d'une opportunité, vous pouvez utiliser la formule ci-dessous. Dans ce cas, nous appliquons une remise de 12 %, puis nous arrondissons le résultat à deux décimales à l’aide de la fonction ROUND().
   
   
3. Cette formule est une formule de case à cocher qui détermine si une opportunité spécifique est « importante ». Elle vérifie si le nombre d’employés dans la société associée au compte de l’opportunité est supérieur à 1 000 ET si le montant de l’opportunité est supérieur à 10 000 $. Si les deux instructions sont « true », le champ est affiché sous la forme d'une case à cocher dans la présentation de page Opportunité. Sinon, il apparaît comme une case vide.
   
   

La documentation sur les formules comprend une multitude d'exemples se rapportant à de nombreux cas d'utilisation. En les examinant, sachez que de nombreux exemples contiennent des concepts avancés qui ne sont pas couverts dans cette unité. Assurez-vous de comprendre les informations présentées avant d'exploiter ces formules.

Ressources

• Aide Salesforce : Calcul de valeurs de champ avec des formules
• PDF : Mémo sur les formules