使用条件 - ipa.go.jp · JavaおよびすべてのJava関連の商標およびロゴは、米国およびその他の国における米国SunMicrosystems，Inc．の商標または登録商標です。

Copyright ©2008 IPA

使用条件

<ガイドラインをご使用になる前にお読みください>

発注者ビューガイドライン（以下、「本ガイドライン」といいます。）を利用することをもって、以下に記載する使用条件（以下、「本使用条件」といいます。）に同意したものとさせていただきます。

本ガイドラインの著作権は、独立行政法人情報処理推進機構が保有しています。

以下の利用可能な行為を除き、本ガイドラインの一部または全部を著作権法の定める範囲を超え、許可なく改変、公衆送信、販売、出版、翻訳、翻案等をすることは営利、非営利など目的の

いかんに関わらず禁じられています。

＜本ガイドラインの目的＞

本ガイドラインは、外部設計工程における、発注者にわかりやすい仕様の記述方法及び合意方法を世の中に広く普及することを目的としています。

＜利用可能な行為＞

本ガイドラインは、以下の著作権表示を明記した上で、

著作権表示： Copyright©2008 IPA

情報システム開発に携わる方が本目的のために

・本ガイドラインの全部または一部を無償で複製すること、

・本使用条件を配布先に遵守させることを条件に本ガイドラインの複製物を無償で再配布すること、

により利用することができます。

独立行政法人情報処理推進機構は、本ガイドラインが第三者の著作権、特許権、実用新案権等の知的財産権に抵触しないことを一切保証するものではなく、また、本ガイドラインの内容に

誤りがあった場合でも一切責任を負うものではありません。

独立行政法人情報処理推進機構は、上記の利用可能な行為を除き、第三者の著作権、特許権、実用新案権等の知的財産権に基づくいかなる権利も許諾するものではありません。

独立行政法人情報処理推進機構は、本ガイドラインのシステム開発への利用、開発したシステムの使用及びシステムの使用不能により生じるいかなる損害についても、なんら責任を負うも

のではありません。

本ガイドラインを海外へ持ち出し、または外国籍の人に提供する場合には、「外国為替及び外国貿易法」の規制及び米国輸出管理規則等外国の輸出関連法規を確認の上、必要な手続きを

行ってください。

本ガイドラインへのお問い合わせについては、独立行政法人情報処理推進機構ソフトウェア・エンジニアリング・センターまでご連絡下さい。

ＪａｖａおよびすべてのＪａｖａ関連の商標およびロゴは、米国およびその他の国における米国ＳｕｎＭｉｃｒｏｓｙｓｔｅｍｓ，Ｉｎｃ．の商標または登録商標です。

その他、本書に記載されている会社名、製品名などは各社の商標または登録商標です。

なお、本資料では、™ または® の表記は省略しております。

第1部 - 9

デ－タモデル編第1部表現


第2章設計書記述のポイント

ここでは、工程成果物に着目した設計書の表現のコツを説明する

第1部 - 10



2.1 表現のコツ一覧

コツID コツの説明コツの分類

MD1001 エンティティをタイプ分けして、色で表現する

ER図中のエンティティにインスタンスの作成、および更新の時期を記述する

業務単位にER図を作成する

イベント系エンティティをデ－タの発生順で記述する

エンティティ一覧にデ－タの主管部署を記述する

エンティティ一覧に業務名、エンティティの種別を記述する

エンティティ一覧にデ－タ件数や保存期間などを記述する

エンティティおよび属性の抽出元を記述する

エンティティ一覧において旧システムのデ－タモデルからの変更点を明記する

CRUD図のCreate,Read,Update,Delete記述欄を固定する

CRUD図のエンティティをイベント系エンティティとリソ－ス系エンティティに分離し

て記述する

CRUD図のビジネスプロセスを実際の業務の時系列順に並べる

CRUD図のイベント系エンティティをエンティティを作成する順番に沿って並べる

デ－タフロ－図にイラストを使用する

処理で利用するデ－タの入出力を図を利用して記述する

処理の間を流れるデ－タとその状態を記述した図表を作成して説明する

ER図の表現のコツ




エンティティ一覧／定義書の表現のコツ





CRUD図の表現のコツ




