Share

Nom fonctionnel: Partage

Partage une vue cartographique reproductible via un lien ou un code d’intégration.

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é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

Actions de partage: mail, réseaux sociaux, lien à copier.
Bloc d’intégration HTML (embed).
Gestion de l’état partagé (emprise, couches, visibilité, transparence, basemap).

Parcours utilisateur (le plus courant)

Ouvrez l’onglet de partage depuis le groupe Export.
Choisissez un canal puis copiez le lien ou le code.
Testez le lien dans une session privée pour valider la reproductibilité.

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 Share.
`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/shareConfigSchema
API technique du widget: classes/ShareService
Code source (déclaration): packages/common/src/lib/widgets/export/share/share.declaration.ts
Code source (config): packages/common/src/lib/widgets/export/share/share.config.ts

Exemple minimal (copier-coller)

{
    "widgetId": "share",
    "widgetClass": "Share",
    "active": false,
    "inToolbar": true,
    "config": {}
}

Exemple avancé

{
    "widgetId": "share-advanced",
    "widgetClass": "Share",
    "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/share-01.png: widget ouvert avec configuration standard.
(Capture à ajouter) /assets/screenshots/TODO/share-02.png: interaction principale et résultat attendu.

Liens PDF source

US030 - Partager une carte_e02b237408724547a5d18180804628fa-120226-0900-174.pdf