> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/features/reports.md).

# Rapports personnalisés

Créez des rapports personnalisés à partir des données de Dastra : tables, métriques, dimensions, filtres, graphiques, exports et partage.

Les rapports personnalisés extraient les informations utiles des données de Dastra, sous la forme que vous choisissez : tableau, graphique ou export.

## Démarrage rapide

1. Dans le menu de gauche, sous **Ressources**, cliquez sur **Rapports personnalisés**.
2. Les rapports sont organisés par catégories. Avant de créer votre premier rapport, vous devez **créer une première catégorie**.
3. Cliquez sur **Créer un rapport** pour construire un rapport vierge, ou ouvrez la flèche du bouton et choisissez **Créer à partir de modèles**.

Si l'analyse par IA est incluse dans votre abonnement, le bouton d'IA à côté de **Créer un rapport** (**Générer un rapport personnalisé avec l'IA**) génère un rapport à partir d'une courte description, par exemple « Nombre de traitements par étape de workflow avec un graphique ».

## Glossaire

* **Métrique** : une valeur mesurable que l'on regroupe (agrège) sur plusieurs éléments. *Exemple : le nombre de traitements, la durée moyenne de traitement d'une tâche, etc.*
* **Dimension** : à l'inverse de la métrique, la dimension n'agrège pas les données. C'est une propriété (une colonne) d'un élément. *Exemple : le nom du traitement, son statut, sa référence, etc.*

## Construction du rapport

Un rapport se construit en quatre temps :

1. **Sélection des données** : choisissez les tables que vous voulez interroger, puis les métriques et dimensions pertinentes.
2. **Filtres** : affinez vos résultats avec des critères pour ne garder que les données utiles à votre analyse.
3. **Graphique** : affichez le rapport sous forme de graphique ou de tableau.
4. **Export et partage** : exportez le rapport en PDF, Word, HTML, Excel, CSV, JSON ou Markdown, partagez-le ou branchez-le sur un outil de BI comme Power BI.

### Sélection des tables

Choisissez d'abord la table racine dans la liste **Sélectionnez la table racine** : c'est la table principale du rapport, par exemple les traitements. Cliquez ensuite sur **Ajouter table** pour ajouter des tables liées à la table racine (les étapes du traitement, la finalité, les tags, etc.). Vous pouvez interroger jusqu'à 7 tables dans chaque rapport, table racine comprise.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-508832dd7b5b75335b2b41c7c9d4c216bc44f1b5%2Freports-1.png?alt=media" alt="La sélection de la table racine et des tables liées"><figcaption><p>La sélection de la table racine et des tables liées</p></figcaption></figure>

Cliquez sur **Suivant** quand vous avez choisi les tables.

{% hint style="info" %}
Vous pouvez revenir à la sélection des tables depuis la construction du rapport, avec le bouton **Modifier** de la carte **Tables sélectionnées**, pour ajouter d'autres tables. Les tables déjà utilisées par le rapport sont verrouillées.
{% endhint %}

### Construction à partir des métriques et dimensions

Construisez votre rapport en faisant glisser les métriques et dimensions voulues, ou en les sélectionnant, depuis le panneau de gauche vers la zone **Déposez des métriques et dimensions ici**. Un message vous prévient lorsque vous avez atteint le nombre maximum de métriques et dimensions pour un rapport.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-3e4aa9acec61a38255b45c515a47af3931c95c2d%2Freports-2.png?alt=media" alt="L&#x27;éditeur de métriques et dimensions"><figcaption><p>L'éditeur de métriques et dimensions</p></figcaption></figure>

La carte **Filtres** limite les données, et **Trier par** définit l'ordre des lignes (cochez **Tri ascendant** pour un tri croissant). **Rafraîchir les données** met à jour l'aperçu.

Cliquez sur **Enregistrer et continuer** pour ouvrir le rapport, ou sur **Enregistrer** pour rester dans l'éditeur.

{% hint style="info" %}
Les données sont automatiquement agrégées par dimension pour calculer les métriques sélectionnées.
{% endhint %}

Exemple : si vous sélectionnez la métrique **Nb Traitements de données** et la dimension **Statut**, vous obtenez un rapport regroupé sous cette forme :

| Statut    | Nb Traitements de données |
| --------- | ------------------------- |
| Brouillon | 12                        |
| Actif     | 560                       |

### Lien vers la fiche de l'objet

Pour les tables d'objets dotés d'une fiche (traitements, exercices des droits, violations de données, actifs, acteurs, audits, mesures de sécurité, contrats, systèmes d'IA et tâches), la dimension **Lien vers la ressource (url)** ajoute à chaque ligne un lien cliquable **Détails**. Ce lien ouvre la fiche de l'objet dans le bon module, dans un nouvel onglet, pour l'espace de travail courant. La colonne est également incluse dans les exports, sous forme d'URL.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-eab4af9ef3129623e14a9ee5a42db4b435d92e6e%2Fcustom-report-record-url-dimension.png?alt=media" alt="Dimension Lien vers la ressource (url) dans la construction du rapport"><figcaption><p>Ajout de la dimension Lien vers la ressource (url) au rapport</p></figcaption></figure>

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-5f1846717440dafe94a1a5116df2a383ee6c24bd%2Fcustom-report-details-link.png?alt=media" alt="Lien Détails cliquable dans un rapport personnalisé"><figcaption><p>Chaque ligne affiche un lien Détails qui ouvre la fiche de l'objet</p></figcaption></figure>

## Afficher le rapport et ajouter un graphique

Une fois le rapport enregistré, vous arrivez sur sa page. Le tableau de données s'affiche avec un filtre par unité organisationnelle, **Effacer les filtres** et la description du rapport, que vous pouvez modifier directement.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-b570b52fe16895a7430a3b6d75829148aae6f986%2Freports-3.png?alt=media" alt="Un rapport personnalisé avec son tableau de données"><figcaption><p>La page d'un rapport personnalisé</p></figcaption></figure>

Pour ajouter un graphique, cliquez sur **Ajouter graphique**, puis réglez les options :

* **Type de graphique** : **Diagramme en colonnes**, **Diagramme en barres**, **Diagramme circulaire** ou **Zone de chaleur** ;
* **Métrique affichée** : la valeur mesurée par le graphique ;
* **Dimension n°1** et **Dimension n°2** : les axes du graphique ;
* **Disposition des données** : **Par défaut**, **Répartition dans la colonne** (valeurs empilées) ou **Répartition par pourcentage** (empilées à 100 %) ;
* **Trier par** et **Tri ascendant** : l'ordre d'affichage.

L'aperçu se met à jour au fil de vos choix. Pour modifier ou supprimer le graphique plus tard, utilisez **Modifier graphique** ou **Supprimer graphique** au-dessus du graphique.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-9680c7d4d5eddb5b22e9e80cdd804b2536d8b518%2Freports-4.png?alt=media" alt="La fenêtre Ajouter graphique avec ses options"><figcaption><p>La fenêtre Ajouter graphique</p></figcaption></figure>

## Imprimer, exporter et partager

Depuis la page d'un rapport :

* **Exporter** télécharge le rapport au format CSV, Excel, JSON, PDF, Word, HTML ou Markdown ;
* le menu du bouton **Modifier** propose **Imprimer**, **Exporter**, **Partager** (réservé aux utilisateurs qui disposent de la permission **Configuration avancée**) et **Déplacer dans la corbeille** ;
* **Connecter outils BI** branche le rapport sur un outil d'analyse de données : voir [Intégration dans les outils d'analyse de données (BI)](https://doc.dastra.eu/features/reports/bi-tools.md).

## Corbeille

Un rapport ou une catégorie supprimé passe d'abord par la corbeille : vous pouvez le restaurer tant qu'il n'a pas été supprimé définitivement.

* **Placer un élément dans la corbeille** : dans le menu d'actions d'un rapport, cliquez sur **Déplacer dans la corbeille** puis confirmez. Le menu d'actions d'une catégorie, dans le panneau de gauche, propose la même action : la catégorie et tous ses rapports sont placés dans la corbeille.
* **Consulter la corbeille** : activez l'option **Voir la corbeille** au-dessus de la liste des rapports, ou depuis le menu du panneau des catégories.
* **Restaurer** : depuis la corbeille, **Restaurer** remet l'élément dans la liste active. Restaurer une catégorie restaure aussi les rapports placés dans la corbeille avec elle ; restaurer un rapport dont la catégorie est dans la corbeille restaure aussi cette catégorie.
* **Supprimer définitivement** : depuis la corbeille, **Supprimer** efface l'élément après confirmation. La suppression d'une catégorie supprime aussi tous ses rapports. Cette action est irréversible.

{% hint style="info" %}
Les actions de la corbeille nécessitent le droit de modification des rapports personnalisés.
{% endhint %}


---

# 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://doc.dastra.eu/features/reports.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.