デ－タのフロ－等の表現のコツ

MD3001

MD3002

MD3003

MD3004

MD4001

MD4002 デ－タのフロ－等の表現のコツ

デ－タのフロ－等の表現のコツMD4003

MD1002

MD1003

MD1004

MD2001

MD2002

MD2003

MD2004

MD2005

工程成果物に着目した設計書の表現のコツは次のとおり

第1部 - 11



Z

Z

PP

Z

発注

発注番号

仕入先番号 (FK)社員番号 (FK)

発注区分受注(注文)明細

受注明細番号受注番号(注文番号) (FK)

商品番号 (FK)

受注数量値引き額消費税額金額計

仕入先

仕入先番号

社員

社員番号

社員氏名

営業所

営業所コード

営業所名

受注(注文)

受注番号(注文番号)

受注ユーザID (FK)出荷先ユーザID (FK)受注社員番号 (FK)受注営業所コード (FK)

受注日納入希望日顧客先注文番号税込合計額

出荷/売上明細

売上明細番号売上番号 (FK)

商品番号 (FK)

出荷数量商品原価

入荷/仕入

入荷番号

倉庫番号 (FK)仕入先番号 (FK)社員番号 (FK)

受注_発注

受注番号(注文番号) (FK)発注番号 (FK)

発注_入荷

発注番号 (FK)入荷番号 (FK)

受注_出荷

受注番号(注文番号) (FK)売上番号 (FK)

登録ユーザ

ユーザID

顧客名顧客郵便番号顧客住所顧客電話番号

出荷/売上

売上番号

倉庫番号 (FK)社員番号 (FK)

出荷指示番号

倉庫

倉庫番号

倉庫名倉庫住所倉庫電話番号倉庫FAX番号倉庫区分

社員_営業所

営業所コード (FK)社員番号 (FK)

2.2 ER図の表現のコツ

ER図をわかりやすく表現するにはMD1001：エンティティをタイプ分けして、色で表現する

レビューのポイントとなるタイプにピンクや赤など、インパクトのある色を用いて、視覚的に概観を掴みやすくする

分類するタイプとしては、各種方法論にて多様な定義が存在する。下記に例をあげる例１イベント／リソース系エンティティ（あるいはリソース系エンティティを組織・場所・モノまで詳細に分けたもの）といった

業務に依存しない分類

例２販売・出荷・支払といった業務依存の分類

無色のER図の例

緑：リソース

イベント／リソースに分類し、イベントをピンクにした例

ピンク：イベント

Z

PP

Z

Z

発注

発注番号

仕入先番号 (FK)社員番号 (FK)

発注区分受注(注文)明細

受注明細番号受注番号(注文番号) (FK)

商品番号 (FK)

受注数量値引き額消費税額金額計

仕入先

仕入先番号

社員

社員番号

社員氏名

営業所

営業所コード

営業所名

受注(注文)

受注番号(注文番号)

受注ユーザID (FK)出荷先ユーザID (FK)受注社員番号 (FK)受注営業所コード (FK)

受注日納入希望日顧客先注文番号税込合計額

出荷/売上明細

売上明細番号売上番号 (FK)

商品番号 (FK)

出荷数量商品原価

社員_営業所

営業所コード (FK)社員番号 (FK)

入荷/仕入

入荷番号

倉庫番号 (FK)仕入先番号 (FK)社員番号 (FK)

受注_発注

受注番号(注文番号) (FK)発注番号 (FK)

発注_入荷

発注番号 (FK)入荷番号 (FK)

受注_出荷

受注番号(注文番号) (FK)売上番号 (FK)

登録ユーザ

ユーザID

顧客名顧客郵便番号顧客住所顧客電話番号

出荷/売上

売上番号

倉庫番号 (FK)社員番号 (FK)

出荷指示番号

倉庫

倉庫番号

倉庫名倉庫住所倉庫電話番号倉庫FAX番号倉庫区分

イベントに着目すると、受注⇒発注⇒入荷⇒出荷／売上という業務の流れが読み取れる

第1部 - 12




ER図の理解を促進させるにはMD1002：ER図中のエンティティにインスタンスの作成、および更新の時期を記述する

