> For the complete documentation index, see [llms.txt](https://www.center.daxium-air.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.center.daxium-air.com/user-documentation/documentation-utilisateur/build/building-the-reporting/report-templates/excel.md).

# Excel

Créer des modèles de rapport Excel pour les exports de données et les rapports tabulaires.

Les modèles Excel (.xlsx) sont idéaux pour les rapports orientés données nécessitant des calculs, des graphiques ou des mises en page tabulaires. Ils sont le format recommandé pour les rapports en mode listing qui compilent les données de plusieurs fiches dans un seul fichier.

## Vue d'ensemble

|                       |                                                                         |
| --------------------- | ----------------------------------------------------------------------- |
| **Format**            | `.xlsx` (MS Excel 2007 minimum ; 2013 recommandé)                       |
| **Moteur de rapport** | Bibliothèque Aspose pour Excel                                          |
| **Idéal pour**        | Rapports listing, tableaux d'agrégation, graphiques, exports de données |
| **Mode listing**      | Cas d'usage principal — compile plusieurs fiches dans un seul fichier   |

## Syntaxe de base des champs

Les modèles de rapport Excel utilisent une feuille dédiée **PPActions** pour déclarer les champs à insérer et leur emplacement. La syntaxe générale des balises (`<%SystemName%>`) s'applique dans les cellules, mais les champs d'un tableau de listing sont déclarés via la feuille PPActions plutôt qu'insérés directement.

### Mise en place de la feuille PPActions

1. Ajoutez une feuille nommée `PPActions` à votre modèle.
2. Ajoutez une deuxième feuille avec le nom de votre choix et créez un tableau avec une ligne d'en-tête et une ligne de données.
3. Donnez un **nom de zone** au tableau : sélectionnez-le et saisissez un nom dans la Zone Nom (coin supérieur gauche d'Excel).
4. Dans la feuille PPActions, ajoutez une ligne avec autant de colonnes que de champs dans votre tableau :

<figure><img src="https://1911583818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ymrtuLI4wkVYM9CeCbX%2Fuploads%2Fi7hV67uqWqwVqWslw0M4%2FRel%20sans%20rel.avif?alt=media&amp;token=8cffedeb-ad76-48b6-afbf-b0d9879f9f03" alt=""><figcaption></figcaption></figure>

Chaque colonne déclare un champ à l'aide de trois propriétés :

| Propriété   | Valeur                                  |
| ----------- | --------------------------------------- |
| `Type`      | `table` — déclare un tableau de listing |
| `TableName` | Le nom de zone que vous avez défini     |
| `Value`     | Nom système du champ                    |

## Relations

Pour inclure les fiches enfants d'un champ relation, ajoutez une ligne dans la feuille PPActions avec le type `subtable` :

<figure><img src="https://1911583818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2ymrtuLI4wkVYM9CeCbX%2Fuploads%2Fv3TR7M4BjCqucNM2DnIa%2Fimage.png?alt=media&amp;token=39ac57b0-057f-403f-bc23-57adc6122b77" alt=""><figcaption></figcaption></figure>

```
<%Type:subtable;TableName:nom du tableau;Relationship:nom de la relation%> | <%Value:nom du champ%>
```

| Propriété      | Valeur                                                    |
| -------------- | --------------------------------------------------------- |
| `Type`         | `subtable` — déclare un tableau de relation               |
| `TableName`    | Le nom de zone du tableau de relation                     |
| `Relationship` | Libellé du champ de relation dans le formulaire principal |

Pour afficher le nombre de fiches liées : `<%Value:[Relation.Count]%>`

## Astuces

* La police, les couleurs, les règles de mise en forme conditionnelle et les formules Excel sont toutes préservées lors de la génération du rapport.
* Le mode listing fonctionne selon les mêmes principes que Word — consultez [Automatismes](/user-documentation/documentation-utilisateur/build/building-forms/automations.md) pour la planification.
* Vous pouvez partir d'un fichier `.xlsx` vierge ou adapter un modèle de tableur existant.

## Limitations

* Format : `.xlsx` uniquement.
* Limite du mode listing : **30 000 fiches** par rapport.
* La taille des images est déterminée par les dimensions de la cellule, pas par des paramètres de fonction : `<%Value:SystemName;Type:Image%>` — redimensionnez la cellule cible pour contrôler la taille de la photo.
* Par défaut, une image intégrée peut déborder des bordures de sa cellule. Ajoutez `<%ReportOption('UseCellEmbeddedImage','True')%>` dans la première cellule du modèle pour l'y contenir. Voir [ReportOption()](/user-documentation/documentation-utilisateur/build/building-the-reporting/syntax-functions.md#manipulation-dimages).
* `MarkDown()` n'est pas fonctionnel dans les rapports Excel.


---

# 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://www.center.daxium-air.com/user-documentation/documentation-utilisateur/build/building-the-reporting/report-templates/excel.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.