---
title: 例: Webhook 値を使用した Go To Record クイック アクション を使用してレコードを作成および更新する (GAD)
slug: neurons-for-itsm/admin-user-help/jpn/latest/webhook-go-to-record-gad
createdAt: 2026-10-29T01:28:19.827Z
---

この例では、Webhook が提供する値を使用して、Go to Record クイック アクション を使用して次のタスクを実行する方法を示します。

- この例では、「レコードへ移動」を使用するときに、移動先のレコードが存在しない場合、「レコードへ移動」クイック アクションで提供された情報を使用して新しいレコードを作成する方法を示します 。
- レコードの更新 クイック アクションを使用してレコード内の値を更新することで、新しいレコードがフォーカスを取得することを示します。
- Webhook を使用して、レコードへの移動、レコードの作成、レコードの更新のすべての値を指定する方法。

:::hint{type="info"}
Webhook の値は、アクションで使用するために、Update Variables And Stored Values クイック アクション に保存されます。 Postman アプリケーションは、Webhook POST リクエストを実行エンドポイントに送信するときに REST-API クライアントとして使用されます。
:::

## 前提条件

:::hint{type="info"}
「レコードへ移動」クイック アクションを使用するには、グローバル定数 **EnableActionService&#x20;**&#x3092; **True&#x20;**&#x306B;設定します。
:::

この例では、 **構成コンソール** への管理者レベルのアクセス権があり、ビジネス オブジェクトおよび クイック アクションの作成に精通していることを前提としています。

給与責任者で Webhook に実行リクエストを送信する前に、3 セットのタスクを完了する必要があります。

1. 既存のビジネス オブジェクト (この例では、 **プロジェクト**ビジネス オブジェクトを使用) に、アクション **変数と保存された値の更新**、 **レコードに移動** 、および **レコードの更新** を含む複合アクションを作成します。
2. 上記で作成した複合アクションを参照する Webhook を作成します。
3. Execute POST リクエストで認証として使用する API キーを作成します。

::::ExpandableHeading
## 項目1: プロジェクトビジネスオブジェクトの複合アクションを作成する

1. 給与責任者に管理者としてログインします。
2. **構成コンソール** > **ビルド** >**ビジネス オブジェクト** >**&#x20;プロジェクト** > **クイック アクション** > **グラフィカル アクション デザイナ**に移動します。
3. 「**高度なアクション**」の下で、 「**変数と保存された値の更新**」 クイック アクションブロックを見つけて、デザイナー ボードにドラッグします。
4. 共**通 設**定タブで、 名**前 フ**ィールドに名前を入力します (例: C**reateAndUpdatewithGTRWithWHValues)**。 これはアクションセット全体の名前です。
5. 自**動保存を**選択します。

:::hint{type="info"}
複合アクションの使用中に問題が発生した場合、自動保存により、その時点までに加えられた変更がすべて保存されます。
:::

6. ブ**ロック 設**定タブで、 エ**ディターを**クリックします。 次の値を選択または入力します。

| 分野                    | パラメータ                  |
| --------------------- | ---------------------- |
| 変数タイプ                 | 変数                     |
| 変数名                   | ウェブフック本体               |
| データタイプ                | JSON または XML           |
| 値 (JSON)<br />値 (XML) | \{}<br />\<xml>\</xml> |

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/-zgWlpyVYXmq_JiYMFXOn_examplegotorecordwithwebhook1.png" alt="例の最初の画像は、「保存された値と変数の更新」アクション ブロックの値を示しています。" position="flex-start" size="100" width="710" height="96" initialPath="images/example_go_to_record_with_webhook_1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_1.png" showCaption="false" indent="1"}

7. 画面下部の「 **OK&#x20;**」をクリックします。
8. \[**アクションの記録**]の下で、 \[**記録に移動**] クイック アクションを見つけて、ブロックをデザイナー ボードにドラッグ アンド ドロップします。
9. 「**記録へ移動」&#x20;**&#x30D6;ロックを 「**変数と保存された値を更新」&#x20;**&#x30D6;ロックにリンクして、後者がチェーンの 2 番目のブロックになるようにします。
10. 「**レコードに移動」 の** 「**ブロック」タ**ブでは、 「**ビジネス オブジェクト」&#x20;**&#x30D5;ィールドに現在のビジネス オブジェクト名が事前に入力されており、編集できません。
11. 次のようにフィールドに入力します。

| 分野                              | パラメータ                                                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| フィールド名                          | プロジェクト名                                                                                                                   |
| フィールド値 (JSON)<br />フィールド値 (XML) | $(JSONPathValue(Variable("WebhookBody"), "$.gotonamevalue"))<br />$(XPathValue(Variable(“WebhookBody”), "gotonamevalue")) |
| 見つからない場合は新しいレコードを作成します          | 選択済み                                                                                                                      |

