Microsoft 365 Organizational Data Service - Référence d’attribut

Microsoft 365 Organizational Data Service prend en charge deux types d’attributs de données organisationnelles : les attributs réservés et les attributs personnalisés.

Attributs réservés

Les attributs réservés sont des attributs ayant une signification prédéfinie dans Microsoft 365. Microsoft définit ce que chaque attribut représente afin que les applications et services Microsoft pris en charge puissent reconnaître et utiliser les données de manière cohérente.

Par exemple, des attributs tels que Organisation, Poste, Centre de coûts et Entreprise ont une signification bien établie. Lorsque vous mappez des données de votre système source à un attribut réservé, Microsoft 365 comprend ce que ces données représentent et les expériences prises en charge peuvent les utiliser en conséquence.

Utilisez un attribut réservé lorsque les données de votre organisation correspondent à un attribut déjà défini par Microsoft 365.

Utilisez le tableau ci-dessous pour identifier l’attribut réservé approprié pour vos données et indiquer si les applications en aval le prennent en charge (oui ou non).

Nom d’attribut réservé Profil Microsoft 365 Viva Insights (y compris le tableau de bord Copilot) Viva Glint People Skills
Microsoft_PersonEmail Oui Oui Oui Non
Microsoft_FirstName Oui Non Oui Non
Microsoft_LastName Oui Non Oui Non
Microsoft_DisplayName Oui Non Oui Non
Microsoft_JobTitle Oui Oui Oui Non
Microsoft_JobDiscipline Oui Oui Oui Non
Microsoft_LevelDesignation Oui Oui Oui Non
Microsoft_Layer Oui Oui Oui Non
Microsoft_Company Oui Oui Oui Non
Microsoft_CompanyCode Oui Oui Oui Non
Microsoft_Organization Oui Oui Oui Non
Microsoft_CompanyOfficeLocation Oui Oui Oui Non
Microsoft_CompanyPostOfficeBox Oui Oui Oui Non
Microsoft_CompanyOfficeStreet Oui Oui Oui Non
Microsoft_CompanyOfficeCity Oui Oui Oui Non
Microsoft_CompanyOfficeState Oui Oui Oui Non
Microsoft_CompanyOfficeCountryOrRegion Oui Oui Oui Non
Microsoft_CompanyOfficePostalCode Oui Oui Oui Non
Microsoft_ManagerEmail Oui Oui Oui Non
Microsoft_EmploymentType Oui Oui Oui Non
Microsoft_SecondaryJobTitle Oui Non Non Oui
Microsoft_HireDate Oui Oui Oui Non
Microsoft_EmployeeID Oui Non Oui Non
Microsoft_CostCenter Oui Oui Oui Non
Microsoft_Division Oui Oui Oui Non
Microsoft_Phone Oui Non Non Non
Microsoft_AssistantsEmail Oui Non Non Non
Microsoft_DotLineManagersEmailAndLabel Oui Non Non Non
Microsoft_UserSkillNames Non Non Non Oui
Microsoft_HourlyRate Non Oui Non Non
Microsoft_SupervisorIndicator Non Oui Oui Non
Microsoft_WeeklyBadgeOnsiteDays Non Oui Non Non
Microsoft_GlintEmploymentStatus Non Non Oui Non
Microsoft_ManagerID Non Non Oui Non
Microsoft_EndDate Non Non Oui Non
Microsoft_EmploymentStatus Non Oui Non Non

Description de l’attribut

