LoopEnd - ループ終了
ループの終了コンポーネントです。ループ終了後に出力ストリームを返します。
■ストリーム情報
| 入力 | フォーマット | すべて |
|---|---|---|
| 接続数 | 1 | |
| 説明 | すべてのストリームを入力できます。 | |
| 出力 | フォーマット | NONE |
| 説明 | 入力ストリームをそのまま出力します。 |
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ループ開始コンポーネント | componentName | - |
ループを開始するコンポーネントを指定します。 プルダウンリストで前に連結してきたループを開始するコンポーネント名の一覧が表示されます。 ただし、RecordJoinコンポーネントのように入力ストリームが複数存在するコンポーネントを指定することはできません。 |
|||||||||
| 出力形態 | choice | - |
ループによって複数回このコンポーネントに入力されるストリームのレコードをまとめるかどうかを指定します。 詳しくは、下記トピック「出力形態」を参照してください。
|
■ループ処理
ループの終点となります。ループしている場合、このコンポーネントを実行した後、最後にループの起点となったコンポーネントに戻って処理を継続します。すべてのループの実行後、次のコンポーネントに制御が移ります。■トランザクション処理
| コミット | 何もしません。 |
|---|---|
| ロールバック | 何もしません。 |
■エラー処理
このコンポーネントがエラーを発生することはありません。
■このコンポーネントの動作について
このコンポーネントを使用した場合、実際にはループ開始コンポーネント で指定したコンポーネントから、 このコンポーネントまでの区間が内部的にサブフローになります。そのため、以下の点に注意が必要です。
- ループ区間内に別のループを開始するコンポーネントがあった場合、そのコンポーネントのループもLoopEndコンポーネントでループ開始に折り返します。
- パラレルなどの分岐処理は、ループ区間内で完結する必要があります。ループ区間をはみだすリンクを連結した場合はコンパイルエラーになります。
- 複数のLoopEndコンポーネントを配置してネストすることもできます。ループ区間の整合性を維持するように注意してください。
- ループ区間内でBranchStartコンポーネントなどを使って処理を分岐し、分岐先をBreakコンポーネントで終了した場合、Breakコンポーネントでループを中断した後はこのLoopEndコンポーネントの次の処理が継続されます。
- ループ区間内でBranchStartコンポーネントなどを使って処理を分岐し、分岐先をEndコンポーネントで終了するなどした場合（内部的なサブフローが何も返さな状態）、 ループの出力ストリームはループの入力ストリームとなります。
- フローの「汎用エラー処理」にエラー処理フローを設定してエラー処理を行う場合は、ループ内でエラーが発生した場合はエラー処理フローのシステム変数「エラー詳細」でInputStreamを参照することはできません。
※コンポーネントのプロパティ「エラー処理」にエラー処理フローを設定した場合はInputStreamを参照することが可能です。
■出力形態
出力形態 ではフローがループしている場合の出力ストリームの形式を指定します。このプロパティの指定により複数レコードのストリームをひとつにまとめたり、コンテナに入れて出力することができます。
いずれの場合もループによって処理されるストリーム、つまり本コンポーネントへの入力ストリーム型とフィールド定義はすべて同じである必要があります。ブランチして異なるストリーム型のストリームをまとめることはできません。
また、ループがなく入力ストリームがひとつしかない場合は最後のストリームが出力ストリームとなります。 MIMEの場合は子パートがひとつのマoチパートMIMEになるのではなく元のMIMEがそのまま出力されます。XMLの場合フィールド定義がなくともエラーにはなりません。
ストリームをまとめる
「ストリームをまとめる」を指定した場合、ストリーム型によって次のようにストリームがまとめられます。
| Binary, Text | ストリームが連結されます。 |
|---|---|
| Record, CSV, FixedLength | ストリーム中のレコードをすべてまとめて単一のストリームとします。 |
| ParameterList | String[]以外のデータ型のフィールドでは最後のストリームのフィールド値になります。 String[]型のフィールドではフィールド値が配列になります。 |
| XML | フィールド定義に添ってXMLが再構成されます。 フィールド定義がされていない場合はエラーになります。 |
| MIME | マルチパートMIMEになります。 |
コンテナ
「コンテナ」は、後続のフロー処理で複数のストリームを添付ファイルにする場合などに使用します。