Workday Financials スポークの設定

WS-Security ユーザー名プロファイルを使用して ServiceNow インスタンスと Workday インスタンスを統合し、ServiceNow 要求を認証します。

始める前に

• 統合ハブ サブスクリプションを要求します。
• Workday Financials スポークをアクティブ化します。
• 必要なロール：アドミン

Workday Financials ベース URL を指定する

Workday Financials インスタンスのベース URL を接続の詳細 [connection_details] テーブルに指定します。SOAP API に基づくスポークアクションでは、これらの詳細をアクションの実行に使用します。

始める前に

必要なロール：admin

手順

1. 移動先 すべて > システム定義 > テーブル.
2. [接続の詳細] テーブルをフィルタリングして検索します。
3. [リストを表示] 関連リストをクリックします。
4. [新規] をクリックします。
5. フォームに、これらの値を入力します。

   表 : 1. [接続の詳細] フォーム

   フィールド	説明
   ベース URL	Workday インスタンスのベース URL またはテナント名を入力します。
   バージョン	API のバージョンを入力します。例： v33.2。

6. [保存] をクリックします。

Workday Financials スポークの WS-Security ユーザー名プロファイルを作成する

WS-Security ユーザー名プロファイルを作成して、ServiceNow からの要求を認証するための Workday 認証情報を提供します。

始める前に

必要なロール：admin

手順

1. 移動先 すべて > 統合ハブ > SOAP 統合 > WS-Security ユーザー名プロファイル.
2. [新規] をクリックします。
3. フォームに、これらの値を入力します。

   フィールド	説明
   名前	認証情報を一意に識別する名前。たとえば、「WorkdayFinancials ユーザー」と入力します。
   アプリケーション	レコードが適用可能なアプリケーション。[Workday Financials スポーク] を選択します。
   ユーザー名	Workday Web サービスを使用するデータ連携の権限を持つ Workday ユーザー。
   パスワード	Workday ユーザーのパスワード。

4. [保存] をクリックします。

Workday Financials スポークの SOAP セキュリティ方針を構成する

ServiceNow からの要求を認証するために作成したセキュリティユーザー名プロファイルを追加して、SOAP セキュリティプロファイルを設定します。

始める前に

必要なロール：admin

手順

1. 移動先 すべて > 統合ハブ > SOAP 統合 > SOAP セキュリティポリシー.
2. レコード WorkdayFinancials を開きます。
3. [WS-Security ユーザー名プロファイル] で、 Workday Financials スポーク用に作成したセキュリティユーザー名プロファイルを選択します。
   詳細については、「Workday Financials スポークの WS-Security ユーザー名プロファイルを作成する」を参照してください。
4. WS-Security X.509 プロファイルには値を指定しないでください。
5. フォームヘッダーを右クリックし、 [保存] をクリックします。

Workday Financials スポークのクライアント ID とクライアントシークレットの生成

Workday Financial スポーク を API クライアントとして Workday アカウントに登録し、クライアント ID、クライアントシークレットを生成します。

始める前に

必要なロール：アドミン

手順

1. Workday テナントにログインします。
2. [検索] に移動し、「統合用 API クライアントの登録 (Register API Client for Integrations)」タスクを入力します。
3. [統合用 API クライアントの登録 (Register API Client for Integrations)] フォームで、詳細を入力します。

   フィールド	説明
   クライアント名	アプリのクライアント名です。たとえば、「Workday Financials スポーク」と入力します。
   期限切れがないリフレッシュトークン	期限切れがないリフレッシュトークンを有効にするオプションです。
   スコープ (機能エリア)	必要な機能エリアを選択します。
   Workday 所有スコープを含める	Workday 所有スコープを選択するオプションです。

   
4. [OK] をクリックします。
   登録に成功すると、クライアント ID とクライアントシークレットが生成されます。
5. 指定したクライアント名の後にある省略記号ボタンをクリックします。
6. 選択 API クライアント >統合のリフレッシュトークンを管理します。
7. Workday アカウントを選択し、[OK] をクリックします。
   リフレッシュトークンを削除または再生成する画面が表示されます。
8. [新しいリフレッシュトークンを生成 (Generate New Refresh Token)] オプションを選択し、[OK] をクリックします。

タスクの結果

新しいリフレッシュトークンが生成されました。システムプロパティを構成するために、リフレッシュトークンはコピーして保存してください。

Workday Financials スポークのトークン URL を生成する

