---
title: 回避策: Webhook を使用してインシデントを更新する
slug: neurons-for-itsm/admin-user-help/jpn/latest/dbXA-webhook
createdAt: 2026-10-29T01:28:26.424Z
---

## シナリオ

これは、初期の Webhook 実装で **Insert Object** 以外のアクション タイプを使用できるようにするための回避策の概念実証です。 これは上級ユーザー向けの複雑な回避策ですので、 Ivanti サービス マネージャの将来のリリースで完全に実装されるまで待つことができる場合は、そうすることをお勧めします。

インシデント レコードの説明を更新するには、Webhook を使用します。これは、ステージング ビジネス オブジェクトとトリガーされたアクションを使用して自動的に実行できます。

:::hint{type="info"}
**重要**: テスト中に、トリガーされたアクションを使用してステージング ビジネス オブジェクトを自動的に削除する操作が機能しませんでした。 したがって、 **Done&#x20;**&#x30D5;ィールドが **True**に設定されているステージング レコードを手動で削除するか、スケジュールに従って実行されるアクション/ワークフローを設定して、これを実行する必要があります。
:::

### 前提条件

この例を再現するには、 給与責任者 管理者であり、Postman などの外部 API ツールにアクセスできる必要があります。

## 仕組み

![](https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/daxkQAncSMJoK1ZZh8jtu_workaround-webhook-creation1.png)

1. Postman または同様のツールを使用して、 給与責任者 Webhook 経由で **WebhookStaging** ビジネス オブジェクトにリクエストを送信します。 このリクエストでは、更新するインシデント レコードの **RecID** と新しい説明がすべてリクエスト本文に含まれます。
2. リクエストを受信すると、 **WebhookStaging** ビジネス オブジェクトによって **Create a New Record** アクション (この例では **Create Staging** と呼ばれます) が実行され、新しいレコードが作成され、リクエスト本体のすべてのデータが **DataField**に配置されます。
3. 同じアクション (**新しいレコードの作成**) で、式によってリクエスト本文から **RecID&#xA0;**&#x304C;抽出され、新しく作成された **WebhookStaging&#x20;**&#x30AA;ブジェクト レコードの ID フィールドに入力されます。
4. W**ebhookStaging レ**コードが作成されると、トリガーされたアクションによって U**pdate a Record&#x20;**&#x30A2;クションが実行され、 D**one&#x20;**&#x30D5;ィールドの値が f**alse&#x20;**&#x304B;ら t**rueに**変更されます。
5. 同時に、 **子で実行** アクションは、インシデント レコードに対して **レコードを更新** アクションを実行するように構成され、これにより **データ フィールド&#x20;**&#x304B;ら説明が取得され、インシデント レコードの **説明&#x20;**&#x30D5;ィールドが更新されます。

::::ExpandableHeading
## WebhookStagingビジネスオブジェクトを作成する

1. 給与責任者で、 **WebhookStaging**というビジネス オブジェクトを作成します。
2. ビジネス オブジェクトに次の追加フィールドを作成します。

| 分野       | 表示名      | タイプ      | ヌル可能 | 保存済み |
| -------- | -------- | -------- | ---- | ---- |
| データフィールド | データフィールド | テキスト(最大) | 選択済み | 選択済み |
| 終わり      | 終わり      | ブール      | 選択済み | 選択済み |
| レコードID   | レコードID   | リンク      | 選択済み | 選択済み |

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/oE4p1rs6kACtjZEaITtzd_workaround-bo-creation1.png" position="flex-start" size="100" width="1172" height="421" initialPath="images/workaround-bo-creation1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-bo-creation1.png" showCaption="false" indent="1"}

