> 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/integrations/connexions-et-mapping-des-champs.md). # Connexions, cas d'usage et mapping des champs Fonctionnement des connexions, cas d'usage et mapping des champs, communs à toutes les intégrations natives Cette page décrit les concepts communs à toutes les intégrations natives. Pour les instructions propres à chaque connecteur, consultez les pages dédiées (ServiceNow, SAP LeanIX, Jira, Microsoft Teams…). ### Le magasin d'intégrations Ouvrez **Paramètres > Intégrations** dans votre workspace. Le catalogue liste toutes les intégrations disponibles, filtrables par catégorie et par objet Dastra ciblé, avec les onglets **Toutes / Installées**.

Cliquez sur une intégration pour ouvrir sa page : elle présente les **cas d'usage** disponibles (chacun avec son sens de circulation des données, ex. *ServiceNow > Dastra*), la description, et — pour les connecteurs qui s'authentifient auprès d'un outil externe — un bouton **Gérer les connexions**. ### Les connexions Une connexion enregistre ce dont Dastra a besoin pour s'authentifier auprès de l'outil externe : soit des identifiants (identifiant/mot de passe ou clé d'API, stockés chiffrés par Dastra), soit une autorisation déléguée **OAuth** (aucun mot de passe stocké par Dastra). Vous pouvez créer **plusieurs connexions vers le même outil** — par exemple une instance de production et une sandbox — et choisir celle utilisée par chaque cas d'usage. Cliquez sur **Gérer les connexions** pour ouvrir le panneau des connexions. Pour chaque connexion vous voyez : * son état de santé : **Connexion opérationnelle**, **En attente d'autorisation** (OAuth commencé mais non finalisé) ou **Connexion en erreur** (avec le dernier message d'erreur et le nombre d'erreurs), * la méthode d'authentification, * les cas d'usage qui l'utilisent. Depuis ce panneau vous pouvez **Tester** une connexion (un test réussi réinitialise aussi son état d'erreur) ou la **supprimer**.

Pour créer une connexion, cliquez sur **Ajouter une connexion** : 1. Donnez-lui un **Nom de la connexion** (ex. *Instance de production*) — facultatif, mais utile quand vous en avez plusieurs. 2. Choisissez la **Méthode d'authentification** quand le connecteur en propose plusieurs : **Basic (identifiants / clé d'API)** ou **OAuth**. 3. Renseignez les champs demandés par le connecteur (URL de l'instance, jeton d'API…). 4. Cliquez sur **Connecter** — ou **Enregistrer et se connecter** pour OAuth, qui vous redirige vers l'outil externe pour autoriser Dastra.

### Installer un cas d'usage Cliquez sur **Ajouter l'intégration** sur la carte d'un cas d'usage. Le panneau d'installation vous guide en trois étapes maximum : 1. **Connexion** — sélectionnez une connexion existante ou créez-en une depuis la liste. 2. **Configuration** — les réglages propres au connecteur (options de synchronisation, mapping des champs…). Cette étape se déverrouille dès qu'une connexion valide est sélectionnée. 3. **Webhook** — uniquement pour les connecteurs qui reçoivent des événements de l'outil externe (ex. Jira). Cette étape se déverrouille après l'enregistrement de la configuration. Une fois installé, la carte du cas d'usage vous donne : * un interrupteur **Activer**, * une entrée **Configuration** pour rouvrir la configuration, * **Lancer la synchronisation** (connecteurs d'import uniquement) pour déclencher une synchro immédiate, * **Afficher les journaux** pour consulter les exécutions passées, * **Désinstaller**.

{% hint style="warning" %} Désinstaller un cas d'usage efface les identifiants associés. Les actifs, demandes et autres enregistrements créés par l'intégration sont conservés — ils appartiennent à votre workspace. {% endhint %} ### Le mapping des champs Les cas d'usage d'import comportent une section **Mapping des champs** : pour chaque champ Dastra, choisissez le champ de l'outil externe qui l'alimente lors de la synchronisation. Un champ laissé sans source conserve son **comportement par défaut**. * Les champs Dastra obligatoires sont marqués d'un astérisque rouge ; la configuration ne peut pas être enregistrée tant qu'un champ obligatoire n'a ni source ni valeur par défaut. * **Mapper un champ** ajoute une ligne pour n'importe quel autre champ Dastra, y compris vos champs personnalisés. * La liste des champs sources est récupérée en direct depuis l'outil externe quand c'est possible : vos attributs personnalisés côté source apparaissent donc aussi.

#### Options avancées Chaque ligne dispose d'un panneau **Avancé** avec deux options : * **Valeur par défaut** — écrite lorsqu'il n'y a pas de champ source, ou en repli pour les valeurs sources non transcodées. Pour les champs de type date, vous pouvez choisir **Aujourd'hui** ou une date relative (ex. *dans 30 jours*), résolue au moment de la création de l'enregistrement. * **Transcodage des valeurs** — pour les listes fermées (statuts, étapes de cycle de vie…) : associez chaque valeur source à une valeur Dastra. Les valeurs non mappées prennent la valeur par défaut.

Valeur par défaut et transcodage des valeurs

Pour les champs de type date, la valeur par défaut peut être dynamique — résolue au moment de la création de l'enregistrement :

Une date par défaut relative (ici : dans 30 jours) sur l'échéance de la demande

#### Suggestions par IA Si l'assistant IA est activé sur votre compte, le bouton **Suggérer par IA** propose un mapping complet (et chaque ligne a son propre bouton de suggestion). Les suggestions n'écrasent jamais les champs déjà mappés et vous sont toujours soumises pour relecture avant l'enregistrement. ### Synchronisation et journaux * Les connecteurs d'import (ServiceNow, SAP LeanIX, Filerskeepers) synchronisent **quotidiennement** ; vous pouvez aussi déclencher une synchro à tout moment avec **Lancer la synchronisation**. * **Afficher les journaux** montre chaque exécution avec son résultat et ses compteurs : éléments créés, mis à jour, marqués et en erreur, avec le détail de l'erreur le cas échéant.

--- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://doc.dastra.eu/features/integrations/connexions-et-mapping-des-champs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.