Nom d’attribut réservé Description Type de données Exemple
Microsoft_PersonEmail Identificateur unique d’un enregistrement d’employé. Il peut s’agir de l’adresse SMTP principale ou de l’alias de messagerie de l’employé. E-mail person.name@contoso.com
Microsoft_FirstName Prénom du salarié. Chaîne Alexa
Microsoft_LastName Nom de famille de l’employé. Chaîne Lopez
Microsoft_DisplayName Nom préféré de l’employé à afficher. Il s’agit du nom d’affichage public qu’un employé choisit de répertorier. Chaîne Alexa Smith
Microsoft_JobTitle Titre d’emploi public de l’employé. Chaîne Ingénieur logiciel
Microsoft_JobDiscipline Discipline à laquelle appartient un employé. Pour obtenir des informations plus exploitables, évitez d’utiliser trop peu ou trop de disciplines de travail uniques. Il s’agit de la discipline du travail public. Chaîne Gestion financière
Microsoft_LevelDesignation Niveau qui représente l’expérience, le niveau de gestion ou l’ancienneté d’un employé au sein du organisation. Il s’agit de la désignation de niveau public utilisée par votre entreprise. Chaîne Directeur
Microsoft_Layer La position d’un employé au sein de la hiérarchie organisationnelle, exprimée en tant que distance par rapport au leader supérieur de l’organisation. Par exemple, le PDG se trouve à la couche 0. Évitez d’utiliser trop ou trop de couches uniques. Il s’agit de la couche qui est disponible publiquement dans votre entreprise. Entier 2
Microsoft_Company Nom de l’entreprise. String Contoso
Microsoft_CompanyCode Numéro d’entité juridique de la société ou de sa subdivision. String Réf. A2518
Microsoft_Organization Nom du organisation interne ou du service auquel appartient un employé. Chaîne Planification et analyse financières
Microsoft_CompanyOfficeLocation L’emplacement du bureau de l’entreprise d’un employé. Il s’agit d’un code d’emplacement, comme un numéro de bâtiment, un étage ou une pièce. Il ne doit pas s’agir du bureau à domicile ou de l’adresse personnelle d’un employé. Chaîne 2N
Microsoft_CompanyPostOfficeBox Numéro de boîte postale de l’entreprise accessible au public. Chaîne Boîte de commande 12
Microsoft_CompanyOfficeStreet Adresse postale du bureau de l’entreprise accessible au public. Chaîne NE 12th Street
Microsoft_CompanyOfficeCity La ville d’adresse du bureau accessible au public. Chaîne Redmond
Microsoft_CompanyOfficeState État du bureau de la société accessible au public. Chaîne Washington
Microsoft_CompanyOfficeCountryOrRegion Pays ou région du bureau de l’entreprise mis à disposition publiquement. Il s’agit d’une valeur de chaîne de format libre, par exemple, « États-Unis ». Chaîne États-Unis
Microsoft_CompanyOfficePostalCode Code postal du bureau de l’entreprise accessible au public. Chaîne 98004
Microsoft_ManagerEmail Identificateur unique du responsable d’un employé. Il peut s’agir de l’adresse SMTP principale ou de l’alias de messagerie du responsable. Pour les PDG, cela peut être laissé vide. E-mail manager.name@contoso.com
Microsoft_EmploymentType Permet de classer les employés selon leur type d’emploi. String Regular
Microsoft_SecondaryJobTitle Titre du poste secondaire de l’employé. Chaîne Ingénieur logiciel
Microsoft_HireDate Date à laquelle un employé a commencé à travailler. Si un employé a plusieurs dates d’embauche, il est préférable d’utiliser la date d’embauche la plus récente. Viva Glint utilise la date d’embauche pour dériver les groupes de titularisation. DateTime 12/31/2021
Microsoft_EmployeeID Identifiant unique attribué à chaque employé. String E123456
Microsoft_CostCenter Centre de coûts financiers auquel l’employé est affecté. String CC-7890
Microsoft_Division Division ou unité commerciale à laquelle appartient l’employé. String Ressources humaines
Microsoft_Phone Numéro de téléphone professionnel de l’employé. String 123-456-7890
Microsoft_DotLineManagersEmailAndLabel Responsable hiérarchique qui supervise le travail d’un employé entre des projets ou des fonctions sans être son responsable direct, ainsi que son étiquette de relation. Prend en charge plusieurs valeurs d’e-mail ou de chaîne séparées par des points-virgules. TupleList : Email | Chaîne mgr1@contoso.com | responsable technique ; mgr2@contoso.com | Chef de projet
Microsoft_AssistantsEmail Personne de soutien désignée pour un employé, qui est généralement un cadre supérieur ou un cadre supérieur. Responsable de la gestion du calendrier, de la coordination et du soutien administratif. TupleList : Email adam@contoso.com; alex@contoso.com
Microsoft_UserSkillNames Compétences de l’employé, séparées par un point-virgule. Cette valeur est utilisée pour l’inférence Viva Skills. Il est donc important de vous assurer que le champ chargé ici est un champ que vous souhaitez utiliser pour générer des compétences pour vos utilisateurs. String Gestion de projet ; organization
Microsoft_HourlyRate Le salaire d’un employé est représenté sous forme de taux horaire. Double 50.25
Microsoft_SupervisorIndicator Le status de manager de chaque employé en tant que IC (contributeur individuel), Mngr (manager) ou Mngr+ (manager des managers). Chaîne (IC/Mngr/Mngr+) Mngr
Microsoft_WeeklyBadgeOnsiteDays Nombre moyen réel de jours par semaine qu’un employé travaille sur le site de travail principal de l’entreprise. Doit être un nombre compris entre 0 et 7. Entier 1
Microsoft_ManagerID ID d’employé du responsable. String E246801
Microsoft_EndDate Date à laquelle l’association d’un employé à l’organisation prend fin. DateTime 12/31/2021
Microsoft_EmploymentStatus Indique le status d’emploi actuel d’une personne au sein de l’organisation. String Actif
Microsoft_GlintEmploymentStatus Indique le status d’emploi actuel d’un employé au sein de l’organisation. Doit être « ACTIF » ou « INACTIF », en majuscules. String ACTIF