業務とエンティティのおおよその関係が把握可能となる

ER図に作成、および更新の時期を記載した例

出版社

出版社ID

出版社名出版社住所

改訂

ISBN (FK)改訂版

改訂日

販売

ISBN (FK)店舗ID (FK)

販売数最終販売日

書籍

ISBN

書籍名著者初版発行日販売価格出版社ID (FK)

店舗

店舗ID

店舗名店舗住所

・書籍販売時

・改版実施時

・書籍登録時

・書籍登録時

・書籍販売時・店舗登録時

書籍販売時、店舗情報も登録することがわかる

書籍登録時、出版社情報も登録することがわかる

第1部 - 13




ER図の理解を促進させるにはMD1003：業務単位にER図を作成する(1/2)

エンティティの関係が深いものどうしでグルーピングしているので、業務に関係があるエンティティに集中できる

業務名受注業務と調達業務

業務名受注業務

業務名調達業務

受注

受注NO

受注登録者 (FK)

出荷手配

出荷手配NO

手配登録者 (FK)受注NO (FK)

受注明細

受注NO (FK)受注明細NO

商品コード (FK)

出荷手配明細

出荷手配NO (FK)出荷手配明細NO


出荷実績明細

出荷実績NO (FK)出荷実績明細NO

商品

商品コード

商品名

出荷実績

出荷実績NO

出荷手配NO (FK)

従業員マスタ

従業員番号

従業員氏名

発注

発注NO

従業員番号 (FK)

入荷

入荷NO

従業員番号 (FK)発注NO (FK)

発注明細

発注NO (FK)発注明細NO


入荷明細

入荷NO (FK)入荷明細NO


従業員マスタ

従業員番号

従業員氏名

商品

商品コード

商品名

発注

発注NO

従業員番号 (FK)

受注

受注NO

受注登録者 (FK)

出荷手配

出荷手配NO

手配登録者 (FK)受注NO (FK)

出荷実績

出荷実績NO

出荷手配NO (FK)

受注明細

受注NO (FK)受注明細NO


出荷実績明細

出荷実績NO (FK)出荷実績明細NO

商品

商品コード

商品名

発注明細

発注NO (FK)発注明細NO

商品コード (FK)入荷明細

入荷NO (FK)入荷明細NO


従業員マスタ

従業員番号

従業員氏名

入荷

入荷NO

従業員番号 (FK)発注NO (FK)

出荷手配明細

出荷手配NO (FK)出荷手配明細NO


受注、調達業務を1つのER図に記載した例

重複して記載しておく重複して記載しておく

業務単位にER図を分けて作成する

受注、調達業務毎にER図を分けて記載した例

（画面、帳票などの情報から）ER図を作成する過程で、ともするとER図が複雑になり、見にくくなってしまう

第1部 - 14




ER図の理解を促進させるにはMD1003：業務単位にER図を作成する(2/2)

業務単位に分割するため明確なルールはないが、以下のような点に着目するとよい

業務との関連に着目する

同一業務の中で、生成、使用されるイベント系エンティティを中心に、関連するエンティティをグルーピングする

同一業務の中で、さらにイベント系エンティティが生成されるサイクル（日次、月次など）に着目し、関連するエンティティをグルーピングする

全体の構造に着目する

データ構造の関連性から、エンティティの関連が希薄な箇所で切り分ける

