使用下面的视频来帮助确定要用于导入属性的数据连接器。 然后，使用下表了解有关 Microsoft 365 组织数据服务属性及其映射方式的详细信息。
公共属性
下表提供了有关 Microsoft 365 组织数据服务公共属性的更多详细信息。
| 属性 | 说明 | 数据类型 | 示例 |
|---|---|---|---|
| Microsoft_PersonEmail | 员工记录的唯一标识符。 它可以是员工的主要 SMTP 地址或电子邮件别名。 | 电子邮件 | person.name@contoso.com |
| Microsoft_ManagerEmail | 员工经理的唯一标识符。 它可以是管理员的主要 SMTP 地址或电子邮件别名。 对于首席执行官来说，这可以留空。 | 电子邮件 | manager.name@contoso.com |
| Microsoft_DotLineManagersEmailAndLabel | 虚线经理，负责监督员工跨项目或职能部门的工作，而不是他们的直接经理，以及他们的关系标签。 支持多个以分号分隔的电子邮件或字符串值。 | TupleList： Email |字符串 | mgr1@contoso.com |技术主管; mgr2@contoso.com | 项目主管 |
| Microsoft_AssistantsEmail | 员工的指定支持人员，通常是高管或高级领导。 负责日历管理、协调和行政支持。 | TupleList： Email | adam@contoso.com; alex@contoso.com |
| Microsoft_Organization | 员工所属的内部组织或部门名称。 | String | 财务规划和分析 |
| Microsoft_LevelDesignation | 表示员工在组织内的体验、管理级别或资历的级别。 这是公司使用的任何公开级别指定。 | String | 主管 |
| Microsoft_JobDiscipline | 员工所属的规则。 若要获得更多可操作的见解，请避免使用过少或过多的唯一作业规则。 这是公开作业规则。 | String | 财务管理 |
| Microsoft_Layer | 员工在组织层次结构中的位置，以其与组织最高领导之间的距离表示。 例如，CEO 位于第 0 层。 避免使用过少或过多的唯一层。 这是公司公开发布的层。 | 整数 | 2 |
| Microsoft_FirstName | 员工的名字。 | String | Alexa |
| Microsoft_LastName | 员工的姓氏。 | String | Smith |
| Microsoft_DisplayName | 要显示的员工的首选名称。 这是员工选择列出的公开显示名称。 | String | Alexa Smith |
| Microsoft_JobTitle | 公开发布的员工职务。 | String | 软件工程师 |
| Microsoft_CompanyOfficeLocation | 员工的公司办公地点。 这是一个位置代码，如建筑物号、楼层或房间。 这不应是员工的家庭办公室或个人地址。 | String | 2N |
| Microsoft_CompanyPostOfficeBox | 这是公开发布的公司邮政编号。 | String | PO 邮箱 12 |
| Microsoft_CompanyOfficeStreet | 这是公开发布的公司办公室街道地址。 | String | NE 12 号街 |
| Microsoft_CompanyOfficeCity | 这是公开可用的办公地址城市。 | String | 雷德蒙德 |
| Microsoft_CompanyOfficeState | 这是公开可用的公司办公室状态。 | String | 华盛顿州 |
| Microsoft_CompanyOfficeCountryOrRegion | 这是公开发布的公司办公国家或地区。 它是任意格式的字符串值，例如“美国”。 | String | 美国 |
| Microsoft_CompanyOfficePostalCode | 公开可用的公司办公室邮政编码。 | String | 98004 |
| Microsoft_Company | 公司名称。 | String | Contoso |
| Microsoft_CompanyCode | 公司或其子部门的法人编号。 | String | A2518 |
| Microsoft_SecondaryJobTitle | 员工的次要职务。 | String | 软件工程师 |
| Microsoft_EmploymentType | 用于根据雇员的雇佣类型对员工进行分类。 | String | Regular |
| Microsoft_HireDate | 员工开始受雇的日期。 如果员工有多个入职日期，最好使用最近的入职日期。 Viva Glint 使用“雇用日期”派生终身期组。 | 日期时间 | 12/31/2021 |
| Microsoft_EmployeeID | 分配给每个员工的唯一标识符。 | String | E123456 |
| Microsoft_CostCenter | 员工分配到的财务成本中心。 | String | CC-7890 |
| Microsoft_Division | 员工所属的部门或业务部门。 | String | 人力资源 |
| Microsoft_Phone | 员工的工作电话号码。 | String | 123-456-7890 |
注意
Microsoft_LevelDesignation 和 Microsoft_Layer 属性在 Microsoft Entra 中没有相应的属性。 因此，将这些值添加到 Microsoft 365 用户配置文件的唯一方法是使用 Microsoft 365 组织数据服务功能。
属性到属性映射
下表显示 Microsoft 365 组织数据服务公共属性如何映射到 Microsoft 365 用户配置文件架构中的属性。
| .csv 文件中的属性（列标题） | Microsoft 365 用户配置文件架构中的属性 | Viva Insights 中的属性 |
|---|---|---|
| Microsoft_PersonEmail | 不适用 电子邮件将转换为最终用户的 Microsoft Entra objectId，并用于内部处理。 |
PersonID |
| Microsoft_ManagerEmail | 位置 -> 经理 -> userId 电子邮件将转换为管理员的 Microsoft Entra objectId，并存储在 Microsoft 365 用户配置文件中。 |
ManagerID |
| Microsoft_DotLineManagersEmailAndLabel | positions-colleagues-userid>>， relationship = dotlinemanager | 不适用 |
| Microsoft_AssistantsEmail | positions-colleagues-userid>>， relationship = 助手 | 不适用 |
| Microsoft_Organization | 位置 -> positionDetail -> companyDetail -> 部门 | 组织 |
| Microsoft_LevelDesignation | 位置 -> positionDetail -> 级别 | LevelDesignation |
| Microsoft_JobDiscipline | 位置 -> positionDetail -> 角色 | FunctionType |
| Microsoft_Layer | 位置 -> positionDetail -> 层 | 层 |
| Microsoft_FirstName | 名称 -> 第一个 | 不适用 |
| Microsoft_LastName | 名称 -> 最后一个 | 不适用 |
| Microsoft_DisplayName | 名称 -> 显示名称 | 不适用 |
| Microsoft_JobTitle | 位置 -> positionDetail -> 职务 | EmployeeJobTitle |
| Microsoft_CompanyOfficeLocation | 位置 -> positionDetail -> companyDetail -> 办公地址 | 位置 |
| Microsoft_CompanyPostOfficeBox | 位置 -> positionDetail -> companyDetail -> physicalAddress -> 邮箱 | CompanyPostOfficeBox |
| Microsoft_CompanyOfficeStreet | 位置 -> positionDetail -> companyDetail -> physicalAddress -> 街道 | CompanyOfficeStreet |
| Microsoft_CompanyOfficeCity | 位置 -> positionDetail -> companyDetail -> physicalAddress -> 城市 | CompanyOfficeCity |
| Microsoft_CompanyOfficeState | 位置 -> positionDetail -> companyDetail -> physicalAddress -> 州 | CompanyOfficeState |
| Microsoft_CompanyOfficeCountryOrRegion | 位置 -> positionDetail -> companyDetail -> physicalAddress -> 国家或地区 | CountryOrRegion |
| Microsoft_CompanyOfficePostalCode | 位置 -> positionDetail -> companyDetail -> physicalAddress -> 邮政编码 | CompanyOfficePostalCode |
| Microsoft_Company | 位置 -> positionDetail -> companyDetail -> 显示名称 | OrgCompany |
| Microsoft_CompanyCode | positions -> positionDetail -> companyDetail ->companyCode | OrgCompanyCode |
| Microsoft_SecondaryJobTitle | positions -> positionDetail -> secondaryJobTitle | 不适用 |
| Microsoft_EmploymentType | positions-positionDetail-EmployeeType>> | EmploymentType |
| Microsoft_HireDate | anniversaries-date>[type='originalHireDate'] | HireDate |
| Microsoft_EmployeeID | positions-positionDetail-employeeid>> | 不适用 |
| Microsoft_CostCenter | positions-> positionDetail ->company-costcenter> | 不适用 |
| Microsoft_Division | positions-> positionDetail ->company-division> | 不适用 |
| Microsoft_Phone | phones-number> (type=business) | 不适用 |
非公共属性
下表提供了有关 Microsoft 365 组织数据服务 非公开 属性的更多详细信息。
| 属性 | 说明 | 数据类型 | 示例 |
|---|---|---|---|
| Microsoft_UserSkillNames | 员工具备的技能，用分号隔开。 此值用于 Viva 技能推理，因此请务必确保此处上传的字段是要用于为用户生成技能的字段。 | String | 项目管理;设备 |
| Microsoft_HourlyRate | 员工的工资以小时费率表示。 | 双精度 | 50.25 |
| Microsoft_SupervisorIndicator | 每个员工的经理状态为 IC (个人参与者) 、Mngr (经理) 或 Mngr+ (经理的经理) 。 | 字符串 (IC/mngr/mngr+) | mngr |
| Microsoft_WeeklyBadgeOnsiteDays | 员工每周在公司主要工作场所工作的实际平均天数。 必须是介于 0 和 7 之间的数字。 | 整数 | 1 |
| Microsoft_ManagerID | 经理的员工 ID。 | String | E246801 |
| Microsoft_EndDate | 员工与组织关联的结束日期。 | 日期时间 | 12/31/2021 |
| Microsoft_EmploymentStatus | 指示组织内个人的当前就业状况。 | String | 活动 |
| Microsoft_GlintEmploymentStatus | 指示员工在组织内的当前就业状况。 必须为“ACTIVE”或“INACTIVE”，全部大写。 | String | 活动 |
属性到应用映射
| 属性 | Viva Insights 中的属性 |
|---|---|
| Microsoft_UserSkillNames | 不适用 – 这仅用于 People Skills |
| Microsoft_HourlyRate | 按小时收费 |
| Microsoft_SupervisorIndicator | 主管 |
| Microsoft_WeeklyBadgeOnsiteDays | WeeklyBadgeOnsiteDays |
| Microsoft_ManagerID | 不适用 |
| Microsoft_EndDate | 不适用 |
| Microsoft_EmploymentStatus | CurrentEmploymentStatus |
| Microsoft_GlintEmploymentStatus | 不适用 |