Attribuer au mappage d’application

Nom d’attribut réservé Propriété dans le schéma de profil utilisateur Microsoft 365 Propriété dans Viva Insights
Microsoft_PersonEmail S/O

Le courrier électronique est converti en objectId Microsoft Entra de l’utilisateur final et est utilisé pour le traitement interne.
ID de personne
Microsoft_ManagerEmail positions -> manager -> userId

Le courrier électronique est converti en ID d’objet Microsoft Entra pour le responsable et stocké dans le profil utilisateur Microsoft 365.
ID du manager
Microsoft_DotLineManagersEmailAndLabel positions-collègues-userid>>, relation = dotlinemanager S/O
Microsoft_AssistantsEmail positions-collègues-userid>>, relation = assistant S/O
Microsoft_Organization positions -> positionDetail -> companyDetail -> département Organisation
Microsoft_LevelDesignation positions -> positionDetail -> level LevelDesignation
Microsoft_JobDiscipline positions -> positionDetail -> role Type de fonction
Microsoft_Layer positions -> positionDetail -> layer Couche
Microsoft_FirstName noms -> prénom S/O
Microsoft_LastName noms -> nom S/O
Microsoft_DisplayName noms -> displayName S/O
Microsoft_JobTitle positions -> positionDetail -> jobTitle EmployeeJobTitle
Microsoft_CompanyOfficeLocation positions -> positionDetail -> companyDetail -> officeLocation Lieu
Microsoft_CompanyPostOfficeBox positions -> positionDetail -> companyDetail -> physicalAddress -> postOfficeBox CompanyPostOfficeBox
Microsoft_CompanyOfficeStreet positions -> positionDetail -> companyDetail -> physicalAddress -> street CompanyOfficeStreet
Microsoft_CompanyOfficeCity positions -> positionDetail -> companyDetail -> physicalAddress -> city CompanyOfficeCity
Microsoft_CompanyOfficeState positions -> positionDetail -> companyDetail -> physicalAddress -> state CompanyOfficeState
Microsoft_CompanyOfficeCountryOrRegion positions -> positionDetail -> companyDetail -> physicalAddress -> countryOrRegion CountryOrRegion
Microsoft_CompanyOfficePostalCode positions -> positionDetail -> companyDetail -> physicalAddress -> postalCode CompanyOfficePostalCode
Microsoft_Company positions -> positionDetail -> companyDetail -> displayName OrgCompany
Microsoft_CompanyCode postes -> positionDetail -> companyDetail ->companyCode OrgCompanyCode
Microsoft_SecondaryJobTitle positions -> positionDetail -> secondaryJobTitle S/O
Microsoft_EmploymentType positions-positionDetail-EmployeeType>> Type d’emploi
Microsoft_HireDate anniversaires-date>[type='originalHireDate'] DateEmbauche
Microsoft_EmployeeID positions-positionDetail-employeeid>> S/O
Microsoft_CostCenter positions-> positionDetail ->company-costcenter> S/O
Microsoft_Division positions-> positionDetail ->company-division> S/O
Microsoft_Phone numéro_de_>téléphone(type=entreprise) S/O

Attributs personnalisés

Les attributs personnalisés sont des attributs spécifiques aux données de votre organisation et n’ont pas de signification prédéfinie dans Microsoft 365.

Par exemple, votre organization peut conserver des attributs tels que le segment d’effectifs, le programme de leadership ou la population d’employés qui sont significatifs pour votre entreprise, mais qui ne sont pas représentés par un attribut réservé existant.

Utilisez un attribut personnalisé lorsqu’il n’existe pas d’attribut réservé approprié à mapper pour les informations que vous souhaitez importer.

Comment choisir des attributs

Lors de la préparation de vos données organisationnelles :

  • Utilisez un attribut réservé lorsqu’il correspond à la signification de vos données sources.

  • Utilisez un attribut personnalisé lorsqu’aucun attribut réservé ne représente fidèlement les données.

  • Ne mappez pas des données à un attribut réservé simplement parce que les noms sont similaires. La signification des données doit correspondre à la définition de l’attribut réservé.