Workday アカウントに API クライアントを登録し、Workday Financials スポークのトークン URL を生成します。

始める前に

必要なロール：アドミン

手順

1. Workday テナントにログインします。
2. [検索] に移動し、[API クライアントの登録 (Register API Client)] タスクを入力します。
3. [API クライアントの登録 (Register API Client)] で、詳細を入力します。

   フィールド	説明
   クライアント名	アプリのクライアント名です。たとえば、「Workday Financials スポーク」です。
   クライアント権限許可タイプ	認証コード権限を選択します。
   アクセストークンタイプ	アクセストークンタイプ： [ベアラー (Bearer)] を選択します。
   リダイレクト URI	ServiceNow URL は、https://<instance>.service-now.com/oauth_redirect.do 形式で入力します。
   期限切れがないリフレッシュトークン	期限切れがないリフレッシュトークンを有効にするオプションです。
   スコープ (機能エリア)	必要な機能エリアを選択します。
   Workday 所有スコープを含める	Workday 所有スコープを選択するオプションです。

4. [OK] をクリックします。

タスクの結果

システムプロパティを構成するために、生成されたトークンエンドポイント値はコピーして保存してください。

Workday Financials スポークのシステムプロパティの構成

システムプロパティを構成し、Workday Financials スポーク用の SOAP API に基づくアクションの OAuth を有効にします。

始める前に

• Workday Financials スポークのクライアント ID とクライアントシークレットの生成
• Workday Financials スポークのトークン URL を生成する
• 必要なロール：アドミン

手順

1. 移動先 すべて > システムプロパティ > すべてのプロパティ.
2. [アプリケーション] 列で、[Workday Financials スポーク] を検索します。
3. sn_workdayfin_spke.glide.hub.clientid システムプロパティを開きます。
4. Workday アカウントから生成されたクライアント ID を [値] フィールドに入力し、[更新] をクリックします。
5. sn_workdayfin_spke.glide.hub.clientsecret システムプロパティを開きます。
6. Workday アカウントから生成されたクライアントシークレットを [値] フィールドに入力し、[更新] をクリックします。
7. sn_workdayfin.glide.hub.refreshtoken システムプロパティを開きます。
8. Workday アカウントから生成されたリフレッシュトークンを [値] フィールドに入力し、[更新] をクリックします。
9. sn_workdayfin_spke.glide.hub.tokenurl システムプロパティを開きます。
10. Workday アカウントから生成されたトークン URL を [値] フィールドに入力し、[更新] をクリックします。

タスクの結果

必要なシステムプロパティが Workday Financials スポークに構成されました。

認証情報レコードの作成

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

始める前に

必要なロール：アドミン

手順

1. 移動先 すべて > 接続 & 認証情報 > 認証情報.
2. [新規] を選択します。

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

3. [基本認証情報] を選択します。
4. フォームに、これらの値を入力します。

   名前	認証情報レコードを識別する名前です。例: Workday Financials Cred。
   ユーザー名	RaaS レポートへのアクセス権を持つ Workday ユーザーのユーザー名。
   パスワード	RaaS レポートへのアクセス権を持つ Workday ユーザーのパスワード。

5. フォームヘッダーを右クリックし、[保存] を選択します。

接続レコードの構成

Workday Financials スポーク接続を作成して構成し、 ServiceNow 要求を認証します。

始める前に

必要なロール：アドミン

手順

1. 移動先 すべて > 接続 & 認証情報 > 接続と認証情報エイリアス.
2. エイリアスレコード ( WorkdayFinancials など) を開きます。
3. [接続] タブから、[新規] を選択します。
4. フォームに、これらの値を入力します。

   フィールド	説明
   名前	接続レコードを識別する名前です。例: Workday Financials Conn。
   認証情報	基本認証タイプの必須認証情報レコード。Workday Financials スポーク用に作成した認証情報レコードを選択します。例: Workday Financials Cred。 詳細については、「認証情報レコードの作成」を参照してください。
   接続 URL	Workday インスタンスに接続するためのベース URL。

5. [属性] タブのtenant_nameには、Workday テナント名の値を入力します。
6. フォームヘッダーを右クリックし、[保存] を選択します。

To Do レポートの構成

To Do レポートを作成して構成し、ワーカーのファイナンス関連の受信ボックスアイテム (成功、To Do、アクションアイテム、承認など) を取得します。

始める前に

必要なロール:レポートおよびビジネスプロセスイベントステップレポートデータソースを作成するためのアクセス権を持つユーザー。

