Gonexa University

Modèle Associé

Plusieurs types de modèles de document existent pour permettre de gérer de nouveaux cas d'usage comme des annexes des modèles principaux

Pré-requis
✓ Avoir déjà fait la configuration d'un modèle principal
✓ Mettre à jour le package sur la dernière version

Pourquoi ajouter des documents associés ?

Les modèles de documents associés peuvent être de type statique, dynamique, multiple ou graphique pour répondre à vos cas d'usages les plus avancés.

Un document associé, qu'est-ce que c'est ?

Il est possible d’ajouter un ou plusieurs documents à la suite d’un document principal à la génération, grâce aux documents associés. Ces documents peuvent être ajoutés avec ou sans conditions. Ils sont dépendants du document principal et ne peuvent être générés seuls.

Choix du type de document associé

ETAPE #1
Créer le modèle de document de type associé
  • Créez et configurez le modèle de document principal
  • Dans l’onglet Doc du votre modèle principal, cliquez sur "Nouveau modèle associé"
  • Donnez un nom au modèle et choisissez le type d’associé que vous souhaitez créer parmi les possibilités suivantes :
    Statique
    Le document associé est fixe et ne contient pas de balise. Il n'y a pas de choix d'objet principal. La page peut être un PDF

    Utile dans le cas d'ajout de CGVs
    Dynamique
    Le document contient des balises dynamiques. Dans ce cas, le choix de l’objet se fait parmi les objets de type principal ou secondaire du modèle de document principal

    A utiliser pour ajouter une annexe avec des infos dynamiques
    Multiple
    Le document contient des balises et se répète en fonction du nombre d’objets enfants dans le document principal. Dans ce cas, le choix de l’objet se fait parmi les objets enfants du modèle de document principal

    Utilisé dans le cas où on affiche des fiches produits. Le document principal contient un tableau avec 5 produits, alors le document associé s’ajoutera 5 fois à la suite du document principal, une fois pour chaque produit
    Graphique
    Le document est un fichier Excel qui contient un graphique à afficher sur le document à générer

    Annexe utilisée pour une synthèse de compte avancée par exemple
  • Validez et vous serez redirigé sur la configuration du modèle de document associé
  • Ajoutez des objets supplémentaires au besoin et les balises de votre document s'il n'est pas statique et chargez le modèle de document associé
  • Votre modèle associé sera lié au modèle principal depuis lequel vous l'avez créé
  • Testez la génération depuis votre modèle principal pour trouver le document associé ajouté au premier à la génération


Lier un modèle de document associé existant

Dans le cas où un modèle associé doit être lié à plusieurs modèles principaux, faîtes la liaison entre les deux en fonction de l'endroit où vous vous trouvez

  • Sur votre associé rendez-vous dans l’onglet "Modèles principaux" et trouvez la liste de tous les modèles principaux qui sont liés à ce modèle associé
  • Cliquez sur "Lier à un modèle principal"
  • Sélectionnez le modèle de document principal que vous souhaitez lier et cliquez sur "Choisir"
  • Rafraichissez la page et trouvez un nouveau modèle principal (n) dans la liste associée
  • Depuis cette liste, supprimez le lien ou retournez sur le modèle principal via les boutons
  • Sélectionnez le modèle de document principal depuis lequel vous souhaitez ajouter une annexe
  • Depuis l'onglet "Doc" accédez à la liste "Modèles associés", puis sur "Lier un modèle de document associé"
  • Sélectionnez le modèle associé et cliquez sur "Choisir"


Ajouter des conditions d’affichage d’un document associé [FACULTATIF]

Ajoutez des conditions sur le lien entre le document principal et associé pour définir les critères d'ajout du document associé

