Report
Report
Nom fonctionnel: Rapport métier
À quoi sert ce widget ?
Construit un rapport métier à partir de l’état de la carte et des données affichées.
Conseil: un viewer “trop outillé” devient vite bruyant. Activez ce widget uniquement s’il sert un parcours utilisateur clair.
Quand l’activer
- Quand vous devez transmettre une vue cartographique reproductible.
- Quand le workflow métier impose un export standardisé.
- Quand vous voulez capitaliser une analyse en dehors de la session.
En clair
- Côté utilisateur: La valeur métier est immédiate: la carte devient un support de décision et de communication.
- Côté intégration: Vérifiez précisément le périmètre partagé/exporté (couches, emprise, transparence, droits).
Prise en main
Accéder au widget
- Accédez au widget depuis le groupe d’outils Export/Partage.
- Vérifiez que les couches nécessaires sont visibles avant génération.
Le configurer sans se tromper
- Choisissez le format de sortie (lien, impression, rapport selon widget).
- Renseignez les options de sortie avant validation.
Ce que l’utilisateur voit
- Paramètres de génération de rapport métier.
- Sélection des données/contextes à inclure.
- Export du résultat pour diffusion opérationnelle.
Parcours utilisateur (le plus courant)
- Préparez la carte dans l’état à documenter.
- Lancez la génération puis contrôlez la complétude du rendu.
- Partagez le rapport avec les parties prenantes concernées.
Exemples concrets
- Partager une carte contextualisée avec une équipe métier.
- Produire un export imprimable pour une réunion terrain.
- Générer un rapport métier avec emprise et couches sélectionnées.
Configuration (aperçu)
| Option | Type | Défaut | Description |
|---|---|---|---|
widgetId | string | - | Identifiant unique de l’instance Report. |
active | boolean | false | Active l’ouverture du widget au démarrage. |
inToolbar | boolean ou objet ou string | selon widget | Définit si le widget est visible dans une toolbar, et sous quelle forme. |
container | string ou objet | selon widget | Choisit le conteneur de rendu (drawer, dialog, floating, toolbar-tabs, hidden). |
Pour le détail complet (et toujours à jour), utilisez la référence technique et le schéma ci-dessous.
Liens techniques et code
- Référence technique du widget: Référence technique du widget
- Schéma principal:
schemas/reportConfigSchema - API technique du widget:
types/ReportConfig - Code source (déclaration):
packages/common/src/lib/widgets/export/report/report.declaration.ts - Code source (config):
packages/common/src/lib/widgets/export/report/report.config.ts
Exemple minimal (copier-coller)
{ "widgetId": "report", "widgetClass": "Report", "active": false, "inToolbar": true, "config": {}}Exemple avancé
{ "widgetId": "report-advanced", "widgetClass": "Report", "active": true, "handleOpenAtStartup": false, "inToolbar": { "type": "button", "toolbarId": "default-toolbar", "order": 10 }, "onActivate": { "deactivate": { "classes": [] } }, "config": {}}Points d’attention
- Les services externes indisponibles peuvent bloquer la génération.
- Le résultat dépend des couches visibles au moment de l’export.
- Les liens partagés doivent respecter vos contraintes de sécurité.
Dépannage
| Symptôme | Vérification rapide |
|---|---|
| Le lien est généré mais inutilisable. | Vérifiez externalServices, le token et l’URL de partage. |
| Le rapport est incomplet. | Vérifiez les couches actives et les restrictions de service. |
FAQ
Le destinataire retrouve-t-il la même vue ?
Oui pour les éléments inclus dans l’état de partage.
Peut-on automatiser ces flux ?
Oui, via la configuration et l’intégration front/back.
Captures à ajouter
- (Capture à ajouter)
/assets/screenshots/TODO/report-01.png: widget ouvert avec configuration standard. - (Capture à ajouter)
/assets/screenshots/TODO/report-02.png: interaction principale et résultat attendu.
Liens PDF source
US019 - Outil de rapport_885e728a43b847aaa9cbdd01215bb20f-120226-0858-126.pdfUS019a - Rapport Excel_7aa61a2206dd405380ddfd6af08db4d1-120226-0900-164.pdf