12. 作成時に新しいレコードを入力するには、以下のように値を入力します。 必要に応じて、フィールドと値のペアをさらに追加するには、「 **フィールドの追加** 」を使用します。

| 分野                              | パラメータ                                                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| フィールド名                          | プロジェクト名 (プロジェクト)                                                                                                          |
| フィールド値 (JSON)<br />フィールド値 (XML) | $(JSONPathValue(Variable("WebhookBody"), "$.gotonamevalue"))<br />$(XPathValue(Variable(“WebhookBody”), "gotonamevalue")) |

| 分野                              | パラメータ                                                                                                         |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| フィールド名                          | まとめ                                                                                                           |
| フィールド値 (JSON)<br />フィールド値 (XML) | $(JSONPathValue(Variable("WebhookBody"), "$.summary"))<br />$(XPathValue(Variable(“WebhookBody”), "summary")) |

| 分野     | パラメータ                         |
| ------ | ----------------------------- |
| フィールド名 | ProjectOwnerLink (プロジェクトオーナー) |
| フィールド値 | $(CurrentUserRecId())         |

| 分野     | パラメータ                  |
| ------ | ---------------------- |
| フィールド名 | ProjectStartDate (開始日) |
| フィールド値 | $(CurrentDateTime()    |

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/MD99CBfr7YBHlAN5-zBmv_examplegotorecordwithwebhook2.png" alt="レコードに移動アクションブロックのフィールド値を示す例の 2 番目の画像" position="flex-start" size="100" width="937" height="610" initialPath="images/example_go_to_record_with_webhook_2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_2.png" showCaption="false" indent="1"}

13. **レコードアクション**の下で、 **レコードの更新** クイック アクション を見つけて、ブロックをデザイナーボードにドラッグアンドドロップします。
14. これを **Go to Record** ブロックにリンクして、複合アクションで 3 番目に実行されるようにします。
15. レ**コードの更新 の** ブ**ロックタ**ブで、以下のように値を選択または入力します。

| 分野                              | パラメータ                                                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| フィールド名                          | まとめ                                                                                                                       |
| フィールド値 (JSON)<br />フィールド値 (XML) | $(JSONPathValue(Variable("WebhookBody"), "$.secondsummary"))<br />$(XPathValue(Variable(“WebhookBody”), "secondsummary")) |

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/4bv6CJSqT3ZHicm76XlMu_examplegotorecordwithwebhook3.png" alt="レコード更新ブロックの値を示す例の 3 番目の画像" position="flex-start" size="100" width="911" height="438" initialPath="images/example_go_to_record_with_webhook_3.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_3.png" showCaption="false" indent="1"}

16. **\[保存]**&#x3092;クリックします。
::::

:::ExpandableHeading
## 項目 2: 上記で作成した複合アクションを参照する Webhook を作成します。

1. 給与責任者に管理者としてログインします。
2. 構**成コンソール >** ビ**ルド >**&#x57;**ebhooks マネージャーに**移動します。
3. 新**しい Webhook を追加を**クリックします。
4. 次のようにフィールドに入力します。

| 分野         | パラメータ                                                       |
| ---------- | ----------------------------------------------------------- |
| 名前         | GTR と WH 値による作成と更新                                          |
| エンドポイント拡張  | ウェブH2                                                       |
| 状態         | 有効                                                          |
| ビジネスオブジェクト | プロジェクト (FrsProject)                                         |
| アクション      | CreateAndUpdatewithGTRWithWHValues (リストから作成した複合アクションを選択します) |

5. **\[保存]**&#x3092;クリックします。
:::

:::ExpandableHeading
## 項目3: APIキーを作成する

1. 給与責任者に管理者としてログインします。
2. 構**成コンソール >** 構**成>**&#x30BB;**キュリティ コントロール&#x20;**> A**PI キーに**移動します。
3. キ**ーグループ&#x20;**&#x306E;いずれかにある A**PI キーの追加&#x20;**&#x3092;クリックして、Webhook 用の新しい API キーを作成します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/BjoHTowEm7NPUfUENMQTR_examplegotorecordwithwebhook4.png" alt="セキュリティコントロールでの API キーの作成を示す画像 4" position="flex-start" size="100" width="1336" height="275" initialPath="images/example_go_to_record_with_webhook_4.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_4.png" showCaption="false" indent="1"}

4. 次のようにフィールドに値を入力します。

| 分野    | パラメータ          |
| ----- | -------------- |
| 説明    | Webhook API キー |
| に代わって | ユーザ名           |
| 役割    | 管理者            |

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/vDkJF8WOm1g_Hm54vDAAa_examplegotorecordwithwebhook5.png" alt="WebhookのAPIキーの作成" position="flex-start" size="100" width="865" height="381" initialPath="images/example_go_to_record_with_webhook_5.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_5.png" showCaption="false" indent="1"}

5. キ**ーを保存を**クリックします。
6. API キー リスト ページに移動するには、\[ **戻る** ] をクリックします。
7. API キーをメモしてください。 これはExecute POSTリクエストのAuthorization値として使用されます。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/xcWOnvI3hUn82yiw6bvp2_examplegotorecordwithwebhook6.png" alt="新しく作成された API キーを表示する API キー リスト - これをメモする必要があります。" position="flex-start" size="100" width="980" height="291" initialPath="images/example_go_to_record_with_webhook_6.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_6.png" showCaption="false" indent="1"}
:::

## Webhookと複合アクションの実行

すべての前提条件が完了したら、Webhook と複合アクションを実行できるようになります。

1. HTTP リクエストを送信できる Postman または同様のアプリケーションを開きます。
2. 以下のように、EndpointExtension、Authorization ヘッダー、JSON/XML 本文を含む URL を指定して、実行エンドポイントの POST リクエストを作成します。
   - POST リクエスト ヘッダーに、画像に示すように、以前にメモした API キーを追加します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/puMmGhvmOHkDwXj4HYZKU_examplegotorecordwithwebhook8.png" alt="Postmanのヘッダーセクションの認証APIキー" position="flex-start" size="100" width="1015" height="286" initialPath="images/example_go_to_record_with_webhook_8.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_8.png" showCaption="false" indent="1"}

:::Paragraph{listStyleType="disc" indent="2"}
大文字と小文字を区別するエンドポイント拡張機能を POST URL の末尾に追加します: `https://[your server]/api/rest/Webhooks/Execute?extension=WebH2`。 Webhook を作成するときに POST URL が表示されます。
:::

:::Paragraph{listStyleType="disc" indent="2"}
JSON 本文で、クイック アクション変数で使用される値を送信します。
:::

:::Paragraph{indent="1"}
例えば：
:::

\{

"gotonamevalue": "new record",

"要約": "要約が更新されました",

"secondsummary": "要約が 2 回目に更新されました"

}

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/hkrTrkkOcfz_B5rXtZ38j_examplegotorecordwithwebhook7.png" alt="Postman経由で送信するHTTP POSTリクエスト" position="flex-start" size="100" width="1209" height="431" initialPath="images/example_go_to_record_with_webhook_7.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_7.png" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
\:XML: : :
:::

\<xml>

\<gotonamevalue>新記録\</gotonamevalue>

\<summary>概要を更新しました\</summary>

\<secondsummary>概要を2度目に更新しました\</secondsummary>

\</xml>

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/qd6XKcMKpcBtdc-Uh-VA1_examplegotorecordwithwebhook10.png" alt="Postman リクエストの XML バージョン" position="flex-start" size="100" width="720" height="279" initialPath="images/example_go_to_record_with_webhook_10.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_10.png" showCaption="false" indent="1"}

:::hint{type="info"}
プ**ロジェクト&#x20;**&#x30EF;ークスペース、 名**前 列**に、 g**otonamevalue と**同じ値を持つ既存のレコードが存在しない必要があります。
:::

3. 送**信を**クリックします。
4. Postman で成功した応答として **Status 200 OK** を受信したことを確認します。
5. 給与責任者で、 **プロジェクト** ワークスペースを開き、手順 12 の **レコードに移動&#x20;**&#x30A2;クションの **新しいレコードの作成** セクションのフィールドと値を使用して、新しいレコードが作成されたかどうかを確認します。
   - Postman 経由で送信された Webhook 値を含む新しいレコードが、 **Name** =`new record`で作成されているはずです。
   - N**ame (**&#x4A;SON/XML 本文で提供される g**otonamevalue )** を持つレコードのS**ummary&#x20;**&#x304C;、JSON/XML 本文で提供される s**econdsummary&#x20;**&#x5024;で更新されました (このセクションの手順 2 を参照)。
   - 新しいレコードの **Summary&#x20;**&#x5024;には、 **secondsummary** フィールドに指定された値が含まれます。

:::hint{type="info"}
**レコードへ移動&#x20;**&#x30AF;イック アクションは、Webhook の値を使用して新しいレコードを作成し、そのレコードに移動します。 次に、 **レコードの更新** クイック アクション は、Webhook **secondsummary** (手順 15 を参照) の値を使用して、レコードの **Summary** 値を更新します。
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/zRP3A4tf3xwVbZWFxZl0X_examplegotorecordwithwebhook9.png" alt="アクション ブロックと Webhook の組み合わせアクションを使用して、選択した情報でレコードが作成および更新されました。" position="flex-start" size="100" width="1081" height="166" initialPath="images/example_go_to_record_with_webhook_9.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/example_go_to_record_with_webhook_9.png" showCaption="false" indent="1"}
