データディクショナリーは、ソリューションが保持するすべての項目を説明し、ビジネス、開発者、テスト担当者が「請求額」で同じものを指すようにします。各項目について次の内容を記録します。
- 名前と平易な定義(「claim_amount:契約者が支払いを求める金額で、免責額を差し引く前のもの」)。
- データ型:テキスト、整数、小数、日付、Yes/No、またはコードリスト(許可された値の決まった集まり)。
- 形式と長さ:YYYY-MM-DD、小数点以下2桁、12文字。
- 必須か任意か、そして検証ルール(「未来の日付でない」)。
- ソースとオーナー:値がどこから来るか、誰がその意味を決めるか。
よく引っかかる落とし穴は、数値のように見えるコードです。0048213のような証券番号は整数ではなくテキストです。数値として保存すると先頭のゼロが失われ、2つの証券番号を足し合わせる人もいません。それで計算をすることがないなら、おそらくテキストです。