---
title: コレクションで実行クイック アクション (GAD)
slug: neurons-for-itsm/admin-user-help/jpn/latest/iheq-gad
createdAt: 2026-10-29T01:28:19.742Z
---

- [コレクションで実行クイック アクションについて](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/iheq-gad#About_Run_for_Collection)
- [パラメータ](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/iheq-gad#Parameters)
- クラシック アクション デザイナ [コレクションで実行クイック アクション (CAD)](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/cAtJ-cad)

## コレクションで実行クイック アクションについて

:::hint{type="info"}
このクイック アクションを使用するには、 グローバル定数 **EnableActionService&#x20;**&#x3092; **True**に設定します。 E**nableActionService が**グローバル定数リストで使用できない場合 (アップグレードされたインスタンスの場合に該当する可能性があります)、管理者は手動で定数を追加できます。
:::

**コレクションで実行**アクションを使用すると、コレクションまたは配列内の複数のレコードに対してアクションを実行できます。 レコードのコレクションは、JSON または XML で、式または Webhook から提供できます。 この機能により、Webhook または Web サービス申請を介して受信したデータに基づいてビジネス オブジェクトを作成または更新できるようになります。

エラーが発生した場合にアクションを停止するか続行するかを選択することもできます。 コレクションの最大サイズは 50 レコードです。

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/KJmXHiVR6i5uhOt6mg0VM_gadrunforcollectionactionblock.png" alt="GAD のコレクションで実行ブロックを実行する" position="flex-start" size="53" width="368" height="118" initialPath="../../images/gad_run_for_collection_action_block.png" githubPath="Admin-User-Jpn/Content/Configure/QuickActions/images/gad_run_for_collection_action_block.png" showCaption="false"}

## 使用上の提案

コ**レクションで実行&#x20;**&#x30A2;クションを使用する方法はいくつかあります。

- **「レコードへ移動」 クイック アクションと組み合わせて使用します**: 更新するレコードの JSON または XML コレクションを指定します。各エントリには、異なるレコードの一意の識別子があります。 **コレクションで実行&#x20;**&#x30AF;イック アクション と**レコードへの移動&#x20;**&#x30AF;イック アクション を一緒に使用して、コレクションを反復処理し、コレクション内の各項目のレコードに移動し、次の項目に進む前にレコードに対して何らかのアクションを実行します。
- **別のシステムからデータをエクスポートし、 給与責任者 ビジネス オブジェクトにインポートします**: 外部システムで JSON または XML 形式へのデータのエクスポートが許可されている場合は、JSON データに基づいてレコードを作成するアクションを定義することで、そのデータを 給与責任者 ビジネス オブジェクトにマップできます。 このデータは、Webhook 経由で 給与責任者 に送信できます。 コレクションを実行クイック アクションを使用して複数のレコードを一度に作成します。

:::hint{type="info"}
データのエクスポートに関して、アクションの実行ごとに 50 レコードという制限は、現時点では一括インポートには適していない可能性があります。
:::

- **ビジネスのアプリケーション間でのデータのリアルタイム共有を可能にします:** 外部アプリケーションは、いつでも Webhook を介して JSON/XML 配列内の複数のデータ項目を 給与責任者 に送信でき、 給与責任者 はこれに応じてビジネス オブジェクトの作成や更新、電子メールの送信など、必要なアクションを実行できます。
- **別のアクションと組み合わせて使用します:&#x20;**&#x5916;部 Web サービスを呼び出す [REST Webサービスクイック アクションを実行する](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/rest-web)などのアクションを構成できます。 この Web サービスは、JSON または XML 形式でデータを返すことができ、そのデータは変数に格納され、その後 **Run for Collection** クイック アクション を使用して処理されます。

## パラメータ

パラメータにアクセスするには、 **設定**ペインに表示する **アクション ブロック**を選択します。

### アクションブロック設定

**ブロック ラベル**: ブロックの一意の名前。 これは、デザイン領域に同じアクション ブロックを複数追加または複製した場合に、各アクションを識別するのに役立ちます。

| 分野                 | パラメータ                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ステップスルーするコレクション    | 選択したコレクションを反復処理する式を作成するには、 ***f(x)*** をクリックして、簡略化された式エディターを開きます。 詳細については、「[簡易式エディタの使用](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/dETlohknYNmY9Dwnqk_9E)」を参照してください。<br />この式は、反復処理するコレクション全体を返す必要があります。 ほとんどの場合、これは **WebhookBody&#x20;**&#x306A;どの変数ですが、任意の式にすることもできます。 例については、「[例: コレクションで実行 (GAD) を使用してサーバーの健全性を監視する](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/e6KF-gad)」を参照してください。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 各アイテムに対して実行するアクション | コレクション内の各レコードに対して実行するアクションをドロップダウン リストから選択します。 リストされているアクションは、操作しているビジネス オブジェクトで使用できるアクションです。 作成するアクション (このドロップダウン リストに表示される) では、 **CurrentCollectionItem** 関数を使用する必要があります。<br />アクション固有の関数 **CurrentCollectionItem** を挿入するには、 **Functions > Collections > CurrentCollectionItem**をクリックします。<br />:inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/5UYs_0Iry-EowcT7c8qVd_currentcollectionitemexpression.png" alt="簡易式エディタのコレクションで実行アクションの特定の機能" caption size="61" width="428" height="221"}<br />この関数は、Webhook の例で使用される **JSONPathValue&#x20;**&#x306B;従って、テキストまたは何らかのデータを指す式として、反復処理するコレクション内の項目の値を保持します。 参照: [例: Webhook を使用してレコードを移動する](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/Bnf3-webhook)<br />関数にはコンテキストが渡され、データの取得に使用する一意の変数名を認識します。 このコンテキストが必要なのは、複数のユーザーからの複数のコレクションが同時に実行される可能性があるため、どの **CurrentCollectionItem&#x20;**&#x3092;取得するかを理解する手段が必要であるためです。<br />**CurrentCollectionItem&#x20;**&#x95A2;数は、 *Run for Collection&#x20;*&#x30AF;イック アクション で**のみ&#x20;**&#x4F7F;用できるため、別のアクションで使用しようとするとエラー メッセージが表示されます。 |
| エラー時に停止            | 選択すると、各レコードの処理中にエラーが発生すると、反復全体が停止し、進行状況は保存されません。 選択しない場合、エラーは収集されますが、全体的な反復は継続され、その時点までの進行状況が保存されます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

変更を確定するには、\[ **保存** ] をクリックします。

## スタートブロック設定

これらの設定には、「 **スタート ブロック**」を選択してアクセスします。「 [スタートブロック設定](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/mCY--gad#CommonTab)」を参照してください。

## サービスログエントリ

**コレクションで実行&#x20;**&#x30AF;イック アクションを使用した結果を確認するには、サービス ログを開きます。 参照: [ログの表示](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/PbbzLKVkTqscWYlpZfrSk#Viewing)。

次の情報を使用して、実行の結果を表示したり、診断やデバッグを行うことができます。

- 反復の合計の長さ。
- 成功数/合計。
- 失敗の数。
- 失敗メッセージ（ある場合）。

![コレクションで実行アクションのサービス ログの抜粋](https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/m8qlMgoorHAzXIfgxWkKf_gadrunforcollectionservicelogentry.png)
