Gonexa University

Formation Initiale


La solution Gonexa Doc est la solution historique de Gonexa permettant de générer un document à partir d'un modèle au format .docx .xlsx .pptx .pdf

Installer Gonexa

Cette première étape vous guidera dans les étapes d'installation de notre solution de génération

Nous allons parcourir 5 étapes simples pour y parvenir :

  • Installer notre application via l’AppExchange
  • Donner les accès aux utilisateurs et à vous même
  • Sécuriser la solution avec une clé
  • Faire le lien entre Gonexa et Salesforce
  • Mettre à disposition des utilisateurs le bouton de génération

Pré-requis

AVANT DE DEMARRER
  • Avoir les droits d'installation d'un package sur l'environnement ciblé
  • Avoir un compte sur l'AppExchange

Installer le package via l'AppExchange

ETAPE #1
Accès à la page Gonexa sur l'AppExchange
  • Cliquez sur le lien suivant pour accéder à l’application Gonexa Doc sur l’AppExchange, la place de marché de Salesforce qui vous permet de consulter, télécharger et installer notre applications Gonexa Doc.
  • Cliquez sur "Get In Now"
Connexion à votre compte AppExchange
  • Connectez-vous à votre Salesforce en cliquant "Log In"
  • Choisissez Salesforce et entrez ensuite vos informations d’identification
  • Choisissez l’environnement de Production ou la Sandbox (recommandé avant le passage en production)
  • Renseignez votre nom d’utilisateur et votre mot de passe
  • Cliquez sur “Se connecter à Salesforce”