エンティティの数が、20～30(A3一枚に記述できる範囲）を目安とする

エンティティの数が少ないならば、グルーピング毎に背景色を変えることでER図を見やすくする

【ER図分割の観点】

第1部 - 15



顧客

顧客番号

顧客名住所電話番号

受注

受注番号

顧客番号 (FK)受注年月日

商品

商品番号

商品名商品単価

受注明細

受注番号 (FK)商品番号 (FK)

受注数量

納品

納品番号

受注番号 (FK)納品年月日

納品明細

納品番号 (FK)商品番号 (FK)

受注番号 (FK)

販売計画

販売計画番号

製品番号販売予定数量

販売実績

商品番号販売年月日

販売数量合計金額


ER図に業務の流れを反映するにはMD1004：イベント系エンティティをデータの発生順で記述する

ER図上のエンティティを意味のある配置にすることで、システム化業務フローに沿ったデータの発生順が理解しやすくなる

ER図の例

計画受注納品

データを出力するシステム化業務の順序

集計

第1部 - 16



2.3 エンティティ一覧／定義書の表現のコツ

データモデルに業務の担当を反映するにはMD2001：エンティティ一覧にデータの主管部署を記述する

データを作成／削除する部署を限定することで、データへアクセスする機能の分散／重複を防止できる

設計時のデータ要件まとめ部署、および運用時のデータ主管部署が明確になる

項番エンティティ名説明・・・担当部署

１社員自社の社員をあらわす人事

２組織社員が所属する組織をあらわす人事

７出荷明細出荷の明細情報をあらわす販売

８販売計画販売の年間予測をあらわす販売企画

３顧客取引先企業をあらわす営業

４受注受注の基本情報をあらわす販売

５受注明細受注の明細情報をあらわす販売

６出荷出荷の基本情報をあらわす販売

エンティティ一覧の例

データの責任所在を記述する

第1部 - 17




エンティティの性質をエンティティ一覧で表現するにはMD2002：エンティティ一覧に業務名、エンティティの種別を記述する

エンティティ一覧記載例

項番エンティティ名エンティティ説明

受注受注の基本情報を表す

0002 受注明細受注の明細情報を表す販売イベント系エンティティ

0003 商品マスタ販売を目的とした財を表す在庫リソース系エンティティ生産財は含まない

0004 発注発注情報を表す調達イベント系エンティティ

0005 倉庫マスタ商品を保管する場所を表す在庫リソース系エンティティ

0006 商品別売上高商品別売上集計情報を表す損益サマリ系エンティティ

0007 取引先別売上高取引先別売上集計情報を表す損益サマリ系エンティティ

業務名エンティティ種別（注）備考

0001 販売イベント系エンティティ

データの移行、試験データ作成などの計画策定に必要な情報となる

（注）イベント系エンティティ：受注、発注など業務活動によって発生・増加する情報を管理するエンティティリソース系エンティティ：商品マスタ、倉庫マスタなど、イベント系エンティティから参照される、実際に存在するモノを管理するエンティティサマリ系エンティティ：売上高など、業務活動によって発生した情報の集計結果を管理するエンティティ

一覧に記載した種別とER図の色分けやグルーピングと相違しないことを確認すると、エンティティの性質をより理解できる（MD1001参照)

第1部 - 18




データモデルに業務量を反映するにはMD2003：エンティティ一覧にデータ件数や保存期間などを記述する

データの保存期間（削除のタイミング）が、データ構造を決めるひとつの根拠となる

データ件数の初期値、最大値、増加率を記述し、データを格納するリソース量の見積もり、データの運用設計の入力情報にする

項番エンティティ名説明・・・保存期間理由

１社員自社の社員をあらわす永年

永年

永年

５年

５年

５年

５年

－

２組織社員が所属する組織をあらわす－

７出荷明細出荷の明細情報をあらわす社内規則２０

３顧客取引先企業をあらわす－

４受注受注の基本情報をあらわす社内規則１０

５受注明細受注の明細情報をあらわす社内規則１０

６出荷出荷の基本情報をあらわす社内規則２０


法律やユーザ企業内の規則など保存期間を設定した理由を併記することが望ましい

第1部 - 19




エンティティ抽出の根拠を示すにはMD2004：エンティティおよび属性の抽出元を記述する

発注者は、現行システムで利用している用語でデータの意味を理解している

項番エンティティ名説明・・・抽出元

１社員自社の社員をあらわす社員（テーブル）

２組織社員が所属する組織をあらわす社員（テーブル）

３顧客取引先企業をあらわす受注伝票（ファイル）

４受注受注の基本情報をあらわす受注伝票（ファイル）

５受注明細受注の明細情報をあらわす受注伝票（ファイル）


抽出元項番属性型桁・・・

テーブル／ファイル属性

社員（テーブル）





１社員番号ＩＤ

２社員名氏名

３生年月日生年月日

４性別性別

５組織コード組織名

エンティティ定義書の例

新システムを開発する際、対象とする業務の現行システムが存在する場合に、現行システムでの帳票や台帳、テーブルを記述する

