Workdayコネクタ
ワークデイコネクタは、Reports-as-a-Service APIを使用してユーザー属性をワークデイからインポートします。 この統合により、特定のユーザー属性をインポートしてNexthink Adoptでのターゲティング能力を向上させることができます。 Adoptが主な使用ケースですが、インポートされたデータは、カスタムフィールドをサポートする任意のNexthink機能でも活用できます。 このコネクタは、OAuth 2.0およびBasic Auth認証方法に対応しています。
前提条件
ワークデイコネクタを設定する前に、以下を完了してください:
ワークデイでカスタムレポートを作成する。
OAuth 2.0 Authorization Code Grantを使用してワークデイAPIクライアントを登録する。
Nexthinkでコネクタ資格情報を設定する。 詳細は、Connector credentialsの文書を参照してください。
ワークデイでのレポート作成
ワークデイのカスタムレポート作成ページに移動します。
レポートを設定する:
レポートタイプとしてアドバンスを選択します。
意味のあるレポート名を提供してください。
レポートが迅速にデータを返すことを保証するために、Web Service および Optimized for Performance オプションを選択します。 データソースは収集されるデータに依存しますが、標準的な推奨はIndexed All Workerを使用することです。
ユーザー識別子（email や UPNなど）を含む必要なレポートフィールドを追加します。
レポートを作成した後、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でのOAuth 2.0クライアントアプリケーションの作成
WorkdayでEdit Tenant Setup – Securityを開きます。
OAuth 2.0設定でOAuth 2.0クライアント有効化チェックボックスを有効にします。
Register API Clientに移動します。
次のフィールドを指定します:
クライアント名: クライアントアプリの名前を入力します。
クライアント認可タイプ: Authorization Code Grant を選択します。
コード交換用証拠鍵（PKCE）サポート: いいえに設定します; PKCEはサポートされていません。
アクセストークンタイプ: Bearerを選択します。
リダイレクトURI: Nexthinkのコネクタ資格情報設定ページに記載されたリダイレクトURIを入力します。 詳細は、Connector credentialsを参照してください。
有効期限のないリフレッシュトークン: はいに設定します。
スコープ（機能領域）: 取得したいデータを含む機能領域(Workdayドメイン）を有効にします。
Workdayオーナーのスコープを含む: はいを選択します。
クライアントアプリが作成されたら、次の値をコピーし、Nexthinkのコネクタ資格情報設定ページに入力します。 Nexthink UIに表示されるラベルが括弧内に示されています。
Workday REST API エンドポイント (URL アドレス)
トークンエンドポイント(アクセストークンURL)
認可エンドポイント(認可コードURL)
クライアントIDとクライアントシークレット
コネクタ資格情報の設定
Workday APIクライアントの資格情報を使用して、Nexthinkウェブインターフェースで新しいコネクタ資格情報を作成します。 詳細は、Connector credentialsを参照してください。
ワークデイコネクタの設定
Nexthinkウェブインターフェースから:
管理 > インバウンドコネクタ に移動します。
ページの右上の新しいコネクタボタンをクリックします。
コネクタリストからWorkday: User Attributes を選択します。
一般タブには以下が含まれます:
名前: コネクタの内容を表す意味のある名前。 この名前は管理ページに表示されます。
NQL ID: NQLクエリでワークデイコネクタを参照する際に使用されるコネクタの一意識別子。 ワークフローを保存するとNQL IDは変更できませんが、初めに提案されたNQL IDを修正できます。
説明: コネクタの目的と動作についての簡単な説明。
スケジューリング:
繰り返し: 実行時間と繰り返しを設定します。 実行は予定された時間に開始され、一時間にわたり分配されます。
接続:
資格情報: コネクタ資格情報ページから事前設定された資格情報を選択します。 詳細については、コネクタ資格情報 ドキュメントを参照してください。
URL: 資格情報を選択すると、このURLが自動的に入力されます。
パラメータタブには以下が含まれます:
レポートリソース: ワークデイレポートのフルパスを入力します。 他の値（例: format=xml）で上書きされないようにしてください。例:
/ccx/service/customreport2//<report_path>
データマッピングタブには以下が含まれます:
既知の制限
証拠キーコード交換(PKCE)はサポートされていません。
このコネクタは、同期あたり3百万件を超えるレコードを処理できません。
従業員が同じUPNを共有している場合、UPNをベースとした識別は、最初の1,000件のユーザレコードのみを処理します。
ユーザープリンシパル名(UPN)は、Collectorにおける設定が必要です。
メールアドレスには、Entra ID (Azure AD)コネクタが必要です。
Workday APIには以下の制限が課されています:
レポートはポストプロセスによっては1百万から3百万件のレコードを含むことができます。グルーピングが有効な場合は1百万件。
レポート出力のサイズは2GBを超えることができません。
詳細は公式のWorkdayコミュニティ文書を参照してください。
NQLでの実行ログのクエリ
NQLを使用して、以下のテーブルのクエリを実行することにより、Workdayコネクタインスタンスの実行に関する詳細な洞察を得ます。
時間
datetime
コネクタ実行ログエントリのタイムスタンプ。
ステータス
enumeration
実行ステータス:
• 成功: すべての行が受信および処理されました。
• 部分成功: 行の制限により一部の行が無視されました。
• 失敗: コネクタがデータを受信または処理できませんでした。
details.name
文字列
コネクタインスタンスの名前。
details.description
文字列
エラーの説明（該当する場合）。 以下のような説明を含む: • 受信した行が多すぎる... • フィールドに対する無効な JSONata 式
details.connector
文字列
使用されたコネクタテンプレートの名前。
details.credentials
文字列
インスタンスで使用された資格情報のラベル。
details.credentials_id
文字列
資格情報の一意の識別子。
details.nql_id
文字列
コネクタ インスタンスのNQL ID。
details.number_of_received_rows
数値
ソースから受信した行の総数。
details.number_of_processed_rows
数値
コネクタによって処理された行の総数―インポートされた行と異なる場合があります。
platform.inbound_connector_logs クエリを実行して、すべてのインバウンドコネクタの実行に関する包括的ログ情報を取得します。
このテーブルにアクセスするには、データモデルの表示でプラットフォームログ許可を有効にする必要があります。
NQLの例
Last updated
Was this helpful?