---
title: 例: Webhook を使用してレコードを移動する
slug: neurons-for-itsm/admin-user-help/jpn/latest/Bnf3-webhook
createdAt: 2026-10-29T01:28:26.378Z
---

## シナリオ

ある企業は、レコードの作成を追跡するために Cherwell Service Management (CSM) を使用します。 ただし、 Ivanti サービス マネージャ 内の少数のレコードの作成を自動的に複製したいと考えています。

CSMには、Webhook を呼び出して給与責任者 に作成されたレコードを自動的に複製する HTTP リクエスト ワンステップ アクションがあります。 CSM その後、中間フォーマットを必要とせずにリクエストを送信します。

### 前提条件

この例では、 CSM への管理者レベルのアクセス権があり、ビジネス オブジェクトと One-Step Actions™ の両方の作成に精通していることを前提としています。 給与責任者の管理者ロールも必要です。

::::ExpandableHeading
## CSMのセットアップ

1. CSMでは、給与責任者で既に作成されているビジネス オブジェクトをミラーリングする **ノート PC** というビジネス オブジェクトを作成します。

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

:::Paragraph{indent="1"}
CSMでのビジネス オブジェクトの作成に関するヘルプについては、「[ CSM でのビジネス オブジェクトの作成または編集](https://help.cherwell.com/bundle/csm_features_10_5_help_only/page/content/suite_features/business_objects/create-edit_a_business_object.html)」を参照してください。
:::

2. CSMでは、 **ノート PC&#x20;**&#x30D3;ジネス オブジェクトに対して、**Send Record to ISM** という **自動アクションを**作成します。 これにより、 **HTTP リクエスト ワンステップ アクション** がトリガーされ、 給与責任者 Webhook にデータが送信されます。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/a5ivg9BOSXx7yV2dsCvkH_csm-create-action1.png" position="flex-start" size="100" width="1077" height="610" initialPath="images/csm-create-action1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/csm-create-action1.png" showCaption="false" indent="1"}

3. 「**最初の保存時に実行」&#x20;**&#x304C;選択されていることを確認します。

:::Paragraph{indent="1"}
CSMでワンステップ アクションを作成する方法については、「 [ワンステップ アクションの作成または編集](https://help.cherwell.com/bundle/csm_features_10_5_help_only/page/content/suite_features/one-steps/create-edit_a_one-step.html)」を参照してください。
:::

4. アクション名の右側にある省略記号を選択し、右クリックのコンテキスト メニューで \[ **編集&#x20;**] を選択して、\[**&#x20;ワンステップ エディター**] を開きます。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/fZdJfDswsZO5UzPaw-ENk_csm-create-action2.png" position="flex-start" size="100" width="940" height="684" initialPath="images/csm-create-action2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/csm-create-action2.png" showCaption="false" indent="1"}

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

| 分野      | 価値                                                                                                |
| ------- | ------------------------------------------------------------------------------------------------- |
| 名前      | HTTPリクエスト                                                                                         |
| 方法      | 役職                                                                                                |
| メールアドレス | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=CreateLaptop                           |
| 体       | \{"cores" : LaptopCores, "ram" : Laptop.RAM(GB),"make" : "Laptop.Make", "model" : "Laptop.Model"} |

:::hint{type="info"}
**ヒント:** 作成されたレコードのデータは、送信される JSON に埋め込まれます。
:::

6. ヘ**ッダー を**選択し、必要な認証ヘッダーを追加します。 この場合、` restapikey={REST API キー}`です。

:::Paragraph{indent="1"}
REST API キーを取得するには、「 [REST APIキーの使用](docId:8ETXcKtaJjOL4N5meDNli)」を参照してください。
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/QG0da4fyR-CJazUAi8ghe_csm-create-action3.png" position="flex-start" size="100" width="708" height="444" initialPath="images/csm-create-action3.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/csm-create-action3.png" showCaption="false" indent="1"}
::::

::::ExpandableHeading
## 給与責任者のセットアップ

1. **ノート PC&#x20;**&#x3068;呼ばれる同一のビジネス オブジェクトが 給与責任者に存在することを確認します。

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

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

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

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

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

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

4. 必要な変数 **WebhookBody**に JSON を保存するようにアクションを構成します。 変**数と保存された値の更新&#x20;**&#x30A2;クション ブロック タイプを使用して新しいブロックを作成し、次のように値を編集します。

| 分野     | 価値                                |
| ------ | --------------------------------- |
| 変数タイプ  | 変数                                |
| 名前     | ウェブフック本体                          |
| データタイプ | 翻訳                                |
| 価値     | 簡略化された式エディターによって入力されます (次の手順を参照)。 |

::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"}

5. 新**しいレコードの作成&#x20;**&#x30D6;ロック タイプを使用して新しいブロックを作成し、簡易式エディターを使用して式を作成し、その変数を使用してフィールドに入力します。 次の表現を使用してください:

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

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

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/4l-7a2etrSm-gdM4UvNXA_csm-eg-itsm-qa2.png" position="flex-start" size="100" width="1323" height="538" initialPath="images/csm-eg-itsm-qa2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/csm-eg-itsm-qa2.png" showCaption="false" indent="1"}

6. データが適切なエンドポイントに送信されたときにこのアクションをトリガーする Webhook を作成します。 設**定 メ**ニューで、 ビ**ルド&#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"}

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

| 分野            | 価値                                                                      |
| ------------- | ----------------------------------------------------------------------- |
| 名前            | ノート PCレコードを作成する                                                         |
| 説明            | CSMで作成されたレコードをミラーリングするレコードを作成するための Webhook。                             |
| エンドポイント拡張     | ノート PCを作成<br />**注:** エンドポイント拡張子では大文字と小文字が区別されます。                       |
| 完全なエンドポイント    | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=CreateLaptop |
| ビジネスオブジェクトの選択 | ノート PC                                                                  |
| アクションを選択      | JSON からノート PCを作成する (複合アクション)                                            |

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

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

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

:::ExpandableHeading
## Webhookの使用

1. Webhook の動作を確認したりテストしたりするには、 給与責任者 ノート PC **ビジネス オブジェクトのレコードが&#x20;**&#x306B;ないことを確認します。

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

2. CSMに移動し、 CSM クライアント (デスクトップ クライアントを表示) を使用して新しいノート PC レコードをいくつか作成します。

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

3. 給与責任者に移動し、**&#x20;更新**を選択します。
4. 選択したトリガーが発生すると (この場合は、 CSMでレコードが作成されます)、Webhook がバックグラウンドで実行され、タスクを実行します。 レコードは CSM から 給与責任者に自動的に複製されます。

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