第1部 - 20




データモデルの変更点を確認するにはMD2005：エンティティ一覧において旧システムのデータモデルからの変更点を明記する

データモデルの変更が軽微なシステムの更新時に適用

旧バージョンからの変更点を一覧で確認できる

項番エンティティ名エンティティ_ID エンティティ概要 Ver.1.0.2での変更点備考

1 書籍 BOOK 書籍を表現する変更なし

変更なし

属性「オンラインショップ販売売

上」追加

新規追加

2 出版社 PUB_COMPANY 書籍に対応する出版社を表現

する

店舗別売上管理業務の追加に対応3 販売 SALES 書籍の販売情報を保持する

4 店舗 STORE 書籍の販売を行う店舗を表現

する

店舗別売上管理業務の追加に対応


変更されたエンティティと属性を明記する

第1部 - 21



ビジネスプロセス画面

C C R R

R R R RU

R R C R R

R R R C R R

受注受注入力画面

受注修正画面

出荷入力画面

請求入力画面

出荷

請求

請求

顧客

商品

イベント系エンティティリソース系エンティティ

エンティティ

受注

受注明細

出荷

2.4 CRUD図の表現のコツ

CRUD図をわかりやすく表現するにはMD3001：CRUD図のCreate,Read,Update,Delete記述欄を固定する

Create,Read,Update,Deleteの位置が縦に揃うため、Create,Read,Update,Deleteのないエンティティを発見しやすい

C R

U D C R U D

このように横一列に記述する方法もある

このようにCreate,Read,Update,Deleteの記述欄を固定すると見やすい

第1部 - 22




C C R R

R R R RU

R R C R R

R R R C R R

C

RU

RU

顧客メンテナンス顧客登録画面

顧客修正画面

商品メンテナンス商品修正画面

請求

顧客

商品


エンティティ

受注

受注明細

出荷


受注修正画面

出荷入力画面

請求入力画面

出荷

請求


CRUD図をわかりやすく表現するにはMD3002：CRUD図のエンティティをイベント系エンティティとリソース系エンティティに分離して記述する

イベント系エンティティとリソース系エンティティが分離されていない場合、どのエンティティがイベント系エンティティか明確にわからないため、業務のもれが発見しにくい

（注）イベント系エンティティ：受注、発注などの業務活動によって発生・増加する情報を管理するエンティティリソース系エンティティ：顧客マスタ、商品マスタなど、イベント系エンティティから参照される、実際に存在するモノを管理するエンティティ

イベント系エンティティのうちCreateやUpdateがないエンティティが存在する場合

は業務がもれている可能性があるが、イベント系エンティティとリソース系エンティティが分離されていない場合どのエンティティがイベント系エンティティか明確にわからないため、業務のもれが発見しにくい

第1部 - 23




CRUD図をわかりやすく表現するにはMD3003：CRUD図のビジネスプロセスを実際の業務の時系列順に並べる

業務の流れに沿ってレビューをする際に説明がしやすくなる

ビジネスプロセス受注出荷請求

ビジネスプロセスを実際の業務の時系列と同じように上から下へ順番に並べることにより、レビューの際にCRUD図の検証または確認がしやすくなる


C C R R

R R R RU

R R C R R

R R R C R R


受注修正画面

出荷入力画面

請求入力画面

出荷

請求

請求

顧客

商品


エンティティ

受注

受注明細

出荷

第1部 - 24



請求

顧客

商品


エンティティ

受注

受注明細

出荷


CRUD図をわかりやすく表現するにはMD3004：CRUD図のイベント系エンティティをエンティティを作成する順番に沿って並べる(1/2)

【MD3003】と併せることでCreateが左上から右下に並ぶことが多くなるため、例外的な処理を見つけやすくなる

データモデル受注出荷請求

エンティティを作成する順番に左から右に配置する

受注コード

出荷コード

請求コード

受注コード(FK)出荷コード(FK)受注コード(FK)

第1部 - 25




C C R R

R R R RU

R R C R R

R R R C R R


受注修正画面

出荷入力画面

請求入力画面

出荷

請求

請求

顧客

商品


エンティティ

受注

受注明細

出荷


