Workday から代名詞情報を取得するように Microsoft Entra プロビジョニングを構成する
この記事では、次の 2 つの人事主導のプロビジョニング アプリをカスタマイズして、Workday から代名詞情報を取得する方法について説明します。
Workday の代名詞情報について
Workday では、Workday 2021 R1 リリースでワーカーがワーカー プロファイルの代名詞情報を表示する機能が導入されました。 Workday Web Services (WWS) API 呼び出しを使用して代名詞データをフェッチする機能は、Workday 2022 R1 リリースの Get_Workers API バージョン 38.1 で導入されました。
注意
この記事の特定の Workday コミュニティ ノートとドキュメントへのリンクには、Workday コミュニティ アカウントの資格情報が必要です。 必要なアクセス権を取得するには、Workday 管理者またはパートナーに確認してください。
Workday で代名詞データを有効にする
このセクションでは、Workday で代名詞データを有効にするために必要な手順について説明します。 示されている手順の完了に Workday 管理者を参加させることをお勧めします。
代名詞の表示と共有の基本設定が Workday ガイドラインに従って有効になっていることを確認します。 次の Workday ドキュメントを参照してください。
Workday の [代名詞の管理] タスクを使用して、Workday テナントで優先代名詞データ (HE/HIM、SHE/HER、THEY/THEM) を定義します。
Workday の [ローカライズ設定の管理] タスク -> [個人情報] 領域を使用して、各国/リージョンの代名詞データをアクティブ化します。
Microsoft Entra 統合で使用する Workday 統合システム セキュリティ グループを選択します。 セキュリティ グループのドメイン アクセス許可を更新し、Workday ドメイン [レポート: パブリック プロファイル] に対する GET アクセス権を持ちます。
保留中のセキュリティ ポリシーの変更をアクティブ化します。
テストのために Workday テナント内のワーカーを選択します。 [個人情報の編集] タスクを使用して、このワーカーの代名詞情報を設定します。 ワーカーがパブリック プロファイルの基本設定ですべてのユーザーに代名詞の表示を有効にしていることを確認します。
Workday Studio を使用して、Workday Microsoft Entra 統合システム ユーザーを使用するテスト ユーザーに対して Get_Workers API バージョン 38.1 を呼び出します。 SOAP 要求ヘッダーで、オプション Include_Reference_Descriptors_In_Response を指定します。
<bsvc:Workday_Common_Header> <bsvc:Include_Reference_Descriptors_In_Response>true</bsvc:Include_Reference_Descriptors_In_Response> </bsvc:Workday_Common_Header>Get_Workers 応答で、代名詞情報を表示します。
注意
Get_Workers の応答で代名詞データを取得できない場合は、Workday ドメインのセキュリティ アクセス許可のトラブルシューティングを行います。 統合セキュリティ グループに、代名詞データへのアクセスを許可するセグメント化されたセキュリティ グループへのアクセス許可があることを確認します。
Get_Workers の応答で代名詞データが使用可能であることを確認したら、Microsoft Entra プロビジョニング アプリ構成を更新する次の手順に進みます。
Workday から代名詞を取得するために、Workday Web Services の v38.1 を使用して Workday にクエリを実行するように Microsoft Entra プロビジョニング アプリを更新します。 運用環境で変更を実装する前に、まずテスト/サンドボックス環境でこの構成をテストすることをお勧めします。
アプリケーション管理者以上の権限で Microsoft Entra 管理センターにサインインします。
ID>アプリケーション>エンタープライズ アプリケーション を参照します。
Workday から Active Directory/Microsoft Entra ユーザー プロビジョニング アプリケーションを選択し、[プロビジョニング] に移動します。
[管理者資格情報] セクションで、次に示すように [テナント URL] を更新して、Workday Web Service バージョン v38.1 を含めます。
[属性マッピング] ブレードを開きます。 下にスクロールし、 [詳細オプションの表示] をクリックします。 [Edit attribute list for Workday](Workday の属性リストの編集) をクリックします。
既定の WWS API バージョン v21.1 を使用するようにプロビジョニング アプリが構成されている場合は、この記事を参照して、各属性の XPATH を確認して更新します。
XPATH を使用して PreferredPronoun という名前の新しい属性を追加します
/wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Personal_Information_Data/wd:Pronoun_Reference/@wd:Descriptor変更を保存します。
新しい属性マッピングを追加して、Workday 属性 PreferredPronoun を AD/Microsoft Entra ID の任意の属性にフローできるようになりました。
代名詞情報を表示名の一部として組み込む場合は、次の式を使用するように displayName 属性の属性マッピングを更新できます。
Switch([PreferredPronoun], Join("", [PreferredNameData], " (", [PreferredPronoun], ")"), "", [PreferredNameData])ワーカー Aaron Hall が Workday で代名詞情報を
HE/HIMと設定している場合、上記の式によって、Microsoft Entra ID の表示名が Aaron Hall (HE/HIM) に設定されます変更を保存します。
オンデマンド プロビジョニングを使用して 1 人のユーザーの構成をテストします。