繰り返しコンテナ

繰り返しコンテナは「明細」形式のデータを扱います。複数項目をグルーピングし、追加や削除を行うことができます。

図1に繰り返しコンテナを用意した画面を示します。

繰り返しコンテナはグループ（行）単位で追加することができます。「追加」ボタンを押下すると現在の行の下に、追加されます。（図1,図2）

図1 繰り返しコンテナの追加ボタンを押下する

図2 行が追加された

「挿入」ボタンを押下すると、行の挿入を行うことができます。（図3,図4）

図3 繰り返しコンテナの挿入ボタンを押下する

図4 行が挿入された

「削除」ボタンを押下すると、行の削除を行うことができます。（図5,図6）

図5 繰り返しコンテナの削除ボタンを押下する

図6 行が削除された

1つのモデルに、複数の「繰り返しコンテナ」を含めることができます。（上限はありません。）

はじめに、繰り返しコンテナ型の項目を用意します。

以降、繰り返しコンテナに含まれる項目を連続で定義します。項目IDは次のようになります。

Container ID + "/" + Item ID

なお、繰り返しコンテナ型項目の直下に「繰り返しコンテナID」を必ず用意してください。図7では「No」がこれに相当します。

図7 繰り返しコンテナを定義する

コンテナ名の右側の項目IDは、他の項目名と重複しないようにしてください。例えばモデル内にすでに "mdate" という項目が定義されていた場合、コンテナ内に "report/mdate" という項目を用意することはできません。
上に関連して、コンテナ名が異なるが、そのあとの名称が同じという設定も行えません。例えば "report1/mdate" と "report2/mdate" は、いずれも "mdate" が重複しているとみなされます。
コンテナ内の項目に、再びコンテナを指定することはできません。具体的には "report1/report2/name" といった繰り返しの繰り返しには対応していません。
同様にコンテナ内の要素を繰り返しとすることもできません。具体的には "report/email" を用意した場合、この "email" を繰り返し項目とすることはできません。
コンテナ項目は離して定義することはできません。（通常の項目を間に挟んで定義することはできません。）必ず連続して項目を定義してください。

列の数が多い場合、お使いのブラウザによっては4つの列まで表示し、5つ目以降の列表示が潰れてしまうことがあります。それぞれの列の幅を指定することで、見栄えを調節してください。

「繰り返しコンテナID」項目は必ず必要です。また、この項目を隠し設定にすることはできません。登録・更新画面で「追加」「削除」ボタンが表示されるためです。また「繰り返しコンテナID」はデータベースに保存する必要があります。データベース非保存とすると正しく動作しません。

例