CRUD図をわかりやすく表現するにはMD3004： CRUD図のイベント系エンティティをエンティティを作成する順番に沿って並べる(2/2)

【MD3003】と併せることでCreateが左上から右下に並ぶことが多くなるため、例外的な処理を見つけやすくなる

ビジネスプロセスは時系列順に上から下へ、エンティティは作成順に左から右へ配置されているため、基本的に生成タイミング（C）が左上から右下に並ぶ

第1部 - 26



2.5 データのフロー等の表現のコツ

発注者がデータフロー図の構成要素を区別しやすくするにはMD4001：データフロー図にイラストを使用する

イラスト入りの表現形式でデータフロー図を表現することで、構成要素同士の違いが明確になる

イラストなしのデータフロー図の例イラスト入りのデータフロー図の例

凡例：データフロー（イラストを付加）：プロセス：データストア：外部名

なお、イラストは外部名を示す

イラストに変更する

データフロー図とは、システムにおけるデータの流れ（フロー）に着目して表現した図である。使用する記号には4種類あり、矢印がデータフロー、円がプロセス、二重線がデータストア、四角が外部名を示す

注文

顧客

出荷

出荷指示書

倉庫

注文受付注文情報

出荷指示書

出荷

注文受付顧客

倉庫

注文情報

注文書

出荷情報

出荷情報

注文書

注文

出荷完了出荷完了

第1部 - 27




データの流れをわかりやすく表現するにはMD4002：処理で利用するデータの入出力を図を利用して記述する

文章で表現するよりどの処理でどのようなデータを入力してどこに出力するのかがわかりやすい

入力出力処理

●ユーザ入力

●利用エンティティ

出荷情報検索入力画面

出荷情報検索結果画面

●画面出力

顧客

受注受注明細

出荷

出荷情報検索処理

IPO（入力-処理-出力を表で表したもの）の入力と出力の部分を図を利用してわかりやすく表現した例データの入出力をわかりやすく表現するのが目的なので、詳しい処理は記述しない

検索条件

各種情報

検索結果

<凡例>

：画面

：エンティティ

：処理

第1部 - 28




状態の変化をわかりやすく表現するにはMD4003：処理の間を流れるデータとその状態を記述した図表を作成して説明する(1/2)

各処理でデータの状態がどのように変化するのかがわかりやすい

1.申請／提出3.管理確認①

2.未承認確認

5.人事管理

4.管理確認②

term

<0.申請>

<4.再申請>

<3.未承認><3.未承認>

<5.取下げ>

<1.管理者承認済> <9.承認済>

<9.承認済>

<9.承認済>

<2.人事代理承認済>

<凡例>：処理名称

：状態

第1部 - 29




状態の変化をわかりやすく表現するにはMD4003：処理の間を流れるデータとその状態を記述した図表を作成して説明する(2/2)

各処理でデータの状態がどのように変化するのかがわかりやすい

No. 処理名称処理概要入力される状態出力される状態条件

1 申請／提出各種申請書の申請、または勤怠

の提出を行う

なし 0.申請各種申請／勤怠提出を行った場合

2 未承認確認管理者、または人事により未承認

となった各種申請または勤怠を修

正し、再申請または取下げを行う

3.未承認 4.再申請

5.取下げ

再申請／提出を行った場合

各種申請を取下げた場合

3 管理確認① 各種申請、または勤怠の確認お

よび承認を行う

0.申請

4.再申請

1.管理者承認済

2.人事代理承認済

3.未承認

9.承認済

内容に不備がなく人事承認を行った場合

人事管理者による代理承認した場合

内容に不備がある場合

内容に不備がなく人事承認を必要としない場合

または、人事管理者が承認した場合

4 管理確認② 人事管理者により承認されている

各種申請または勤怠の確認を行

う

2.人事代理承認済 9.承認済管理者が確認した場合

5 人事管理管理者による承認済の各種申請

または勤怠の確認および承認を

行う

1.管理者承認済 3.未承認

9.承認済

内容に不備がある場合

内容に不備がなく全承認業務が終了する場合

Documents

使用条件 - ipa.go.jp · JavaおよびすべてのJava関連の商標およびロゴは、米国およびその他の国における米国SunMicrosystems，Inc．の商標または登録商標です。