項目ルールを定義する（データ辞書としての利用）

データ辞書

「データ辞書」とは、開発するアプリケーションが管理するデータの説明文をまとめたものを指します。一般的にはデータの型や有効桁数といった情報を一元的に管理する目的で整備します。入力ルールや説明用の補助情報といったものを含めて管理できれば、なお良いとされています。Wagbyの設計情報（リポジトリ）は、データ辞書そのものです。

「データ辞書」は、データ同士の関連情報を持っています。そのため、例えばモデル項目を削除しようとしたとき、この項目を参照している影響範囲を調べるといったことにも活用できます。

項目ルールを定義する

項目ルールとは

モデル項目に関するいくつかの設定を、複数の項目に同じように設定するというケースを考えてみます。 例えば、次のようなルールです。

• 日付型項目で、和暦情報を常に表示する。

Wagbyでは、共通で利用できる設計情報を部品化することができます。これを「項目ルール」と呼びます。
ここでは、定義方法と使い方を説明します。

定義方法

1. Designerの「項目ルール」タブを選択します。

   

2. 初期状態では、項目ルールはありません。左上のギアアイコンから「新規」を選択します。

   

3. 項目ルール設定ダイアログが開きます。

   

4. 「設定名」と「概要」を用意します。設定名は必須項目です。

   

5. リポジトリを用意します。「追加」ボタンを押下します。

   

6. モデル項目詳細設定ダイアログのタブ名が「カテゴリ」として選択できます。はじめに、このカテゴリを指定します。
   今回は「入力制御」を選択します。

   

7. 選択したカテゴリ内に含まれる、リポジトリ一覧が表示されます。設定したいリポジトリを選択してください。
   今回は「presentation/displayitem/@subformatForEdit:オプション表示(日付)」選択します。

   

   ワンポイント

   すべてのリポジトリは「リポジトリ構造とチーム開発 > リポジトリ一覧をご覧ください。

8. 続いて「設定値」を指定します。リポジトリによって、選択式か、あるいは手動入力となります。

   

9. 一つの項目ルールに、複数のリポジトリ設定を含めることができます。この例では入力制御と出力制御の両方を設定しています。

   

10. 「保存」ボタンを押下し、この設定を保存します。

    

11. 項目ルールを一つ、作成しました。同じ手順で、複数の項目ルールを用意することができます。

    

優先順位

複数の項目ルールを用意したとき、先頭から順に適用の優先度が高くなっています。同じリポジトリキーに関する設定を含んでいたとき、より上位の項目ルールに含まれているリポジトリ設定が有効になります。

図12で、ドラッグ&ドロップによって項目ルールを並び替えることができます。

項目ルールを使う

モデル項目詳細設定ダイアログの「項目ルール」タブを開きます。用意した項目ルールを適用することができます。

項目ルール名にチェックすることで、適用できます。

設定後、ビルド処理を行ってください。項目ルールが反映されます。

項目ルールの適用状況を確認する

項目ルール設定タブの「閲覧」ボタンを押下すると、この項目ルールが適用されているモデルおよびモデル項目一覧を表示することができます。
これによって、どの項目が適用済みかを把握することができます。

項目ルールの内容を変更する

項目ルール設定タブの「編集」ボタンを押下すると、リポジトリ情報の追加・変更・削除を行うことができます。

編集後、ビルド処理を行ってください。適用されているすべての項目が一斉に変更されます。

名前と型の扱い

モデル項目の一覧で設定する「項目名」「型」「検索（条件に利用する）」「一覧（表示に利用する）」を設定することができます。

型の設定

型の設定では、次の値を入力することができます。

型の設定に関する注意点

Designerで型を変更した場合、いくつかの設定は初期状態に戻ります。しかしこの項目ルール設定では、型を変更してもその他の設定は初期状態に戻さず、維持されます。そのため、型の変更に伴い影響のありそうな関連設定は、開発者自身で注意深く見直しを行なってください。

具体的には、型の変更を行なったとき、この項目ルールを適用しているすべての項目について、次の設定をチェックすることを推奨します。

• 検索画面の範囲検索。（数字型や日付型から文字列型に変更した場合でも、範囲検索の設定は残っている。）
• 入力チェック。許容文字種を含む。
• 暗黙条件。
• 初期値。
• 日付、数値フォーマット。
• 入力フィルタ。
• 主キーの順序設定。
• 絞り込みの設定。
• 入力制御。（入力可・不可の式、必須、禁止文字、正規表現など）
• 計算式。
• データベースのユニーク制約。
• ロック名。
• トランザクション設定。
• SQL式。

仕様・制約

• 項目ルールに関する設定情報は、repository/trunk フォルダ内の .userDefinedItem フォルダに格納されます。
• モデル項目には model/modelitem/userDefinedItem というリポジトリキーで、どの項目ルールを適用するかという情報を含みます。複数適用時はカンマ区切りとなります。
• 項目ルールは、モデル項目詳細設定ダイアログで指定可能なリポジトリキーが対象となります。画面、レイアウト、権限、メニュー、環境設定などに関するものを含めることはできません。

関連する機能

• Designerの機能・その他のツール > 項目テンプレートを用意する