Installation du package
  • Sélectionnez l’option "Install for Admins Only" (les droits seront attribués par la suite via les ensembles d'autorisations)
  • Cliquez sur "Install"
  • Acceptez les conditions et cliquez sur "Confirm and Install"
  • Cliquez sur “Finish to continue”.
  • Une fois l’application installée, vous recevrez une notification de son succès par e-mail vous indiquant le succès de l’installation.
Vérification que le package est bien installé

Vous pouvez le vérifier depuis la Configuration.
Depuis l’onglet accédez aux "Packages installés"

Donner les accès aux utilisateurs et à vous même

ETAPE #2
2 niveaux de droits pour Gonexa Doc
  • Gonexa Doc User : Permet de générer un document
  • Gonexa Doc Admin : Permet de générer un document + Administration des modèles
Ensemble d'autorisation
  • Allez dans la configuration Salesforce
  • Recherchez "Ensemble d'autorisation" ou "Permission Sets"
  • Cliquez sur la lettre "G" pour accéder aux droits proposés par Gonexa
Affectation des ensembles d'autorisation
  • Cliquez sur l'ensemble d'autorisation souhaité
  • Cliquez sur "Gérez les attributions" ou "Manage assignements"
  • Cliquez sur "Ajouter une attribution" ou "Add assignement"
  • Sélectionnez l'utilisateur et cliquez sur suivant pour finaliser

Récupérer la clé de sécurité

ETAPE #3
Accès au gestionnaire de la clé de sécurité
  • Rendez vous dans le lanceur d'application Salesforce pour trouver "Administration Gonexa"
  • Cliquez sur "Gestion clé de sécurité"
  • Autorisez l'accès via le bouton "Autoriser"
Génération de la clé
  • Dans la section "Clés API", Cliquez sur "Générer" pour obtenir votre clé (à noter que cette clé est unique pour votre production. Une autre clé, commune à l'ensemble des sandbox est à renseigner également.)
  • Gardez précieusement cette longue chaîne de caractère qui est votre clé de sécurité

Faire le lien entre Gonexa et Salesforce

ETAPE #4
Accès via l'application Administration Gonexa
  • Rendez vous dans le lanceur d'application Salesforce pour trouver "Administration Gonexa"
  • Cliquez sur "Identifiants nommés" dans la section "Autorisation de la solution Gonexa Doc"
Créer un nouveau identifiant nommé "hérité"

Attention, ici il faut bien cliquer sur la flèche à côté de nouveau pour cliquer sur "Nouveau hérité" et saisir les informations suivantes :

Etiquette :

Gonexa Doc (sensible à la casse)

Nom :

Gonexa_Doc (sensible à la casse)

URL :

Production : https://api.exadoc.gonexa.fr  

tes Copier URL

URL

Sandbox : https://api.exadoc-test.gonexa.fr

tes Copier URL

Type d'identité :

Principal nommé

Protocole d'authentification :

Authentification par mot de passe

Nom d'utilisateur :

Gonexa

Mot de passe :

[Clé de sécurité récupérée à l'étape précédente. Clé unique pour un environnement deproduction. Même clé pour tous vos environnements de Sandbox ou Dev]

Générer un en-tête d'autorisation :

checkbox-unchecked

Autoriser les champs de fusion dans l'en-tête HTTP :

checkbox-checked

Autoriser les champs de fusion dans le corps HTTP :

checkbox-unchecked

Connexion réseau sortante :

checkbox-unchecked

Positionner le bouton de génération

ETAPE #5
Utilisation du composant lightning dans la page (recommandé)
  • Rendez vous sur le contexte où vous souhaitez voir afficher le composant (opportunité, devis, ...)
  • Modifiez la présentation de page lightning en cliquant sur "Modifier la page" en cliquant sur gd
  • Cherchez le composant "Gonexa - Generate Document"
  • Déposez le composant dans votre page
  • Enregistrez & activez la page pour les profils ou applications souhaités.
Utilisation du "bouton" en haut de la page
  • Rendez vous dans le gestionnaire d'objet ou vous souhaitez voir afficher le bouton de génération
  • Cliquez sur la rubrique "Boutons, liens et actions"
  • Cliquez sur "Nouvelle action"

Type d'action :

Composant lightning

Composant lightning :

gnx:generateDocument

Etiquette :

[Texte qui apparait à l'utilisateur]

Nom :

[Automatique]

  • N'oubliez pas de déposer l'action dans la page de présentation souhaitée

Nous allons parcourir 3 étapes simples pour y parvenir :

  • Création de la configuration de base dans Salesforce
  • Design dans Word du document
  • Chargement du modèle dans Salesforce pour le mettre à disposition des utilisateurs

Pré-requis

AVANT DE DEMARRER
  • Avoir fait l'installation complète du package
  • Maitriser les basiques de Mircosoft Word ou Google Docs

Configuration de base dans Salesforce

ETAPE #1
Création de base du nouveau modèle
  • Cliquez sur l'onglet "Modèle de document" ou "Document template"
  • Cliquez sur "Nouveau"
  • Choisissez le type de modèle : Principal pour un modèle classique, Associé pour les annexes ou Traduction pour traduire un modèle principal qui a été déjà fait
  • Donnez un nom au modèle : Il apparaitra à l'utilisateur dans le cas où plusieurs modèles sont présents sur le même objet Salesforce
  • Choisissez la politique de gestion des versions pour permettre d'optimiser le stockage Salesforce
  • Cochez les bons formats de sortie souhaités en restant cohérent avec le format du futur modèle
  • Les autres éléments de configuration sont facultatifs, vous pouvez enregistrer
Sélection de l'Objet principal

L'objet principal est le point départ de la génération, il s'agit du contexte de base pour la création d'un document. 

  • Cliquez sur "Choisir l'objet principal"
  • Cherchez l'objet Salesforce à partir duquel vous souhaitez lancer la génération
  • L'étiquette de la balise est automatiquement alimenté par le nom API de l'objet mais vous pouvez le modifier pour faciliter la compréhension de votre modèle de document
  • Définissez le préfix, on attends ici un texte qui sera figé pour l'ensemble des générations et qui composera la première partie du nom du fichier
  • Choisissez un champ sur l'objet principal pour le suffix qui composera la 2ème partie du nom de fichier dynamiquement cette fois-ci (Astuce, vous pouvez créé un champ formule sur l'objet principal pour avoir un nom de fichier plus personnalisé)
Création d'Objets enfant

Les objets enfants sont les éléments liés à l'objet principal. Il s'agit des "listes associées" à votre objet principal. Par exemple, on aura les "Produits d'opportunités" liés à une opportunité. 

Important, il n'est pas obligatoire d'avoir un objet enfant pour permettre une génération. Seul l'objet principal est obligatoire. 

  • Rendez vous dans l'onglet "Objets" à côté de "Journaux" pour accéder à la création des objets enfants
  • Cliquez sur "Nouveau"
  • Choisissez l'objet Salesforce concerné
  • L'étiquette s'alimente par défaut mais vous pouvez la modifier pour plus de clarté dans le modèle
  • Finalisez cette partie en cliquant sur "Créer"

Design dans Word

ETAPE #2

Vous pouvez partir d'un modèle de document que vous avez déjà ou télécharger un modèle pré-conçus directement accessible via notre page : Templates pré-conçus

Construction de la partie statique du document
  • Assurez vous de mettre en page votre document complètement sur la partie qui ne changera pas au moment de la génération
  • Prévoyez simplement des tableaux dans votre word pour tout ce qui va concerner les "Objets enfants" (ex : Produits d'opportunité)
Ouvrir l'Assistant
  • Dans le document template, cliquez sur "Assistant" en haut à droite de la page
  • Autorisez l'assistant à communiquer avec votre Salesforce (à faire 1 seule fois)
  • Mettez à la bonne taille la fenêtre qui s'est ouverte avec l'objet principal et les objets enfants
Insertion des balises à partir de l'Assistant

Il faudra bien connaître quelle information vous souhaitez dynamiquement mettre à la génération dans votre modèle.

  • Cliquez sur l'objet dans l'Assistant pour afficher les champs disponibles
  • Utilisez la barre de recherche pour filtrer
  • Cliquez sur le champ souhaité (ce champ est copié dans votre presse papier)
  • Il ne reste plus qu'à coller à l'endroit souhaité dans votre document
  • Vous pouvez également cliquez sur les flèches pour naviguer entre les relations des objets et chercher des informations liées à l'objet principal (remonter des relations)
  • Paramétrez la mise en forme de la balise avec le standard Word (taille, couleur, alignement, gras..)
Enregistrement du word sur votre ordinateur
  • Assurez vous d'enregistrez votre modèle word dans un répertoire propre pour le retrouver facilement
  • Pour les utilisateurs de la suite Google Workspace avec Google Doc, enregistrez votre modèle au format Word (.docx)

Important : On recommande de garder le poids du fichier le plus petit possible pour optimiser la génération

Mise en ligne du modèle

ETAPE #3
Ajout du modèle dans le document template
  • Retournez dans la configuration du modèle de document dans Salesforce
  • Cliquez sur "Ajouter un modèle"
  • Sélectionnez sur votre modèle word à partir de l'explorateur de fichier
  • Cliquez sur "Ouvrir"
  • Attendez quelques secondes pour voir apparaître le message de succès
Les erreurs classiques
  • Assurez vous que votre modèle soit bien dans l'un des formats suivants : ".docx" ".pptx" ".xlsx" ou ".pdf"
  • Consultez l'onglet "Champs de fusion" en cas de pastille rouge pour voir si une balise n'est pas correctement formalisée ou que le champ dans Salesforce n'existe pas
Test du modèle
  • Cette partie est importante pour valider que le modèle fonctionne bien comme attendu
  • Indiquez le nom d'un enregistrement de votre objet principale (ex : Opportunité ABC) pour trouver un enregistrement de test
  • Cliquez sur "Tester le modèle"

Votre modèle est à présent disponible à la génération pour toutes les personnes qui ont bien l'ensemble d'autorisation "Gonexa Doc Users permission sets"

Gestion de l'aperçu du document

Votre document généré apparaît dans l'aperçu standard Salesforce par défaut. Vous pouvez le surchargez avec l'aperçu Gonexa.

  • Depuis la page de votre fichier généré, cliquez sur modifiez la page
  • Depuis les composants personnalisés, glissez-déposez l'action Gonexa - File Preview sur la page

    💡 Astuce, donnez ainsi accès à vos utilisateurs à des commandes utiles comme l'impression, le zoom, ou le téléchargement rapide du document généré.

  • Enregistrez

    ⚠️ Attention, Si lors dela génération du document, l'utilisateur ne peut pas voir le modèle généré référez-vous à la gestion des règles de partage du modèle de document ;s'il est en privé l'accès au modèle peut être bloqué si aucune règle de partage n'a pété créé, nous vous recomandons de passer le paramètre de partage du modèle à public lecture seule.

Nous allons parcourir en 3 étapes simples pour designer un document Word :

  • Structurer le document
  • Ajouter le contenu
  • Organiser l'information

Pré-requis

AVANT DE DEMARRER
  • Détenir une licence Microsoft Word

Structurer le document

ASTUCE #1

Créez un document stable, homogène et propre en commençant par structurer votre document.

Voir les mises en page cachées
  • Activez les espaces, retour à la lignes, saut de pages et changement de section en cliquant sur le symbole "afficher les marques de mises en forme" depuis l'onglet accueil
Conceçoir l'apparence document
  • Depuis l'onglet Insertion, choisissez l'orientation du document ou de la section
  • Depuis l'onglet Conception, choisissez la couleur du fond de page, ses bordures, filigrannes...
Définir les marges
  • Depuis l'onglet Mise en page choisissez le format des marges : par défaut ou personnalisées

💡 Modifiez les espacements à la main avec les règles horizontales et verticales

Ajouter le contenu

ASTUCE #2

Créez un document stable, homogène et propre en commençant par structurer votre document.

Gestion des paramètres de police
  • Paramétrez vos titres, sous titres, et corps de texte en créant vos propres polices par défaut depuis l'onglet Volet style depuis l'accueil.

    💡 Utilisez l'outil "Reproduire la mise en forme" pour homogénéiser les polices
Choix des polices
  • Gonexa gère les polices Word suivantes :

    AharoniAldhabi, Andalus, AngsanaNew,AngsanaUPC, Aparajita, ArabicTypesetting, Arial, ArialBlack, ArialNova, ArialNovaCond,ArialNovaCondLight, ArialNovaLight, Batang, BatangChe, BrowalliaNew, BrowalliaUPC,Calibri, CalibriLight, Cambria, CambriaMath, Candara, ComicSansMS, Consolas, Constantia,Corbel, CordiaNew, CordiaUPC, CourierNew, DaunPenh, David, DengXian, DengXianLight,DFKai-SB, DilleniaUPC, DokChampa, Dotum, DotumChe, Ebrima, EstrangeloEdessa, EucrosiaUPC, Euphemia, FangSong, FranklinGothicMedium, FrankRuehl, FreesiaUPC,Gabriola, Gadugi, Gautami, Georgia, GeorgiaPro, GeorgiaProBlack, GeorgiaProCond,GeorgiaProCondBlack, GeorgiaProCondLight, GeorgiaProCondSemibold, GeorgiaProLight,GeorgiaProSemibold, GillSansNova, GillSansNovaCond, GillSansNovaCondLt, GillSansNovaCondUltraBold,GillSansNovaCondXBd, GillSansNovaLight, GillSansNovaUltraBold, Gisha, Gulim, GulimChe,Gungsuh, GungsuhChe, Impact, IrisUPC, IskoolaPota, JasmineUPC, JavaneseText, KaiTi,Kalinga, Kartika, KhmerUI, KodchiangUPC, Kokila, LaoUI, Latha, Leelawadee, LeelawadeeUI,LeelawadeeUISemilight, LevenimMT, LilyUPC, LucidaConsole, LucidaSansUnicode, MalgunGothic,MalgunGothicSemilight, Mangal, Marlett, Meiryo, MeiryoUI, MicrosoftHimalaya, MicrosoftJhengHei,MicrosoftJhengHeiLight, MicrosoftJhengHeiUI,MicrosoftJhengHeiUILight,MicrosoftNewTaiLue,MicrosoftPhagsPa, MicrosoftSansSerif, MicrosoftTaiLe, MicrosoftUighur, MicrosoftYaHei,MicrosoftYaHeiLight, MicrosoftYaHeiUI, MicrosoftYaHeiUILight, MicrosoftYiBaiti,MingLiU, MingLiU-ExtB, MingLiU_HKSCS, MingLiU_HKSCS-ExtB, Miriam, MiriamFixed, MongolianBaiti,MoolBoran, MSGothic, MSMincho, MSPGothic, MSPMincho, MSUIGothic, MVBoli, MyanmarText,Narkisim, NeueHaasGroteskTextPro, NirmalaUI, NirmalaUISemilight, NSimSun, Nyala,PalatinoLinotype, PlantagenetCherokee, PMingLiU, PMingLiU-ExtB, Raavi, RockwellNova,RockwellNovaCond, RockwellNovaCondLight, RockwellNovaExtraBold, RockwellNovaLight,Rod, SakkalMajalla, SanskritText, SegoeMDL2Assets, SegoePrint, SegoeScript, SegoeUI,SegoeUIBlack, SegoeUIEmoji, SegoeUIHistoric, SegoeUILight, SegoeUISemibold, SegoeUISemilight,SegoeUISymbol, ShonarBangla, Shruti, SimHei, SimplifiedArabic, SimplifiedArabicFixed,SimSun, SimSun-ExtB, SitkaBanner, SitkaDisplay, SitkaHeading, SitkaSmall, SitkaSubheading,SitkaText, Sylfaen, Symbol, Tahoma, TimesNewRoman, TraditionalArabic, TrebuchetMS,Tunga, UrduTypesetting, Utsaah, Vani, Verdana, VerdanaPro, VerdanaProBlack, VerdanaProCond,VerdanaProCondBlack, VerdanaProCondLight, VerdanaProCondSemiBold, VerdanaProLight,VerdanaProSemiBold, Vijaya, Vrinda, Webdings, Wingdings, YuGothic, YuGothicLight,YuGothicMedium, YuGothicUI, YuGothicUILight, YuGothicUISemibold, YuGothicUISemilight,YuMincho, YuMinchoDemibold, YuMinchoLight
Piloter les entêtes et pieds de page
  • Créez des entêtes et pieds de page en double cliquant en haut et en bas du document.

    💡 Cochez la case "première page différente" depuis le menu del'entête ou du pied de page si vous souhaitez différencier les éléments de la première page
  • Ajoutez des numérotations de pages depuis l'onglet Insertion en cliquant sur Numéro de page. Accédez à Formats des numéros de page pour paramétrer le format souhaité (1,2,3...) et le début de la numérotation.
Ajouter un sommaire
  • Depuis l'onglet Référence, cliquez sur Table des matières, choisissez le type de table à insérer ou créez-en une personnalisée. Mettez à jour la table des matières ainsi insérée, en faisant clic droit, mettre à jour, dans le cas où de nouveaux titres ont été ajoutés.

    💡 Si vous trouvez des entrées manquantes, veuillez à définir le texte à afficher en tant que titre
Insérer et optimiser les images
  • Ajoutez des images dans votre document en cliquant sur insertion : image ou avec un glisser déposer.

    💡 Optimisez la taille de vos images en les compressant pour exploiter au mieux votre document. Depuis Fichier, cliquez sur "réduire la taille du fichier" et choisissez Ecran

Organiser l'information

ASTUCE #3
Affichage multi-colonnes
  • Sélectionnez le texte concerné, depuis l'onglet cliquez sur insertion pour choisir le nombre de colonnes à afficher.
Répéter l'entête d'un tableau sur la page suivante
  • Sélectionnez la ou les entêtes de votre tableau a répéter, via le clic droit accédez aux propriétés du tableau. Dans l'onglet Ligne, cochez la case "répéter enhaut de chaque page en tant que ligne d'entête".
Créer des paragraphes solidaires
  • Pour éviter que les lignes d'un tableau ou d'un paragraphes ne se coupent entre deux pages, sélectionnez le bloc à scinder, et via le clic droit accédez à paragraphes. Dans l'onglet enchainement, cochez la case paragraphes solidaires et lignes solidaires. Enregistrez.

Pour aller plus loin

Filtrer la visibilité d'un modèle

ASTUCE #1

Rendez disponible la génération du document en fonction d'un critère basé sur votre objet principal.

Créer une condition
  • Accédez à l'onglet Option de votre modèle de document
  • Cliquez sur Nouvelle condition
  • Paramétrez vos conditions et cliquez sur Ajouter

💡Ajoutez autant de condition que besoin et choisissez si vos conditions doivent être strictement vérifiées avec AND ou si vous souhaitez que l'une soit vérifiées seulement en écrivant OR.

Utiliser les extensions de balises

ASTUCE #2
Indiquez la date du jour de la génération

Placez la balise générique Gonexa de date de génération avec le format de date souhaité.

  • Depuis l'assistant, accédez à l'objet principal et scrollez la liste jusqu'à la fin.
  • Trouvez les balises Date de génération du document et copiez-collez celle que vous souhaitez dans votre document.

    Format court : JJ/MM/AAAA
    Format long : le JJ MMMM AAAA

Gérer la mise en forme des textes enrichis

ASTUCE #3

La mise en page Salesforce est appliquée par défaut au contenu d'un champ rich text placé dans un document Word à la génération. Ajoutez une ou plusieurs extensions de balise pour modifier ces paramètres.

Mise en place

Pour appliquer le format appliqué sur la balise dans le modèle word à la place du format utilisé dans le champ Salesforce, il faudra utiliser une extension de balise pour permettre de choisir exactement le bon format. 

Il existe 5 types de formats que l'on peut modifier : "f" pour "font" = police, "s" pour "size" = taille, "c" pour color = couleur, "t" pour "type form" = forme de caractère, "i" pour "indentation" = indentation

Pour vous aider, l'assistant permettra de vous guider :

  • Au niveau de la balise, cliquez sur les 3 petits points à droite
  • Cliquez sur "formater le richtext"
  • Sélectionnez la mise en forme à prendre du Word


Votre balise est copiée et pourra être coller dans votre modèle avec le format suivant :
Ex : {!Account|Description(HTML,f,s)} pour un cas ou je souhaite appliquer la police et la taille qui est définie dans le modèle. 

Insérer une image dynamique

Configuration de l'image

Depuis l'assistant, accédez au champ Rich Text contenant votre image

  • Cliquez sur les "..." pour accéder à la Configuration de l'image
  • Choisissez le format par défaut ou paramétrez la hauteur et largeur attendue

    💡 Astuce, paramétrez la hauteur ou largeur seulement afin que  le ratio de l'image source s'applique automatiquement et ainsi éviter les déformation d'images.

  • Insérez votre balise à l'endroit souhaité
Autoriser l'accès à la base URL 

Dans le cas d'une insertion d’image de type URL, il est probable de devoir autoriser l’accès à la base URL de votre plateforme‍

  • Depuis la Configuration Salesforce, accédez à Paramètre de site distant (remote site detail)
  • Cliquez sur Nouveau site distant
  • Nommez et renseignez l'URL contenant vos images
  • Cochez la case Actif et validez

Vous pouvez facilement insérer une balise faisant référence à un champs de type texte enrichie (Rich text) ou URL dont le contenu est une image, dans votre document.

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

AVANT DE DEMARRER
  • Avoir un modèle déjà prêt avec l'objet principal configuré
  • Prendre un cas d'usage ou l'objet principal a bien des éléments liés (ex : Opportunité, Devis, Compte, ...)
POURQUOI FAIRE DES TABLEAUX ?

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 construite via des objets personnalisés. La technologie Gonexa permettra simplement d'afficher les informations liées à votre contexte.

De nombreux cas d'usage sont possibles comme afficher les produits, les services et les options liées à mon opportunité commerciale dans 3 tableaux séparés dans mon document alors qu'ils sont tous dans le même objet Salesforce (ProductLineItems).

Créer des tableaux

ETAPE #1
Ajout des objets enfants dans Salesforce
  • 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
Insertion des tableaux dans Word

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 :

Chargement du modèle et test
  • 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

ETAPE #2

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.

Identification du filtre à utiliser
  • 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é. 
Ajout de la condition sur l'objet enfant
  • 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")
Vérification du filtre
  • 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

ETAPE #3

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. 

Identifier le critère de tri
  • 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
Ajout du filtre sur l'objet enfant
  • 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
Vérification du tri
  • 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é

Pour aller plus loin

⚠️ L'utilisation des extensions nécessite d'être sur une version du package ultérieur à la version 1.7. Veuillez mettre à jour le package vial'AppExchange, le cas échéant.

Utiliser les extensions de balises dans un tableau

Faire des sommes avec la balise "SUM"

Additionnez les montant d’un même objet enfant, d’un groupement voire même d’une information cachée et cumulez les multi devises. Evitez ainsi les champs de type formule dans Salesforce et affichez facilement des sous totaux.

  • Après avoir paramétré un objet enfant dans Salesforce, ouvert l'assistant et placé votre balise dans votre modèle de document, ajoutez l'extension (SUM) dans votre balise pour additionner les devises ou quantités : Ex. {!Produit|Amount(SUM)}
  • Placez la nouvelle balise à l’endroit de votre page souhaité en suivant l'une des deux options.

    Configuration Word vs résultat à la génération

Limites
  • Il est possible d’afficher une balise SUM toute seule si elle se trouve en dehors d'un tableau Word (option 2)
  • Une balise SUM est impérativement une balise sur un objet enfant
  • La gestion des mutli devises est prise en compte.
Compter le nombre d'enregistrements dans le tableau

Faîtes le cumul des enregistrements de l'objet enfant pour afficher le nombre de ligne d'un tableau ou qui répondent à un critère renseigné dans Salesforce.

  • Après avoir paramétré un objet enfant dans Salesforce, ouvrez l'assistant.
  • Accédez aux balises de l'objet enfant souhaité.
  • Scrollez la liste des balises disponibles jusqu'en bas eta ccédez à la balise "Nombre d'enregistrements"
  • Cliquez dessus pour la copier et collez-là à l’endroit de votre page souhaité.
Limites
  • Il est possible d’afficher une balise COUNT dans un tableau ou en dehors d'un tableau.
  • Une balise COUNT est impérativement une balise sur un objet enfant.

    Additionnez les montant d’un même objet enfant, d’un groupement voire même d’une information cachée et cumulez les multi devises. Evitez ainsi les champs de type formule dans Salesforce et affichez facilement des sous totaux.

Faire des groupements

Grouper des éléments selon un critère Salesforce

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.

Configuration Word vs résultat à la génération

Conditions d'affichage dans Word

Mettez du dynamisme dans vos modèles en créant des conditions d'affichage de paragraphes, d'images ou n'importe quel élément dans votre document. 

Nous allons décomposer la formation en 2 étapes simples :

  • Création d'une condition simple pour comprendre le principe
  • Voir des cas d'usage réels que nous rencontrons régulièrement

Pré-requis

AVANT DE DEMARRER
  • Avoir un modèle déjà prêt avec l'objet principal et un objet enfant configuré
  • Utiliser un modèle word, attention cette fonctionnalité n'est pas disponible dans Google Doc
  • Avoir les champs "adresse d'expédition" et "adresse de facturation" présents dans le modèle
POURQUOI FAIRE DES CONDITIONS ?

Une condition permet d'afficher ou non un texte, une image, un tableau et tout autre éléments en fonction d'un critère qui se trouve dans Salesforce. C'est très pratique pour ajouter un paragraphe légal dans les CGVs en fonction d'une case à cocher par exemple dans Salesforce ou pour masquer une partie qui montre les remises possibles alors qu'aucune remise n'a été appliquée dans un devis. 

L'idée est de personnaliser un modèle sans pour autant démultiplier le nombre de modèle différents. 

Condition d'affichage simple

ETAPE #1
Identification de la logique

La logique dans notre exemple sera simple, nous souhaitons afficher le mot "Pomme" quand la case à cocher sur le compte "Afficher le mot Pomme" est cochée. 

  • Définissez le champ qui sera utilisé ensuite pour la condition (Les champs "liste de sélection multiple", "date", et "zone de texte" ne sont pas utilisables dans une condition)
  • Réfléchissez à la logique que vous souhaitez
  • Retrouvez le modèle de document sur lequel vous souhaitez faire la condition
  • Assurez vous que l'objet principal & les objets enfants (facultatifs) sont bien configurés
  • Ouvrez l'assistant à partir du modèle de document
Créer la condition via l'assistant
  • A 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 "Ajouter une condition"
  • Je complète la logique en indiquant dans la case "True" le mot "Pomme" (True = Case cochée)
  • Je laisse vide la case "False" pour ne rien mettre si la case est décochée
  • Cliquez sur "Copier"
Insertion de la condition dans Word
  • Cliquez sur l'onglet "Insertion" dans le ruban word
  • Cliquez sur "Champs..." ou "Insérer un champs" (Sur MacOS)
    Accédez au pictogramme intitlulé "Quick parts", puis sur "Field..." (Sur Windows)
  • Coller à présent la condition dans la zone éditable à la place du signe égal déjà présent
  • Finaliser en cliquant sur "Ok"

Notez  que c'est la condition si faux qui sera affichée par défaut dans le modèle mais que la condition s'exécutera en fonction de notre critère au moment de la génération. 

Tester votre condition
  • Charger votre modèle avec la condition comme habituellement en chargeant une nouvelle version
  • Trouvez un enregistrement qui correspond à votre critère (Nous cochons la case "Afficher le mot Pomme" sur notre compte pour l'exemple)
  • Générer 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

Conditions d'affichage réelles

ETAPE #2
Affichage du mot "Gratuit" à la place de 0€ dans un tableau

Nous partons du principe que nous avons un modèle avec un tableau ou il y a un champ devise pour pouvoir faire la condition. Dans notre exemple, nous utilisons l'opportunité et les produits d'opportunité.

  • Assurez vous d'avoir bien un objet principal ainsi qu'un objet enfant configuré
  • Ouvrez l'assistant à partir du modèle de document
  • Cherchez le champ sur votre objet enfant
  • Cliquez sur les 3 petits points et ajouter une condition
  • Indiquez "0" dans la valeur attendue
  • Texte si vrai = Gratuit
  • Texte si faux = [Re-mettre la balise que l'on souhaite afficher]
  • Dans le tableau dans Word, positionnez vous à l'endroit où vous souhaitez insérer la condition
  • Accéder toujours au même menu pour insérer un champ "Insertion/Insérer un champ" ou depuis "Quickparts" "Field.."
  • Collez la condition dans la zone éditable
  • Cliquez sur "Ok"
  • Finaliser en chargeant le modèle comme habituellement
  • Testez
Affichage d'une case cochée ou décochée dans Word

Nous partons d'un exemple où nous souhaitons afficher une case à cocher de la même manière que dans Salesforce.

  • Le principe de départ reste le même que pour la cas précédent
  • Nous insérons une condition
  • Texte si vrai = ✅
  • Texte si faux = ❌

A noter si nous utilisons ici des émojis mais nous pourrions tout à fait insérer des images, il faut simplement faire ce changement après avoir insérer la condition, basculer les codes de champs avec un clic droit sur la condition.

  • Si vous avez modifiez la condition directement en basculant les codes de champs, assurez vous de bien faire "Mettre à jour les champs" en effectuant un clic droit sur la condition
Affichage de plusieurs champs dynamiquement
  • Même principe que précédemment pour insérer la condition
  • Une fois la condition insérée, faites un clic droit pour "basculer les codes de champ"
  • Déplacer l'intégralité des parties que vous souhaitez avoir en dynamique dans la zone "Texte si vrai" ou "Texte si faux" en fonction de votre logique
  • Finaliser en chargeant le modèle comme habituellement
  • Testez

Condition d'affichage avancées

Créez des conditions imbriquées, multiples (ou, et, et +ou), et affichez des images, tableaux, pyctogrames, checkbox ou afficher une mise en page spécifique avec la constructions de conditions SI avancées.

Téléchargez le modèle pour vous inspirer.



  • Téléchargez le modèle de conditions et ouvrez le avec Word.
  • Sélectionnez tout le document (control + A) et faîtes clic droit : basculer les codes des champs pour afficher les conditions
  • Copiez-collez la condition a utiliser dans votre modèle Word.
  • Ouvrez la condition et modifiez les valeurs selon vos besoins :balise, opérateur, texte si vrai, texte si faux
  • Fermez votre condition en la sélectionnant, via clic droit : mettre à jour les codes de champs
⬇ Télécharger le modèle de conditions SI

Vous rencontrez un problème concernant les conditions SI ? 

Consultez notre page d'aide : La condition Word SI insérée dans le document ne se déclenche pas

Import/Export modèles

Facilitez vos déploiements entre 2 environnements via notre outils d'import/export. 

Nous allons parcourir 3 étapes simples pour y parvenir :

  • L'export des modèles à partir de l'environnement source
  • L'import dans le nouvel environnement
  • La mise en production finale des modèles

Pré-requis

AVANT DE DEMARRER
  • Avoir 2 environnements avec Gonexa installé (2 sandboxes ou 1 sandbox + 1 production)
  • Mise à jour du package au minimum sur la version "Bordeaux '23" (Février 2023)
  • Avoir au moins 1 modèle présent sur un environnement
POURQUOI L'IMPORT / EXPORT ?

La configuration Gonexa ne peut pas se déployer à l'aide d'un change set ou d'un outil de déploiement classique puisqu'il ne s'agit pas de déployer de la méta-data.

Un modèle de document est configuré à l'aide de donnée (Saisie dans les champs "Nom du modèle", format de sortie, politique de gestion des versions, etc...) mais aussi du fichier qui porte les balises. 

Si vous deviez déployer ça sans outil particulier, il faudrait faire des exports de donnée + export de fichier et re-faire les liens dans le nouvel environnement. C'est pour cette raison que nous avons développé un outil qui permet d'exporter d'un côté et d'importer dans le nouvel environnement en quelques clics. 

L'export

ETAPE #1
Connection à Salesforce
  • Connectez vous à votre environnement source
  • Vérifiez que vos modèles sont bien présents
Connection à l'App Gonexa
  • Rendez-vous sur l'Administration Gonexa via le lançeur d'application
  • Dans la section des liens, cliquez sur "L'App"
  • Une fenêtre peut s'ouvrir si c'est la 1ère fois pour demander à l'App de communiquer, cliquez sur autoriser
Sélection & export des modèles
  • Cliquez sur "Gérer mes modèles" dans la partie "Import/Export"
  • La liste des modèles apparait, sélectionnez le ou les modèles que vous souhaitez exporter (à noter que seul les modèles avec un fichier sont exportables)
  • Cliquez sur "Exporter" en bas de la liste pour créer le Zip d'export
  • Un fichier Zip se télécharge directement
  • Gardez précieusement ce fichier pour la suite

L'import

ETAPE #2

Il est possible d'importer les modèles sur une production ou une sandbox. A savoir également que si vous répéter l'opération, il y aura une mise à jour des modèles et non pas une création de doublon du moment qu'il s'agit des mêmes modèles. 

Déconnexion environnement source de l'App Gonexa
  • Assurez vous tout d'abord de bien vous déconnecter de l'App Gonexa
  • Cliquez sur l'avatar en haut à droite sur app.gonexa.fr
  • Cliquez sur déconnexion
Connexion à Salesforce
  • Connectez vous à votre environnement Salesforce cible
Connexion à l'App Gonexa
  • Rendez-vous sur l'Administration Gonexa via le lançeur d'application
  • Dans la section des liens, cliquez sur "L'App"
  • Une fenêtre peut s'ouvrir si c'est la 1ère fois pour demander à l'App de communiquer, cliquez sur autoriser
Sélection & export des modèles
  • Cliquez sur "Gérer mes modèles" dans la partie "Import/Export"
  • Cliquez sur "Importer des fichiers"
  • Sélectionnez le Zip que vous aviez exporté
  • Un message de succès vous indique que les modèles sont bien importés
  • Vous pouvez vérifier dans Salesforce que les modèles ont bien été importés

Mise en production finale

ETAPE #3

Cette étape permet d'envoyer l'intégralité des nouveaux modèles importés à nos serveurs Azure pour que les générations fonctionnent. 

Ajout du bouton "Charger versions"

Cette étape n'est pas nécessaire si vous avez installé directement la version "Bordeaux" (Février 2023). Cette partie est nécessaire uniquement en cas d'update d'une version antérieure. 

  • Rendez-vous dans le gestionnaire d'objet dans la configuration
  • Retrouvez l'objet "Document template" ou "Modèle de document"
  • Cliquez sur "Présentation du bouton Vue de liste"
  • Modifiez la vue de liste en cliquant sur le chevron en bout de ligne
  • Ajoutez le bouton personnalisé "Charger versions" dans les boutons personnalisés
Charger les versions via une vue de liste
  • Rendez-vous sur l'onglet "Document template" ou "Modèle de document"
  • Sélectionnez les modèles
  • Cliquez sur le bouton en haut à droite "Charger versions"
  • Les modèles sont à présent complétement fonctionnels

Autoriser l'accès au support

Votre support Gonexa peut avoir besoin de se connecter à votre application à l'aide de votre identifiant pour résoudre et réparer les problèmes découlant de votre demande. Pour ce faire, vous devez au préalable nous autoriser l'accès.

Ouvrir un accès au support Gonexa
  • Depuis l'environnement en question, cliquez sur l'icône de votre utilisateur en haut à droite de n'importe quelle page de votre organisation.
  • Accédez aux paramètres
  • Ouvrez l'onglet Autoriser l'accès à la connexion au compte
  • Accordez l'accès au support Gonexa en sélectionnant la durée de l'accès souhaitée et cliquez sur enregistrer.
Fournir l'Id de l'organisation au support
  • Depuis la Configuration, accédez à Information sur la société
  • Récupérez l'ID de l'organisation
  • Transmettez cette information au support pour qu'il puisse se connecter

Créer un modèle de document PDF

Créez un modèle de document au format d'entrée PDF ayant pour but de faire remplir des informations spécifiques à son destinataire.

Nous allons parcourir 2 étapes simples pour y parvenir :

  • La création d'un fond fixe
  • La création du formulaire

Créer un fond fixe

Créez le fond d'un formulaire avec la méthode de votre choix (Canva, Google Docs, Word, Figma, ou directement avec PDF).

  • Laisser des espaces dédies aux balises
  • Donnez des titres et indications
  • Convertissez-le au format PDF.

Créer le formulaire depuis Adobe Acrobat

ETAPE #1

Ouvrez votre modèle PDF (fond fixe) avec Adobe Acrobat pour y ajouter des balises. Accédez aux outils disponibles depuis le bandeau, sélectionnez "Préparer le formulaire" et cliquez sur "Démarrer."

Ajouter une zone de texte (Champ texte)
  • Depuis la barre de navigation Adobe, sélectionnez l'option "Ajouter un champs de texte" sur le document, à l'endroit souhaité.
  • Double cliquez sur l'éléments pour le paramétrer.
  • Dans le champs "Nom" de l'onglet Général, renseignez la balise Gonexa avec le champs Salesforce à afficher. Copiez-collez là depuis le bandeau assistant.
  • Choisissez si l'élement est obligatoire ou en lecture seule en cochant la case "Lecture seule"
  • Pilotez la mise en forme de vos balises dans l'onglet "Aspect" : taille, couleur de la bordure, couleur du fond, police..
  • Validez en cliquant sur Fermer
Créer une liste d'option (Picklist Salesforce)
  • Depuis la barre de navigation Adobe, sélectionnez l'option "Insérer une liste déroulante" ou "Ajouter une liste de choix" sur le document, à l'endroit souhaité.
  • Double cliquez sur l'éléments pour le paramétrer.
  • Dans le champs "Nom" de l'onglet Général, renseignez la balise Gonexa avec le champs Salesforce à afficher. Copiez-collez là depuis le bandeau assistant.
  • Depuis l'onglet Options, renseignez valeurs de la liste de sélection. Il s'agit des valeurs de picklist exactes Salesforce. Ajoutez les éléments et ordonnancez-les. Sélectionnez la valeur par défaut et cliquez sur Fermer.

    Attention, si une valeur de Picklist Salesforce n'existe pas, c'est à dire est vide, renseignez impérativement Null dans l'élement de valeur dans votre liste d'option.

Placer une case à cocher (Checkbox Salesforce)
  • Depuis la barre de navigation Adobe, sélectionnez l'option "Ajouter des cases à cocher pour permettre la sélection d'une ou plusieurs options" et déposez là sur la page à l'endroit souhaité.
  • Double cliquez sur l'éléments pour le paramétrer.
  • Dans le champs "Nom" de l'onglet Général, renseignez la balise Gonexa avec le champs Salesforce de type case à cocher (Checkbox) à afficher. Copiez-collez là depuis le bandeau assistant.
  • La case sera cochée s'elle est cochée dans Salesforce et récupère une valeur true / false.
  • Cliquez sur Fermer pour valider.

    Attention, Une balise de type case à cocher (Checkbox) ne peut être appelée qu’une fois dans le document.

Créer des boutons radios (liste de sélection unique)
  • Depuis la barre de navigation Adobe, sélectionnez l'outil "Ajouter des cases à cocher pour permettre la sélection d'options qui s'excluent mutuellement" et déposez là sur la page à l'endroit souhaité.
  • Nommez-les avec la balise Gonexa créé depuis l'assistant.
  • Depuis le bandeau, modifiez les valeurs : choix 1, choix, choix 3... avec le nom de la valeur de PickList Salesforce.
  • Un message de succès vous indiquer que les modèles sont bien importés
  • Vous pouvez vérifier dans Salesforce que les modèles ont bien été importés

Enregistrez, chargez votre document dans Salesforce et testez-le.

Créer le formulaire depuis Adobe Acrobat

ETAPE #1

Ouvrez votre modèle PDF (fond fixe) avec Adobe Acrobat pour y ajouter des balises. Accédez aux outils disponibles depuis le bandeau, sélectionnez "Préparer le formulaire" et cliquez sur "Démarrer."

Ajouter une zone de texte (Champ texte)
  • Depuis la barre de navigation Adobe, sélectionnez l'option "Ajouter un champs de texte" sur le document, à l'endroit souhaité.
  • Double cliquez sur l'éléments pour le paramétrer.
  • Dans le champs "Nom" de l'onglet Général, renseignez la balise Gonexa avec le champs Salesforce à afficher. Copiez-collez là depuis le bandeau assistant.
  • Choisissez si l'élement est obligatoire ou en lecture seule en cochant la case "Lecture seule"
  • Pilotez la mise en forme de vos balises dans l'onglet "Aspect" : taille, couleur de la bordure, couleur du fond, police..
  • Validez en cliquant sur Fermer
Créer une liste d'option (Picklist Salesforce)
  • Depuis la barre de navigation Adobe, sélectionnez l'option "Insérer une liste déroulante" ou "Ajouter une liste de choix" sur le document, à l'endroit souhaité.
  • Double cliquez sur l'éléments pour le paramétrer.
  • Dans le champs "Nom" de l'onglet Général, renseignez la balise Gonexa avec le champs Salesforce à afficher. Copiez-collez là depuis le bandeau assistant.
  • Depuis l'onglet Options, renseignez valeurs de la liste de sélection. Il s'agit des valeurs de picklist exactes Salesforce. Ajoutez les éléments et ordonnancez-les. Sélectionnez la valeur par défaut et cliquez sur Fermer.

    Attention, si une valeur de Picklist Salesforce n'existe pas, c'est à dire est vide, renseignez impérativement Null dans l'élement de valeur dans votre liste d'option.

Placer une case à cocher (Checkbox Salesforce)
  • Depuis la barre de navigation Adobe, sélectionnez l'option "Ajouter des cases à cocher pour permettre la sélection d'une ou plusieurs options" et déposez là sur la page à l'endroit souhaité.
  • Double cliquez sur l'éléments pour le paramétrer.
  • Dans le champs "Nom" de l'onglet Général, renseignez la balise Gonexa avec le champs Salesforce de type case à cocher (Checkbox) à afficher. Copiez-collez là depuis le bandeau assistant.
  • La case sera cochée s'elle est cochée dans Salesforce et récupère une valeur true / false.
  • Cliquez sur Fermer pour valider.

    Attention, Une balise de type case à cocher (Checkbox) ne peut être appelée qu’une fois dans le document.

Créer un modèle de document Excel.

Créez un modèle de document au format d'entrée Excel.

Nous allons décomposer cette formation en 4 étapes  :

  • La création d’un tableau sur Excel
  • Faire des calculs (Moyenne, maximum, somme…)
  • Créer une formule
  • Insérer un tableau croisé dynamique

Prérequis de la formation

  • Savoir faire un modèle Word
  • Avoir créé un modèle de document avec objet enfant

Créer un tableau sur Excel

ETAPE #1

Depuis le modèle de document ajoutez des balises sur les objets principaux à votre convenance a l’aide du bandeau assistant.

Pour ajouter des balises sur un objet enfant, veuillez au préalable avoir configuré un objet enfant dans le modèle de document.

💡 Astuce : veuillez définir le contenu imprimable de votre page Excel pour que tous les éléments puissent apparaitre sur une page PDF à la génération. Accédez à la version finale en activant le mode page de votre Excel.

Ajouter un tableau
  • Insérez une entête dans votre document avec les titres des colonnes
  • Dans une seconde ligne, insérez les balises sur l’objet enfant via l’assistant
  • Sélectionnez le tableau, puis depuis l’onglet Insertion, cliquez sur Tableau
  • Cochez la case « Mon tableau comporte des entêtes » si vous les aviez déjà paramétré et cliquez sur OK
  • Une fois le tableau créé, accédez à l’onglet Tableau.
  • Dans la case Nom du tableau, nommez-le avec le label de l’étiquette de l’objet enfant paramétrer dans Salesforce. (Ex. QuoteLineItem)

Enregistrez, chargez votre document dans Salesforce et testez-le.

Faire des calculs (Moyenne, maximum, somme… )

ETAPE #2

Faites des calculs comme la moyenne, le maximum et la somme lié à votre tableau.

Activez la Ligne des totaux
  • Sélectionnez le tableau déjà créé
  • Depuis l’onglet Tableau, cochez la case « Ligne des totaux »
  • Une ligne supplémentaire va apparaitre
  • Sélectionnez la nouvelle case, et sur la flèche pour choisir le type de calcul à réaliser parmi la moyenne, le maximum, le minimum, la somme…

Enregistrez, chargez votre document dans Salesforce et testez-le.

Créer une formule

ETAPE #3

Evitez de faire un champ formule dans Salesforce et ajoutez la logique directement dans votre document Excel.

Activez la ligne des totaux
  • Insérez une colonne à votre tableau et donnez lui un nom
  • Depuis la ligne de la nouvelle colonne insérez votre formule Excel en commençant par "="
  • Sélectionnez la  ou les cases impliquées dans le calcul et construisez votre formule de la forme suivante : = C17 * 0,20

💡 Astuce : Ajoutez les formats attendu : standard, monétaire, fraction, heure, date… pour faire apparaître le bon format à la génération.

Enregistrez, chargez votre document dans Salesforce et testez-le.

Insérez un tableau croisé dynamique

ETAPE #4

Afficher un graphique et des informations croisées dynamiquement dans votre document sur une feuille distincte.

Créer un tableau dynamique
  • Sélectionnez votre tableau
  • Depuis l’onglet insertion, cliquez sur Tableau croisé dynamique
  • Depuis la pop up « Créer un tableau croisé dynamique » cochez « Nouvelle feuille de calcul » pour afficher le rapport sur une feuille de calcul à part et cliquez sur OK.
  • Depuis la nouvelle feuille sur laquelle va apparaitre votre tableau croisé dynamique cochez les cases des champs de tableau à faire apparaitre sur votre tableau
  • Déplacez les champs dans les zones cibles parmi filtres, colonnes, lignes et valeur en les glissant-déposant.
  • Cliquez sur le i a côté de l’élément pour choisir le mode d’affichage : somme, moyenne, maximum…

Enregistrez, chargez votre document dans Salesforce et testez-le.

💡 Attention : Vous ne pourrez pas ajouter de balises Gonexa doc sur la même page que votre tableau croisé dynamique.

Afficher un graphique et des informations croisées dynamiquement dans votre document sur une feuille distincte.

Ajouter un graphique
  • A partir de votre tableau croisé dynamique selectionné, sélectionnez lre graphique que vous souhaitez voir apparaitre.
  • Placez le sur la page à l'endroit souhaité.

Enregistrez, chargez votre document dans Salesforce et testez-le.

Les Flux Gonexa

Gagnez du temps et supprimez les actions répétitives avec les actions de flux Salesforce.

Nous allons décomposer cette formation en 4 étapes  :

  • Grands principes de flux, action déclenchée sur la mise à jour d'un record
  • Générer un document unitairement
  • Générer des documents à partir d'une vue de liste

Prérequis de la formation

  • S'assurer que la génération au clic fonctionne
  • Connaitre le processus à mettre en place

☝️ Org de flux préconçus

Accédez à notre org de flux d'exemple pour vous inspirez. Retrouvez les cas d'usage les plus utilisés par nos clients.

  • adresse : login.salesforce.com
  • identifiant : tester@gonexa.fr
  • mot de passe : Gonexa01

Grands principe de flux

EXEMPLE D'UNE ACTION DÉCLENCHÉE SUR LA MAJ D'UN RECORD

Depuis la configuration Salesforce, accédez aux Flux (flow), puis cliquez sur Nouveaux Flux.

Sélectionnez le type de flux à mettre en place.

Les types de flux
  • Flux d'écran : Affichez des paramétres ou des informations àl'utilisateur avant de lancer une action au clic. (Ex. Choix du modèle et du format de sortie avant génération au clic)
  • Flux déclenché par un enregistrement : Déclencher une action lors de la création, mise à jour ou suppression d'un enregistrement Salesforce. (ex. Modification d'un statut, case à cocher... )
  • Flux déclenché par une planification : déclencher une action précise à une heure programmée (ex. Génération de reçus fiscaux tous les 31 decembre à 9h)

Cliquez sur Créer.

Création d'une variable recordId

💡 Astuce; La variable recordId est quasiment systématique pour tous les flux d'écran. Elle sert à variabiliser le champ recordId, et à fournir au flux le contexte depuis lequel nous lançons la génération.

  • Depuis la boite à outil, cliquez sur Nouvelle ressource
  • Choisissez le type : Variable et donnez un nom d'API
  • Sélectionnez le type de donnée Texte, pour stocker l'id du record à générer.
  • Cochez la case : Disponible pour l'entrée
Ajouter un écran informatif

Depuis le processus, cliquez sur le + et choisissez l'élément : écran

  • Nommez l'étiquette et le nom API

    💡 Astuce; Renommez le bouton suivant dans la configuration du pied de page pour améliorer l'expérience utilisateur.

  • Glissez-déposez le composant souhaité : date, case à cocher, texte informatif...

Validez

Ajouter une action de mise à jour

Pour mettre à jour la donnée renseignée dans l'écran précédent, vous pouvez ajouter une action de mise à jour. Elle déclenchera une prochaine action.

Depuis le processus, cliquez sur le + et choisissez l'élément : mise à jour des enregistrements

  • Nommez l'étiquette et le nom API
  • Cochez la case :spécifier les conditions d'identification des enregistrements
  • Sélectionnez l'objet Salesforce depuis lequel le champ est à mettre à jour (ex. Devis)
  • Filtrez les conditions avec l'Id de l'enregistrement = la variable recordId précédemment créée
  • Définissez les champs à mettre à jour et leur valeur. (Ex. ExpirationDate = Date d'expiration et Statut = Révision)

Validez, enregistrez, nommez et activez votre flux.

Mise à disposition du flux

Déposez le flux sur vote contexte.

  • Accédez à votre objet principal depuis Salesforce (objet depuis lequel l'action est déclenchée)
  • Cliquez sur modifier la page
  • Glissez-déposez le composant Flux à l'endroit souhaité
  • Sélectionnez le flux à appeller dans la liste déroulante
  • Cochez la case : transmettre l'ID de l'enregistrement dans cette variable

Générer un document automatiquement

ACTION DE GÉNÉRATION UNITAIRE

Construisez votre processus à votre convenance (écran, décision, message de succès...) et ajoutez l'action Gonexa.

Les 3 paramètres de l'action GenerateDocument
  • Ajoutez un élément à votre flux de type Action
  • Sélectionnez l'action GenerateDocument : apex-gnc__DocumentGenerationInvocable
  • Renseignez les 3 éléments suivants :
  • Format de sortie : appelle la valeur pdf, xlxs, pptx, ou docx.

    Vous pouvez variabiliser cette valeur avec un écran en créant de nouvelles ressources de type choix.

  • recordId : récupère l'id du record à générer.

    Cette valeur est à variabiliser avec une variable de type texte, disponible pour l'entrée.

  • TemplateId : récupère l'Id du modèle de document à générer.

    Cette valeur peut etre variabilisé dans un écran ou sélectionné parmi les documents selon certains critères comme le nom du document ou l'azure id.

Enregistrez, activez, et testez.

Générer des documents à partir d'une vue de liste

action de génération en masse

Générer plusieurs documents d'un coup a partir d'une vue de liste.

Obtenir les enregistrements

Ajoutez un élément d'obtention d'enregistrement à votre flux

  • Donnez lui une étiquette et un nom API
  • Récupérer les enregistrements depuis l'objet de votre contexte. (Ex. La génération de certifications depuis les contacts)
  • Filtrez les enregistrements avec l'exigence suivante :

    Champ : Id
    Opérateur : dans
    Valeur : ids

Créer la variable ids

Afin de remplir le champ valeur, créez une nouvelle ressource :

  • Type de ressource : Variable
  • Nom d'API : ids

    💡 Attention nom sensible à la casse

  • Type de données : Texte
  • Autoriser les valeurs multiples (collection)
  • Disponible pour l'entrée

Validez

Ajouter l'action Generate Multiple Document

Ajoutez l'action sur la présentation de page de votre objet principal.

  • Depuis le gestionnaire d'objet de la configuration, accédez à l'objet depuis lequel vous souhaitez lancer les générations.
  • Accédez à l'onglet Boutons, liens et actions
  • Créez unnouveau bouton de type Bouton de liste
  • Nommez l'étiquette de votre choix (Ex. générer les certifications)
  • Collez l'URL du Flux dans le lien.

    💡 Astuce vous trouverez l'URL de votre flux dans les détails du flux.

  • Depuis l'onglet présentation dubouton de vue deliste, ajoutez le nouveau bouton et enregistrez.

Validez et testez

Gestion personnalisée des formats
Date & Nombre

Les caractères compris dans la chaine de format Date est interprêtée comme une chaine de format et d'heure personnalisée. Ajoutez un spécificateur standard pour définir l'affichage de l'information souhaitée.

Prérequis de la formation

  • Installer paramétrer et savoir créer un modèle de document
  • Ajouter une balise à l'aide de l'assistant

📅 Personnaliser le format Date

CHOIX DES EXTENSIONS

SPÉCIFICATEUR DE FORMAT

DESCRIPTION

Exemple

{!Etiquette|NomAPI(d)}

Modèle de date courte

01/09/2023

{!Etiquette|NomAPI(D)}

Modèle de date longue

Lundi 10 septembre 2023

{!Etiquette|NomAPI(f)}

Modèle de date longue + heure courte

Lundi 10 septembre 2023 13:30

{!Etiquette|NomAPI(F)}

Modèle de date longue + heure longue

Lundi 10 septembre 2023 13:30:50

{!Etiquette|NomAPI(g)}

Modèle de date courte + heure courte

10/09/2023 13:30:50

{!Etiquette|NomAPI(G)}

Modèle de date courte + heure courte

10/09/2023 13:30

{!Etiquette|NomAPI(M)}

Modèle de mois + jour

10 septembre

{!Etiquette|NomAPI(R)}

Modèle RFC1123

Lundi, 10 Septembre 2023 13:30:3

{!Etiquette|NomAPI(T)}

Modèle d'heure longue

13:30:50

{!Etiquette|NomAPI(t)}

Modèle d'heure court

13:30

{!Etiquette|NomAPI(Y)}

Modèle de date + mois

septembre 2023

🗓️ Personnaliser le format Date

construction de l'extension

SPÉCIFICATEUR DE FORMAT

DESCRIPTION

Exemple

{!Etiquette|NomAPI(dd MMMM yyyy)}

Vous pouvez créer des balises complexes avec les spécificateurs de formats suivants sous la forme {!obj|champ(dd MMMM yyyy)} par exemple. Vous pouvez également choisir d'utiliser les tirets ou les "/" entre chaque format de date.

01 09 2023

🕘 Personnaliser le format Heure

construction de l'extension

SPÉCIFICATEUR DE FORMAT

DESCRIPTION

Exemple

{!Etiquette|NomAPI(d)}

Jour du mois, de 1 à 31

1

{!Etiquette|NomAPI(dddd)}

Nom complet du jour de la semaine

lundi

{!Etiquette|NomAPI(yyyy)}

Année à 4 chiffres

2023

🔢 Personnaliser le format Nombre

GENERER UN FORMAT NOMBRE

SPÉCIFICATEUR DE FORMAT

TYPE DE CHAMP

Exemple

{!Etiquette|NomAPI(C)}

DEVISE

123,45 €

{!Etiquette|NomAPI(D)}
Facultatif : spécificateur de précision
{!Etiquette|NomAPI(D6)}

DÉCIMAL

1234
-001234

{!Etiquette|NomAPI(F)}
Facultatif : spécificateur de précision
{!Etiquette|NomAPI(F4)}

VIRGULE FIXE

1234,56
1234,5600

{!Etiquette|NomAPI(P)}
Facultatif : spécificateur de précision
{!Etiquette|NomAPI(P4)}

POURCENTAGE

100,00 %
-39,7 %

{!Etiquette|NomAPI(N)}
Facultatif : nombre souhaité de décimales
{!Etiquette|NomAPI(N3)}

NOMBRE

1,234567
1,234

Pour aller plus loin, consultez l'article suivant : https://learn.microsoft.com/fr-fr/dotnet/standard/base-types/standard-date-and-time-format-strings