Microsoft 365 組織データ サービス - 属性リファレンス

以下のビデオを使用すると、属性のインポートに使用するデータ コネクタを特定できます。 次に、次の表を使用して、Microsoft 365 組織データ サービス属性とそのマッピング方法について詳しく説明します。

パブリック属性

次の表に、Microsoft 365 組織データ サービスのパブリック属性に関する詳細を示します。

属性 説明 データ型 例
Microsoft_PersonEmail 従業員レコードの一意識別子。 従業員のプライマリ SMTP アドレスまたはメール エイリアスを使用できます。 電子メール person.name@contoso.com
Microsoft_ManagerEmail 従業員の上司の一意識別子。 これは、マネージャーのプライマリ SMTP アドレスまたは電子メール エイリアスにすることができます。 CEOの場合、これは空白のままにしてもかまいません。 電子メール 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 私書箱 12
Microsoft_CompanyOfficeStreet これは、一般公開されている会社のオフィスの住所です。 String NE 12th Street
Microsoft_CompanyOfficeCity これは、一般公開されているオフィスアドレスの市区町村です。 String レドモンド
Microsoft_CompanyOfficeState これは、一般公開されている会社のオフィスの州です。 String ワシントン
Microsoft_CompanyOfficeCountryOrRegion これは、一般公開されている会社のオフィスの国または地域です。 自由形式の文字列値です。例: 「米国」。 String 米国
Microsoft_CompanyOfficePostalCode 公開されている会社の郵便番号。 String 98004
Microsoft_Company 会社名。 String Contoso
Microsoft_CompanyCode 会社またはその下位部門の法人番号。 文字列 A2518
Microsoft_SecondaryJobTitle 従業員の 2 番目の役職。 String ソフトウェア エンジニア
Microsoft_EmploymentType 雇用タイプに基づいて従業員を分類するために使用されます。 文字列 Regular
Microsoft_HireDate 従業員が雇用を開始した日付。 従業員の入社日が複数ある場合は、最新の入社日を使用することをお勧めします。 Viva Glint では、採用日を使用して在職期間グループを導き出します。 DateTime 12/31/2021
Microsoft_EmployeeID 各従業員に割り当てられる一意の識別子。 文字列 E123456
Microsoft_CostCenter 従業員が割り当てられている財務原価センタ。 文字列 CC-7890
Microsoft_Division 従業員が所属する部門または部署。 文字列 人事
Microsoft_Phone 従業員の勤務先の電話番号。 文字列 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 positions -> manager -> userId

メールはマネージャーの Microsoft Entra objectId に変換され、Microsoft 365 ユーザー プロファイルに保存されます。
ManagerID
Microsoft_DotLineManagersEmailAndLabel positions->colleagues->userid, relationship = dotlinemanager 該当なし
Microsoft_AssistantsEmail positions->colleagues->userid, relationship = アシスタント 該当なし
Microsoft_Organization positions -> positionDetail -> companyDetail -> 部署 組織
Microsoft_LevelDesignation positions -> positionDetail -> level LevelDesignation
Microsoft_JobDiscipline positions -> positionDetail -> role FunctionType
Microsoft_Layer positions -> positionDetail -> layer Layer
Microsoft_FirstName 名前 -> 名前 該当なし
Microsoft_LastName 名前 -> 名字 該当なし
Microsoft_DisplayName names -> displayName 該当なし
Microsoft_JobTitle positions -> positionDetail -> jobTitle EmployeeJobTitle
Microsoft_CompanyOfficeLocation positions -> positionDetail -> companyDetail -> officeLocation 場所
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 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 Skills 推論に使用されるため、ここにアップロードしたフィールドが、ユーザーのスキルを生成するために使用するフィールドであることを確認することが重要です。 文字列 プロジェクト管理;organization
Microsoft_HourlyRate 従業員の給与は時給で表されます。 倍精度浮動小数点数 50.25
Microsoft_SupervisorIndicator 各従業員のマネージャー ステータスは、IC (個人貢献者)、Mngr (マネージャー)、または Mngr+ (マネージャーのマネージャー) です。 文字列 (IC/MNGR/MNGR+) mngr
Microsoft_WeeklyBadgeOnsiteDays 従業員が会社の主な職場で勤務している週あたりの実際の平均日数。 0 から 7 までの数値でなければなりません。 整数 1
Microsoft_ManagerID 上司の従業員 ID。 文字列 E246801
Microsoft_EndDate 従業員と organization との関連付けが終了する日付。 DateTime 12/31/2021
Microsoft_EmploymentStatus organization内の個人の現在の雇用状況を示します。 文字列 アクティブ
Microsoft_GlintEmploymentStatus organization 内の従業員の現在の雇用状況を示します。 "ACTIVE" または "INACTIVE" にする必要があります。 文字列 アクティブ

属性からアプリへのマッピング

属性 Viva Insights のプロパティ
Microsoft_UserSkillNames N/A – これは People Skills にのみ使用されます
Microsoft_HourlyRate HourlyRate
Microsoft_SupervisorIndicator SupervisorIndicator
Microsoft_WeeklyBadgeOnsiteDays WeeklyBadgeOnsiteDays
Microsoft_ManagerID 該当なし
Microsoft_EndDate 該当なし
Microsoft_EmploymentStatus CurrentEmploymentStatus
Microsoft_GlintEmploymentStatus N/A