すべての必須の計算フィールドを作成します。

1. 計算されたフィールド 1:
   1. CF_Last_functionally_updated_-1 という名前のインクリメントおよびデクリメントタイプの計算フィールドを作成します。

      

   2. 「 cf_assigned_to_worker_previous 」という名前のルックアップ値タイプの計算フィールドを作成し、このフィールドで CF_Last_functionally_updated_-1 を使用します。

      

2. 計算されたフィールド 2:
   1. Cf_text_0 という名前のテキスト定数タイプの計算フィールドを作成します。

      

   2. CF_Text_as_1 という名前のテキスト定数タイプの計算フィールドを作成します。

      

   3. cf_competed_by_is_not_equal_old_assignee という名前の true/false 条件タイプの計算されたフィールドを作成します。

      

   4. CF_EE_Completed_by_admin_exist_as_old_Assignee_or_not という名前の評価式計算フィールドを作成します。

      

3. 計算されたフィールド 3:
   1. CF_Text という名前のテキスト定数タイプの計算フィールドを作成します。

      

   2. CF_Action_Event という名前のルックアップ関連値タイプの計算フィールドを作成します。

      

   3. CF_inbox_SUbject という名前の連結テキストタイプの計算フィールドを作成します。

      

4. 計算されたフィールド 4:
   1. CF_url という名前のテキスト定数タイプの計算フィールドを作成します。

      

   2. CF_business_pro_transaction という名前のルックアップ関連値タイプの計算フィールドを作成します。

      

   3. CF_BP_Wid という名前のルックアップ関連値タイプの計算フィールドを作成します。

      

   4. CF_Inbox_url という名前の連結テキストタイプの計算フィールドを作成します。

      

5. 計算されたフィールド 5:
   1. cf_step_id という名前のルックアップ関連値タイプの計算フィールドを作成します。

      

   2. CF_subject_id という名前のルックアップ関連値タイプの計算フィールドを作成します。

      

   3. CF_subject_and_step_id という名前のルックアップ関連値タイプの計算フィールドを作成します。

      

6. 計算されたフィールド 6: CF_sent_back という名前のルックアップ関連値タイプ計算フィールドを作成します。

   

7. 計算されたフィールド 7:
   1. アクションイベントの [プロセス定義] という名前CF_Businessルックアップ関連値タイプ計算フィールドを作成します。

      

   2. Cf_parent_business_process_definition という名前のルックアップ関連値タイプの計算フィールドを作成し、その中でアクションイベントCF_Businessプロセス定義を使用します。

      

8. 計算されたフィールド 8:
   1. CF_Last_updated_on-1 という名前のインクリメントおよびデクリメントタイプの計算フィールドを作成します。

      

   2. cf_status_as_of_moment という名前の日付タイプの計算フィールドの時点でのルックアップ値を作成し、このフィールドで CF_Last_updated_on-1 を使用します。

      

9. 計算されたフィールド 9: CF_Action_Event という名前の日付タイプの計算されたフィールドの時点でのルックアップ値を作成します。

   

10. 計算されたフィールド 10: CF_worker という名前の日付タイプの計算されたフィールドの時点でのルックアップ値を作成し、 CF_Action_Event をルックアップフィールドとして使用します。

    

11. 計算フィールド 11: CF_Awaiting_person_is_ISU という名前の True/False 条件タイプの計算フィールドを作成します。

    

このタスクについて

• 識別のため、計算されたフィールド名はすべて CF で始まります。
• レポートを作成する前に、このレポートに必要なすべての計算フィールドを作成し、レポートの作成時に使用できるようにします。
• レポートの作成中に、別のレポート名を選択できます。ただし、レポートフィールド名または各フィールドの列見出しの上書き (レポートドキュメントで指定されている場合) がレポートドキュメントと同じであることを確認してください。
  重要:

  レポートフィールドラベルは、レポートドキュメントと同じである必要があります。それ以外の場合、アクションは失敗します。
• [グループ列見出し] セクションの各ビジネスオブジェクトのグループ列見出しは空白にする必要があります。
• フィルターを作成するときは、必ずフィルターに括弧を追加してください。
• すべてのレポートは、ServiceNow プラットフォームでこれらのアクションにアクセスするために使用される ISU ユーザーが共有または所有している必要があります。
• [ 詳細] セクションで、[ Web サービスとして有効にする] オプションを選択します。

手順

