機能要件に関する発注者と開発者の

Software
Engineering
Center
Information-technology Promotion Agency, Japan
機能要件に関する発注者と開発者の
合意形成を目指して
2011年 6月 3日
独立行政法人 情報処理推進機構(IPA)
ソフトウェア・エンジニアリング・センター(SEC)
Copyright© 2010,2011 Information-technology Promotion Agency, Japan. All rights reserved.
Software Engineering Center
SEC
使用条件
1.
2.
3.
4.
5.
6.
7.
Software Engineering
for Mo・No・Zu・Ku・Ri
本資料の著作権は、独立行政法人情報処理推進機構(IPA)が保有しています。
独立行政法人 情報処理推進機構は、「本資料の全部又は一部を複製、改変、公衆送信、又は翻
訳/翻案し、第三者に有償又は無償で再配布すること」を許諾します。なお、複製し再配布する場
合は、実際の契約書として使用する場合を除き、本使用条件を添付し、本使用条件に記載されて
いる条件を配布先に遵守させて下さい。改変又は翻訳/翻案し再配布する場合は、実際の契約書と
して使用する場合を除き、新しく使用条件を設定することが可能ですが、本使用条件を必ず含め
て下さい。
独立行政法人 情報処理推進機構は、本資料が第三者の著作権、特許権、実用新案権等の知的財
産権に抵触しないことを一切保証するものではなく、また、本資料の内容に誤りがあった場合で
も一切責任を負いかねます。
独立行政法人 情報処理推進機構は、本ページで記載された許諾内容を除き、独立行政法人 情
報処理推進機構又は第三者の著作権、特許権、実用新案権等の知的財産権に基づくいかなる権利
を許諾するものではありません。
独立行政法人 情報処理推進機構は、本資料の商取引への利用、システム開発への利用、開発さ
れたシステムの使用、及び当該システムの使用不能等により生じるいかなる損害についても、な
んら責任を負うものではありません。
本資料へのお問い合わせについては、独立行政法人 情報処理推進機構 ソフトウェア・エンジ
ニアリング・センターまでご連絡下さい。
二次利用時に著作権を表示する場合は、次のように表記してください。
 2011年に公開した場合
Copyright © 2011 IPA, 二次著作権者名
 2012年に公開した場合
Copyright © 2011,2012 IPA, 二次著作権者名
 2013年以降に公開した場合
Copyright © 2011-公開年 IPA, 二次著作権者名
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center
1
SEC
本日のメニュー
Software Engineering
for Mo・No・Zu・Ku・Ri
1. 「機能要件の合意形成ガイド」とその開発背景
2. 「機能要件の合意形成ガイド」内容の紹介
3. 「機能要件の合意形成ガイド」の適用例
4. まとめ~どのように使ったらよいか?~
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center
2
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
1.「機能要件の合意形成ガイド」とその開発背景
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center
3
「機能要件の合意形成ガイド」って何?
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 機能要件に着目し、上流工程で実現したい情報システム像を伝え、
発注者と開発者との不充分な合意形成が原因で発生する下流工程の
手戻りを防止するためのコツを集めたもの
実現したい情報システム像について
発注者と開発者が合意形成するた
めに、伝える側が漏れなく正確に情
報を提供するためのコツ
システム振舞い編
画面編
概説編および
6つの技術領域毎の編
の計7冊から構成
発注者と開発者との不充分な合意
形成が原因で下流工程で発生する
手戻りを防止するための先人の開
発者のコツ
データモデル
編
概要編
ZZ 9/ ZZ 9
納品書
(ZZ9)
Y Y Y Y /M M /D D 23:59
伝 票 番 号 XXXXXXXXXX お 届 け 先 コ ー ド XXXXXXXXXX
お届け先名
NNNNNNNNNNNNNN 御中
お届 け先住所 NNNNNNNNNNNNNNNNNNNNN
NNNNNNNNNNNNNNNNNNNNN
出荷元 コー ド
出荷部門
XXXXXXXXXX
NNNNNNNNNNNNNN
売上区分 X
発注区分 X
支払期限
YYYY 年 M M 月 D D 日
納品明細
No
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
品 番
商品名
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
XXXXXXXXXXXXXXXN N N N N N N N N N N N
単 価 数 量
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
\Z,ZZZ,ZZ ZZ
9
帳票編
合 価
消費税
\Z,ZZZ,ZZZ,ZZ 額
\Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ
9
備 考
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
バッチ編
Copyright © 2010,2011 IPA, All Rights Reserved
外部インタフェース編
Software Engineering Center
4
「機能要件の合意形成ガイド」を作った背景
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 システム開発における手戻りとコストの関係
要件定義
運用テスト
システム仕様
システムテスト
10~100
修
正
ソフトウェア
仕様
ソフトウェア
テスト
5
コ
ス
プログラミング
ト
ソフトウェア システム
テスト
テスト
運用
テスト
発見工程別相対修正コスト
右の出典:B.W.Boehm “Soft. Eng.” IEEE Trans. com (Nov ‘76)
SEC-BOOKS『経営者が参画する要求品質の確保』(P26)より
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center
5
「機能要件の合意形成ガイド」を作った背景
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
事業
業務A
業務B
人による活動
人による活動
システム
システム
業務D
人による活動
業務C
事業・業務とシステム・ソフトウェアとの関係
人による活動
業務要件
業務E
人による活動
システム要件
システム
システム要件
非機能要件
人による活動
業務E
システム利用
機能要件
システム
ハードウェア ソフトウェア
アーキテクチャ設計
その他設備
(ネットワークなど)
ソフトウェア要件
出典:共通フレーム2007「ソフトウェアとシステム」に追記
Copyright © 2010,2011 IPA, All Rights Reserved
要
件
定
義
シ
ス
テ
ム
設
計
ソ
フ
ト
ウ
ェ
ア
設
計
業務要件のブレークダウン
Software Engineering Center
6
「機能要件の合意形成ガイド」を作った背景
発注者
顧客社外ユーザ
代理店
監督官庁
企業・個人ユーザ
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
システム開発に係る
ステークホルダー
開発者
開発グループ
顧客社内ユーザ
ソフトハウス
経営者
企画/
業務設計担当
システム
開発担当
開発ベンダ
オフショア先
運用・業務支援グループ
SECBOOKS 共通フレーム2007(第2版)P.6
「コミュニケーションチャネルの複雑さ」を参考
アウトソーサ
ヘルプ
デスク
コールセンタ
システム開発におけるステークホル
ダーの増加により、発注者間、発注
者と開発者間の認識の齟齬、意思
伝達の漏れが多く発生
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center
7
「機能要件の合意形成ガイド」を作った背景
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 システム開発において起こりうるギャップの例
発注者と開発者の認識の齟齬により要求と実現されるソフトとの間に
ギャップが生じる
これの解決支援が目的
①要件定義すべき内容が抜けてお
り、開発者に説明していない。
発注者
シ
ス
テ
ム
化
計
画
業
務
部
門
の
要
求
内
容
開発者
A
要
件
定
義
内
容
②発注者が開発者に説
明したが、何らかの
理由で漏れた。
B
外
部
設
計
内
容
C
ソ実
フ現
トさ
ウれ
ェる
ア
バグや障害
バグや障害
③発注者が開発者に
説明し、共通理解
が得られた。
バグや障害
この絵は、発注者が要件定義ま
でを行い、それ以降の工程を開
発者が行う場合の例
④開発者が何らかの理由により
誤認・拡大解釈し、実現範囲
に取り込んでしまった。
Copyright © 2010,2011 IPA, All Rights Reserved
参考文献:IPA/SEC
発注者ビューガイドラインの活用と拡張(p.4)
Software Engineering Center
8
SEC
「機能要件の合意形成ガイド」開発のあゆみ
2006年度~2007年度
2008年度
2009年度
2010年度
IPA/SEC
機能要件の合意形成技法WG
発注者ビュー検討会(注)
(情報システムにおける「仕様」について、お客様に
わかりやすい記述方法および合意方法を共同検
討することを目的に国内主要SI事業者(9社)が結
集した検討会)
発注者ビューガイドラインの作成/評価
Software Engineering
for Mo・No・Zu・Ku・Ri
課題整理・領域拡大
発注者ビュー
ガイドライン
成果物
「発注者ビュー
ガイドライン
ver. 1.0」
3技術領域
コツ数 187
IPAにて
7月より
公開
成果物
「発注者
ビューガイド
ラインの活用
と拡張」
改訂版
の作成
評価
成果物
機能要件の
合意形成ガイ
ド
6技術領域 3月
コツ数 278
・Webサイトによる成果物の公開
・IPA/SEC,JUASとの連携
・書籍出版
書籍
「失敗しない」
外部設計」
日経BP社
8月
注:発注者ビュー検討会=実践的アプローチに基づく要求仕様の発注者ビュー検討会
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center
9
「機能要件の合意形成ガイド」普及のあゆみ

