Workday HR スポーク用 Webhook の設定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：22分

    • Webhook を設定して、ServiceNow インスタンスに Workday HR アプリケーションから必要な従業員の詳細を取得します。

    始める前に

    必要なロール：admin

    Workday での OAuth 2.0 用 ServiceNow Webhook API クライアントの構成

    Workday で API クライアントを構成して、Webhook 要求を認証します。

    始める前に

    必要なロール：Workday アドミンロール、または Workday で OAuth 2.0 クライアントをセットアップする権限が付与されたロール。

    このタスクについて

    ServiceNow プラットフォームをリスナーエンドポイントとして使用し、Workday からイベント通知を受信する場合にのみ、この手順を設定する必要があります。Workday からイベント通知を受信する必要がない場合は、このセクションで説明する構成を省略できます。
    注:
    これらの構成は、Workday で実行する必要があります。

    手順

    1. Workday で、[テナントセットアップの編集 - セキュリティ (Edit Tenant Setup - Security)] タスクにアクセスします。
    2. [OAuth 2.0 設定] セクションから [OAuth 2.0 クライアント有効 (OAuth 2.0 Clients Enabled)] オプションを選択します。
    3. [API クライアントの登録 (Register API Client)] タスクにアクセスします。
    4. クライアント名を入力します。
    5. [認証コード許可 (Authorization Code Grant)] で [クライアント権限許可タイプ (Client Grant Type)] を選択します。
    6. [アクセストークンタイプ (Access Token Type)] で [ベアラー (Bearer)] を選択します。
    7. 有効なリダイレクト URI を入力します。
      注:
      OAuth 2.0 リダイレクト URI が有効な HTTPS URL であることを確認してください。
    8. オプション: [リフレッシュトークンのタイムアウト (Refresh Token Timeout)] を日数で選択します。
    9. オプション: リフレッシュトークンがタイムアウトしないようにするには、[期限切れがないリフレッシュトークン (Non-Expiring Refresh Tokens)] オプションを選択します。
    10. REST API クライアントテナント全体に OAuth 権限を許可するには、[アドミンの同意を付与する (Grant Administrative Consent)] オプションを選択します。
      このオプションを選択する場合、Workday 機能エリアへのクライアントアクセスを明示的に許可する必要はありません。
    11. [機能エリア] プロンプトから、OAuth 2.0 クライアントがアクセスする必要がある機能エリアを選択します。
    12. オプション: OAuth 2.0 クライアントが機能エリアにないコア Workday ドメインへのアクセスを必要とする場合は、[Workday 所有スコープを含める (Include Workday Owned Scope)] オプションを選択します。

    Workday HR スポーク用 CreateUser Webhook の設定

    CreateUser Webhook を使用して、Workday から ServiceNow インスタンスに新しくオンボーディングされた従業員の詳細を取得します。

    ServiceNow インスタンスでの Create User Webhook 用ユーザー名とパスワードの生成

    Create User Webhook の要求を認証し、Workday アプリケーションから必要なデータを取得するために、ServiceNow インスタンスでユーザー名とパスワードを生成します。

    始める前に

    必要なロール：ServiceNow admin

    注:
    これらの設定は、ServiceNow インスタンスで実行される必要があります。

    手順

    1. アドミニストレーターとして ServiceNow インスタンスにログインします。
    2. 移動先 すべて > システム定義 > テーブル.
    3. Workday HR スポーク Webhook レジストリテーブルをフィルタリングして検索します。
      例：Workday Webhook レジストリ。
    4. [リストを表示] 関連リストをクリックします。
    5. [新規] をクリックします。
    6. フォームに、これらの値を入力します。
      フィールド 説明
      説明 Webhook レジストリレコードの説明。「CreateUser の Workday イベントと認証」と入力します。
      UserName Workday Web サービスを使用するデータ連携の権限を持つ Workday ユーザー。
      パスワード Workday ユーザーのパスワード。
      Workday イベント Webhook が設定されているイベント。「CreateUser」と入力します。
      Workday インスタンス Workday ホスト URL とテナント名。次の形式で URL を入力します。https://<workday_host_url>/<workday_tenant_name>
    7. フォームヘッダーを右クリックし、 [保存] をクリックします。
    8. [ユーザー名とパスワードを生成] をクリックします。
      ユーザー名とパスワードの値をコピーして記録します。これらの値は、Webhook 要求を認証するために Workday インスタンスで指定する必要があります。
      注:
      環境に複数の HIRE BP がある場合は、すべての HIRE BP を構成して、すべての HIRE 従業員トランザクションに対して CreateUser Webhook を有効にする必要があります。

    ServiceNow インスタンスからの Create User Webhook 用リソースパスの取得

    後で Create User Webhook 要求を認証し、Workday アプリケーションから必要なデータを取得するために、ServiceNow インスタンスからリソースパスを取得します。

    始める前に

    必要なロール：ServiceNow admin

    注:
    これらの設定は、ServiceNow インスタンスで実行される必要があります。

    手順

    1. アドミニストレーターとして ServiceNow インスタンスにログインします。
    2. 移動先 すべて > システム Web サービス > スクリプト化 Web サービス > スクリプト化 REST API.
    3. Workday HRSpoke のレコードを開きます。
    4. [リソース ] タブで、[コールバック] レコードをクリックします。
    5. 後で使用するために、リソースパス の値を記録して保存します。

    Workday インスタンスへの Create User Webhook 用 CLAR ファイルのインポート

    ServiceNow Store で入手可能な CLAR ファイルをインポートして、Create User Webhook を設定し、ServiceNow インスタンスからの要求を認証します。

    始める前に

    • Workday スタジオをインストールする必要があります。
    • カスタムレポート作成ポリシーにアクセスします。

      New_Hire_record レポート構造に基づいて Workday でカスタムレポートを作成し、そのレポートを ISU ユーザーと共有します。

    • ビジネスプロセス定義を編集するためにアクセスします。
    • データ連携システムを作成および編集するためにアクセスします。
    • 必要なロール：admin
    注:
    • データ連携名、レポートフィールド XPath (必要な場合)、および Workday インスタンスヘッダーを除いて、ユーザーは CLAR ファイルのフィールドまたはプロパティの値を変更しないように警告されます。
    • これらの構成は、Workday Studio で実行する必要があります。

    手順

    1. の Workday HR スポーク ページから ServiceNow Store、サポートリンクとドキュメントから Workday-HR-Webhook-Studio-Sample ファイルをダウンロードします。
    2. サンプルファイルを解凍して、CLAR ファイルを取得します。
    3. CLAR ファイルを Workday スタジオにインポートします。
    4. [StartHere] コンポーネントの [プロパティ] タブで、[サービス] に移動し、この Webhook に対して作成された RAAS レポートを選択します。
      StartHere コンポーネントを構成する
    5. 実装やサンドボックスなど、レポートが存在する環境を選択し、要件に従ってレポートを構成します。
    6. レポート名を入力し、必要なレポートを選択します。
      レポート名
    7. レポートのエイリアス名を入力します。
      エイリアス名
    8. レポートエイリアスを追加したら、プロンプトに基づいてレポートを実行するために使用する [追加パス] に、選択したレポートのパスを追加します。
      [追加パス]
    9. [ヘッダーの設定] コンポーネントで、WorkdayInstance ヘッダーに Workday インスタンスを指定します。
      [ヘッダーの設定] コンポーネントを構成する
    10. HttpOut のプロパティで、これらの値を入力します。
      フィールド 値
      エンドポイント REST エンドポイント
      注:
      詳細については、「ServiceNow インスタンスからリソースパスを取得する」を参照してください。
      HTTP メソッド POST
      HttpOut のプロパティを設定する
    11. 変更内容を保存します。
    12. プロジェクトエクスプローラーで、データ連携を選択し、Workday システムに展開します。
    13. Workdayインスタンスにログインし、次に移動します: 統合 > 統合システム > 統合属性を設定する.
      統合属性を設定する
    14. ServiceNow インスタンスでユーザー名とパスワードを生成するで生成した [データ連携属性の設定] にユーザー名とパスワードを入力します。
      統合属性の設定を設定する
    15. ビジネスプロセスを変更し、このデータ連携をビジネスプロセスに追加します。
      1. ビジネスプロセスの定義を編集します。
        定義を編集
      2. 有効日を選択し、[OK] をクリックします。
      3. [+] 記号をクリックし、BP で新しいビジネスプロセスステップを追加します。
      4. ビジネスプロセスの完了ステップの後のオーダーを選択します。
      5. ビジネスプロセスを追加し、[タイプ] を [データ連携] として選択します。
        統合タイプを選択する
      6. [ユーザーとして実行] に ISU ユーザー名を入力し、[OK] をクリックします。
      7. BP の雇用に新しく追加されたビジネスプロセスステップで、[データ連携の構成] をクリックします。
        統合の設定
      8. [データ連携基準] で、[値タイプ] に [実行時に値を決定] を選択し、[値] に [従業員 ID] を選択します。
        [実行時に値を決定]

        [値]で選択した [従業員 ID] フィールドが表示されます。

        [従業員 ID] フィールド
      9. [OK] をクリックします。
      10. 次の詳細を含む Webhook のレポートを作成します。

        レポート定義：

        レポート定義

        列ラベル：

        列ラベル

        計算されたフィールドの詳細：

        計算されたフィールドの詳細

        フィルターとプロンプトの詳細：

        フィルターとプロンプトの詳細

    Workday HR スポーク用 Offboarding Webhook の設定

    Offboarding Webhook を使用して、Workday から ServiceNow インスタンスに退職した従業員の詳細を取得します。

    ServiceNow インスタンスでの Offboarding Webhook 用ユーザー名とパスワードの生成

    Offboarding Webhook の要求を認証し、Workday アプリケーションから必要なデータを取得するために、ServiceNow インスタンスでユーザー名とパスワードを生成します。

    始める前に

    必要なロール：admin

    注:
    これらの設定は、ServiceNow インスタンスで実行される必要があります。

    手順

    1. アドミニストレーターとして ServiceNow インスタンスにログインします。
    2. 移動先 すべて > システム定義 > テーブル.
    3. Workday HR スポーク Webhook レジストリテーブルをフィルタリングして検索します。
      例：Workday Webhook レジストリ。
    4. [リストを表示] 関連リストをクリックします。
    5. [新規] をクリックします。
    6. フォームに、これらの値を入力します。
      フィールド 説明
      説明 Webhook レジストリレコードの説明。「Offboarding の Workday イベントと認証」と入力します。
      UserName Workday Web サービスを使用するデータ連携の権限を持つ Workday ユーザー。
      パスワード Workday ユーザーのパスワード。
      Workday イベント Webhook が設定されているイベント。
      Workday インスタンス Workday ホスト URL とテナント名。次の形式で URL を入力します。https://<workday_host_url>/<workday_tenant_name>
    7. フォームヘッダーを右クリックし、 [保存] をクリックします。
    8. [ユーザー名とパスワードを生成] をクリックします。
      ユーザー名とパスワードの値をコピーして記録します。これらの値は、Webhook 要求を認証するために Workday インスタンスで指定する必要があります。
      注:
      環境に複数の HIRE BP がある場合は、すべての HIRE BP を構成して、すべての HIRE 従業員トランザクションに対して CreateUser Webhook を有効にする必要があります。

    ServiceNow インスタンスからの Offboarding Webhook 用リソースパスの取得

    後で Offboarding Webhook 要求を認証し、Workday アプリケーションから必要なデータを取得するために、ServiceNow インスタンスからリソースパスを取得します

    始める前に

    必要なロール：admin

    注:
    これらの設定は、ServiceNow インスタンスで実行される必要があります。

    手順

    1. アドミニストレーターとして ServiceNow インスタンスにログインします。
    2. 移動先 すべて > システム Web サービス > スクリプト化 Web サービス > スクリプト化 REST API.
    3. Workday HRSpoke のレコードを開きます。
    4. [リソース ] タブで、[コールバック] レコードをクリックします。
    5. 後で使用するために、リソースパス の値を記録して保存します。

    Workday インスタンスへの Offboarding Webhook 用 CLAR ファイルのインポート

    ServiceNow Store で入手可能な CLAR ファイルをインポートして、Offboarding Webhook を設定し、ServiceNow インスタンスからの要求を認証します。

    始める前に

    • Workday スタジオをインストールする必要があります。
    • カスタムレポート作成ポリシーにアクセスします。

      New_terminated_record レポート構造に基づいて Workday でカスタムレポートを作成し、そのレポートを ISU ユーザーと共有します。

    • ビジネスプロセス定義を編集するためにアクセスします。
    • データ連携システムを作成および編集するためにアクセスします。
    • 必要なロール：admin
    注:
    • データ連携名、レポートフィールド XPath (必要な場合)、および Workday インスタンスヘッダーを除いて、ユーザーは CLAR ファイルのフィールドまたはプロパティの値を変更しないように警告されます。
    • これらの構成は、Workday Studio で実行する必要があります。

    手順

    1. の Workday HR スポーク ページから ServiceNow Store、サポートリンクとドキュメントから Workday-HR-Offboarding-Webhook-Studio-Sample ファイルをダウンロードします。
    2. サンプルファイルを解凍して、CLAR ファイルを取得します。
    3. CLAR ファイルを Workday スタジオにインポートします。
    4. [StartHere] コンポーネントの [プロパティ] タブで、[サービス] に移動し、この Webhook に対して作成された RAAS レポートを選択します。
      Offboarding スポークの RAAS レポート
    5. 実装やサンドボックスなど、レポートが存在する環境を選択し、要件に従ってレポートを構成します。
    6. レポート名を入力し、必要なレポートを選択します。
      Offboarding Webhook のカスタム RaaS レポート
    7. レポートのエイリアス名を入力します。
      Offboarding Webhook のエイリアスレポート
    8. レポートエイリアスを追加したら、プロンプトに基づいてレポートを実行するために使用する [追加パス] に、選択したレポートのパスを追加します。
      Offboarding Webhook の追加パス
    9. レポートエイリアスを選択します。
    10. [ヘッダーの設定] コンポーネントで、WorkdayInstance ヘッダーに Workday インスタンスを指定します。
      [ヘッダーの設定] コンポーネント - Offboarding Webhook
    11. HttpOut のプロパティで、これらの値を入力します。
      フィールド 値
      エンドポイント REST エンドポイント
      注:
      詳細については、「ServiceNow インスタンスからリソースパスを取得する」を参照してください。
      HTTP メソッド POST
      Offboarding Webhook の httpout プロパティ
    12. 変更内容を保存します。
    13. プロジェクトエクスプローラーで、データ連携を選択し、Workday システムに展開します。
    14. Workdayインスタンスにログインし、次に移動します: 統合 > 統合システム > 統合属性を設定する.
      統合属性 Offboarding を設定する
    15. ServiceNow インスタンスでの Offboarding Webhook 用ユーザー名とパスワードの生成で生成した [データ連携属性の設定] にユーザー名とパスワードを入力します。
      統合属性構成 Offboarding Webhook
    16. ビジネスプロセスを変更し、このデータ連携をビジネスプロセスに追加します。
      1. ビジネスプロセスの定義を編集します。
      2. [Workday アカウント] ボックスで ISU ユーザーを選択します。
      3. 有効日を選択し、[OK] をクリックします。
      4. [+] 記号をクリックし、BP で新しいビジネスプロセスステップを追加します。
      5. ビジネスプロセスの完了ステップの後のオーダーを選択します。
      6. ビジネスプロセスを追加し、[タイプ] を [データ連携] として選択します。
      7. [ユーザーとして実行] に ISU ユーザー名を入力し、[OK] をクリックします。
      8. BP の雇用に新しく追加されたビジネスプロセスステップで、[データ連携の構成] をクリックします。
        統合 Offboarding Webhook を設定する
      9. [データ連携基準] で、[値タイプ] に [実行時に値を決定] を選択し、[値] に [従業員 ID] を選択します。
        [統合基準 (integration criteria)] の実行時の値

        [値] で選択した [従業員 ID] フィールドが表示されます。

        Offboarding Webhook の [データ連携基準] [従業員 ID]
      10. [OK] をクリックします。
      11. [カスタムレポートの作成] タスクを開きます。
      12. レポート名を入力します (例：New_terminated_record)。
      13. [レポートタイプ] に [詳細] を選択します。
      14. [パフォーマンスに最適化] オプションをオフにします。
      15. [データソース] に [すべてのワーカー] を選択します。
        退職用の [カスタムレポートを表示]
      16. 次のようにレポートを作成します。
        Offboarding Webhook のサンプルレポート

        レポートの [グループ列見出し]レポートの [グループ列見出し]

        レポートの [ソート] セクション

        レポートの [フィルター] セクションレポートの [フィルター] セクション

      17. [プロンプト] タブから [未定義のプロンプトのデフォルトを入力] オプションを選択します。
      18. [詳細] タブから [Web サービスとして有効化] オプションを選択します。

    Workday HR スポーク用 LeaveofAbsence Webhook の設定

    LeaveofAbsence Webhook を使用して、Workday から ServiceNow インスタンスに従業員の休暇の詳細を取得します。

    ServiceNow インスタンスでの LeaveofAbsence Webhook 用ユーザー名とパスワードの生成

    LeaveofAbsence Webhook の要求を認証し、Workday アプリケーションから必要なデータを取得するために、ServiceNow インスタンスでユーザー名とパスワードを生成します。

    始める前に

    必要なロール：admin

    注:
    これらの設定は、ServiceNow インスタンスで実行される必要があります。

    手順

    1. アドミニストレーターとして ServiceNow インスタンスにログインします。
    2. 移動先 すべて > システム定義 > テーブル.
    3. Workday HR スポーク Webhook レジストリテーブルをフィルタリングして検索します (例：Workday Webhook レジストリ)。
    4. [リストを表示] 関連リストをクリックします。
    5. [新規] をクリックします。
    6. フォームに、これらの値を入力します。
      フィールド 説明
      説明 Webhook レジストリレコードの説明。「LeaveofAbsence の Workday イベントと認証」と入力します。
      UserName Workday Web サービスを使用するデータ連携の権限を持つ Workday ユーザー。
      パスワード Workday ユーザーのパスワード。
      Workday イベント Webhook が設定されているイベント。「LeaveofAbsence」と入力します。
      Workday インスタンス Workday ホスト URL とテナント名。次の形式で URL を入力します。https://<workday_host_url>/<workday_tenant_name>
    7. フォームヘッダーを右クリックし、 [保存] をクリックします。
    8. [ユーザー名とパスワードを生成] をクリックします。
      ユーザー名とパスワードの値をコピーして記録します。これらの値は、Webhook 要求を認証するために Workday インスタンスで指定する必要があります。
      注:
      環境に複数の HIRE BP がある場合は、すべての HIRE BP を構成して、すべての HIRE 従業員トランザクションに対して CreateUser Webhook を有効にする必要があります。

    ServiceNow インスタンスからの LeaveofAbsence Webhook 用リソースパスの取得

    後で Offboarding Webhook 要求を認証し、Workday アプリケーションから必要なデータを取得するために、ServiceNow インスタンスからリソースパスを取得します

    始める前に

    必要なロール：admin

    注:
    これらの設定は、ServiceNow インスタンスで実行される必要があります。

    手順

    1. アドミニストレーターとして ServiceNow インスタンスにログインします。
    2. 移動先 すべて > システム Web サービス > スクリプト化 Web サービス > スクリプト化 REST API.
    3. Workday HRSpoke のレコードを開きます。
    4. [リソース ] タブで、[コールバック] レコードをクリックします。
    5. 後で使用するために、リソースパス の値を記録して保存します。

    Workday インスタンスへの LeaveofAbsence Webhook 用 CLAR ファイルのインポート

    ServiceNow Store で入手可能な CLAR ファイルをインポートして、LeaveofAbsence Webhook を設定し、 ServiceNow インスタンスからの要求を認証します。

    始める前に

    • Workday スタジオをインストールする必要があります。
    • カスタムレポート作成ポリシーにアクセスします。

      Leave_of_absence_request レポート構造に基づいて Workday でカスタムレポートを作成し、そのレポートを ISU ユーザーと共有します。

    • ビジネスプロセス定義を編集するためにアクセスします。
    • データ連携システムを作成および編集するためにアクセスします。
    • 必要なロール：admin
    注:
    • データ連携名、レポートフィールド XPath (必要な場合)、および Workday インスタンスヘッダーを除いて、ユーザーは CLAR ファイルのフィールドまたはプロパティの値を変更しないように警告されます。
    • これらの構成は、Workday Studio で実行する必要があります。

    手順

    1. の Workday HR スポーク ページから ServiceNow Store、サポートリンクとドキュメントから Workday-HR-Leave-of-Absence-Webhook-Studio-Sample ファイルをダウンロードします。
    2. サンプルファイルを解凍して、CLAR ファイルを取得します。
    3. CLAR ファイルを Workday スタジオにインポートします。
    4. [StartHere] コンポーネントの [プロパティ] タブで、[サービス] に移動し、この Webhook に対して作成された RAAS レポートを選択します。
      LeaveofAbsence Webhook の RaaS レポート
    5. 実装やサンドボックスなど、レポートが存在する環境を選択し、要件に従ってレポートを構成します。
    6. レポート名を入力し、必要なレポートを選択します。
      LeaveofAbsence Webhook のカスタム RaaS レポート
    7. レポートのエイリアス名を入力します。
      レポート名のエイリアス
    8. レポートエイリアスを追加したら、プロンプトに基づいてレポートを実行するために使用する [追加パス] に、選択したレポートのパスを追加します。
      レポートエイリアスの追加パス
    9. レポートエイリアスを選択します。
    10. [ヘッダーの設定] コンポーネントで、WorkdayInstance ヘッダーに Workday インスタンスを指定します。
      Workday インスタンスのヘッダーを設定
    11. HttpOut のプロパティで、これらの値を入力します。
      フィールド 値
      エンドポイント REST エンドポイント
      注:
      詳細については、「ServiceNow インスタンスからリソースパスを取得する」を参照してください。
      HTTP メソッド POST
      LeaveofAbsence Webhook の http out プロパティ
    12. 変更内容を保存します。
    13. プロジェクトエクスプローラーで、データ連携を選択し、Workday システムに展開します。
    14. Workdayインスタンスにログインし、次に移動します: 統合 > 統合システム > 統合属性を設定する.
      LeaveofAbsence Webhook の [データ連携属性の設定]
    15. ServiceNow インスタンスでの LeaveofAbsence Webhook 用ユーザー名とパスワードの生成で生成した [データ連携属性の設定] にユーザー名とパスワードを入力します。
      統合属性構成のユーザー名とパスワード
    16. ビジネスプロセスを変更し、このデータ連携をビジネスプロセスに追加します。
      1. ビジネスプロセスの定義を編集します。
        ビジネスプロセス定義
      2. [Workday アカウント] ボックスで ISU ユーザーを選択します。
      3. 有効日を選択し、[OK] をクリックします。
      4. [+] 記号をクリックし、BP で新しいビジネスプロセスステップを追加します。
      5. ビジネスプロセスの完了ステップの後のオーダーを選択します。
      6. ビジネスプロセスを追加し、[タイプ] を [データ連携] として選択します。
        ビジネスプロセス- [タイプ] [データ連携]
      7. [ユーザーとして実行] に ISU ユーザー名を入力し、[OK] をクリックします。
      8. BP の雇用に新しく追加されたビジネスプロセスステップで、[データ連携の構成] をクリックします。
        ビジネスプロセスのデータ連携の構成
      9. [データ連携基準] で、[値タイプ] に [実行時に値を決定] を選択し、[値] に [従業員 ID] を選択します。
        [データ連携基準] - [実行時に値を決定]

        [値]で選択した [従業員 ID] フィールドが表示されます。

        データ連携基準として選択された従業員 ID
      10. [OK] をクリックします。
      11. [カスタムレポートの作成] タスクを開きます。
      12. レポート名を入力します (例：Leave_of_absence_request)。
      13. [レポートタイプ] に [詳細] を選択します。
      14. [パフォーマンスに最適化] オプションをオフにします。
      15. [データソース] に [すべてのアクティブなワーカーと終了したワーカー (All Active and Terminated Workers)] を選択します。
      16. 次のようにレポートを作成します。
        サンプルレポート

        レポートのグループ列見出しセクションレポートのグループ列見出し

        レポートのフィルターセクションレポートのフィルターセクション

      17. [プロンプト] タブから [未定義のプロンプトのデフォルトを入力] オプションを選択します。
      18. [詳細] タブから [Web サービスとして有効化] オプションを選択します。