コレクションの要素の処理:page-support-status: eolScheduled

For-Each コンポーネントは、コレクションの各要素を順次処理した後、For-Each コンポーネントに渡された元のペイロードを使用してフローを続行するために使用されます。

Parallel For-Each コンポーネントは、コレクションの各要素を処理した後、結果をフローの次のカードに渡すために使用されます。

結果の順序は、元のペイロード内の要素の順序に対応します。たとえば、Parallel For-Each コンポーネントに渡されるペイロードが ​["Apple","Banana","Cherry"]​ であるとします。コンポーネントのスコープ内に、各要素を個別のコンポーネントとして処理する Set Payload コンポーネントがあります。Set Payload コンポーネントは DataWeave 式 ​payload ++ '-result'​ を使用して各ペイロードを処理します。Parallel For-Each コンポーネントは結果 ​["Apple-result","Banana-result","Cherry-result"]​ をフローの次のカードに渡します。

For-Each コンポーネントを使用すると、コレクションをバッチに分割することで処理時間を短縮できます。各バッチは、個別の Mule メッセージとして処理されます。たとえば、コレクションに 200 個の要素があり、[Batch Size (バッチサイズ)] を 50 に設定すると、For Each コンポーネントは 50 個の要素から成る 4 つのバッチをそれぞれ個別の Mule メッセージとして反復処理します。

一括処理は Parallel For-Each コンポーネントではサポートされません。

For Each コンポーネント内の各反復で、前の反復で使用した変数を使用できます。1 つの要素の処理中に作成された新しい変数や、既存の変数に加えられた変更は、別の要素の処理中に参照できます。変数へのこれらの変更は、引き続き For-Each スコープの外部で使用できます。

たとえば、For-Each コンポーネントのスコープの直前で Set Variable コンポーネントを使用するとします。Set Variable コンポーネント内で変数 ​NumOfElements​ を 0 に設定します。次に、For-Each スコープ内で Set Variable コンポーネントを使用して、同じ変数を使用します。このコンポーネントでは、コールされるたびに値を 1 ずつ増加する DataWeave スクリプトが指定されています。処理されるコレクションの別の要素を For-Each コンポーネントが送信するたびに、値が増加して ​NumOfElements​ に保存されます。すべての要素が処理されると、​NumOfElements​ の値は、コレクションに含まれていた要素の数になります。この値をフローの後続のカードが For-Each スコープの外部で使用できます。

Parallel For-Each コンポーネントの場合、スコープに入る変数の値は、各変数の処理の開始時点では同じです。1 つの要素の処理中に作成された新しい変数や、既存の変数の変更は、別の要素の処理中に参照できません。また、Parallel For-Each コンポーネントのスコープ内での変数の変更は、フローの後続のカードで使用できません。

たとえば、前述の例と同様に、Parallel For-Each コンポーネントのスコープの直前で Set Variable コンポーネントを使用するとします。Set Variable コンポーネント内で変数 ​NumOfElements​ を 0 に設定します。次に、Parallel For-Each スコープ内で Set Variable コンポーネントを使用して、同じ変数を使用します。このコンポーネントでは、コールされるたびに値を 1 ずつ増加する DataWeave スクリプトが指定されています。コンポーネントにより実行される各並列プロセスで、​NumOfElements​ が到達する最高値は 1 です。また、フローの後続のカードで ​NumOfElements​ を使用している場合、Parallel For-Each コンポーネントでコレクションの処理が終了した後、その初期値は 0 になります。これは、Parallel For-Each コンポーネントの開始前の値と同じです。

For Each コンポーネントと Parallel For Each コンポーネントでは、要素が原因でスコープ内のコンポーネント、コネクタ、またはモジュールが例外をスローした場合、コレクションの処理が停止します。また、Parallel For-Each コンポーネントでは、並列プロセスのいずれかがシステムへの開かれた接続を待機している間にタイムアウトした場合、コレクションの処理が停止します。並列プロセスで待機できる最大時間を設定できます。

例外が原因でコレクションの処理が停止した場合、Flow Designer では、例外をスローしたカードに赤の円が表示されます。タイムアウトが原因でコレクションの処理が停止した場合、Flow Designer では、Parallel For-Each コンポーネントのカードに赤の円が表示されます。​[Logs (ログ)]​ ペインを開くと、エラーメッセージを参照できます。

このコンポーネントを設定する場合、以下の項目に値を指定する必要があります。

このコンポーネントを設定する場合、以下の項目に値を指定する必要があります。

このコンポーネントを設定する場合、以下の項目に値を指定することができます (必須ではありません)。