> 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/build-template/configure-document-template-in-salesforce.md).

# Configurer un modèle de document dans Salesforce

Cliquez sur l'onglet "Modèle de document" ou "Document template"

## Création de base du nouveau modèle

* Cliquez sur l'onglet "Modèle de document" ou "Document template"
* Cliquez sur "Nouveau", vous créez par défaut un modèle de type "Principal"
* 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

![Création d'un nouveau modèle de document](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2Fs45XxIeBnRWeVZOeD15e%2F01-01-nouveau-doc.gif?alt=media)

## Sélection de l'Objet principal

**Qu'est-ce que l'objet principal ?**

C'est l'objet Salesforce depuis lequel vous souhaitez lancer la génération et le contexte de base pour créer un document et récupérer la données à afficher dans le modèle. Il peut être standard, custom ou d'un autre applicatif Salesforce.

* Sélectionnez l'objet principal parmi la liste déroulante des objets disponibles en base
* L'étiquette de la balise est automatiquement alimenté par le nom API de l'objet mais vous pouvez la modifier à votre convenance si necessaire

{% hint style="success" %}
**Pour exemple**

Vous pouvez renommer l'étiquette `Opportunité_Gonexa_2026__c` par `Opp` pour faciliter la compréhension des balises qui seront insérées dans le modèle et réduire leur longueur.
{% endhint %}

## Paramètres de la nomenclature du nom du fichier généré

{% hint style="warning" %}
**Astuce**

Pour avoir un nom de fichier plus personnalisé comme "Devis-{Date du jour} {N° De Devis} Nom du compte" pensez à créer un champ formule sur l'objet principal et à le définir comme suffixe.
{% endhint %}

* Ecrivez le préfixe que vous voulez donner au nom des documents à générer. C'est un texte figé qui composera la première partie du nom du fichier.
* Définissez le suffixe, choisissez un champ sur l'objet principal qui composera la 2ème partie du nom de fichier dynamiquement.

![Objet principal, préfixe et suffixe](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2FQQ0wL4qix1apRytCvyCx%2F02-02-nom-objet-prefixe-suffixe.gif?alt=media)

## Choix de la politique de version

* Sélectionnez la politique de version que vous souhaitez appliquer pour ce modèle de document parmi les 3 options.

![Politique de version, format de sortie et type de génération](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2F1NnE7ggRJsbShPN7OHB2%2F03-03-politique-sortie-type.gif?alt=media)

**LES DIFFÉRENTES POLITIQUES DE GESTION DES VERSIONS**

| Politique                | Description                                                                                                                                                                                      |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nouveau fichier**      | À chaque nouvelle génération sur le même enregistrement, un nouveau fichier sera créé. *Permet de garder tout l'historique.*                                                                     |
| **Nouvelle version**     | À chaque nouvelle génération sur le même enregistrement, une nouvelle version du même fichier sera créé. *A favoriser si vous souhaitez garder une traçabilité mais n'avoir qu'un seul fichier.* |
| **Effacer et remplacer** | À chaque nouvelle génération sur le même enregistrement, le nouveau fichier écrasera l'ancien pour le remplacer. *Utile pour optimiser le stockage et n'avoir toujours qu'un fichier.*           |

## Formats de sortie disponibles

* Sélectionnez les formats de sortie disponible à appliquer parmi les options.

**LES FORMATS DISPONIBLES**

| Format                          | Description                                                                                                                                 |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Format d'origine & PDF**      | Offrira à l'utilisateur la possibilité de choisir de générer son document dans le format d'origine comme Word, Powerpoint, Excel ou en PDF. |
| **Format d'origine uniquement** | L'utilisateur pourra générer son document uniquement dans le format d'origine c'est à dire en Word, Powerpoint, Excel ou en PDF.            |
| **PDF uniquement**              | L'utilisateur ne pourra générer le document qu'en format PDF, sans pouvoir le modifier. **\[Le plus utilisé]**                              |

## Sélection du type de génération

* Sélectionnez le type de génération à appliquer parmi les options.

**LES DIFFÉRENTS TYPES DE GÉNÉRATION**

| Type          | Description                                                                                                                                                                                                                                                            |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Synchrone** | Permet de générer un document de manière immédiate et d'être redirigé sur le document une fois généré **\[Le plus utilisé]**                                                                                                                                           |
| **Future**    | Permet de générer le document de manière asynchrone. Cela signifie que l'action s'exécutera en arrière plan. Dans le cas d'une génération future, vous ne serez pas redirigé sur le document et il sera nécessaire d'actualiser la page pour voir le document          |
| **Externe**   | Permet de générer un document très lourd et complexe sur les serveurs Gonexa. Dans ce cas vous ne serez pas redirigé sur le document et il sera nécessaire d'actualiser la page après quelques secondes pour voir le document. **\[Necessite une licence spécifique]** |

* Enregistrez vos choix. Vous pourrez les modifier à n'importe quel moment ultérieurement.

Les paramétres de bases ont été définis. Vous pouvez directement construire par la création du modèle. Si toutefois, vous souhaitez ajouter des balises sur des objets enfants, créez-les d'abord avant de passer à la partie design et insertion de balises.

## Création d'Objets enfant \[FACULTATIF]

**Qu'est ce qu'un objet enfant ?**

Facultatif, l'ajout d'un ou plusieurs objet enfant permet d'afficher une liste associée à l'objet principal pour lister plusieurs éléments comme les produits d'opportunités, les produits ou les contacts d'un compte sous forme de tableau.

* Rendez vous dans le composant "Assistant Gonexa" pour accéder à la création d'objets enfants
* Cliquez sur "+ Objet enfant"

![Bouton + Objet enfant dans l'Assistant Gonexa](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2FAxleyEArAFLqFQYXhNn6%2Fconstruction-modele-2.png?alt=media)

* Choisissez l'objet Salesforce concerné
* L'étiquette s'alimente par défaut avec le nom API de l'objet, mais vous pouvez la modifier pour plus de clarté dans le modèle.
* Ajoutez un filtre si vous souhaitez filtrer les enregistrements enfants à récupérer
* ![Création d'un objet enfant (1/2)](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2FvlqOTTDAX7CJjacCwnXl%2F04-04-creation-objet-enfant-numero-1.gif?alt=media)
* Ajoutez un tri si vous souhaitez en appliquer un pour les résultats dans le tableau enfant
* Finalisez cette partie en cliquant sur "Créer"

Pour aller plus loin sur l'ajout d'objets enfants, rendez-vous dans l'article [Gérer des tableaux](/doc/getting-started/manage-tables.md)

![Création d'un objet enfant (2/2)](https://4198981723-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTYUzkIngX1MnHE8kOJDR%2Fuploads%2FUsSyksRHMTDF0iUxsSYU%2F05-04-creation-objet-enfant-numero-2.gif?alt=media)


---

# 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/build-template/configure-document-template-in-salesforce.md?ask=<question>&goal=<user_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.