Web公開文書の利用実績
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
「機能要件の合意形成ガイド」
2010/4~2010/11のダウンロード単純合計:
約42,000件(約5,000件/月)
ユニークユーザは月700~800人
「発注者ビューガイドライン」2008/7~
2010/6末のダウンロード単純合計:
約132,000件(約5,000件/月)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 10
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
2.「機能要件の合意形成ガイド」内容の紹介
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 11
「機能要件の合意形成ガイド」の目的

SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
要件定義・外部設計におけるお客様との認識の齟齬を防ぐ
目的とする情報システム
像
(外部設計として整備する事
項)
業務モデルの構築
発注者
発注者視点で、
見える・わかる
情報システムの実現
開発者
発注者視点で書き、
説明する
外部設計書
機能要件の合意形成ガイド
お客様との認識の齟齬を防ぐ
非機能ではなく、機能寄り(機能要件、動作仕様etc…)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 12
SEC
機能要件の合意形成ガイドとは

Software Engineering
for Mo・No・Zu・Ku・Ri
278のコツを適用する技術領域・適用画面に分類・整理したもの
278 言い切る/聞き切る 44 図表に書く
シ振
ス舞
テい
ム編
・言い切る/聞き切る
60
画
面
編
84
35
バ
ッ
チ
編
23
帳
票
編
31
7
7 ・バッチ処理一覧
・バッチ処理フロー
・バッチ処理定義
・バッチ共通ルール
7
・言い切る/聞き切る
8 ・帳票レイアウト
・帳票項目説明
・帳票概要
・帳票編集定義
8
1 ・もれ/矛盾をチェックする
2
3
1
2 ・もれ/矛盾をチェックする
4
2
3
11
2 ・もれ/矛盾をチェックする
1
1
1
5
発注者
22 一緒にレビューする
94 が事前に
17
意識する
2 ・全レベルでレビュー(要件との整合)
・全レベルでレビュー(設計書の正しさ)
・仕掛レベルのレビュー
・充実レベルのレビュー
・充実・完成レベルのレビュー
2
3
3
5
8
5
24
2 ・設計書レビューの進め方
1 ・画面全体に渡る共通事項のレビュー
3 ・画面の一連の動きのレビュー
6 ・1つの画面のレビュー
2
1
15
4
5
4
13
10 ・外部システム関連図
・外部インタフェース一覧
・外部インタフェース項目説明
・外部インタフェース処理説明
10
・言い切る/聞き切る
6 ・画面一覧
5 ・画面遷移
4 ・画面レイアウト
3 ・画面遷移・レイアウト共通ルール
6 ・画面入出力項目一覧
8 ・工程成果物間の関連
4
36
8 ・ER図
・エンティティ一覧
・CRUD図
8
・言い切る/聞き切る
7 ・システム化業務フロー
11
4
5
2
29
6 ・画面一覧
・画面遷移
・画面レイアウト
・画面入出力項目一覧
・画面アクション明細
・画面遷移・レイアウト共通ルール
・工程成果物間の関連
6
・言い切る/聞き切る
45
外イフ
部 ンェ
ター
ス
編
5 ・システム化業務一覧
・システム化業務フロー
・システム化業務説明
・システム振舞い共通ルール
・工程成果物間の関連
5
・言い切る/聞き切る
デ
ー
タ
モ
デ
ル
編
101 もれ/矛盾をチェックする
27
・エンティティ・属性を抽出する
・データモデルの概要を説明する
・データモデルの詳細を説明する
・データの変化を確認する
・業務とデータの関係を確認する
・他システムとやりとりするデータを確認する
・業務量を確認する
0
2
1
Copyright © 2010,2011 IPA, All Rights Reserved
0
9
9
4
4
2 ・一緒にレビューする
2
7 ・発注者
が事前に
意識する
7
1 ・一緒にレビューする
0
3
1
11
3
2
3
1
24
2 ・一緒にレビューする
0
8
5
4
10
8 ・発注者
が事前に
意識する
8
0
8
8
Software Engineering Center 13
「機能要件の合意形成ガイド」コツとは

「○○の様な場面に△△のような行動を取る(記述する)と□□の
様な効果がでる」といったイメージ
事例から生まれたもの


Software Engineering
for Mo・No・Zu・Ku・Ri
発注者と開発者との認識の齟齬を防止する為のノウハウ


SEC
ガイド執筆メンバにおける認識の齟齬防止に効果があった事例を抽
象化したもの
目的、施策、メリットがはっきりしている

はっきり出来なかった中途半端なモノ⇒コラム
※ コツが主役である。
→「工程成果物」、「合意成熟度レベル」、「4つの作業」などは、
コツを分類する為に用意された仕切り版の様なもの。
これらを規定するガイドではない。
※ あらゆる場面に効果が出る訳ではない
→利用時には取捨選択必要(コツ間の矛盾も存在)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 14
「機能要件の合意形成ガイド」技術領域
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 技術領域
エンタープライズ系業務システムを構築するにあたり、機能要件として
設計対象となる主要な要素。次の6つの技術領域からなる。
システム振舞い
画面
データモデル
これらの
1つひとつが
技術領域
ZZ9/ZZ9
納品書
(ZZ9)
YYYY/MM/DD 23:59
伝票番号 XXXXXXXXXX お届け先コード XXXXXXXXXX
お届け先名
NNNNNNNNNNNNNN 御中
お届け先住所 NNNNNNNNNNNNNNNNNNNNN
NNNNNNNNNNNNNNNNNNNNN
出荷元コード
出荷部門
XXXXXXXXXX
NNNNNNNNNNNNNN
売上区分 X
発注区分 X
支払期限
YYYY年MM月DD日
納品明細
No
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
単 価
品 番
商品名
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ
9
帳票
数量
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
ZZ
合 価
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
\Z,ZZZ,ZZZ,ZZ
消費税
額
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
\Z,ZZZ,ZZ
9
備 考
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
NNNNNNNNNNNN
バッチ処理
外部インタフェース
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 15
「機能要件の合意形成ガイド」工程成果物
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 工程成果物とは?
各技術領域において、設計書の一部として書かれ、
合意形成のために必要な設計要素(名称は一般的なもの)
設計書
画面設計書
発注者
「工程成果物」
画面レイアウト
画面入出力項目
一覧
確認
画面アクション明細
※ コツに登場する設計要素のみ収録
開発で必要なもの全てを収録しているわけではない。
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 16
「機能要件の合意形成ガイド」工程成果物
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 システム振舞い編の紹介
要件定義プロセスで作成される業務フローや業務処理定義書を元に、
システム化する範囲を識別し、その範囲の設計を発注者と開発者が合意
するためのコツを、4つの「工程成果物」を中心に解説。
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 17
「機能要件の合意形成ガイド」工程成果物
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 画面編の紹介
要件定義、外部設計工程で作成される業務フローやシステム化業務フ
ローを元に、導き出されるユーザインターフェースの1つである「画
面」を設計するためのコツを、6つの「工程成果物」を中心に解説。
画面遷移
画面間の遷移関係を示した図。
画面から画面への遷移と画面
遷移を起こすキッカケとなるイベン
ト。
条件分岐がある場合は、その条
件と対応する分岐遷移
画面一覧
No
分類
1 入力フォー
ム
2 入力フォー
ム
3 入力フォー
ム
…
…
画面
画面名
…
ID
ペット登録画面 S-01 …
販売者登録画 S-02 …
面
ログイン画面
S-05 …
…
…
システムで使用する
画面の一覧
…
画面遷移・レイアウト
共通ルール
画面レイアウトと画面遷移
余白
ヘッダーエリア
ユー コンテンツエリア コンテ
ティリ
(main)
ンツエ
ティエリ
リア
ア
(sub2)
コンテ
ンツエ
リア
(sub1) フッターエリア
画面アクション明細
アクションの処 アクションの処理詳細
理概要
入 力 さ れ た 情 ①顧客情報の入力チェック
報をもとに顧客 ②検索処理
情 報 を 登 録 す 入力された情報をもとに顧客情報テー
る
ブルを検索する
③-1 合致するデータが存在しない場合
顧客情報を登録し、顧客登録画面を初
期表示する
③-2 合致するデータが存在した場合
エラーメッセージを表示する
画面遷移に
伴って起動
させる動作
項目・イベント発生オブジェクト名、
それらに対応する画面部品
(ボタン、入力出力項目など)
およびその配置
20%
60%
に関する共通ルールおよ
び諸々の画面(群)が準じ
る 典型的なレイアウトや
80ピクセル 遷移のポリシ
80ピクセ
60ピクセル
20%
画面レイアウト
画面入出力項目一覧
表
識別
示
表示用のラベル 部品の種類 入力
ID
桁
数
1 ユーザ名
ラベル
× 18
2 新しいパスワード
テキストボックス
△ 18
3 再入力パスワード
テキストボックス
△ 18
4 名前(姓)
テキストボックス
△ 19
5 名前(名)
テキストボックス
△ 19
6 Eメールアドレステキストボックス
○ 39
7 電話
テキストボックス
○ 19
8 住所1
テキストボックス
○ 39
9 住所2
テキストボックス
○ 39
Copyright © 2010,2011 IPA, All Rights Reserved
入
力
桁
数
10
10
18
18
38
18
38
38
データ型
文字列
文字列
文字列
文字列
文字列
文字列
文字列
文字列
文字列
入力制約
初期表示
○ ユーザ名値
パスワード入力パターン ×
パスワード入力パターン ×
×
×
Eメール入力パターン
×
電話番号入力パターン ×
×
×
-
画面を介して入出力
する項目の外部仕様
Software Engineering Center 18
SEC
「機能要件の合意形成ガイド」工程成果物
Software Engineering
for Mo・No・Zu・Ku・Ri
 データモデル編の紹介