1. [カスタムレポートの作成] タスクにアクセスします。
2. レポート名を入力します。
   たとえば、 SNIH_Inbox_Items- 財務アイテムなどです。
3. レポートタイプに [詳細] を選択します。
4. [ パフォーマンスに最適化] オプションをオフにします。
5. [ビジネスプロセスイベントステップ] として [データソース] を選択します。
6. 一時レポートオプションがオフになっていることを確認し、[ OK] をクリックします。

   

7. レポートビジネスオブジェクトとレポートのフィールドを選択します。

   

   

8. [グループ列見出し] セクションで、すべてのビジネスオブジェクトを選択します。
   各ビジネスオブジェクトのグループ列見出しは空白にする必要があります。

   

9. [ フィルター] セクションで、図示のように値を選択し、必ず括弧を追加してください。

   

   

   

   

10. [プロンプト] セクションで、[ 未定義のプロンプトのデフォルトを入力 (Populate Undefined Prompt Defaults )] チェックボックスをオフにします。

    

11. [ プロンプトのデフォルト ] セクションでプロンプトの値を選択します。
    すべてのプロンプトフィールドの プロンプト XML エイリアスのラベル が、表示されているものと同じである必要があります。

    

    注:

    ビジネスプロセスタイプでは、デフォルト値列に含まれる財務ビジネスプロセスタイプはほとんどありません。要件に応じて、さらにファイナンスビジネスプロセスタイプを追加できます。
12. [詳細] セクションで、[ Web サービスとして有効にする] オプションを選択し、[ OK] をクリックします。
13. レポートの構成が完了したら、3 つのドットアイコンをクリックして移動します Web サービス > URL を表示.

    

14. 以下のパラメーターで必要な日時範囲を選択し、[ OK] をクリックします。

    

15. [URL を表示 Web サービス (View URLs Web Service)] ページで、[CSV] セクションの下のマーク付きアイコンをクリックします。

    

    レポートが新しいブラウザータブに表示されます。レポートの RaaS URL はブラウザータブで確認でき、このリンクからこれらの詳細を取得できます。

    • https://wd2-impl-services1.workday.com は、顧客の Workday テナントのベース URL です。
    • Tenant_Name は顧客の Workday テナントです。
    • Report_Owner_user_name はレポートの所有者のユーザー名です。
    • SNIH_Inbox_Items-_finance_items はレポート名です。

    

元帳アカウントレポートの構成

元帳アカウントレポートを作成および構成して、元帳アカウントの詳細を取得します。

始める前に

必要なロール:レポートおよび元帳アカウントレポートデータソースを作成するためのアクセス権を持つユーザー。

このタスクについて

• 識別のため、計算されたフィールド名はすべて CF で始まります。
• レポートを作成する前に、このレポートに必要なすべての計算フィールドを作成し、レポートの作成時に使用できるようにします。
• レポートの作成中に、別のレポート名を選択できます。ただし、レポートフィールド名または各フィールドの列見出しの上書き (レポートドキュメントで指定されている場合) がレポートドキュメントと同じであることを確認してください。
  重要:

  レポートフィールドラベルは、レポートドキュメントと同じである必要があります。それ以外の場合、アクションは失敗します。
• [グループ列見出し] セクションの各ビジネスオブジェクトのグループ列見出しは空白にする必要があります。
• フィルターを作成するときは、必ずフィルターに括弧を追加してください。
• すべてのレポートは、ServiceNow プラットフォームでこれらのアクションにアクセスするために使用される ISU ユーザーが共有または所有している必要があります。
• [ 詳細] セクションで、[ Web サービスとして有効にする] オプションを選択します。

手順

1. [カスタムレポートの作成] タスクにアクセスします。
2. レポート名を入力します。
   たとえば、 RPT_ledger_account などです。
3. レポートタイプに [詳細] を選択します。
4. [パフォーマンスに最適化] チェックボックスをオフにします。
5. [ Data source (データソース )] で [ Ledger Accounts (元帳アカウント)] を選択します。
6. [一時レポート] チェックボックスをオフにして、[OK] をクリックします。

   

7. レポートビジネスオブジェクトとレポートのフィールドを選択します。

   

8. [ フィルター] セクションで、図示されている値を選択し、必ず括弧を追加してください。

9. [プロンプト] セクションで、[ 未定義のプロンプトのデフォルトを入力 (Populate Undefined Prompt Defaults )] チェックボックスをオフにします。

