Paramètres
Dans l'onglet Paramètres, deux options contrôlent la synchronisation des comptes :
| Option | Description | Défaut |
|---|---|---|
| Réécriture des données | Active la mise à jour automatique de tous les champs utilisateur depuis Microsoft 365. Les champs se synchronisent automatiquement lors de modifications dans Entra ID ou lors d'une synchronisation manuelle | Actif |
| Nouveaux utilisateurs actifs par défaut | Définit si un nouvel utilisateur importé depuis Entra ID est créé automatiquement dans ECARD s'il n'existe pas | Actif |
Filtres
L'onglet Filtres permet de limiter l'import aux membres de certains groupes Office 365 :
- Groupes : l'administrateur sélectionne les groupes dont les membres doivent être importés. Seuls les utilisateurs appartenant à ces groupes seront ajoutés dans ECARD.
Il est recommandé de créer un groupe spécifique à ECARD dans votre annuaire Entra ID pour assurer que la synchronisation importe uniquement les bons utilisateurs.
Mapping des champs
L'onglet Mapping autorise l'association de chaque champ Microsoft 365 avec un champ ECARD, permettant d'adapter la synchronisation aux attributs spécifiques de votre organisation.
Le mapping est organisé en deux sections :
Segmentation
Ces champs permettent de structurer automatiquement l'arborescence de votre organisation dans ECARD.
| Champ ECARD | Champ Microsoft 365 par défaut | Description |
|---|---|---|
| Entreprise | companyName | Rattache l'utilisateur à une entité (terme de taxonomie). Si l'entité n'existe pas, elle est créée automatiquement. |
| Dossier | department | Rattache l'utilisateur à un groupe/dossier au sein de l'entité. Si le dossier n'existe pas, il est créé automatiquement. |
Attributs des utilisateurs
Ces champs définissent les données de profil synchronisées pour chaque utilisateur.
| Champ ECARD | Champ M365 par défaut | Obligatoire | Description |
|---|---|---|---|
| Email principal | userPrincipalName | Oui | Identifiant unique de l'utilisateur dans ECARD. Sert de clé de correspondance lors de la synchronisation. |
| Prénom | givenName | Oui | Prénom de l'utilisateur. |
| Nom | surname | Oui | Nom de famille de l'utilisateur. |
| Fonction | jobTitle | Non | Intitulé de poste. |
| Entreprise | companyName | Non | Nom de l'entreprise (champ texte du profil, distinct de la segmentation). |
| Autres emails | otherMails | Non | Adresses email secondaires (champ répéteur). |
| Téléphone 1 | mobilePhone | Non | Premier numéro de téléphone. Le libellé (portable/bureau) est déterminé automatiquement selon la source choisie. |
| Téléphone 2 | businessPhones | Non | Deuxième numéro de téléphone. |
| Rue | streetAddress | Non | Adresse postale (rue). |
| Ville | city | Non | Ville. |
| Code Postal | postalCode | Non | Code postal. |
| Pays | country | Non | Pays. |
| État/Région | state | Non | État ou région. |
Champs personnalisés via les Extension Attributes
Chaque champ ECARD peut également être associé à l'un des 15 attributs d'extension Active Directory (onPremisesExtensionAttributes.extensionAttribute1 à extensionAttribute15). Ces attributs sont des champs personnalisés configurés dans votre Active Directory on-premises et synchronisés vers Entra ID. Ils permettent de mapper des données métier spécifiques à votre organisation (matricule, centre de coût, code site, etc.).
Fonctionnement
- La liste déroulante de chaque ligne affiche les champs Microsoft 365 disponibles, accompagnés d'une valeur d'exemple issue du premier utilisateur de votre annuaire (ex :
givenName (Jean)). - Les champs obligatoires (marqués "Oui") doivent impérativement être mappés pour que la synchronisation fonctionne.
- Les champs non obligatoires peuvent être laissés sur "-- Sélectionner --" pour ne pas être synchronisés.
- Les modifications de mapping sont enregistrées en cliquant sur le bouton Appliquer en haut de page.
- Si la connexion à l'API Microsoft 365 échoue lors du chargement de l'onglet, un message d'avertissement s'affiche et les sélecteurs restent désactivés avec les valeurs actuellement configurées.
Exemples de mapping
- Segmentation / Entreprise ECARD -- companyName (crée automatiquement des entités et organise les utilisateurs)
- Dossier (organisation interne) -- Sous-objet d'une entreprise pour segmenter les utilisateurs
- Email principal -- userPrincipalName ou Mail
- Fonction -- jobTitle
- Nom -- surname
- Entreprise -- companyName
- Téléphone 1 -- mobilePhone
- Téléphone 2 -- businessPhones
- Adresse -- streetAddress, city, postalCode, country, state
Chaque menu déroulant présente tous les attributs disponibles via Microsoft Graph (id, displayName, givenName, mail, etc.).
Comportement important
Un champ non relié (valeur : "Aucun") ne modifiera pas les données ECARD existantes. En revanche, un champ relié mais vide dans Entra ID supprimera le contenu correspondant dans ECARD.
Exemple :
- Si Fonction n'est pas reliée et qu'un utilisateur possède déjà une fonction dans ECARD, cette information n'est pas modifiée lors des synchronisations.
- Si Fonction est reliée à jobTitle mais vide dans Entra ID, la synchronisation effacera la fonction existante dans ECARD.