開発対象システムのデータモデルを設計するためのコツを、
4つの「工程成果物」を中心に解説。
ER図
ユーザ企業内で利用す
るデータをモデル化して
表現したもの
CRUD図
業務とエンティティの
関係を表現したもの
エンティティ
顧
客
機
能
エンティティとリレーショ
ンを表現するシンボルを
用いて作図する。
顧客登録
C
顧客検索
R
受注登録
R
受注明細登録
R
製
品
受
注
受
注
明
細
C
R
R
C
その他資料
データモデル
エンティティ一覧
項番 エンティティ名
説明
1 顧客
・・・
2 商品
・・・
3 受注
・・・
エンティティの一
覧
エンティティ定義
エンティティ名商品
エンティティ名およ
項番 属性名 型 桁 PK 説明
1 商品番号 X 10 P ・・・
びエンティティごと
2 商品名
X 100
・・・
3 商品区分コード
X 3
・・・
の属性の一覧
・・・
Copyright © 2010,2011 IPA, All Rights Reserved
データ辞書
ユーザ企業内で利用する
データに関する規則集
データの最小単位で
データ項目定義 あるデータ項目を定義
ドメイン一覧/定義
データ項目をカテゴリ
分けするための基準
コード一覧/定義
データの内部構造や値
が決まっているデータ項
目の仕様を定義
ファイル一覧/定義
システム間でやりと
りされるデータファイ
ルの一覧/詳細
Software Engineering Center 19
SEC
「機能要件の合意形成ガイド」工程成果物
Software Engineering
for Mo・No・Zu・Ku・Ri
 外部インタフェース編の紹介
外部インタフェースについての「コツ」を、4つの「工程成果物」を中心
に解説。
外部インタフェースの対象領域
やりとりされる
データ
(名称、内容)
開発対象
業務システム
相手先
業務システム
データのやりとりの特性
データのやりとりの方向、手段/方法
データのやりとりのタイミング
外部インタフェース項目説明
No
1
PKEY 項目名
1 送信時刻
2
送信件数
ディテールヘッダ
No PKEY 項目名
1
1 受注番号
2
2 受注区分
3
顧客コード
4
受注金額合計
VARCHAR2
6
7
受注明細件数
支払区分
VARCHAR2
VARCHAR2
クレジット番号
クレジットユーザ名
届け先住所
届け先氏名
届け先電話番号
VARCHAR2
VARCHAR2
VARCHAR2
VARCHAR2
VARCHAR2
3
レコードフッタ
No PKEY 項目名
1
1 送信時刻
システム間のデータの送受
信関係を図示したもの
属性
VARCHAR2
VARCHAR2
VARCHAR2
NUMBER
受注日時
9
希望配送日
9
希望配送時間帯
ディテールボディ
No PKEY 項目名
1
1 注文番号
2
2 商品コード
3
3 商品単価
4
4 購入数量
5
ディテールフッタ
No PKEY 項目名
1
1 終了レコード
2
2 受注明細件数
システム
B
NUMBER
5
8
9
10
11
12
外部システム関連図
属性
VARCHAR2
VARCHAR2
VARCHAR2
桁数 必須 説明
12 ○ 送信処理を開始した時刻
(yyyymmdd/hhmmssの形式)
2 ○ 送信する受注件数(=ディテールヘッダレコード数)
桁数 必須 説明
12 ○ 受注(あるいは取消)処理時に採番した番号
1 ○ 受注あるいは取消の区分、1:受注、0:取消
12 ○ 受注を受けた顧客の顧客コード
12 ○ 受注金額あるいは取消金額
(=ディテールボディの単価×購入数量の合計)
15 ○ 受注あるいは取消が成立した日時
(yyyymmdd/hhmmssの形式)
2 ○ 後続するディテールボディーレコード数
1 ○ 支払方法区分
(D:送品時支払、C:クレジット支払、S:振込)
16
クレジット支払いの場合のクレジット番号
16
クレジット支払いの場合のクレジット所有者名
100
顧客情報で登録されている住所と異なる場合の送付先住
50
顧客情報で登録されている住所と異なる場合の送付先氏
8
顧客情報で登録されている住所と異なる場合の送付先電
話番号
8
配送希望日
1
配送時間帯区分(1:午前中、2:13-15、3:15-18、4:18-20)
属性
NUMBER
CHAR
NUMBER
NUMBER
桁数
属性
桁数
2
12
6
2
NUMBER
12
属性
VARCHAR2
必須 説明
○ 受注した注文明細毎の番号(1から昇順)
○ 受注した商品の商品コード
○ 受注時点での商品単価(受注時は必須)
○ 受注あるいは取り消した商品数
必須 説明
○ 受注明細件数
(ディテールヘッダの受注明細件数と同じ)
桁数 必須 説明
12 ○ 送信処理を開始した時刻
(yyyymmdd/hhmmssの形式)
外部インタフェースに含まれ
る項目に関する定義
システムA
外部インタフェース処理説明
通信先
通信先プラットフォーム
受注管理システム
UNIX(HP-UX11i)
エラー時の対応
送信/受信
送信
データ量
メッセージ長
可変
500Byte(max)
エスケープの規定
エラー時のファイルを破棄し、ファイルを再生成後にリトライする。
外部インタフェース処理説明
・ レコード間では次の規則に従っていること。
① レコードヘッダレコードの送信件数、レコードフッタレコードの送信件数、ならびにディテールヘッダレコードの数は一致していること。
② ディテールヘッダレコードの受注明細件数、ディテールフッタレコードの受注明細件数、ならびに後続するディテールボディレコードの件数は一致していること。
③ ディテールヘッダレコードの受注金額合計と後続するディテールボディレコードの販売単価×購入数量の合計は一致していること。
④ レコードヘッダレコードの送信時刻とレコードフッタレコードの送信時刻は一致していること。
外部インタフェース一覧
・ 受信側で上記の規則に従っていないデータを受信した場合には、途中でデータが欠落したものとみなし、送信エラー扱いとすること。
No 外部インタフェースID
出力 入力
相手先システム情報
(To) (From) 自システム名
システム名
既/新
○
受注管理システム 販売管理システム 既存
外部データ名
1
7800001
受注情報
2
7800002
商品出荷状況情報
○
受注管理システム 販売管理システム 既存
3
7800003
商品情報
○
受注管理システム 販売管理システム 既存
4
7800004
新規顧客情報
○
5
7800005
顧客更新情報
○
6
7800006
受注処理ログ情報
7
7800007
信用照会問合せ情報
8
7800008
信用照会結果情報
9
10
11
6800001
6800002
6800009
出荷指示情報
配送結果情報
販売管理処理ログ情
報
・ 送信対象の受注情報がない場合は、レコードヘッダレコードとレコードフッタレコードだけを送信し、その際の送信件数は0とする。
受注管理システム 顧客管理システム 既存
受注管理システム 顧客管理システム 既存
○
受注管理システム 処理証跡管理シス 既存
テム
受注管理システム クレジット信用照会 既存
システム(外部)
○
受注管理システム クレジット信用照会 既存
システム(外部)
販売管理システム 集配信システム
既存
販売管理システム 集配信システム
既存
販売管理システム 処理証跡管理シス 既存
テム
○
○
○
○
・ 受信側は外部インタフェースレコードを受信したら、受信したレコードが上記に示す規則に従っているかを確認する。
規則に従った外部インタフェースレコードであった場合には、送信元に対して「受信成功」のメッセージを送信する。
規則に従っていない場合には「送信エラー」のメッセージを送信する。
外部インタフェースを一覧化
したもの
システム
C
外部システムとのデータのやりとりの
方式について、概要を記述したもの
システムC
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 20
「機能要件の合意形成ガイド」工程成果物
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 バッチ編の紹介
バッチ処理の外部設計とバッチ処理以外の設計要素との接点にあたる
コツを、4つの「工程成果物」を中心に解説。
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 21
SEC
「機能要件の合意形成ガイド」工程成果物
Software Engineering
for Mo・No・Zu・Ku・Ri
 帳票編の紹介
