Formation Initiale

Créer des tableaux

• Dans votre modèle de document, cliquez sur l'onglet "Objets" pour accéder à la liste des objets liés
• Cliquez sur "Nouveau" dans la partie "Objet enfants"
• Sélectionnez 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
• Cliquez sur "Créer"
• Répétez l'opération plusieurs fois avec à chaque fois une étiquette nommée correctement (ex : Etiquette n°1 = Produit, Etiquette n°2 = Service, Etiquette n°3 = Option")
• On termine cette partie en cliquant sur "Ouvrir Assistant" afin de faciliter l'insertion des informations dans le document final

Cette étape se base sur des tableaux standards proposés par Word. Pour plus de simplicité, n'hésitez pas à utiliser nos modèles pré-conçus disponibles sur notre site web.

• 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, nommez comme vous souhaitez les colonnes
• 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

Pour faciliter la compréhension, vous pouvez télécharger le modèle présenté durant la démonstration ci-dessous :

• 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 les tableaux

Les filtres permettent de s'assurer de voir uniquement la donnée pertinente par rapport à votre contexte. 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éé, il faut bien le créer et s'assurer qu'il soit alimenté. 

• Dans l'onglet "Objet", cliquez sur l'étiquette (ex : Produit, Service ou Option)
• Dans le panneau "Conditions", cliquez sur "Nouvelle condition"
• Retrouvez le champ à utiliser pour le filtre
• Indiquez l'opérateur et la valeur attendue (ex : Category = "Produit")

• 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 les tableaux

Cette étape est facultative puisque cela permettra simplement d'améliorer un peu l'organisation de la donnée dans votre tableau au moment de la génération. 

• Même chose que pour le filtre, il faut identifier le bon champ qui va nous permettre de trier dynamiquement
• Assurez vous qu'il y a un lien avec l'objet enfant
• Si ce champ n'existe pas, il faudra bien le créer également
• Récupérez le nom API du champ, il sera nécessaire pour le filtre

• Retournez sur l'objet enfant que vous souhaitez filtrer
• Dans la zone "Requête de tri", indiquez le nom API du champ à filtrer
• Mettez un espace + ASC ou DESC suivant si vous souhaitez un tri croissant (ASC pour Ascending) ou décroissant (DESC pour Descending)
• Exemple : "TotalPrice ASC" si je souhaite trier le ligne de produit du plus gros montant total (TotalPrice) en haut au plus petit en bas

• Retournez dans votre contexte (Devis, Opportunité, ...)
• Assurez vous d'avoir de la donnée complétée sur 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 :

• Nommez le champ "Nom du groupe" de la manière souhaitée. Ex. Groupe
• Renseignez dans le champ "Champ sur lequel grouper" le nom API du champ sur l'objet enfant sur lequel faire le groupement (il peut s'agit d'un objet basé sur l'objet enfant ou sur un objet parent de celui-ci)
  Ex. Quantity ou Product2.Familly
• Depuis votre modèle de document Word, créez un tableau d'une ligne et d'une colonne depuis lequel vous allez renseignez la balise Nom du groupement construite de la façon suivante :
  
  {!Nom du groupe | Nom Api du champ sur lequel grouper}
  
  Ex. {!Groupe|Product2.Familly}
• Insérez ensuite le tableau de votre objet enfant dans ce tableau initial. 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.