|
アグリゲーターモジュールが実行されると、次の処理が行われます。
- 単一のソースモジュールの操作からすべてのバンドルを蓄積します。
- 累積されたバンドルごとに 1 つの項目を含む配列を持つ単一のバンドルを出力します。 配列の項目の内容は、特定の アグリゲータ モジュールとその設定に依存します。
次の画像は、アグリゲーターモジュールの通常の設定を表示します。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header |
|
| Source Module |
バンドル集計が開始するモジュール。 ソースモジュールは、通常、一連のバンドルを出力するイテレータまたは検索モジュールです。
アグリゲータのソースモジュールを設定（およびアグリゲータの設定を閉じる）すると、ソースモジュールとアグリゲータモジュールの間のルートがグレーの領域で囲まれ、集計の開始と終了が明確に表示されます。
イテレータについて詳しくは、Iterator モジュールを参照してください。
検索モジュールについて詳しくは、「モジュールの概要」の 検索モジュールを参照してください。
|
|
Target structure type
（配列アグリゲータ モジュールにのみ適用）
|
データが集計されるターゲット構造。 デフォルトのオプション Custom を使用すると、Array aggregator の出力バンドルの Array item：に集計する項目を選択できます。
配列 aggregator モジュールの後にさらにモジュールを接続し、集計モジュールの設定に戻ると、ターゲット 構造体型ドロップダウンメニューに、次のモジュールと、「コレクションの配列」型のフィールドがすべて含まれます。
この例では、Slack >メッセージを作成 モジュールの Attachments フィールドが、配列アグリゲータ > ターゲット構造タイプ フィールドに表示されます。
|
| Aggregated fields |
集計モジュールの出力に含めるフィールド。 |
| Group by |
「グループ化」フィールドを使用すると、1 つ以上のマッピングされた項目を含む式を定義できます。 集計データは、式の値によってグループに分けられます。 各グループは、キーとデータの配列を含む個別のバンドルとして出力します。 結果をグループ化することで、後続のモジュールでキーをフィルターとして使用できます。
各バンドルには、次の 2 つの項目が含まれます。
Key：グループ化の基準にする値。Array:Key 値に対して評価された式の対象となるバンドルからの集計データ。
|
| 空の集計後に処理を停止 |
デフォルトでは、Aggregator モジュールは、Aggregator モジュールに到達したバンドルがない場合（例えば、集約を含むパスからすべて除外されている場合）でも、集約の結果を出力します。 オプション Stop processing after an empty aggregation が有効になっている場合、Aggregator モジュールは、入力バンドルがないときに出力バンドルを生成しません。 代わりに、フローが停止します。 |
| note note |
| NOTE |
| ソースモジュールと Aggregator モジュール間のモジュールで生成されたバンドルは、Aggregator モジュールでは出力されません。 これらのバンドルは、「アグリゲータ 後のフローのモジュールからアクセスでき せん。 ソースモジュールと Aggregator モジュールの間でモジュールによって出力されるバンドルからのデータが必要な場合は、指定された項目を Aggregator モジュールの設定（Array aggregator モジュールの設定の 集計フィールド フィールドなど）に必ず含めてください。 |
アグリゲータの動作のシナリオの例
このサンプルシナリオでは、すべてのメール添付ファイルを zip で圧縮し、その ZIP ファイルを Dropbox にアップロードする方法を示します。
以下のシナリオでは、次の方法を示します。
-
最初のモジュールは、受信メールのメールボックスを監視します。 メール > メールをウォッチ トリガーは、項目 Attachments[] を含んだバンドルを出力します。これは、メールのすべての添付ファイルを含んだ配列です。
-
2 つ目のモデルは、メールの添付ファイルを反復します。 メール > 添付ファイルを反復 イテレータは、Attachments[] 配列から項目を 1 つずつ取得し、それらを別のバンドルとしてさらに送信します。
-
3 番目のモジュールはアグリゲータです。 Email >Iterate attachments モジュールによって出力されたバンドルを集計します。 アーカイブ > アーカイブアグリゲータを作成 は、ZIP ファイルを含んだ単一のバンドルを受信して出力するすべてのバンドルを蓄積します。
-
最後のモジュールは、結果の ZIP ファイルを Dropbox にアップロードします。 Dropbox/ ファイルをアップロード アーカイブ / アーカイブを作成 モジュールから ZIP ファイルを取得して、Dropbox にアップロードします。
以下に、アーカイブ／アーカイブを作成アグリゲーターの設定例を示します。
|