---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# First Advantage スポークのセットアップ

# First Advantage スポークのセットアップ {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分

API キーを使用して ServiceNow インスタンスと First Advantage アカウントをデータ連携し、ServiceNow 要求を認証します。

## 始める前に

* 統合ハブ サブスクリプションを要求します。
* First Advantage スポークを有効にします。
* 必要なロール：admin
{#setup-first-adv__ul_l2l_mph_gfb}

## First Advantage スポーク の接続レコードの作成 {#ariaid-title2}

接続レコードを作成して、ServiceNow インスタンスと First Advantage サーバーを統合します。ServiceNow インスタンスは、この接続レコードを使用して First Advantage スポークアクションを実行します。

### 始める前に

必要なロール：admin

First Advantage サーバーから API キーを取得します。

### 手順

1. 移動先 すべてプロセスの自動化ワークフロースタジオ.
2. \[統合\] を選択します。
3. \[接続\] タブを選択します。
4. \[すべての接続を検索\] フィールドに「<kbd class="ph userinput">First Advantage</kbd>」と入力します。  
   \[送信\] タブが選択されていることを確認します。
5. \[FirstAdvantage\] タイルで、\[詳細を表示\] を選択します。  
6. \[構成\] を選択します。
7. フォームに入力します。  
   {#create-conn-fadv__table_pxh_y3s_qdc__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 接続名 | 接続の名前。最初のレコードのデフォルトの読み取り専用名は、接続エイリアスのものと同じです。接続レコードを作成するときに、\[接続を追加\] をクリックして別の名前を指定することができます。 |
   | 接続 URL | First Advantage サーバーへの接続 URL を指定するオプション。URL は <https://rest-ua.fadv.com>です。 |
   | 配布メール | 配布メール ID を指定するオプション。 |
   | バージョン | API のバージョンを指定するオプション。 |
   | API キー | First Advantage サーバーがアクセス要求を認証するために使用する API キーを入力するオプション。 |
   [表 : 1. First Advantage スポーク接続フォーム]

   {#create-conn-fadv__table_pxh_y3s_qdc}
8. \[接続を設定\] を選択します。  
   これで接続レコードが設定されます。
{#create-conn-fadv__steps_zwz_fhz_4fb}

## ServiceNow インスタンスでの First Advantage 状況の作成 {#ariaid-title3}

ServiceNow インスタンスの \[状況\] リストに表示する First Advantage 状況を作成します。

### 始める前に

必要なロール：アドミン

### ドラフト、準備完了、および処理中の状況の作成 {#ariaid-title4}

タスク \[task\] テーブルでドラフト、準備完了、および処理中の状況を作成します。

#### 始める前に

必要なロール：admin

#### 手順

1. フィルターナビゲーターで、「<kbd class="ph userinput">sys_choice.list</kbd>」と入力します。  
   選択 \[sys_choice\] テーブルのレコードが表示されます。
2. \[新規\] をクリックします。
3. フォームでこれらの値を入力し、ドラフト状況のレコードを 3 つ作成します。  
   {#draft-inp-ready-fadv__table_z25_l1x_vkb__entry__2}

   | フィールド | 値 |
   |-|-|
   | テーブル | タスク \[task\] |
   | 要素 | 状況 |
   | ラベル | ドラフト |
   | 値 | 137 |
   [表 : 2. レコード 1：ドラフト状況]

   {#draft-inp-ready-fadv__table_z25_l1x_vkb}  
   注:  
   * ここに記載されているとおりに、\[値\] フィールドに正確な数値を入力してください。これらの数値に変更がある場合、スポークフローはトリガーされません。
   * レコードがグローバルアプリケーションで作成されていることを確認します。
   {#draft-inp-ready-fadv__ul_dhl_zpy_vkb}
4. \[送信\] をクリックします。
5. 同様に、準備完了状況処理中状況のレコードを作成します。  
   {#draft-inp-ready-fadv__table_v1g_mdy_vkb__entry__2}

   | フィールド | 値 |
   |-|-|
   | テーブル | タスク \[task\] |
   | 要素 | 状況 |
   | ラベル | 準備完了 |
   | 値 | 173 |
   [表 : 3. レコード 2：準備完了ステータス]

   {#draft-inp-ready-fadv__table_v1g_mdy_vkb} {#draft-inp-ready-fadv__table_wyf_mdy_vkb__entry__2}

   | フィールド | 値 |
   |-|-|
   | テーブル | タスク \[task\] |
   | 要素 | 状況 |
   | ラベル | 進行中 |
   | 値 | 181 |
   [表 : 4. レコード 3：処理中ステータス]

   {#draft-inp-ready-fadv__table_wyf_mdy_vkb}  
   注:  
   * ここに記載されているとおりに、\[値\] フィールドに正確な数値を入力してください。これらの数値に変更がある場合、スポークフローはトリガーされません。
   * レコードがグローバルアプリケーションで作成されていることを確認します。
   {#draft-inp-ready-fadv__d49994e135}
{#draft-inp-ready-fadv__steps_nkw_tbx_vkb}

#### タスクの結果

タスク \[task\] テーブルでドラフト、準備完了、および処理中の状況が作成されます。

### 完了状況とキャンセル状況の作成 {#ariaid-title5}

First Advantage タスク \[sn_fadv_spoke_first_adventage_task\] テーブルに完了状況とキャンセル状況を作成します。

#### 始める前に

必要なロール：admin

#### 手順

1. 移動先 すべてFirst Advantage スポーク注文タスク.
2. \[新規\] をクリックします。  
   注:  
   レコードが First Advantage アプリケーションで作成されていることを確認します。
3. \[ステータス\] を右クリックし、\[選択を設定\] を選択します。
4. \[キャンセル\] ステータスを作成するには、次の手順を実行します。
   1. \[新しいアイテムのテキスト\] に「<kbd class="ph userinput">キャンセル</kbd>」と入力します。
   2. \[数値\] に「<kbd class="ph userinput">149</kbd>」と入力します。  
      注:  
      ここに記載されているとおりに、\[数値\] フィールドに正確な数を入力してください。これらの数値に変更がある場合、スポークフローはトリガーされません。
   3. \[追加\] をクリックします。
   4. \[保存\] をクリックします。
   {#add-complete-canc-fadv__substeps_oly_w2d_wkb}
5. \[完了\] ステータスを作成するには、次の手順を実行します。
   1. \[新しいアイテムのテキスト\] に「<kbd class="ph userinput">完了</kbd>」と入力します。
   2. \[数値\] に「<kbd class="ph userinput">127</kbd> 」と入力します。  
      注:  
      ここに記載されているとおりに、\[数値\] フィールドに正確な数を入力してください。これらの数値に変更がある場合、スポークフローはトリガーされません。
   3. \[追加\] をクリックします。
   4. \[保存\] をクリックします。
   {#add-complete-canc-fadv__substeps_oxx_2fd_wkb}

#### タスクの結果

First Advantage タスク \[sn_fadv_spoke_first_advantage_task\] テーブルに完了状況とキャンセル状況が作成されます。

### 完了：成功状況および完了：交渉決裂状況の作成 {#ariaid-title6}

First Advantage 従業員タスク \[sn_fadv_spoke_first_advantage_employee_task_table\] テーブルに完了：成功状況および完了：交渉決裂状況を作成します。

#### 始める前に

必要なロール：admin

#### 手順

1. 移動先 すべてFirst Advantage スポーク従業員タスク.
2. \[新規\] をクリックします。  
   注:  
   レコードが First Advantage アプリケーションで作成されていることを確認します。
3. \[ステータス\] を右クリックし、\[選択を設定\] を選択します。
4. \[キャンセル\] ステータスを作成するには、次の手順を実行します。
   1. \[新しいアイテムのテキスト\] に「<kbd class="ph userinput">完了：成功</kbd>」と入力します。
   2. \[数値\] に「<kbd class="ph userinput">161</kbd>」と入力します。  
      注:  
      ここに記載されているとおりに、\[数値\] フィールドに正確な数を入力してください。これらの数値に変更がある場合、スポークフローはトリガーされません。
   3. \[追加\] をクリックします。
   4. \[保存\] をクリックします。
   {#add-complete-state-fadv__substeps_oly_w2d_wkb}
5. \[完了\] ステータスを作成するには、次の手順を実行します。
   1. \[新しいアイテムのテキスト\] に「<kbd class="ph userinput">完了：交渉決裂</kbd>」と入力します。
   2. \[数値\] に「<kbd class="ph userinput">117</kbd> 」と入力します。  
      注:  
      ここに記載されているとおりに、\[数値\] フィールドに正確な数を入力してください。これらの数値に変更がある場合、スポークフローはトリガーされません。
   3. \[追加\] をクリックします。
   4. \[保存\] をクリックします。
   {#add-complete-state-fadv__substeps_oxx_2fd_wkb}
{#add-complete-state-fadv__steps_cxx_xyd_wkb}

#### タスクの結果

First Advantage 従業員タスク \[sn_fadv_spoke_first_advantage_employee_task_table\] テーブルに完了：成功状況および完了：交渉決裂状況が作成されます。

## First Advantage Webhook のセットアップ {#ariaid-title7}

Webhook を設定して、ServiceNow インスタンスで招待および注文イベントの更新を受信します。

### 始める前に

必要なロール：アドミン

### First Advantage スポークの認証キーの作成 {#ariaid-title8}

Jenkins からの要求を承認するための認証キーを作成します。

#### 始める前に

必要なロール：アドミン

#### 手順

1. 移動先 すべてシステム定義スクリプト - バックグラウンド.
2. \[スクリプトを実行 (サーバー上で実行される JavaScript)\] テキストフィールドで、次のコマンドを入力します。  
   `gs.info(GlideSecureRandomUtil.getSecureRandomString(32));`
3. \[スクリプトを実行\] をクリックします。
4. 後で使用するために生成された値をコピーして記録します。  
{#create-authorization-key-first-advantage__steps_mcx_5wd_s2c}

### ServiceNow インスタンスの署名キーの指定 {#ariaid-title9}

First Advantage Webhook クライアントにキーを指定して、First Advantage Webhook を設定します。

#### 始める前に

* [First Advantage スポークの認証キーの作成](https://servicenow-prod.fluidtopics.net/xpaffIGScDTFfi6Jf7_RKA#create-authorization-key-first-advantage "Jenkins からの要求を承認するための認証キーを作成します。") 値を記録します。
* 必要なロール：アドミン
{#add-fadv-key__ul_qxk_yq2_wkb}

#### 手順

1. 移動先 すべてFirst Advantage スポークFADV Webhook クライアントの詳細.
2. \[新規\] をクリックします。
3. フォームに、これらの値を入力します。  
   {#add-fadv-key__table_gx1_fr2_wkb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 名前 | レコードを一意に識別する名前。 |
   | 認証キー | 生成された認証キー詳細については、「[First Advantage スポークの認証キーの作成](https://servicenow-prod.fluidtopics.net/xpaffIGScDTFfi6Jf7_RKA#create-authorization-key-first-advantage "Jenkins からの要求を承認するための認証キーを作成します。")」を参照してください。 |
   [ ]

   {#add-fadv-key__table_gx1_fr2_wkb}
4. \[送信\] をクリックします。

### アクセス API エンドポイント {#ariaid-title10}

招待イベントと注文イベントの API エンドポイントにアクセスし、必要な詳細を First Advantage と共有して Webhook を設定します。

#### 始める前に

必要なロール：アドミン

#### 手順

1. 移動先 すべてSystem Web Servicesスクリプト化 REST API.
2. First Advantage スポークのレコードを開きます (例：First Advantage Webhook)。
3. \[リソース\] タブで、次を実行します。
   1. 招待イベントのレコードを開きます (例：招待ステータス)。
   2. \[リソースパス\] に入力されたパスをコピーして記録します (例：<kbd class="ph userinput">/api/sn_fadv_spoke/fadv/invite_status</kbd>)。
   3. 注文イベントのレコードを開きます (例：注文ステータス)。
   4. \[リソースパス\] に入力されたパスをコピーして記録します (例：<kbd class="ph userinput">/api/sn_fadv_spoke/fadv/order_status</kbd>)。
   {#conf-api-fadv__substeps_cyb_md2_wkb}
{#conf-api-fadv__steps_gft_kr2_wkb}

#### 次のタスク

First Advantage に連絡して、ServiceNow インスタンスの Webhook を設定します。このために、次の詳細を First Advantage と共有します。

* 次の形式のカスタムヘッダー：<kbd class="ph userinput">fadvKey &lt;authorization-key&gt;</kbd>  
  注:  
  * カスタムヘッダーがこの形式のみであることを確認します。変更がある場合、スポークフローはトリガーされません。
  * 以前に指定したものと同じキーを指定します First Advantage スポークFADV Webhook クライアントの詳細.
  * ここでの説明と同じケースの <kbd class="ph userinput">fadvKey</kbd> を使用します。
  {#conf-api-fadv__ul_kfx_lvc_ykb}
* 次の形式の招待イベントの API エンドポイント：<kbd class="ph userinput">&lt;ServiceNow-instance-URL&gt;/api/sn_fadv_spoke/fadv/invite_status</kbd>
* 次の形式の注文イベントの API エンドポイント：<kbd class="ph userinput">&lt;ServiceNow-instance-URL&gt;/api/sn_fadv_spoke/fadv/order_status</kbd>
{#conf-api-fadv__ul_jgh_5d2_wkb}

## First Advantage アカウントおよびパッケージと ServiceNow との同期 {#ariaid-title11}

First Advantage アカウントとパッケージを ServiceNow と同期して、First Advantage アカウントとパッケージの詳細を保存します。

### 始める前に

必要なロール：First Advantage admin

### 手順

1. 移動先 すべてFirst Advantage スポークアカウント.
2. \[新規\] をクリックします。
3. フォームに、次の値を入力します。  
   {#sync-packages-fadv__table_hhk_nzk_ynb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | プライマリアカウント | アカウントがプライマリアカウントであることを指定するオプション。チェックボックスをオンにします。 |
   | アカウント ID | プライマリアカウントの ID。 |
   | アカウント名 | プライマリアカウントの名前。 |
   [表 : 5. アカウントフォーム]

   {#sync-packages-fadv__table_hhk_nzk_ynb}
4. \[送信\] をクリックします。  
   プライマリアカウントが作成され、レコードが表示されます。
5. 移動先 First Advantage スポークアカウント.
6. \[アカウントを取得\] 関連リストをクリックします。
7. 移動先 First Advantage スポークパッケージ.
8. \[パッケージの取得\] 関連リンクをクリックします。
{#sync-packages-fadv__steps_evy_h1l_ynb}

### タスクの結果

First Advantage アカウントとパッケージの詳細が取得されます。  
注:  
FADV admin ロールを持つユーザーのみが、アカウントとパッケージの詳細を同期できます。FADV user ロールを持つユーザーは、取得した詳細のみを表示できます。