10. [プロンプトのデフォルト] セクションでプロンプトの値を選択します。
    すべてのプロンプトフィールドの プロンプト XML エイリアスのラベル が、表示されているものと同じである必要があります。

11. [詳細] セクションで、[ Web サービスとして有効にする] オプションを選択し、[ OK] をクリックします。
12. レポートの構成が完了したら、3 つのドットアイコンをクリックして移動します Web サービス > URL を表示.

    

13. 以下のパラメーターで必要な日時範囲を選択し、[ OK] をクリックします。

    

14. [URL を表示] Web サービスページで、[ CSV] セクションの下にあるマーク付きアイコンをクリックします。

    

    レポートが新しいブラウザータブに表示されます。レポートの RaaS URL はブラウザータブで確認でき、このリンクからこれらの詳細を取得できます。

    • https://wd2-impl-services1.workday.com は、顧客の Workday テナントのベース URL です。
    • Tenant_Name は顧客の Workday テナントです。
    • Report_Owner_user_name はレポートの所有者のユーザー名です。
    • レポート名はRPT_ledger_accountです。

    

支払ステータスレポートの構成

支払ステータスレポートを作成して構成し、指定された日付範囲内のサプライヤー支払情報を取得します。

始める前に

必要なロール:レポートおよびサプライヤー支払レポートデータソースを作成するためのアクセス権を持つユーザー。

このタスクについて

• 識別のため、計算されたフィールド名はすべて CF で始まります。
• レポートを作成する前に、このレポートに必要なすべての計算フィールドを作成し、レポートの作成時に使用できるようにします。
• レポートの作成中に、別のレポート名を選択できます。ただし、レポートフィールド名または各フィールドの列見出しの上書き (レポートドキュメントで指定されている場合) がレポートドキュメントと同じであることを確認してください。
  重要:

  レポートフィールドラベルは、レポートドキュメントと同じである必要があります。それ以外の場合、アクションは失敗します。
• [グループ列見出し] セクションの各ビジネスオブジェクトのグループ列見出しは空白にする必要があります。
• フィルターを作成するときは、必ずフィルターに括弧を追加してください。
• すべてのレポートは、ServiceNow プラットフォームでこれらのアクションにアクセスするために使用される ISU ユーザーが共有または所有している必要があります。
• [ 詳細] セクションで、[ Web サービスとして有効にする] オプションを選択します。

手順

1. [カスタムレポートの作成] タスクにアクセスします。
2. レポート名を入力します。
   たとえば、 CR 支払ステータスレポートなどです。
3. レポートタイプに [詳細] を選択します。
4. [パフォーマンスに最適化] チェックボックスをオフにします。
5. [ Data Source (データソース )] で [ Supplier Payments (サプライヤー支払)] を選択します。
6. [一時レポート] チェックボックスをオフにして、[OK] をクリックします。

   

7. レポートビジネスオブジェクトとレポートのフィールドを選択します。

   

   

8. [グループ列見出し] セクションで、すべてのビジネスオブジェクトを選択します。
   各ビジネスオブジェクトのグループ列見出しは空白にする必要があります。

   

9. [ フィルター] セクションで、図示されている値を選択し、必ず括弧を追加してください。

   

10. [プロンプト] セクションで、[ 未定義のプロンプトのデフォルトを入力 (Populate Undefined Prompt Defaults )] チェックボックスをオフにします。

    

11. [プロンプトのデフォルト] セクションでプロンプトの値を選択します。
    すべてのプロンプトフィールドの プロンプト XML エイリアスのラベル が、表示されているものと同じである必要があります。

    

12. [詳細] セクションで、[ Web サービスとして有効にする] オプションを選択し、[ OK] をクリックします。
13. レポートの構成が完了したら、3 つのドットアイコンをクリックして移動します Web サービス > URL を表示.

    

14. 以下のパラメーターで必要な日時範囲を選択し、[ OK] をクリックします。

    

15. [URL を表示 Web サービス (View URLs Web Service)] ページで、[CSV] セクションの下のマーク付きアイコンをクリックします。

    

    レポートが新しいブラウザータブに表示されます。レポートの RaaS URL はブラウザータブで確認でき、このリンクからこれらの詳細を取得できます。

    • https://wd2-impl-services1.workday.com は、顧客の Workday テナントのベース URL です。
    • Tenant_Name は顧客の Workday テナントです。
    • Report_Owner_user_name はレポートの所有者のユーザー名です。
    • レポート名はCR_Payment_status_reportです。