Workday用コネクター

Workdayコネクタは、Reports-as-a-Service APIを使用してWorkdayからユーザー属性をインポートします。 この統合により、Nexthink Adoptでのターゲティング能力を強化するため、特定のユーザー属性をインポートすることができます。 Adoptが主なユースケースですが、インポートされたデータは、カスタムフィールドをサポートするあらゆるNexthink機能によって活用できます。 コネクタはBasic認証のみをサポートします。

前提条件

Workdayコネクタを設定する前に、以下を完了してください:

  • Workdayでカスタムレポートを作成します。

  • Nexthinkでコネクタの資格情報を設定します。 詳細については、コネクタの資格情報ドキュメンテーションを参照してください。

Workdayでレポートを作成

  1. Workdayのカスタムレポート作成ページに移動します。

  2. レポートを設定:

  • レポートタイプとしてAdvancedを選択します。

  • 意味のあるレポート名を提供します。

  1. レポートが迅速にデータを返すように、Webサービスおよびパフォーマンス最適化オプションを選択します。 データソースは収集されるデータに依存しますが、標準の推奨としてはIndexed All Workerを使用します。

  2. メールやUPNなどのユーザー識別子を含む必要なレポートフィールドを追加します。

  3. レポートを作成したら、Nexthinkで使用するためのURLを生成します。 URLフォーマットは次の通りです:https://<tenant>.workday.com/ccx/service/customreport2/<tenant>/<report_path>

  • 設定のためにURLを2つの部分に分割します:

    • コネクタの資格情報用のベースURL: https://<tenant>.workday.com

    • リソースパス: /ccx/service/customreport2/<tenant>/<report_path>

詳細については公式のWorkdayコミュニティドキュメントを参照してください。

Workday コネクタの構成

Nexthink ウェブインターフェースから:

  1. 管理 > インバウンドコネクタ を選択します。

  2. ページの右上隅にある 新しいコネクタ ボタンをクリックします。

  3. コネクタリストから Workday: ユーザ属性 を選択します。

一般 タブには以下が含まれています:

  • 名前: コネクタの意味のある名前。 この名前は管理ページに表示されます。

  • NQL ID: ワークデイコネクタをNQLクエリで参照するときに使用される一意の識別子。 最初は提案されたNQL IDを変更できますが、一度ワークフローを保存すると、NQL IDを変更できなくなります。

  • 説明: コネクタの目的と動作についての簡潔な説明。

  • スケジューリング:

    • 再発: 実行時間と再発の設定。 実行は予定時刻に始まり、1時間で分配されます。

  • 接続:

    • 資格情報: コネクタの資格情報ページから設定済みの資格情報を選択します。 BasicAuth のみサポートされています。 詳細については、コネクタの資格情報ドキュメンテーションを参照してください。

    • URL: 資格情報を選択すると、このURLは自動的に入力されます。

パラメータ タブには以下が含まれています:

  • レポートリソース: Workdayレポートへの完全なパスを入力します。 例として、 /ccx/service/customreport2//<report_path>

データマッピング タブには以下が含まれています:

  • 識別: ユーザーを識別するためにAPIレスポンスからフィールドを選択します。

    • ソース識別子 (JSONata): ユーザーを識別するAPIレスポンスで返されたフィールド名を入力します。 必要に応じて、JSONata を使用して値を変換します。

    • Nexthink 識別子: UPN(Collectorを介したUPNの収集が必要)または メールアドレス(Entra IDコネクタが必要)のいずれかを選択します。

  • フィールドマッピング: カスタムフィールドをユーザーオブジェクトに一致させるには マッピングを追加 をクリックします。

    • ソース識別子 (JSONata): ユーザーを識別するAPIレスポンスで返されたフィールド名を入力します。 必要に応じて、JSONata を使用して値を変換します。

    • Nexthink フィールド: 値をインポートするためのカスタムフィールドを選択します。

既知の制限事項

  • 従業員が同じUPNを共有している場合、UPNベースの識別は最初の1,000ユーザーレコードのみを処理します。

  • ユーザープリンシパル名(UPN)はCollectorでの設定が必要です。

  • メールアドレスにはEntra ID(Azure AD)コネクタが必要です。

  • Workday APIは次の制限を課しています:

    • レポートには後処理に応じて100万から300万のレコードが含まれることができ、グループ化が有効である場合は100万。

    • レポートの出力サイズは2GBを超えることはできません。

詳細については、公式のWorkday コミュニティ ドキュメントを参照してください。

Last updated

Was this helpful?