3. W**ebhookStaging&#x20;**&#x30D3;ジネス オブジェクトの R**elationships を**クリックし、図のようにステージング ビジネス オブジェクトと Incident ビジネス オブジェクト間の関係を設定します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/iShpvLiUVVC6RSAHxTXCW_workaround-bo-creation2.png" position="flex-start" size="98" width="683" height="605" initialPath="images/workaround-bo-creation2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-bo-creation2.png" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
ステージング ビジネス オブジェクトは、インシデント ビジネス オブジェクト **(** には 0 個以上&#x306E;**&#x20;が含まれており、**&#x4C;ink **フィールドにインシデント RecID が格納されます。**
:::
::::

::::ExpandableHeading
## 給与責任者 で「CreateStaging」アクションを作成する

**CreateStaging** は、 **Create a New Record** アクション ブロックに基づいており、Webhook に送信されたデータをダンプするステージング オブジェクトと、更新するレコードの **RecID&#x20;**&#x3092;作成するために使用されます。

1. グ**ラフィカル アクション デザイナーを**開きます。

:::Paragraph{indent="1"}
参照: [グラフィカル アクション デザイナ (GAD) の使用](docId\:mCY-aA4Y7o3ZvBxFbZdw3)。
:::

:::hint{type="info"}
**ヒント:&#x20;**&#x5FC5;要に応じて、 **クラシック アクション デザイナー** を使用することもできます。
:::

2. 変**数と保存された値の更新&#x20;**&#x30A2;クション ブロック タイプを使用して新しいブロックを作成します。 このブロックは、アクションで使用される保存された値と変数を更新します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/76VwcxXcjaEo0hcMueL-l_workaround-qa-creation1.png" position="flex-start" size="92" width="643" height="154" initialPath="images/workaround-qa-creation1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-qa-creation1.png" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
詳細については、次を参照してください: [保存された値と変数を更新する クイック アクション](docId\:U-h34CmI5j9n-sRIiEhrF)
:::

3. 変**数と保存された値の更新&#x20;**&#x30A2;クション ブロックを構成して、Webhook エンドポイントに渡されたデータを必要な変数 W**ebhookBodyに**保存します。 次のように値を編集します。

| 分野     | 価値       |
| ------ | -------- |
| 変数タイプ  | 変数       |
| 名前     | ウェブフック本体 |
| データタイプ | 翻訳       |
| 価値     | \{}      |

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/mu0hmHAK9xkuX8QcZRuB4_csm-eg-itsm-qa1.png" position="flex-start" size="100" width="1329" height="238" initialPath="images/csm-eg-itsm-qa1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/csm-eg-itsm-qa1.png" showCaption="false" indent="1"}

4. 新**しいレコードを作成する&#x20;**&#x30A2;クション ブロック タイプを使用して新しいブロックを作成し、それを 変**数と保存された値を更新する&#x20;**&#x30A2;クション ブロックに添付します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/-2EAYAPG3HgYVpDTl-o-z_workaround-webhook-creation2.png" position="flex-start" size="80" width="563" height="118" initialPath="images/workaround-webhook-creation2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-webhook-creation2.png" showCaption="false" indent="1"}

5. 新**しいレコードを作成する&#x20;**&#x30D6;ロックを編集します。

:::Paragraph{indent="1"}
各フィールドについて、 **簡易式エディタ&#x20;**&#x3092;使用して式を作成し、変数を使用してその特定のフィールドに入力します。 D**ataField お**よび R**ecordID フ**ィールドは、Webhook データから入力されます。 R**ecordIDの**場合、式は JSON パスの値を取得し、それを使用してフィールドに入力します。 この式を使用して、 **RecordID** フィールドに入力します。
:::

:::Paragraph{indent="1"}
`$(JSONPathValue(Variable("WebhookBody"), "$.incidentRecId"))`
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/7d_WFGQK7zPfFrKZXQLbg_workaround-webhook-creation3.png" position="flex-start" size="38" width="267" height="587" initialPath="images/workaround-webhook-creation3.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-webhook-creation3.png" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
ターゲットビジネスオブジェクト (Incident) は、 **RecordIdCategory** フィールドに設定されます。
:::

:::Paragraph{indent="1"}
ヘルプについては、「 [簡易式エディタの使用](docId\:xMuy81M1jVTpvus2dXIqV)
:::

6. アクションを「 **Create Staging**」として保存します。
::::

::::ExpandableHeading
## 給与責任者 でWebhookを作成する

新**しいレコードの作成&#x20;**&#x30A2;クションをトリガーする Webhook を作成し、Webhook データと RecID をステージング ビジネス オブジェクト W**ebhookStagingに**格納します。

1. 設**定 メ**ニューで、 ビ**ルド&#x20;**&#x30BB;クションの W**ebhooks マネージャー を**クリックします。

:::Paragraph{indent="1"}
W**ebhooks マネージャー&#x20;**&#x304C;開きます。
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/mJCkdTp4-GYAmfubQy3Zx_creatingwebhook.png" position="flex-start" size="100" width="1691" height="811" initialPath="images/creating_webhook.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/creating_webhook.png" showCaption="false" indent="1"}

2. W**ebhook の追加を**クリックします。
3. 次の情報をフィールドに入力します:

| 分野            | 価値                                                                        |
| ------------- | ------------------------------------------------------------------------- |
| 名前            | インシデントの説明を更新                                                              |
| 説明            | この Webhook はステージング オブジェクトを作成し、トリガーされたアクションを実行して関連するインシデントの説明を更新します。       |
| エンドポイント拡張     | アップデートインシデント<br />**注:** エンドポイント拡張子では大文字と小文字が区別されます。                      |
| 完全なエンドポイント    | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=UpdateIncident |
| ビジネスオブジェクトの選択 | Webhookステージング（Webhookステージング）                                              |
| アクションを選択      | CreateStaging (複合アクション)                                                   |

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/daxkQAncSMJoK1ZZh8jtu_workaround-webhook-creation1.png" position="flex-start" size="100" width="1050" height="698" initialPath="images/workaround-webhook-creation1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-webhook-creation1.png" showCaption="false" indent="1"}

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

:::Paragraph{indent="1"}
「 **Webhook が正常に作成されました**」という確認メッセージが表示されます。 Webhook がリストに表示され、デフォルトで有効になります。
:::
::::

::::ExpandableHeading
## レコード更新アクションを作成する

レ**コードの更新&#x20;**&#x30A2;クションは **子で実行**アクションから実行され、関連する W**ebhookStaging オ**ブジェクトにダンプされたデータを取得して、ターゲット オブジェクトの説明を更新します。

1. グ**ラフィカル アクション デザイナーを**開きます。

:::Paragraph{indent="1"}
参照: [グラフィカル アクション デザイナ (GAD) の使用](docId\:mCY-aA4Y7o3ZvBxFbZdw3)。
:::

2. 説**明の更新&#x20;**&#x30D6;ロック タイプを使用して新しいブロックを作成します。 名前を付けます **レコードを更新します**。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/xfYWVCcm1sqFYTKgpOA8O_workaround-2ndqa-creation1.png" position="flex-start" size="99" width="692" height="222" initialPath="images/workaround-2ndQA-creation1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-2ndQA-creation1.png" showCaption="false" indent="1"}

3. レ**コードの更新&#x20;**&#x30D6;ロックを編集します。

:::Paragraph{indent="1"}
簡略化された式エディターを使用して式を作成し、 **データフィールド&#x20;**&#x304B;らコンテンツを取得して、それをインシデント **説明&#x20;**&#x30D5;ィールドに解析します。 次の表現を使用してください:
:::

:::Paragraph{indent="1"}
`$(JSONPathValue([WebhookStaging#.WebhookStaginAssocIncident]DataField, "$.description"))`
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/I40iOboTGmsI9inyGDz1z_workaround-2ndqa-creation2.png" position="flex-start" size="33" width="230" height="264" initialPath="images/workaround-2ndQA-creation2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-2ndQA-creation2.png" showCaption="false" indent="1"}
::::

::::ExpandableHeading
## 給与責任者 でトリガーアクションを設定する

W**ebhookStaging ビ**ジネス オブジェクトに対して 2 つのトリガー アクションを設定します。 これらの 1 つには、 **子で実行**に基づいたアクションが含まれています。

1. W**ebhookStaging&#x20;**&#x30D3;ジネス オブジェクトを開いた状態で、 ビ**ジネス ルールを**クリックします。
2. ト**リガーされたアクションを**クリックします。
3. 次のように 2 つのトリガー アクションを作成します。

:::hint{type="info"}
**ヒント:** 「 **次へ&#x20;**」をクリックして次の画面に移動し、トリガーされたアクションごとにテーブルに表示されるすべてのフィールドを確認します。
:::

| トリガー1                | 価値                           |
| -------------------- | ---------------------------- |
| 名前                   | 完了をTrueに設定する                 |
| オブジェクトイベント           | 挿入時                          |
| このトリガーによって実行されるアクション | アクション: オブジェクトの更新             |
| ターゲットオブジェクトフィールド     | 完了 = $(true)<br />上書き = 選択済み |

| トリガー2                | 価値                    |
| -------------------- | --------------------- |
| 名前                   | トリガーインシデントの更新         |
| オブジェクトイベント           | 挿入時                   |
| このトリガーによって実行されるアクション | 子で実行                  |
| **子で実行の構成**          |                       |
| 子オブジェクトと関係           | Webhookステージング関連インシデント |
| 新規追加 > 実行するアクション     | アップデートの説明             |

:::Paragraph{indent="1"}
**子で実行**アクションは、ステージング オブジェクトの作成時にトリガーされ、ステージング ビジネス オブジェクトとターゲット レコード間の関係を使用して 3 番目のアクションを実行します。
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/hDtrcBKv3mcrsdPkerndD_workaround-rfcqa-creation1.png" position="flex-start" size="80" width="562" height="340" initialPath="images/workaround-rfcQA-creation1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-rfcQA-creation1.png" showCaption="false" indent="1"}

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/Tax99bIk3DdtT4WZ27g0l_workaround-rfcqa-creation2.png" position="flex-start" size="100" width="1230" height="396" initialPath="images/workaround-rfcQA-creation2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-rfcQA-creation2.png" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
次のフィールドを使用してトリガーアクションを作成します。
:::

| 分野        | 価値                    |
| --------- | --------------------- |
| 名前        | 子で実行                  |
| 関係        | Webhookステージング関連インシデント |
| 実行するアクション | アップデートの説明             |

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

:::ExpandableHeading
## レコードの説明を更新するリクエストを送信する

1. これは、更新する説明を含むターゲット インシデント レコードです。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/Wxy_pBV1s7g68rvad81ax_workaround-demo1.png" position="flex-start" size="100" width="1342" height="460" initialPath="images/workaround-demo1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-demo1.png" showCaption="false" indent="1"}

2. Postman または同様のツールを使用して、対象のインシデントの **RecID** と新しい **説明** をリクエストで送信します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/YDdC6x-k7mQefVfSts0kq_workaround-demo2.png" position="flex-start" size="100" width="860" height="449" initialPath="images/workaround-demo2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-demo2.png" showCaption="false" indent="1"}

3. Postman で \[ **送信&#x20;**] をクリックします。
4. 給与責任者インシデント レコード ページで **更新** をクリックします。
5. 説**明 フ**ィールドが新しい値で更新されました。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/bMr8wYmaQ7S-hPbOl_1_X_workaround-demo3.png" position="flex-start" size="84" width="585" height="344" initialPath="images/workaround-demo3.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/workaround-demo3.png" showCaption="false" indent="1"}
:::