Pour exemple
Le modèle de document associé "CGV Fournisseur" ne doit s'ajouter au Devis que si le compte est de type Fournisseur. Le modèle de document associé "CGV Client" lui, s'ajoutera au Devis que si le compte est de type Client.

  • Sur votre modèle principal, rendez-vous dans l’onglet "Doc", puis accédez au bloc "Modèles associés (n)"
  • Depuis les liens déjà construits, cliquez sur la flèche et sur "Modifier la condition"
  • Construisez votre ou vos condition.s d’affichage comme souhaité
  • Cliquez sur "Choisir"
  • Sur votre modèle principal, rendez-vous dans l’onglet "Doc", puis accédez au bloc "Modèles associés (n)"
  • Depuis les liens déjà construits, cliquez sur la flèche et sur "Modifier la condition"
  • Construisez votre ou vos condition.s d’affichage comme souhaité
  • Cliquez sur "Choisir"

Modèle de document Associé Graphique

ETUDE DE CAS


Ce modèle associé est une annexe technique permettant de créer des graphiques à partir de données Excel, et de les afficher dans un document Word ou PowerPoint.

Pré-requis
✓ Utiliser la version de package Grenoble 2.3
✓ Disposer d'un modèle de document et savoir gérer des tableaux et des documents au format Excel avec Gonexa
✓ Vérifier que la valeur de la picklist "Graph" est disponible sinon suivre la procédure

Ajouter la valeur de Picklist "Graph" si elle n'est pas visible
  • Depuis la Configuration, accédez à Gestionnaire d'objet > Modèle de document > Champs et relations
  • Recherchez le champ Type (gnx_Type__c)
  • Si la valeur "Graph" est absente, cliquez sur "Nouveau (valeurs)" nommez par "Graph" et validez
  • Accédez à l'onglet "Types d'enregistrement" > Associate et modifiez la liste de sélection disponible pour le champ type et passez la valeur "Graph" de disponible à Sélectionnée. Enregistrez


Créer un modèle associé de type Graph
  • Depuis votre modèle de document principal, accédez à l'onglet "Doc" et au bloc "Modèles associés"
  • Si besoin, créez des objets enfants pour générer des graphiques sur des objets liés (ex. : Contrat + Lignes de contrats)
  • Cliquez sur "Nouveau modèle associé" et Nommez le (ex. : Graphiques)
  • Sélectionnez le type de modèle : Graphique (Excel)
  • Le champ "Choix de l'objet du modèle principal" sera renseigné par défaut
  • Cliquez sur "Choisir"


Créer le Excel
  • Créez un fichier Excel avec les parties fixes, dynamiques et les tableaux de données ajoutés via le bandeau "Insertion" > "Tableau" pour qu'il soit bien défini en tant que Tableau Excel
  • Ajoutez l'entête et les balises comme dans un tableau enfant classique
  • Créez les graphiques en sélectionnant le tableau concerné, puis accédez à l'onglet "Insertion" > "Graphique"
  • Nommez votre graphique
  • Sélectionnez le tableau et donnez-lui un nom dans l'onglet "Tableau" qui doit être identique au premier Graphique
  • Ajoutez un titre et une légende à chaque graphique
  • Cliquez sur le graphique et définissez dans la "Zone de nom" un nom unique pour chaque graphique

Pour exemple
Un tableau nommé "GraphA" et un graphique nommé "GraphA"
Un tableau nommé "GraphB" et un graphique nommé "GraphB"


Insérer le graphique dans le document principal
  • Depuis Salesforce, dans le bloc Modèles principaux, accédez à votre modèle principal
  • Ouvrez le document principal (Word ou PowerPoint)
  • Placez la balise à l'endroit souhaité pour insérer le graphique

    La balise Graphique

    La syntaxe de la balise : {!gnxgraph|Nom_du_graph(w=100)}

    Paramètres :
    Nom_Du-Graph
    = correspond au nom exact du graphique dans Excel
    w=200 = définit la largeur du graphique en pixels

    Pour exemple
    La balise  {!gnxgraph|GraphA(w=150)} qui reprend le nom exact du graphique dans Excel et affichera le graphique en taille réduite de 150 pixels

    Attention
    Le nom du tableau doit être strictement le même que le nom du graphique
    Un tableau et son graphique affichés sur la même feuille Excel, permettra de mettre à jour les lignes du graphique