.svg.png){kind=small}
Gérer des tableaux
Insérez des éléments liés à votre contexte principal sous forme de tableaux
Nous allons parcourir 3 étapes simples pour y parvenir :
- Création de plusieurs tableaux dans un document
- Filtrer ces tableaux pour afficher uniquement la donnée pertinente
- Trier les tableaux par le critère de son choix
Pré-requis
Pré-requis
✓ Avoir un modèle déjà prêt avec l'objet principal configuré
✓ Prendre un cas d'usage où l'objet principal a bien des éléments liés (ex : Opportunité, Devis, Compte...)
Pourquoi faire des tableaux ?
Qu'est-ce qu'un "Objet enfant" Gonexa ?
Un tableau correspond à une liste associée dans Salesforce. Par exemple, si je suis sur un compte, les contacts sont enfants du compte. Si je me trouve sur une opportunité, les produits d'opportunités sont des enfants de l'opportunité.
Ces relations peuvent être standards ou construites via des champs personnalisés. La technologie Gonexa permettra simplement d'afficher les informations liées à votre contexte.
Créer des tableaux
Pour exemple
De nombreux cas d'usage sont possibles comme afficher les produits, les services et les options liées à mon opportunité commerciale ou les listes des contacts liées au comptes.
- Dans votre modèle de document, accédez au composant "Assistant Gonexa"
- Cliquez sur "+ Objet enfant"
- Séléctionnez l'objet Salesforce lié à votre contexte (ex : Produits d'opportunité lié à l'opportunité)
- Renommez bien l'étiquette de la balise si vous souhaitez avoir plusieurs tableaux sur le même objet enfant
Astuce
Renommer l'étiquette de la balise permettra de différenciers vos tableaux et d'ajouter la bonne balise dans le bon tableau à la construction du modèle - Cliquez sur "Créer"
- Répétez l'opération plusieurs fois avec à chaque fois une étiquette nommée correctement
Pour exemple
Vous pouvez créer 3 objets enfants sur le même objets Salesforce comme Produits d'opportunités, avec l'un qui porte l'étiquette "Produit", le second l'étiquette "Service", et le troisième l'étiquette "Option" - On terminera cette partie en cliquant sur "Accéder aux balises" pour insérer les balises dans le document final
Attention
1 Objets enfant = 1 tableau dans le documents. Créez autants d'objets enfants que vous souhaiterez créer de tableau distinct dans le modèle de documents
Astuce
Cette étape se base sur des tableaux standards proposés par Word. Pour plus de simplicité, n'hésitez pas à utiliser nos Templates préconçus
- Insérez un nouveau tableau avec 2 lignes et le nombre de colonnes que vous souhaitez
- La première ligne permettra d'avoir le nom des colonnes fixes, nommez les comme vous souhaitez. C'est l'entête du tableau.
- Sur la 2ème ligne, nous allons utiliser l'Assistant que nous avons ouvert précédemment pour mettre les balises
- Cliquez sur l'objet enfant souhaité et cherchez le champ en fonction de ce que vous souhaitez mettre dans votre tableau
- Finalisez le modèle avec l'ensemble des champs que vous souhaitez voir afficher
Attention
Les balises d'un objet enfants doivent impérativement être placées dans un tableau. Si elles sont en dehors, elles ne s'afficheront pas à la génération.
Pour faciliter la compréhension, vous pouvez télécharger le modèle présenté dans la vidéo de formation.
- Retournez dans Salesforce et chargez le modèle Word avec les tableaux en cliquant sur "Charger version"
- Assurez vous d'avoir un enregistrement de test avec des enfants
- Testez la génération pour voir le résultat final
Filtrer la donnée [Facultatif]
Les filtres permettent de s'assurer de voir uniquement la donnée pertinente par rapport à votre contexte.
Pour exemple
Ici, nous souhaitons filtrer uniquement la catégorie "Produit" dans le 1er tableau, les "Services" dans le 2ème et les "Options" dans le dernier. Nous utilisons 3 fois le même objet Salesforce mais avec des vues différentes.
La connaissance de votre Salesforce est indispensable pour connaître le bon filtre à utiliser et qui sera celui alimenté par la bonne donnée.
- Si le champ qui pourra filtrer la donnée n'est pas encore créé, assurez vous de le créer et de l'alimenter
- Dans le composant Assistant Gonexa, modifiez l'objet enfant en cliquant sur le crayon
- Dans la section "Filtrer", ajoutez un filtre de récupération des enregistrements
- Retrouvez le champ à utiliser pour le filtre
Pour exemple
Famille de produit = "Options"
- Retournez dans votre contexte (Devis, Opportunité, ...)
- Assurez vous d'avoir de la donnée complétée sur le champ filtré
- Générez pour vérifier que le filtre a bien été appliqué
Trier la donnée [Facultatif]
Cette étape est facultative. Elle permet d'organiser la donnée dans votre tableau au moment de la génération et d'appliquer une règle.
- Comme pour le filtre, identifiez le bon champ qui va nous permettre de trier dynamiquement notre tableau
- Retournez sur l'objet enfant que vous souhaitez trier
- Dans la section "Trier", sélectionnez le champ Salesforce sur lequel vous souhaitez faire un tri
- Choisissez l’ordre de tri parmi Ascendant ou Descendant
- Exemple un tri ascendant du champ ProductCode
Pour exemple
Un tri sur le champs ProductCode ascendant permettra de trier les produits
- Retournez dans votre contexte (Devis, Opportunité, ...)
- Assurez vous d'avoir de la donnée complétée dans le champ trié
- Générez pour vérifier que le tri a bien été appliqué
Faire des groupements
Regroupez tous les éléments d’un objet enfant qui correspondent à un critère, c’est-à-dire groupez les lignes d’un tableau d’un document Word selon un champs Salesforce comme la famille d’un produit par exemple.
Depuis l'objet enfant de votre modèle de document :
- Retournez sur l'objet enfant que vous souhaitez grouper
- Choisissez le champs Salesforce sur lequel faire le groupement. Il peut s'agir d'un objet basé sur l'objet enfant ou sur un objet parent de celui-ci.
Pour exemple
Product2.Family - Nommez le champ "Nom du groupe" de la manière souhaitée comme "Groupe" par exemple.
Depuis votre modèle de document, construisez votre tableau avec une des deux méthodes suivantes.
Si vous ne souhaitez pas répéter les entêtes du tableau sur plusieurs tables, cette méthode est recommandée pour être la plus simple.
- Depuis votre modèle de document Word, créez un tableau d’une colonne et de deux lignes, dont la première ligne contient le nom du groupement.
Pour exemple
La première ligne du tableau contiendra la balise suivante {!Nom du groupe | Nom Api du champ sur lequel grouper} c'est à dire dans notre cas {!Groupe|Product2.Family} - Dans la 2ème ligne du tableau, insérez l’intégralité du tableau. (Entête, colonnes, et ligne) contenant les objets enfants
- Ajustez les bordures et colonnes à votre convenance grâce à la mise en forme Word.
Télécharger un modèle d'exemple
Si vous souhaitez gérer la répétition des entêtes du tableau sur plusieurs pages, vous devez impérativement utiliser cette méthode. Le tableau, dans sa globalité, sera répété en fonction du nombre de résultat qui correspond au critère et avec le nom de sa famille en entête.
- Depuis votre modèle de document Word, créez un tableau d’une colonne et de trois lignes, depuis lequel, dans la 1ère ligne, vous allez renseignez la balise de groupement.
Pour exemple
La première ligne du tableau contiendra la balise suivante {!Nom du groupe | Nom Api du champ sur lequel grouper} c'est à dire dans notre cas {!Groupe|Product2.Family} - Dans la 2ème ligne du tableau, fractionnez la cellule en fonction du nombre de colonne souhaité
- Dans la 3ème ligne du tableau, insérez le tableau de votre objet enfant contenant les balises enfants, en ajustant les colonnes ainsi que les bordures. Vous pouvez également modifier les propriétés du tableau en choisissant comme “Habillage de texte” la valeur “Autour”
Configuration Word vs Résultat à la génération
Télécharger un modèle d'exemple
