---
title: 例: Azure DevOps パイプライン実行のログ記録
slug: neurons-for-itsm/admin-user-help/jpn/latest/azure-devops
createdAt: 2026-10-29T01:28:26.358Z
---

## シナリオ

企業には、コードを実行するために使用する開発ビルド パイプラインが多数あります。 この例では、開発者が既存の Azure DevOps (ADO) イベント機能と Ivanti サービス マネージャ Webhook を使用してパイプライン データを 給与責任者に送信する方法を示します。 このプロセスは、特定のパイプラインの実行に関する貴重な情報を 給与責任者 ビジネス オブジェクトに転送します。

### 前提条件

この例を再現するには、 給与責任者 および ADO パイプラインの管理者ロールが必要です。 また、作成した Webhook にパイプラインの結果を送信するように Azure DevOps インスタンスを設定する必要があります。 ただし、ADO をインストールしていなくても、ここで機能する原理を理解することができます。

:::ExpandableHeading
## 給与責任者 でビジネスオブジェクトを作成する

1. 給与責任者で、 **Pipeline Run**というビジネス オブジェクトを作成します。 パイプライン実行からの ADO 情報を保持するために、次のフィールドを作成します。

| 分野      | 説明                                                                                                                                           |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| ビルドID   | 実行された開発ビルドの ID。                                                                                                                              |
| メッセージ   | このフィールドにはビルド ステータスに関するメッセージが表示されます。                                                                                                          |
| ビルドリンク  | Visual Studio でビルドを開くための HTTPS リンク (この例)。                                                                                                    |
| Gitハッシュ | Git ハッシュは、次の要素で構成される一意のコンテンツ名です。<br />- コミットメッセージ。<br />- ファイルが変更されます。<br />- コミットの作成者 (およびコミッター - 異なる場合もあります)。<br />- 日付。<br />- 親コミットハッシュ。 |
| 説明      | メッセージ フィールドからのメッセージのユーザー フレンドリーなバージョン。                                                                                                       |
:::

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

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/PatixdYDunYXFGMyrC_H-_ado-eg-blocks1.png" position="flex-start" size="73" width="509" height="144" initialPath="images/ado-eg-blocks1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/ado-eg-blocks1.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;**&#x30D6;ロック タイプを使用して新しいブロックを作成し、 **新規アクション - InsertObject**という名前を付けて、**保存された値と変数の更新アクション&#x20;**&#x30D6;ロックに添付します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/1CTQoFYFZbn0jMraNBa8y_ado-eg-blocks2.png" position="flex-start" size="74" width="519" height="138" initialPath="images/ado-eg-blocks2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/ado-eg-blocks2.png" showCaption="false" indent="1"}

5. **新規アクション - InsertObject&#x20;**&#x30D6;ロックを編集します。

:::Paragraph{indent="1"}
各フィールドについて、簡易式エディタを使用して式を作成し、 **変数と保存された値の更新** アクション ブロック内の変数を使用して、その特定のフィールドに値を入力します。 式は JSON パスの値を取得し、それを使用してフィールドに入力します。 たとえば、次の式を使用して、 **ビルド ID** フィールドに入力します。
:::

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

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/kiYv94TDI2o4-2fVViPk0_ado-eg-blocks3.png" position="flex-start" size="35" width="243" height="572" initialPath="images/ado-eg-blocks3.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/ado-eg-blocks3.png" showCaption="false" indent="1"}

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

6. アクションを **CreateBuildRun**として保存します。
::::

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

1. データが適切なエンドポイントに送信されたときに **CreateBuildRun** アクションをトリガーする 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"}

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

| 分野            | 価値                                                                           |
| ------------- | ---------------------------------------------------------------------------- |
| 名前            | 完了したパイプラインを記録する                                                              |
| 説明            | この Webhook は、提供されたデータを使用して「パイプライン実行」ビジネス オブジェクト レコードを作成します。                  |
| エンドポイント拡張     | 完了したパイプライン<br />**注:** エンドポイント拡張子では大文字と小文字が区別されます。                           |
| 完全なエンドポイント    | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=CompletedPipeline |
| ビジネスオブジェクトの選択 | パイプライン実行 (PipelineFailure)                                                   |
| アクションを選択      | CreateBuildRun (複合アクション)                                                     |

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

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

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

:::ExpandableHeading
## Webhookが機能していることを確認する

1. Webhook の動作を確認してテストするには、ADO で最近ログに記録されたビルドを見つけます。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/BRseTKI0JU6-Z-iZmtUQ__ado-eg-pipeline1.png" position="flex-start" size="100" width="1307" height="538" initialPath="images/ado-eg-pipeline1.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/ado-eg-pipeline1.png" showCaption="false" indent="1"}

2. 給与責任者で、 **Pipeline Runs** ビジネス オブジェクトを開き、 **Refresh** を選択して新しいレコードを確認します。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/plSa4K8-e6MEyum4_CB3Q_ado-eg-pipeline2.png" position="flex-start" size="100" width="976" height="245" initialPath="images/ado-eg-pipeline2.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/ado-eg-pipeline2.png" showCaption="false" indent="1"}

3. レコードの 1 つを開いてフィールドを確認します。 レコードは、**&#x20;完了したパイプラインをログに記録** Webhook によって呼び出された **CreateBuildRun** アクションによって自動的に作成されました。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/KxNptjzLZ_y1GEOx16XHZ_ado-eg-pipeline3.png" position="flex-start" size="96" width="669" height="313" initialPath="images/ado-eg-pipeline3.png" githubPath="Admin-User-Jpn/Content/Configure/Webhooks/images/ado-eg-pipeline3.png" showCaption="false" indent="1"}
:::
