コレクションで実行クイック アクション (CAD)
- グラフィカル アクション デザイナ: コレクションで実行クイック アクション (GAD)
コレクションで実行クイック アクションについて
このクイック アクションを使用するには、 グローバル定数 EnableActionService を Trueに設定します。 EnableActionService がグローバル定数リストで使用できない場合 (アップグレードされたインスタンスの場合に該当する可能性があります)、管理者は手動で定数を追加できます。
コレクションで実行 クイック アクション を使用すると、コレクションまたは配列内の複数のレコードに対してアクションを実行できます。 レコードのコレクションは、JSON または XML で、式または Webhook から提供できます。 この機能により、Webhook または Web サービス申請を介して受信したデータに基づいてビジネス オブジェクトを作成または更新できるようになります。
エラーが発生した場合にアクションを停止するか続行するかを選択することもできます。 コレクションの最大サイズは 50 レコードです。
使用上の提案
コレクションで実行 クイック アクション を使用する方法はいくつかあります:
- 「レコードへ移動」 クイック アクションと組み合わせて使用します: 更新するレコードの JSON または XML コレクションを指定します。各エントリには、異なるレコードの一意の識別子があります。 「コレクションで実行」 クイック アクション と「レコードに移動」 クイック アクション を一緒に使用して、コレクションを反復処理し、コレクション内の各項目のレコードに移動し、次の項目に進む前にレコードに対して何らかのアクションを実行します。
- 別のシステムからデータをエクスポートし、 給与責任者 ビジネス オブジェクトにインポートします: 外部システムで JSON または XML 形式へのデータのエクスポートが許可されている場合は、JSON データに基づいてレコードを作成するアクションを定義することで、そのデータを 給与責任者 ビジネス オブジェクトにマップできます。 このデータは、Webhook 経由で 給与責任者 に送信できます。 コレクションを実行クイック アクションを使用して複数のレコードを一度に作成します。
データのエクスポートに関して、アクションの実行ごとに 50 レコードという制限は、現時点では一括インポートには適していない可能性があります。
- ビジネスのアプリケーション間でのデータのリアルタイム共有を可能にします: 外部アプリケーションは、いつでも Webhook を介して JSON/XML 配列内の複数のデータ項目を 給与責任者 に送信でき、 給与責任者 はこれに応じてビジネス オブジェクトの作成や更新、電子メールの送信など、必要なアクションを実行できます。
- 別のアクションと組み合わせて使用します: 外部 Web サービスを呼び出す REST Webサービスクイック アクションを実行するなどのアクションを構成できます。 この Web サービスは、JSON または XML 形式でデータを返すことができ、そのデータは変数に格納され、その後 Run for Collection クイック アクションを使用して処理されます。
パラメータ
分野 | パラメータ |
|---|---|
アクション名を入力 | アクションの一意の名前。 |
アクションの説明を入力 | オプション。 アクションの実行内容のプレーンテキストの説明を入力します。 |
カテゴリーを入力 | ドロップダウンリストからカテゴリを選択します。 このカテゴリ フィールドは、アクションをさまざまなカテゴリにグループ化します。 サービスカテゴリーとは関係ありません。 |
ステップスルーするコレクション | 選択したコレクションを反復処理する式を作成するには、 f(x) をクリックして、簡略化された式エディターを開きます。 詳細については、「簡易式エディタの使用」を参照してください。 この式は、反復処理するコレクション全体を返す必要があります。 ほとんどの場合、これは WebhookBody などの変数ですが、任意の式にすることもできます。 例については、「例: コレクションで実行 (GAD) を使用してサーバーの健全性を監視する」を参照してください。 |
各アイテムに対して実行するアクション | コレクション内の各レコードに対して実行するアクションをドロップダウン リストから選択します。 リストされているアクションは、操作しているビジネス オブジェクトで使用できるアクションです。 作成するアクション (このドロップダウン リストに表示される) では、 CurrentCollectionItem 関数を使用する必要があります。 アクション固有の関数 CurrentCollectionItem を挿入するには、 Functions > Collections > CurrentCollectionItemをクリックします。 ![]() この関数は、Webhook の例で使用される JSONPathValue に従って、テキストまたは何らかのデータを指す式として、反復処理するコレクション内の項目の値を保持します。 参照: 例: Webhook を使用してレコードを移動する 関数にはコンテキストが渡され、データの取得に使用する一意の変数名を認識します。 このコンテキストが必要なのは、複数のユーザーからの複数のコレクションが同時に実行される可能性があるため、どの CurrentCollectionItem を取得するかを理解する手段が必要であるためです。 CurrentCollectionItem 関数は、 コレクションで実行クイック アクションでのみ 使用できるため、別のアクションで使用しようとするとエラー メッセージが表示されます。 |
エラー時に停止 | 選択すると、各レコードの処理中にエラーが発生すると、反復全体が停止し、進行状況は保存されません。 選択しない場合、エラーは収集されますが、全体的な反復は継続され、その時点までの進行状況が保存されます。 |
アクション
ボタン | アクション |
|---|---|
| リストにフィールドを追加します。 |
![]() | リストからフィールドを削除します。 |
保存 | 設定をコミットします。 |
キャンセル | 保存せずに終了します。 |
サービスログエントリ
コレクションで実行クイック アクションを使用した結果を確認するには、サービス ログを開きます。 参照: ログの表示。
次の情報を使用して、実行の結果を表示したり、診断やデバッグを行うことができます。
- 反復の合計の長さ。
- 成功数/合計。
- 失敗の数。
- 失敗メッセージ(ある場合)。