開発対象となる業務システムで帳票として扱われる出力成果物を設計
するためのコツを、5つの「工程成果物」を中心に解説。
帳票概要
サブシステム名
販売管理
帳票名
商品一覧リスト 帳票分類 一覧表
業務名
販売管理
帳票ID
RZAB-01
出力枚数 100P/回
機能名
商品管理
作成方法
バッチ出力
作成環境 サーバ
出力様式 CSV
用紙サイズ A4横
プリンタ種別
その他 出力タイミング 月次
保存期間 -
改ページ条件
なし
出力制御条件 なし
セキュリティ条件 なし
指定プリンタ なし
再出力 可
利用部門 ○○部門担当者(●●さん)
現行帳票名
概要
商品管理機能の商品情報一覧画面で表示されている商品リストの一覧を出力する
商品一覧は、商品コード、商品名、商品名(カタカナ)、単価、販売開始時期、当月販売可否、当月販売可能数を掲載する。
商品の出力順序は商品コード順である。
備考
帳票項目説明
No
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
フォント
種類
サイズ
項目名
【ヘッダ部】
ページ番号
伝票内通しページ番号
通番ページ番号
MSゴシック
MSゴシック
MSゴシック
出力日、出力時刻
消費税額
備考
【合計行】
合計金額
仮受消費税
編集様式
参照先エンティティ
出力編集
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
10
10
10
10
10
10
10
10
10
10
10
10
左詰
左詰
左詰
左詰
左詰
左詰
左詰
左詰
左詰
左詰
左詰
左詰
10
28
10
10
10
40
40
1
1
4
2
2
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
MSゴシック
10
10
10
10
10
10
左詰
左詰
左詰
左詰
左詰
左詰
2
15
24
10
3
14
2
15
24
7
3
10
8 左詰
3
3
3
フォーマット
3 数字(ZZ9)
3 数字(ZZ9)
通番ページ編集ルールに従う
3 数字(ZZ9)
通番ページ編集ルールに従う
YYYY/MM/DD△H24:MI
出力時のシステム時刻を設定
14 (出力日と出力時刻の間は半角
(伝票単位に更新)
空白を空けること)
伝票単位に出力
10 文字列
28 文字列(日本語)
10 文字列
10 文字列
10 文字列(日本語)
40 文字列(日本語)
40 文字列(日本語)
1 文字列
1 文字列
4 数字
2 数字(Z9)
2 数字(Z9)
MSゴシック
【伝票ヘッダ】
出荷元コード
出荷元名
伝票番号
届け先コード
届け先名
届け先住所1
届け先住所2
売上区分
発注区分
支払期限(年)
支払期限(月)
支払期限(日)
【明細行】
NO
品番
商品名
単価
数量
合価
表示属性
文字詰 表示桁数 内部桁数
8 右詰
8 右詰
8 右詰
16
数字(Z9)
文字列
文字列(日本語)
数字(\Z,ZZZ,ZZ9)
数字(ZZ9)
数字(\Z,ZZZ,ZZZ,ZZ9)
出荷トランザクション
部門マスタ
出荷トランザクション
出荷トランザクション
出荷トランザクション
出荷トランザクション
出荷トランザクション
出荷トランザクション
出荷トランザクション
支払期限マスタ
帳票の用途、物理的な属性、動作環境、
運用要件などについてまとめたもの
参照カラム
部門コード
表示用部門名
出荷No
納品先コード
納品先名
納品先住所1
納品先住所2
売上区分
発注区分
支払期限
1から昇順にカウントアップ
出荷明細トランザクション 品番
商品マスタ
商品名
商品マスタ
単価
出荷明細トランザクション 数量
合価=単価×数量
消費税額
=(単位消費税額×数量)
MSゴシック
10 左詰
10
MSゴシック
10 左詰
24
24 文字列(日本語)
MSゴシック
MSゴシック
10 左詰
10 左詰
16
14
12 数字(\ZZZ,ZZZ,ZZZ,ZZ9)
10 数字(\Z,ZZZ,ZZZ,ZZ9)
7 数字(\Z,ZZZ,ZZ9)
商品マスタ
単位消費税額
帳票レイアウト
1
2
ZZ9/ZZ9
16px
納品書
4
10px
出荷元コード
出荷部門
8
伝票番号 XXXXXXXXXX お届け先コード XXXXXXXXXX
お届け先名 9 NNNNNNNNNNNNNN
御中
お届け先住所 NNNNNNNNNNNNNNNNNNNNN 10
NNNNNNNNNNNNNNNNNNNNN
売上区分 X
発注区分 X
支払期限
11
納品明細
17
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
3
(ZZ9)
YYYY/MM/DD 24:59
ヘッダ
部
5
XXXXXXXXXX
NNNNNNNNNNNNNN6
10px
12
13
YYYY年MM月DD日
14
No
帳票名
作成周期 出力様式
用紙
プリンタ種別
サイズ
帳票分類
改ページ 出力制約
条件
条件
1 RZAB-01
商品一覧リスト
月次
CSV
A4横
その他
一覧表
なし
なし
販売
商品管理
バッチ出力
2 RZAB-02
商品明細情報表
随時
汎用紙
A4横
モノクロレーザ
詳細表
なし
あり
販売
商品管理
オンライン出力
3 RZBA-01
送付先宛名シールリスト その他
専用紙
A4縦
モノクロレーザ
宛名リストなし
なし
販売
販売促進
オンライン出力
4 RZCB-02
得意先別受注明細表
PDF
A4横
その他
明細表
販売
売上管理
バッチ出力
5 RZCC-01
得意先別請求書(帳票) 月次
汎用紙
A4横
ページプリンタ
明細表
販売
請求管理
バッチ出力
6 RZCC-01
得意先別請求書(FAX) 月次
FAX
A4横
その他
明細表
販売
請求管理
オンライン出力
帳票ID
月次
業務
機能
作成方法
出荷明細トランザクション 備考
10px
7
No
合計金額=Σ(合価)
仮受消費税=Σ(消費税額)
帳票レイアウトに基づいて印字されるデータ
項目の属性情報を記載したもの
10px
帳票一覧
【利用頻度】月1回
【出力条件】そのまま印刷可能な状態とすること。
【帳票廃止可能性】電子化し再利用できるなら廃止可
15
16
10px
作成する帳票を一覧化したもの
見出し
項目1
項目2
項目3
項目4
□□□
□□□
□□□
□□□
□□□
□□□
□□□
□□□
□□□□
□□□□
□□□□
□□□□
□□□□
□□□□
□□□□
□□□□
□□□□□
□□□□□
□□□□□
□□□□□
□□□□□
□□□□□
□□□□□
□□□□□
□□□
□□□
□□□
□□□
□□□
□□□
□□□
□□□
伝票ヘッダ部
(2ページ目以降
は、
売上区分、発注区
分、支払期限は印
帳票編集定義
処理説明
サブシステム名
業務名
機能名
帳票分類
処理説明
全般
21
18
24
消費税 23
備 考
品 番
商品名 19 20 単 価 数量 22 合 価
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z 額
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
\Z,ZZZ,ZZ NNNNNNNNNNNN
XXXXXXXXXXXXXXXNNNNNNNNNNNN \Z,ZZZ,ZZ ZZ \Z,ZZZ,ZZZ,Z
9
9
\Z,ZZZ,ZZZ,ZZZ,Z 25
合計金額
Z9 \Z,,ZZZ,ZZZ,Z 26
うち消費税
Z9
以上、確かに納品致しました。
●●県△△市□□町4-21-22
株式会社 ◇◇◇◇◇◇◇◇
明細表
販売管理
販売管理
納品書出力
改ページ条件 あり
出力制御条件 あり
帳票名
帳票ID
出力様式 汎用紙
帳票作成方法
納品書
RZCD-01
用紙サイズ A4横
バッチ出力
モノクロレーザ
なし
本帳票は、出荷に伴う納品書を作成するものである。
本帳票は、出荷トランザクションに格納されたデータと出荷明細トランザクションに格納されたデータをもとに納品書を作成する。
本帳票は、出荷トランザクションに格納された出荷元コード、伝票番号をキーとして1つの納品書を作成する。
出荷される商品の明細データは出荷明細トランザクションに格納されており、必要なデータは発注番号をキーとして抽出する。
改ページ条件 発注番号が変わる毎に改ページを行う。
同一の発注番号で納品書に印字される出荷明細(納品明細)が20件を超える場合には、20件毎に改ページを行う。
同一の発注番号で改ページが発生する場合には伝票ヘッダ部、フッタ部の処理が異なるので注意のこと。
発注番号が変わる毎に合計行部の印字内容も変わるので注意のこと。
ヘッダ部
明細行部
(25行を超えた
ら改ページす
る)
伝票ヘッダ部
合計行部
(最終ペー
ジにのみ印
刷すること)
10px
帳票上で印字されるデータの出力位置、
大きさなどを示したもの
Copyright © 2010,2011 IPA, All Rights Reserved
ヘッダ部は改ページされる毎に作成する。
ページ番号
伝票番号が変わることに1にリセットする。改ページされたら1カウントアップする。
伝票内通しページ番号
同一の伝票番号における総ページ数を示す。
同一の伝票番号の明細行は20件毎に改ページされるので、
出荷明細トランザクションにある同一の伝票番号を持つ明細行数の和から総ページ数を算出する。
通番ページ番号 本帳票の通しページである。1から改ページ毎に1カウントアップする。
出力日、出力時刻印刷処理の行われたシステム時刻を設定する。この時刻は伝票番号毎にリセットする。
伝票ヘッダ部は改ページされる毎に作成する。
同一の伝票番号の納品書が複数枚にわたる場合には、2ページ目以降は売上区分、発注区分、支払い期限は印字しない。
出荷元情報
出荷元コード
出荷部門
納品先情報
伝票番号
お届け先コード
お届け先名
お届け先住所1
お届け先住所2
出荷トランザクションの部門コードを設定する。
部門コードをキーとして部門マスタを参照し、このコードに合致する表示用部門名を設定する。
出荷トランザクションに格納されている出荷Noを設定する。
出荷トランザクションに格納されている納品先コードを設定する。
出荷トランザクションに格納されている納品先名を設定する。
出荷トランザクションに格納されている納品先住所1を設定する。
出荷トランザクションに格納されている納品先住所2を設定する。
出力項目のデータ転記/編集、改ページ、
ヘッダ/フッタの編集要件を示したもの
Software Engineering Center 22
「機能要件の合意形成ガイド」合意形成とは
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 合意形成の進め方(合意成熟度と4つの作業)
(次工程へ)
合意成熟度のレベル
完成
一緒に
レビューする
もれ/矛盾を
チェックする
図表に書く
言い切る/聞き切る
充実
もれ/矛盾を
チェックする
一緒に
レビューする
図表に書く
言い切る/聞き切る
仕掛
合意形成を図るための作業
(要件定義から)
外部設計の工程
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 23
「機能要件の合意形成ガイド」合意形成成熟度と作業
 合意成熟度レベル

SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
定義は細かく書いてあるが、
読者はなんとなく
分かっていれば十分
合意形成の進度に応じた分類
 4つの作業

合意形成の為に行う作業の大まかな分類
レベル
合意成熟度
レベル
4つの作業
仕掛
充実
完成
各
レ
ベ
ル
の
ゴ
ー
ル
の
イ
メ
ー
ジ
もれ/矛盾をチェックする
作
業
の
種
類
図表に書く
一緒にレビューする
言い切る/聞き切る
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 24
「機能要件の合意形成ガイド」合意形成成熟度と作業
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 合意形成の進め方(合意成熟度のレベル)
レベル
仕掛
充実
完成
仕掛レベル
各
レ
ベ
ル
の
ゴ
ー
ル
の
イ
メ
ー
ジ
作
業
の
種
類
 発注者が「言い切っ
た」、開発者が「聞き
切った」と言えるレベ
ル
もれ/矛盾をチェックする
図表に書く
一緒にレビューする
 要件定義が完了して
いなければ、このレ
ベルで実施します。シ
ステム化の目的と範
囲が明確になってい
ます。
言い切る/聞き切る
概要編31ページ~33ページからの抜粋
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 25
「機能要件の合意形成ガイド」合意形成成熟度と作業
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 合意形成の進め方(合意成熟度のレベル)
レベル
仕掛
充実
完成
充実レベル
各
レ
ベ
ル
の
ゴ
ー
ル
の
イ
メ
ー
ジ
作
業
の
種
類
 言い切った/聞き
切った内容から「図
表に書いてレビュー」
を繰り返し、発注者と
開発者の合意内容が
充実していくレベル
もれ/矛盾をチェックする
図表に書く
一緒にレビューする
言い切る/聞き切る
概要編31ページ~36ページからの抜粋
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 26
「機能要件の合意形成ガイド」合意形成成熟度と作業
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 合意形成の進め方(合意成熟度のレベル)
レベル
仕掛
充実
完成
各
レ
ベ
ル
の
ゴ
ー
ル
の
イ
メ
ー
ジ
作
業
の
種
類
完成レベル
 合意内容が管理され、
発注者と開発者の双
方が「合意内容を確
認できた」と言えるレ
ベル
 外部設計工程の成果
物の最終承認直前ま
でのレベル
もれ/矛盾をチェックする
図表に書く
一緒にレビューする
言い切る/聞き切る
概要編31ページ~36ページからの抜粋
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 27
「機能要件の合意形成ガイド」合意形成成熟度と作業
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 合意形成の進め方(4つの作業)
レベル
仕掛
充実
各
レ
ベ
ル
の
ゴ
ー
ル
の
イ
メ
ー
ジ
完成
 要件定義の結果を伝えます。
• システム化の目的・範囲
• 運用時や保守拡張時の操
作や業務
言い切る/聞き切る
もれ/矛盾をチェックする
作
業
の
種
類
発注者は
図表に書く
一緒にレビューする
• 業務遂行において変えるこ
とのできない制約条件(業
務や組織構造、連携システ
ムなどにより生じる制約、
及び業務上の法令や規則
など)
正しく伝えるために、
発注者が言い切ること、開
発者が聞き切ることです。
概要編31ページ~41ページからの抜粋
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 28
「機能要件の合意形成ガイド」合意形成成熟度と作業
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 合意形成の進め方(4つの作業)
レベル
仕掛
充実
各
レ
ベ
ル
の
ゴ
ー
ル
の
イ
メ
ー
ジ
完成
開発者は
設計書の記述上の約
束事を共通ルールとし
て記述します。
発注者から聞き切った
情報を反映して書きま
す。
図表に書く
レビューで指摘された
欠陥を修正します。
もれ/矛盾をチェックする
作
業
の
種
類
一緒にレビューする
言い切る/聞き切る
概要編31ページ~41ページからの抜粋
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 29
「機能要件の合意形成ガイド」合意形成成熟度と作業
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 合意形成の進め方(4つの作業)
レベル
仕掛
充実
完成
各
レ
ベ
ル
の
ゴ
ー
ル
の
イ
メ
ー
ジ
共通ルール自体にも
れ/矛盾がないことを
チェックします。
もれ/矛盾をチェックする
作
業
の
種
類
開発者は
図表に書く
「工程成果物」が共通
ルールに沿っているこ
とをチェックします。
他の技術領域の「工
程成果物」を含め、整
合をチェックします。
一緒にレビューする
言い切る/聞き切る
概要編31ページ~41ページからの抜粋
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 30
「機能要件の合意形成ガイド」合意形成成熟度と作業
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 合意形成の進め方(4つの作業)
レベル
仕掛
充実
完成
各
レ
ベ
ル
の
ゴ
ー
ル
の
イ
メ
ー
ジ
発注者は開発者が想定
していない前提や運用が
ないかをレビューします。
一緒にレビューする
もれ/矛盾をチェックする
作
業
の
種
類
発注者の要件と開発者
の設計に齟齬がないこと
をレビューします。
図表に書く
システム化の目的と範囲
に照らし合わせて、「工程
成果物」が正しく書かれ
ていることをレビューしま
す。
言い切る/聞き切る
概要編31ページ~41ページからの抜粋
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 31
「機能要件の合意形成ガイド」合意形成成熟度と作業
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 合意形成の進め方(合意成熟度と4つの作業)再掲
(次工程へ)
合意成熟度のレベル
完成
一緒に
レビューする
もれ/矛盾を
チェックする
図表に書く
言い切る/聞き切る
充実
もれ/矛盾を
チェックする
一緒に
レビューする
図表に書く
言い切る/聞き切る
仕掛
合意形成を図るための作業
(要件定義から)
外部設計の工程
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 32
「機能要件の合意形成ガイド」目次構成

SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
若干差異はあるが、各技術領域編内部の構成はほぼ同じ
第1章
概要
編全体の概要
・前提条件、スコープ
・工程成果物の定義
第2章
合意形成に使う
主な図表の解説
各工程成果物の詳細説明(サンプル付き)
第3章
合意形成のコツ
コツの紹介
・「4つの作業」別に記述
・「発注者が事前に意識する」が含まれる
ものがある
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 33
「機能要件の合意形成ガイド」コツの読み方SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
コツの目的:
何を解決したいコツなのか
施策:目的達成のために、どうすれば
よいのかの概要
合意成熟度レベル:
どのタイミングで使えるか
工程成果物:
このコツに登場す
る工程成果物
具体例:
コツの具体例
メリット:
コツ適応による効果
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 34
「機能要件の合意形成ガイド」記述例
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 言い切る/聞き切るためのコツの例
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 35
「機能要件の合意形成ガイド」記述例
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 図表に書くためのコツの例
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 36
「機能要件の合意形成ガイド」記述例
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 もれ/矛盾をチェックするためコツの例
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 37
「機能要件の合意形成ガイド」記述例
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 一緒にレビューするためのコツの例
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 38
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
3.「機能要件の合意形成ガイド」の適用例
(開発者向け書き方/レビュー編)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 39
SEC
事例1:わかりにくい設計書
Software Engineering
for Mo・No・Zu・Ku・Ri
 事例:わかりにくい画面遷移ドキュメント
 ユーザの役割(一般ユーザ、サプライヤ、管理者)毎に、異なる遷移を表
現しようと、以下の様な遷移図を持っていくと、お客様に「意味がわから
ない」といわれた。
《開始点》
ログイン画面
遷移と分岐が
ゴチャゴチャし
てて分からん
…
[一般ユーザの場合]
トップページ
[サプライヤの場合]
[管理者の場合]
管理者トップページ
サプライヤトップページ
メニュー画面
発注者側
(お客様)
[一般ユーザの場合]
《終了点》
商品一覧画面(ユーザ)
[サプライヤの場合]
[管理者の場合]
《終了点》
商品一覧画面(管理者)
《終了点》
商品一覧画面(サプライヤ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 40
SEC
事例1:わかりにくい設計書
Software Engineering
for Mo・No・Zu・Ku・Ri
 何故、そのようなことになってしまったのか?
 ユーザ役割毎に画面遷移順序が異なるにも拘わらず、1つの画面遷移
ドキュメントに収めてしまったから。
一般ユーザの遷移
《開始点》
ログイン画面
[一般ユーザの場合]
トップページ
サプライヤの遷移
望ましい書き方は
ユーザ役割別に
画面遷移を作成す
る
[サプライヤの場合]
[管理者の場合]
管理者トップページ
商品一覧(ユーザ編)画面遷移
サプライヤトップページ
《開始点》
《開始点》
ログイ ン 画面(共通)
トップページ
管理者トップページ
サ プライ ヤ トップページ
[メニュー選択]
メニュー画面(共通)
[メニュー選択]
メニュー画面(共通)
[業務種類選択]
《終了点》
商品一覧画面(管理者)
《終了点》
商品一覧画面(サプライヤ)
メニュー画面(共通)
[業務種類選択]
[業務種類選択]
《終了点》
商品一覧画面(ユ ーザ )
商品一覧画面(ユーザ)
[ログイ ン ]
[サプライヤの場合]
[管理者の場合]
《終了点》
ログイ ン 画面(共通)
[ログイ ン ]
[メニュー選択]
[一般ユーザの場合]
《開始点》
ログイ ン 画面(共通)
[ログイ ン ]
メニュー画面
商品一覧(サプライヤ編)画面遷移
商品一覧(管理者編)画面遷移
《終了点》
商品一覧画面(管理者)
《終了点》
商品一覧画面(サ プライ ヤ )
画面遷移の例
管理者の遷移
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 41
事例1:わかりにくい設計書
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 適用できるコツ(書き方のコツ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 42
事例1:わかりにくい設計書
Copyright © 2010,2011 IPA, All Rights Reserved
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
Software Engineering Center 43
事例2:出来上がった画面遷移をレビューする SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 事例:出来上がった画面遷移の過不足についてレビューしたい
 出来上がった画面遷移が過不足なく記述されていることを確認したい。
どうすればいい?
単に追いかけるだけ
じゃ芸がないよな…
受付状況確認画面
ログイン画面
注文結果確認画面
[受付状況確認]
[注文]
[ログイン]
[注文入力]
[書籍検索]
メニュー画面
「OK」
「閉じる」
注文入力画面
開発者側
[書籍登録]
書籍検索画面
[確認]
「OK」
「閉じる」
書籍登録画面
書籍登録確認画面
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 44
事例2:出来上がった画面遷移をレビューする SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 適用できるコツ(レビューのコツ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 45
SEC
事例3:発注者と一緒にレビューする
Software Engineering
for Mo・No・Zu・Ku・Ri
 事例:出来上がったデータモデルについてレビューしたい
 データモデルのレビューが表面的になりがち
 お客様に、データ構造の意味(出来ること/出来ないこと など)をしっ
かり伝えるにはどうすればよい?
たぶん、良いん
じゃないかな...
大丈夫かな…
買取引
発注者側
(お客様)
対象ER図の例
取引ID
顧客
商談ID ( F K)
楽器番号 ( F K)
希望価格
取引ステータス
取引発生日
取引グループ
顧客ID
グループID
顧客名
連絡先
顧客ID ( F K)
発生日
終了日
商品
楽器番号
売取引
取引ID
ステータス
開発者側
商談ID ( F K)
取引ステータス
希望価格
楽器番号 ( F K)
取引発生日
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 46
事例3:発注者と一緒にレビューする
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 適用できるコツ(レビューのコツ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 47
事例のまとめ(適用する上での注意事項) SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 取り上げたものは、「お客様との齟齬を防止するノウハウ」
 ガイドにおいてはこのノウハウをコツと呼ぶ
 「機能要件の合意形成ガイド」はこのようなコツが満載
 コツについてケーススタディからわかること
 どの局面にも通用するわけではない
 コツの適用可能/不可能はプロジェクト(システム)の特性により異なる。
(例えば、CRUD図は顧客納品物/レビューの対象ではない。)
 唯一の解ではない
 たとえば、画面遷移の過不足をチェックする方法はこれだけではない
 コツは“森”ではなく“木”に近い
 大局的な作業プロセスや、成果物構成などを規定するものではなく、
特定の場面において役立つノウハウ(記述の仕方、振る舞い)。
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 48
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
3.「機能要件の合意形成ガイド」の適用例
(発注者への要求確認編)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 49
事例1:例外業務システム処理の設計漏れ SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 事例:会計システムの振込処理における誤振込時の組戻し処理の漏れ
 会計システムの振込処理において、誤振込が発生した場合、財務部が金融機
関に連絡をした上で、振込データの戻しとこれに伴う会計処理(組み戻し処
理)を行うことになっているが、会計システムでは組み戻し処理が設計され
ていなかった。
 本番直前の運用テストの段階で財務部からの指摘で組み戻し処理が抜けてい
る事が判明。急遽追加することになった。
当社の支払処理は銀行振込の
場合、・・・・・・・・・
という手順となります。
ここはシステム化の対象です。
ヒアリング時
経理部門担当者
レビュー時
システム化業務フ
ロー
販売部門
業務フロー
万一、振込口座が
誤っていて誤振込
になった場合には、
銀行に連絡すると
ともに組戻し処理
を行います。
財務部門担当者
なるほど、
そういう処理の
流れになるん
ですね?
経理部門担当者
出荷部門
(倉庫)
仕入先
<<システム支援>>
顧客の登録
システム化される
振込処理の流れ
は次のようになり
ます。
テナント
契約
販売部門
出荷部門
(倉庫)
<<システム支援>>
仕入先
物件仮押
<<人の作業>>
意思の確認
<<システム>>
顧客登録
<<システム>>
進捗登録
<<システム支援>>
顧客の登録
テナント
契約
<<システム支援>>
物件仮押
<<人の作業>>
意思の確認
<<システム>>
顧客登録
<<システム>>
進捗登録
ふむふむ。
振込結果
はどうわか
るの?
経理部門担当者
開発担当者
Copyright © 2010,2011 IPA, All Rights Reserved
開発担当者
Software Engineering Center 50
事例1:例外業務システム処理の設計漏れ SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 何故、そのようなことになってしまったのか?
 レビュー時に業務フローとシステム化業務フローを比較・検証しなかっ
たから。
システム化業務フローを見ていただけでは例外業務である組み戻し処理
が抜けていることに気付かなかった。
レビュー時
ヒアリング
時
経理部門担当者
業務フロー
販売部門
出荷部門
(倉庫)
システム化業務フ
ロー
販売部門
経理部門担当者
出荷部門
(倉庫)
仕入先
<<システム支援>>
顧客の登録
仕入先
テナント
契約
<<システム支援>>
物件仮押
<<システム>>
顧客登録
<<システム支援>>
顧客の登録
テナント
契約
<<人の作業>>
意思の確認
<<システム支援>>
物件仮押
<<人の作業>>
意思の確認
<<システム>>
進捗登録
<<システム>>
顧客登録
<<システム>>
進捗登録
財務部門担当者
ヒアリングでは、業務フローを使って、
業務の流れとその中からシステム化
対象の業務を確認していた。
開発担当者
業務フローと
システム化業務フロー
の
比較・検証を行い、
システム化対象業務の
漏れがないかを確認し
ていなかった
Copyright © 2010,2011 IPA, All Rights Reserved
経理部門担当者
開発担当者
レビューでは、システム化業務フロー
を使って、システム化対象の業務の
流れとシステムとのやりとりに齟齬が
ないかを中心に確認していたため、
対象業務に漏れがないかの確認がで
きていなかった。
Software Engineering Center 51
事例1:例外業務システム処理の設計漏れ SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 適用できるコツ(言い切る/聞き切るコツ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 52
事例2:業務運用パターンの確認漏れ
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 事例:売上伝票入力の承認のやり方が不十分と開発途中で発覚
 発注者は開発者にシステム化対象業務の説明する際に、開発者に業務の流れを理
解してもらおうと思い、最もシンプルなフローで「営業部で手続き」等の曖昧な
表現で流れを説明した。その際、伝票入力者と承認者等の役割(ロール)の違い
は後で確認されると思い、説明しなかった。
 開発者は説明されたとおりに、入力処理と承認処理を同一画面で行うよう設計し
た。またワークフローもシンプルな構成のものを想定した。
 権限階層やワークフローの実態が明確になるにつれ、当初開発者が想定していた
規模よりも大きな規模の開発である事がわかり、予算の追加と工期の延長が必要
となってしまった。
システム化される発注処理は各部署
でデータ入力して、承認するという流
れとなっています。
ヒアリング
時
システム化業務フ
ロー
販売部門
伝票承認者
承認代行者
出荷部門
(倉庫)
仕入先
なるほどそうですか。
<<システム支援>>
顧客の登録
テナント
契約
<<システム支援>>
内部統制上、伝票入力者と
伝票承認者は別々にし、承認 営業部門担当者
者も代行をおけるようになって
いるが、その辺は販売担当の
伝票入力者 SEなら常識でわかってくれる
よね?
物件仮押
<<人の作業>>
意思の確認
Copyright © 2010,2011 IPA, All Rights Reserved
<<システム>>
顧客登録
<<システム>>
進捗登録
開発担当者
Software Engineering Center 53
事例2:業務運用パターンの確認漏れ
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 何故、そのようなことが起こってしまったのか?
 発注者が、各部署には入力権限、承認権限、代理承認権限のユーザーがい
るにも拘らず、役割(ロール)を正確に伝えなかった、また実際のワーク
フローもデータの内容により複雑な分岐となることを説明しなかったため
。
 開発者は入力処理と承認処理が分かれていることを確認しているにも拘わ
らず、入力処理と承認処理の利用者の相違、入力処理、承認処理それぞれ
の流れについて確認を怠っていたため。
ヒアリング/レビュー時
また入力処理から承認処理までの一
連の処理の流れを確認させていただ
けませんか?
システム化業務フ
ロー
販売部門
出荷部門
(倉庫)
仕入先
<<システム支援>>
顧客の登録
テナント
契約
<<システム支援>>
物件仮押
<<人の作業>>
営業部門担当者
意思の確認
入力処理と承認処理に分かれていま
すが、それぞれの処理を担当する役
割は異なるのでしょうか?
<<システム>>
顧客登録
承認処理はどういう場合でも同一で
すか?弊社の場合、受注金額で
承認できる職位が異なるんですが?
<<システム>>
進捗登録
開発担当者
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 54
事例2:業務運用パターンの確認漏れ
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 適用できるコツ(レビューのコツ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 55
事例3:要求した画面イメージと異なる
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 事例:発注者からの注文入力画面に関する不十分な要求
 注文入力画面は、同一画面上段に入力欄、下段に注文履歴欄を設け、注文
履歴を確認しながら注文入力を行うという要件であるが、発注者は開発者
に単に「注文履歴を確認しながら注文入力が行えるよう」という曖昧な要
件を伝えたのみで画面レイアウトの提示をしなかった。
 開発者は要件に沿うよう注文入力画面と注文履歴画面を分けて設計した。
 発注者はレビューの段階で注文入力画面がイメージと異なる事に気付き、
急遽仕様変更することになった。
1つの画面
で 発注者:
注文入力画面
発注者:
商品名:
注文番号:
注文
数:
合計
注文
注文番
号
商品名:
わかりました
注文番号:
注文
数:
注文入力画面
2つの画面で
本日の受注一覧:
商品名
発注
者
メニュー
キャンセル
注文数
営業部門担当者
開発担当者
注文入
力
注文履
歴
注文番
号
合計
注文
本日の受注一覧:
商品名
発注
者
キャンセル
注文数
注文入力画面と注文履歴画面
があり、注文履歴を見ながら注
文入力できるようにしてほしい
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 56
SEC
事例3:要求した画面イメージと異なる
Software Engineering
for Mo・No・Zu・Ku・Ri
 何故、そのようなことが起こってしまったのか?
 発注者が具体的な画面レイアウトの提示をしなかった、また開発者が発
注者に確認しなかったから。
 開発者と発注者の間で業務の流れに沿った注文入力画面と注文履歴画面
の流れ、利用シーンを確認しなかったから。
????
注文入力画面
注文入力終了
発注者:
商品名:
複数件数ある場合
注文番号:
ログイン画面
注文入力画
面
営業部門担当
者
開発担当者
こんな画面の遷移と
画面のイメージで
よかったでしょうか?
注文
数:
合計
注文
キャンセル
確認終了
メニュー画面
注文検索画
面
注文一覧画
面
注文番
号
本日の受注一覧:
商品名
発注
者
注文数
更新終了
注文更新画
面
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 57
事例3:要求した画面イメージと異なる
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 適用できるコツ(言い切る/聞き切るコツ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 58
SEC
事例4:意図しない画面遷移
Software Engineering
for Mo・No・Zu・Ku・Ri
 事例:一括注文取消処理の画面遷移がおかしい
 注文一括取消処理は「発注履歴画面にて取消対象を複数選択後、注文取消画面に
遷移し、選択した個々の注文内容を確認しながら取消処理を選択数分連続して行
う」という要件を開発者に提示した。
 出来上がったシステムを確認したところ、
「発注履歴画面(2件選択)→注文取消画面(1件目)→注文取消画面(2件目)
→発注履歴画面」と遷移して欲しいところが、
「発注履歴画面(2件選択)→注文取消画面(1件目)
→発注履歴画面→注文取消画面(2件目)→発注履歴画面」というように
都度発注履歴画面に戻るようになっていた。
注文取消画面
(取消注文1)
注文履歴画面
注文取消画面
(取消注文1)
実行
注文履歴画面
取消の適否確認
削除したい注文
を選択(複数)
実行
発注者
実行
取消注文1に対する注文取消処理およ
び
注文取消画面(取消注文2)の表示
削除したい注文
を選択(複数)
取消注文1に対す
る
注文取消処理
注文取消画面
(取消注文2)
実行
開発者
Copyright © 2010,2011 IPA, All Rights Reserved
取消注文2に対す
る
注文取消処理
Software Engineering Center 59
SEC
事例4:意図しない画面遷移
Software Engineering
for Mo・No・Zu・Ku・Ri
 何故、そのようなことが起こってしまったのか?
 レビューでは発注履歴画面と注文取消画面の確認はしたが、画面遷移の
確認を怠ってしまったから。
レビュー時
ふむふむ。
その操作手順でOKです。
発注者
この画面の表示項目は・・・・・・で、操作手
順は・・・・・・・・・・・と
なります。これでOKですか?
注文履歴画面
画面レイアウト
注文取消画面
画面レイアウト
開発者
レビュー
対象外
注文取消画面
注文履歴画
面
注文取消画面
注文取消画面
画面遷移
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 60
事例4:意図しない画面遷移
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 適用できるコツ(レビューのコツ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 61
SEC
事例5:無駄な類似した帳票の開発
Software Engineering
for Mo・No・Zu・Ku・Ri
 事例:異なる現場部門から類似した内容の帳票開発要求
 大規模システム開発のため、発注者側は設計担当者を業務領域毎に分け、個々に帳
票レイアウト定義を実施。担当者毎に完成時期が異なり、工期も厳しかったため、
発注者側は帳票類の整理と合理化の手間を省き、帳票レイアウト完成の都度五月雨
式に開発者に提示。
 出来上がった帳票を俯瞰すると同じような帳票を幾つも作成してしまい、その無駄
を開発担当者から指摘された。
この帳票は
このレイアウト
でないと
使えません。
開発依頼
部門A担当者
このレイアウト
で何年も業務を
してきたので今
更変更できませ
ん。
部門B担当者
この帳票は
うちの部門の
ノウハウの塊
です。変更は
無理です。
整
理
・
統
合
調
整
で
き
ず
出力項目もレイアウト
もかなり類似している
のに、それぞれ作る
必要があるのかな?
確認してみよう。
開発依頼
開発者
発注者調整
役
開発依頼
部門C担当者
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 62
SEC
事例5:無駄な類似した帳票の開発
Software Engineering
for Mo・No・Zu・Ku・Ri
 何故、そのようなことが起こってしまったのか?
 業務担当毎に設計した帳票類を一旦発注者側内部で整理、合理化した上で開
発者に開発すべき帳票を提示すべきだったが、厳しい工期で各業務担当部門
との調整をつけられず、
業務担当毎に必要な帳票の開発依頼をかけたため。
 帳票の利用目的、必要な理由の確認が不十分なまま開発依頼を行ったため。
この帳票は
うちの部門の
ノウハウの塊
です。変更は
無理です。
このレイアウトで何
年も業務をしてきた
ので今更変更できま
せん。
この帳票は
このレイアウト
でないと
使えません。
この帳票は半年に1回
だけ利用します。
部門A担当者
この帳票の利用目的は
××なので、代替策があ
るなら考えます。
部門B担当者
部門C担当者
こうした調整を図り、帳票を最低限必要なものに絞りたかっ
た
A部門の帳票1とB部門の帳
票2とC部門の帳票3はほとん
ど同じ内容ですが、どのような
使われ方をしていますか?
発注者調整役
3帳票で異なるのは
この部分だけで、
使われ方も3部門とも
同じようなのですが、
統一すると問題になるのは
どんなことですか?
Copyright © 2010,2011 IPA, All Rights Reserved
この項目と
この項目を演算
した結果あればよく、
多少の変更はでき
るかも。
Software Engineering Center 63
事例5:無駄な類似した帳票の開発
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 適用できるコツ(言い切る/聞き切るコツ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 64
事例6:現場業務に精通しない担当者からの帳票要求 SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 事例:現場業務に精通していない業務設計担当者からの帳票開発要求
 発注者側の業務設計担当者は現場の業務にあまり精通していなかったが、
開発者は業務設計担当者の提示する要件に基づいて帳票設計を実施した。
 展開時のユーザー向け説明会で、現場の利用者から帳票に承認印欄が不足
しているとの不備を指摘され、急遽設計変更を行うことになった。
折角作っていただいた
のに、この帳票には
承認印欄がないので、
業務では使えません。
現場担当者に
は未確認
この帳票の仕様は、・・・・・のよ
うになっています。
現場業務に
詳しくない
現場業務担当者
発注者側
業務設計担当者
はいわかりました。
そのように開発します。
開発者
開発
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 65
事例6:現場業務に精通しない発注者の帳票要求
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 何故、そのようなことが起こってしまったのか?
 現場の業務担当者に開発する帳票の仕様に関して意見を聴いていなかった
から。
帳票レビュー迄に現場の担当者の意見も聞いておけばこのような事態にな
らなかった。
この帳票のままでは
承認印欄がないので、
業務では使えません。
追加するようにお願いし
ます。
現場業務担当者
このような帳票の仕様で現場業務で
適用していただけますか?
何か問題はありませんか?
発注者側
業務設計担当者
開発者
帳票レビュー前に内部で確認しておくべきこと
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 66
事例6:現場業務に精通しない発注者の帳票要求
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
 適用できるコツ(レビューのコツ)
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 67
SEC
適用事例のまとめ(1/3)
Software Engineering
for Mo・No・Zu・Ku・Ri
 発注者が開発者に曖昧な要件を提示すると、出来上がるシ
ステムは発注者が意図するものと異なるものとなる可能性
が高くなる。
 出来るだけ要件の曖昧さを排除し、開発者に正確に伝える事が肝
要
 言い切るコツの活用(特にコツID02T001)
発注者はシステムに求めるイメージ、業務上のルール、仕事のや
り方などを文書にとりまとめ、具体的に開発者に伝える。
 発注者は開発者に要件を正確に伝えた心算でいても、正確
に伝わっているとは限らない。
 要件が正しく伝わっている事を確認する事が肝要
 レビューのコツの活用
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 68
適用事例のまとめ(2/3)
Copyright © 2010,2011 IPA, All Rights Reserved
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
Software Engineering Center 69
適用事例のまとめ(3/3)
Copyright © 2010,2011 IPA, All Rights Reserved
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
Software Engineering Center 70
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
4.まとめ
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 71
SEC
どのように使ったらよいか?
Software Engineering
for Mo・No・Zu・Ku・Ri
 どのような場面で使うことを想定して作ったか?
・・・活用のヒントとして
1. 開発標準に沿った設計業務を補足するコツ集として

設計に関するドキュメントを介して、SIベンダの開発担当者間、
あるいは開発担当者とユーザ企業情報システム部門・ユーザとの間の
スムーズな意思疎通をはかるために利用する。
2. 教育コンテンツの素材集として

SIベンダやユーザ企業の情報システム部門を中心に、
各社の教育コンテンツの素材集として利用する。
3. レビューに臨む際の心得として

情報システム開発のステークホルダ間のコミュニケーションを
円滑にするために、レビューのコツを利用する。
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 72
SEC
どのように使ったらよいか?
Software Engineering
for Mo・No・Zu・Ku・Ri
 活用事例活用のヒントとして(旧発注者ビューガイドライン時の適用事例)
#
企業(順不同)
状況
1
㈱NTTデータ
開発手順に適用。具体的には、発注者ビューガイドラインをベースに成果物の記述項目と図の凡例を見直し。また、”コツ”
については社内の既存のチェックリストと統合。
2
富士通㈱
標準開発プロセスの設計書の記述要項、記述例、ワークシートの改善を実施済み。
3
日本電気㈱
社内向けの設計ガイドとして、開発プロセスに合わせてどの作業、どの設計ドキュメントで適用するかを他の設計ガイドと連
携させ独自にガイドとして再編集して利用。
4
㈱日立製作所
標準開発プロセスの設計書の記述要項、記述例、ワークシートの改善を実施済み。
5
㈱構造計画研究所
社内規定「機能設計書記述要領」の1つとして組み入れ、公開。
6
東芝ソリューション㈱
情報システム開発標準群の1つとして組み入れ、社内公開。また、コツの使用について優先度表を作成し、併せて公開。
7
日本ユニシス㈱
社内の(開発関連)知財として管理し展開(公開)するとともに、SE向け説明会等での(書籍も含めた知識の)活用、説明会
の実施など。)
8
TIS㈱
社内向け設計ガイドに発注者ビューガイドラインの記述要素を取り込み。発注者ビューガイドライン自体も参考文書として社
内公開。
9
沖電気工業㈱
2008年度より、開発標準に適用。具体的には、発注者ビューガイドラインをそのまま採用せずに、システム設計書作成規定
の「参考資料」として組み入れております。
10
㈱インテック
ガイドラインと社内設計標準の関連付けを実施。
その対比表を基に適切な局面でガイドの該当箇所を参照し、活用するように社内に案内。
11
㈱東京証券取引所
社内の参考情報とするとともに、社内システム開発プロセスへの組込みを検討中。
12
清水建設㈱
2008年上期に特定アプリケーションの開発案件において、「画面編」を適用し、評価を実施。
「発注者ビューガイドラインの活用と拡張~機能要件の合意形成を目指して~」( 2009年3月31日)からの抜粋・要約
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 73
SEC
どのように使ったらよいか?
Software Engineering
for Mo・No・Zu・Ku・Ri
 悩み・気づき・ヒント
‼ 設計書レビュー時に、
基本的なことの指摘
が多くありませんか?
‼ テスト結果の確認や
検収時に、手直し要
望が多くありません
か?
‼ カットオーバ後に、
すぐ手直しということが
多くありませんか?
そんな時には「機能要件の合意形成ガイド」を一度見てみよう。
⇒そこには発注者と開発者間の合意をより良くするためのヒントがあります。
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 74
SEC
おわりに
Software Engineering
for Mo・No・Zu・Ku・Ri
ダウンロードはこちらから・・・
http://sec.ipa.go.jp/reports/20100331.html
î•ñ

ˆ—
„

i ‹@
\
Fƒ\ƒtƒgƒEƒFƒAƒGƒ“ƒWƒjƒAƒŠƒ“ƒOhp.mht
7冊構成
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 75
SEC
Software Engineering
for Mo・No・Zu・Ku・Ri
以上です。
ご清聴ありがとうございました。
Copyright © 2010,2011 IPA, All Rights Reserved
Software Engineering Center 76