「データ辞書」とは、開発するアプリケーションが管理するデータの説明文をまとめたものを指します。一般的にはデータの型や有効桁数といった情報を一元的に管理する目的で整備します。入力ルールや説明用の補助情報といったものを含めて管理できれば、なお良いとされています。Wagbyの設計情報(リポジトリ)は、データ辞書そのものです。
「データ辞書」は、データ同士の関連情報を持っています。そのため、例えばモデル項目を削除しようとしたとき、この項目を参照している影響範囲を調べるといったことにも活用できます。
モデル項目に関するいくつかの設定を、複数の項目に同じように設定するというケースを考えてみます。 例えば、次のようなルールです。
Wagbyでは、共通で利用できる設計情報を部品化することができます。これを「項目ルール」と呼びます。
ここでは、定義方法と使い方を説明します。
Designerの「項目ルール」タブを選択します。
初期状態では、項目ルールはありません。左上のギアアイコンから「新規」を選択します。
項目ルール設定ダイアログが開きます。
「設定名」と「概要」を用意します。設定名は必須項目です。
リポジトリを用意します。「追加」ボタンを押下します。
モデル項目詳細設定ダイアログのタブ名が「カテゴリ」として選択できます。はじめに、このカテゴリを指定します。
選択したカテゴリ内に含まれる、リポジトリ一覧が表示されます。設定したいリポジトリを選択してください。
続いて「設定値」を指定します。リポジトリによって、選択式か、あるいは手動入力となります。
一つの項目ルールに、複数のリポジトリ設定を含めることができます。この例では入力フォーマットと出力フォーマットの療法を設定しています。
「保存」ボタンを押下し、この設定を保存します。
項目ルールを一つ、作成しました。同じ手順で、複数の項目ルールを用意することができます。
複数の項目ルールを用意したとき、先頭から順に適用の優先度が高くなっています。同じリポジトリキーに関する設定を含んでいたとき、より上位の項目ルールに含まれているリポジトリ設定が有効になります。
図12で、ドラッグ&ドロップによって項目ルールを並び替えることができます。
モデル項目詳細設定ダイアログの「項目ルール」タブを開きます。用意した項目ルールを適用することができます。
項目ルール名にチェックすることで、適用できます。
設定後、ビルド処理を行ってください。項目ルールが反映されます。
図12で、項目ルール設定タブの「閲覧」ボタンを押下すると、この項目ルールが適用されているモデルおよびモデル項目一覧を表示することができます。これによって、どの項目が適用済みかを把握することができます。
図12で、項目ルール設定タブの「編集」ボタンを押下すると、リポジトリ情報の追加・変更・削除を行うことができます。
編集後、ビルド処理を行ってください。適用されているすべての項目が一斉に変更されます。
モデル項目の一覧で設定する「項目名」「型」「検索(条件に利用する)」「一覧(表示に利用する)」を設定することができます。
型の設定では、次の値を入力することができます。
| 区分 | 設定できる型 |
|---|---|
| 文字列 | "文字列", "郵便番号", "メールアドレス", "URL", "ファイル名" |
| 数値 | "整数", "1バイト整数", "2バイト整数", "4バイト整数", "8バイト整数", "4バイト浮動小数点", "8バイト浮動小数点" |
| 日付・時刻 | "日付", "日付と時間", "時間" |
| 他モデルの項目参照 | "他のストアモデルの参照(コンボボックス)", "他のストアモデルの参照(ラジオボタン)", "他のストアモデルの参照(チェックボックス)", "他のストアモデルの参照(検索画面)", "他のストアモデルの参照連動" |
| 繰り返しコンテナ | "(繰り返し項目のコンテナ)" |
| 繰り返しコンテナID | "(繰り返し項目コンテナ用のID)" |
Designerで型を変更した場合、いくつかの設定は初期状態に戻ります。しかしこの項目ルール設定では、型を変更してもその他の設定は初期状態に戻さず、維持されます。そのため、型の変更に伴い影響のありそうな関連設定は、開発者自身で注意深く見直しを行なってください。
具体的には、型の変更を行なったとき、この項目ルールを適用しているすべての項目について、次の設定をチェックすることを推奨します。