> For the complete documentation index, see [llms.txt](https://university.gonexa.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://university.gonexa.fr/doc/getting-started/conditional-display/create-simple-condition.md). # Créer une condition d'affichage simple La condition SI permet d'afficher un texte A ou B selon un critère Salesforce. C'est une logique binaire : si la condition est vraie, Word affiche le résultat A, sinon il affiche l **Cas #1** ## Identification de la logique La condition SI permet d'afficher un texte A ou B selon un critère Salesforce. C'est une logique binaire : si la condition est vraie, Word affiche le résultat A, sinon il affiche le résultat B. La syntaxe fonctionne de la manière suivante : ``` { IF "{!Objet|Champ}" = "Valeur attendue" "résultat si vrai" "résultat si faux" MERGEFORMAT } ``` Elle se compose de 4 éléments : La **balise décisionelle** est le critère Salesforce depuis lequel la décision se base. C'est le champ Salesforce évalué qui porte la valeur à tester. L'**opérateur** définit comment comparer la balise à la valeur attendue. Il peut être égal `=`, différent de `<>`, supérieur à `>`, supérieur ou égal à `>=`, inférieur ou égal à `<=`. La **valeur attendue** est ce à quoi on compare le champ. Sauf dans le cas d'une devise, elle n'est pas entre "". Le **texte si vrai** et **texte si faux** représentent ce qui sera affiché exactement dans le document selon le résultat. Il peut contenir du texte, des balises, des images, des tableaux, des pyctogrammes, des pages, des paragraphes ou être vide "" pour ne rien afficher. `MERGEFORMAT` est optionnel et uniformise la forme du texte affiché. ## Configuration de base Définissez d'abord la logique que vous souhaitez appliquer et la balise décisionelle sur laquelle se baser. * Selon la logique souhaitée et sa complexité, référez-vous à la bonne section parmi les possibilités suivantes : | Logique | Description | Exemple | | ------------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Une condition simple (Valeur A ou B)** | Déclencher une condition sur un seul critère | *Ex. Afficher le mot pomme si la case "Afficher le mot pomme" est cochée* | | **Une condition avancée (ET, OU, ET + OU)** | Déclencher une condition sur plusieurs critères | *Ex. Afficher une clause particulière si le client est de type Grand compte et que le montant de l'opportunité est supérieur à 100 000€* | | **Une condition imbriquée** | Déclencher une condition dans le résultat d'une condition | *Ex. Afficher le logo A si la marque est A ou si la marque est B afficher le logo B sinon afficher le logo C* | * Retrouvez le modèle de document sur lequel vous souhaitez faire la condition et accédez à sa configuration * Assurez vous que l'objet principal & les objets enfants (facultatifs) soient bien configurés * Ouvrez l'assistant à partir du modèle de document ## Créer la condition via l'assistant * À l'aide de l'assistant, trouvez le champ Salesforce qui sera à la base de votre condition * Cliquez sur les 3 petits points au bout de la ligne * Cliquez sur "IF Ajouter une condition" * Complétez la logique en indiquant dans le champ "Texte si la case est cochée" ou "texte si vrai" ; et dans le champ "Texte si la case n'est pas cochée" ou "texte si faux" l'élément qui sera affiché si la case est cochée. Vous pourrez étoffer ensuite le résultat si vrai, résultat si faux, directement dans Word. * Cliquez sur "Copier" pour copier la condition dans votre presse-papier ![Création d'une condition IF avec l'Assistant](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2FgrcTeEfWr7Bcj79XL1nL%2F23-01-creation-if-assistant.gif?alt=media) ## Insertion de la condition dans Word {% tabs %} {% tab title="MacOS" %} * Cliquez sur l'onglet "Insertion" dans le ruban word * Cliquez sur "Champ" * Depuis la pop-up, collez la condition dans la zone éditable à la place du signe = déjà présent * Finaliser en cliquant sur "Ok" ![Insertion de la condition dans Word (macOS)](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2Fg9wQ8v2Y5lbbaVbNSLlb%2F24-05-mise-word-mac.gif?alt=media) {% endtab %} {% tab title="Windows" %} * Cliquez sur l'onglet "Insertion" dans le ruban word * Cliquez sur "Quick parts", puis sur "Champs..." * Depuis la pop-up, collez la condition dans la zone "Formule :" à la place du signe = déjà présent * Finaliser en cliquant sur "Ok" ![Insertion de la condition dans Word (Windows)](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2FoHVLs8oiveSmruTu6O73%2F25-02-mise-dans-word.gif?alt=media) {% endtab %} {% endtabs %} {% hint style="danger" %} **Attention** L'insertion d'une condition se fait impérativement via la manipulation décrite ci-dessous. Copier-coller la condition telle quelle dans le document ne permettra pas de la déclencher. Dans le cas d'une condition avec comme opérateur = c'est le résultat de la conditon si Faux qui s'affiche par défaut dans le document. Si votre résultat si faux est un vide, votre condition n'affiche rien lorsqu'elle est fermée. Passez à l'étape suivante pour ouvrir la condition et aller plus loin. {% endhint %} ## Modifier une condition pré-faite Vous pouvez "ouvrir vos conditions" pour comprendre leur structure ou pour enrichir les résultats si vrai / si faux avec du contenu personnalisé * Depuis votre condition ou en sélectionnant l'intégralité de votre modèle, faîtes clic droit > "Basculer les codes de champs" * Trouvez la condition sous sa forme brute : ``` { IF "{!Quote|Afficher_pomme__c}" = "true" "Pomme" "" MERGEFORMAT } ``` * La condition contient deux zones entre guillemets à la fin : le résultat si vrai et le résultat si faux. Ce sont les seules parties que vous devez modifier. Tout le reste est la structure de la condition. Ne pas y toucher. * Entre ces guillemets, vous pouvez écrire du texte simple, plusieurs paragraphes, insérer des images, des tableaux ou d'autres balises Gonexa ou un vide. Le contenu peut s'étendre sur plusieurs pages et sa mise en forme peut être personnalisée sur Word * Lorsque votre condition a été enrichie, refermez-là en faisant clic-droit "Mettre à jour les champs" pour la refermer. Vous verrez le résultat si faux ou si vrai apparaître. ![Modifier une condition pré-faite](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2FdJw637as6YDm0Q89s7B4%2F26-03-modifier-condition-prefaite.gif?alt=media) {% hint style="danger" %} **Attention** La condition SI est sensible. La moindre modification en dehors des zones de résultat peut la rendre invalide. Avant de modifier, activez les marques de mise en forme (¶) dans Word pour bien visualiser les limites de chaque zone et éviter les erreurs. {% endhint %} ``` { IF "{!Account|Checkbox_pomme}" = "true" "Résultat si vrai modifiable" "résultat si faux modifiable" } ``` ## Tester votre condition * Chargez votre modèle avec la condition comme habituellement en chargeant une nouvelle version * Trouvez un enregistrement qui correspond à votre critère. Dans notre exemple, il faudra s'assurer que la case "Afficher le mot Pomme" sur notre compte est bien cochée * Générez un document pour valider que la condition fonctionne bien * Testez systématiquement toutes les alternatives de votre condition pour vous assurer qu'elle a été bien construite ## Bonnes pratiques {% hint style="warning" %} **Astuce** Pour obtenir les résultats les plus propres et fiables, gardez ces meilleures pratiques à l'esprit : **Prévisualisez avant de finaliser ou de complexifier**\ Effectuez toujours une fusion de test pour confirmer que les instructions IF s'affichent correctement ou pour complexifier la condition existante en y allant étapes par étapes. **Attention aux espaces supplémentaires**\ Word est sensible à l'espacement. Même de petites erreurs peuvent casser les conditions. Assurez-vous qu'elles n'aient pas de coquilles. **Gardez les conditions simples**\ Des IF imbriqués trop complexes peut devenir difficile à maintenir, à faire évoluer ou à transmettre à un autre administrateur. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://university.gonexa.fr/doc/getting-started/conditional-display/create-simple-condition.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.