Workday REST API を使用する構成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：6分

    • Workday REST API を使用するアクションを実行するように ServiceNow インスタンスを設定します。

    始める前に

    • 統合ハブサブスクリプションを要求します。
    • Workday HRスポークを有効にします。
    • Workday からこれらの値を取得し、後で使用するために記録します。これらの値は、クライアントの登録に必要です。
      • クライアント ID
      • クライアント シークレット
      • Workday REST API エンドポイント
      • トークンエンドポイント
      • 認証エンドポイント
    • 必要なロール：admin

    このタスクについて

    Workday REST および Report-as-a-Service (RAAS) API は、OAuth 2.0 と連携し、Workday テナント内のリソースへのアクセスを許可します。OAuth 2.0 を使用するには、API クライアントの登録タスクを使用してクライアントをテナントに登録する必要があります。

    これらの REST ベースのスポークアクションを使用する必要がある場合には、Workday REST API を使用するように ServiceNow インスタンスを設定します。
    • 自分のフィードバック構造を取得
    • オブジェクトカスタムフィールドを検索
    • オブジェクトカスタムフィールドを更新
    • 給与明細書を検索
    • レポートを使用して総合報酬を検索
    • カスタムレポートを検索
    • 受信箱アイテムを検索
    • 従業員のメリットおよび利益計画の詳細を検索
    • 従業員の祝日カレンダー参照 WID を検索
    • 従業員のスケジュールカレンダー参照 WID を検索
    • 従業員の祝日カレンダーを検索
    注:
    これらの構成は、REST ベースのスポークアクションを使用するために必要です。

    OAuth プロバイダーとして Workday HRを登録

    Workday HR インスタンスを OAuth プロバイダーとして登録し、ServiceNowインスタンスが OAuth 2.0 トークンを要求できるようにします。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > システム OAuth > アプリケーションレジストリー.
    2. [New] をクリックします。
      「どのような OAuth アプリケーションですか？」というメッセージが表示されます。
    3. [サードパーティ OAuth プロバイダーに接続します] を選択します。
    4. フォームに、これらの値を入力します。
      表 : 1. アプリケーションレジストリフォーム
      フィールド 説明
      名前 レコードを一意に識別する名前を入力します。たとえば、次のように入力します。 Workday HR OAuth
      アプリケーション レコードが適用可能なアプリケーション。[Workday HRスポーク] を選択します。
      クライアント ID クライアントの登録時に生成されたクライアント ID。
      クライアントシークレット クライアントの登録時に生成されたクライアントシークレット。
      認証 URL クライアントの登録時に生成された認証エンドポイント。
      トークン URL クライアントの登録時に生成されたトークンエンドポイント。
      リダイレクト URL 次の形式の OAuth コールバックエンドポイント： https://<instance>.service-now.com/oauth_redirect.do
      デフォルトの権限許可タイプ トークンを確立するために使用される権限許可のタイプ。[認証コード] を選択します。
      有効 アプリケーションレジストリを積極的に使用するためのオプション。
    5. フォームヘッダーを右クリックし、[保存] をクリックします。
      OAuth エンティティプロファイルが作成されます。

    Workday HRSpoke の認証情報レコードを作成

    Workday HR インスタンスの認証情報レコードを作成します。 Workday HRスポーク接続および資格情報エイリアスでは、これらの認証情報を使用してアクションを許可します。

    始める前に

    必要なロール：admin。

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 認証情報.
    2. [New] をクリックします。

      「作成する認証情報のタイプは？」というメッセージが表示されます。

    3. [OAuth 2.0 認証情報] を選択します。
    4. フォームに、これらの値を入力します。
      表 : 2. OAuth 2.0 認証情報フォーム
      フィールド 説明
      名前 レコードを一意に識別する名前を入力します。例：Workday HR Cred。
      有効 認証情報レコードを積極的に使用するオプションです。
      OAuth エンティティ プロファイル Workday HR を OAuth プロバイダーとして登録する際に作成される OAuth エンティティプロファイル。例えば、 OAuth プロファイル。
    5. フォームヘッダーを右クリックし、[送信]をクリックします。
    6. OAuth トークンを生成するには、[OAuth トークンの 取得] 関連リンクをクリックします。

    Workday HR スポークの接続レコードの作成

    Workday HR インスタンスの接続レコードを作成します。Workday HR スポーク接続および資格情報エイリアスでは、これらの接続を使用して Workday HR でアクションを実行します。

    始める前に

    必要なロール：admin。

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 接続および資格情報エイリアス.
    2. エイリアスレコード WorkdayHR を開きます。
    3. [接続] タブで、[新規] をクリックします。
    4. フォームの各フィールドに入力します。
      注:
      Workday HR スポークアプリケーションで接続レコードを作成していることを確認してください。
      表 : 3. 接続フォーム
      フィールド 説明
      名前 レコードを一意に識別する名前を入力します。例を次に示します。 Workday HR 接続。
      認証情報 Workday HR スポーク用に作成された認証情報レコード。 例：Workday HR Cred。
      接続エイリアス 接続に関連付けられているエイリアスレコードです。
      接続 URL Workday HR インスタンスに接続するための URL。
      有効 接続レコードを積極的に使用するオプション
    5. [属性] タブで、次の値を入力します。
      フィールド 値
      テナント名 Workday アプリケーションのテナント名。
      バージョン v1
    6. [送信] をクリックします。