software engineering center - ipaシステム振舞い編外部インタフェース編イン...

1Software Engineering Center

Information-technology Promotion Agency, Japan

SoftwareEngineeringCenter

Copyright © 2010 IPA, All Rights Reserved

「機能要件の合意形成ガイド」の活用

２０１０年５月

独立行政法人情報処理推進機構(IPA)ソフトウェア・エンジニアリング・センター(SEC)

研究員小林健児

ＳＯＤＥＣ IPAブースセミナー 2010/05/12～14

2Software Engineering CenterＳＯＤＥＣ IPAブースセミナー 2010/05/12～14 Copyright © 2010 IPA, All Rights Reserved

本日のメニュー

1. ガイドを作った背景

2. 機能要件の合意形成ガイドって何？

3. どのように使ったらよいか？

3Software Engineering CenterＳＯＤＥＣ IPAブースセミナー 2010/05/12～14

発見工程別相対修正コスト

ソフトウェテスト

システテスト

運用テスト

システム仕様

プログラミング

要件定義

システムテスト

運用テスト

ソフトウェア

仕様

ソフトウェア

テスト

5

10～100

修

正

コ

ス

ト

右の出展：B.W.Boehm “Soft. Eng.” IEEE Trans. com (Nov ‘76)

ガイドを作った背景

SEC-BOOKS『経営者が参画する要求品質の確保』（P26)より


システム開発における手戻りとコストの関係


ガイドを作った背景システム開発において起こりうるギャップの例

発注者と開発者の認識の齟齬により要求と実現されるソフトとの間にギャップが生じる

システム化計画

業務部門の要求内容

要件定義内容

①要件定義すべき内容が抜けており、開発者に説明していない

②発注者が開発者に説明したが、何らかの理由で漏れた

参考文献：IPA／ＳＥＣ発注者ビューガイドラインの活用と拡張(p.4)

外部設計内容

実現される

ソフトウェア

④開発者が何らかの理由により誤認・拡大解釈し、実現範囲に取り込んでしまった

③発注者が開発者に説明し、共通理解が得られた。

この絵は、発注者が要件定義までを行い、それ以降の工程を開発者が行う場合の例

発注者開発者

A B C

バグや障害

バグや障害

バグや障害



機能要件の合意形成ガイドって何？

これまでのあゆみ

1. 「発注者ビュー検討会」(2006/4～2008/3)実践的アプローチに基づく要求仕様の発注者ビュー検討会（略称発注者ビュー検討会）は、情報システムにおける「仕様」について、お客様にわかりやすい記述方法および合意方法を共同検討することを目的に国内主要SI事業者が結集した検討会。 Output:「発注者ビューガイドライン」のWeb公開

（IPAでの公開は2008/7）

2. 「発注者ビューガイドライン」のブラッシュアップ(IPA/SEC 2008年度)

発注者ビュー検討会から譲渡されたガイドラインの内容充実等の方向性を検討。 Output:「発注者ビューガイドラインの活用と拡張」のWeb公開

（2009/4）

3. 「機能要件の合意形成ガイド」の作成(IPA/SEC 2009年度) Output：「機能要件の合意形成ガイド」のWeb公開（2010/3）



Web公開文書の利用実績

「発注者ビューガイドライン」2008/7～2010/4末のダウンロード単純合計：約178,000件（8,000件/月）

「機能要件の合意形成ガイド」2010/4のダウンロード単純合計：約16,000件



【対象とする工程】

システム化の方向性

システム設計

システム化計画

要件定義

システム開発

テスト

【技術領域】

外部設計

内部設計

対象とする工程

発注者ビューガイドラインで対象とした領域

「画面編」

データベース

「データモデル編」

Webベースを中心としたサーバアプリケーション

「システム振舞い編」

改訂版で追加した領域

「バッチ編」

「帳票編」「外部インタフェース編」



ガイドの構成概要編には、「合意形成の進め方」の考え方を掲載。その他の編には技術領域固有の進め方・設計書の要素・「コツ」などを掲載しています。



画面編データモデル編

バッチ編帳票編

システム振舞い編

外部インタフェース編

インターネット

【インターネット端末】

受注管理システム

７８００００７

信用照会問合せ情報

７８００００８

信用照会結果情報

クレジット信用照会

システム

販売管理システム７８００００１

受注情報

７８００００３

商品情報

７８００００６

受注処理ログ情報

処理証跡管理システム

６８００００９

販売管理処理ログ情報

【社内システム端末】

集配信システム

６８００００１

出荷指示情報

６８００００２

配送結果情報

【監視端末】

７８００００２

商品出荷状況情報

顧客管理システム

７８００００４

新規顧客情報

７８００００５

顧客更新情報

ZZ9／ZZ9 (ZZ9)

YYYY/MM/DD 23:59

出荷元コード XXXXXXXXXX出荷部門 NNNNNNNNNNNNNN

伝票番号 XXXXXXXXXX お届け先コード XXXXXXXXXXお届け先名 NNNNNNNNNNNNNN 御中売上区分 Xお届け先住所 NNNNNNNNNNNNNNNNNNNNN 発注区分 X

NNNNNNNNNNNNNNNNNNNNN 支払期限 YYYY年MM月DD日

No123456789

1011121314151617181920

ZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮ



ZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮ


ZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮ

ZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,ZZ \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮ





納品書

納品明細単　価数量商品名品　番合　価消費税備　考

概要編


外部設計の工程

合意形成の進め方(合意成熟度と4つの作業)

合意形成を図るための作業

言い切る／聞き切る図表に書く

もれ／矛盾をチェックする

一緒に

レビューする

図表に書く


一緒に

レビューする

言い切る／聞き切る



（要件定義から）

（次工程へ）合意成熟度のレベル

仕掛

完成

充実



合意形成の進め方（合意成熟度のレベル）レベル仕掛充実完成

各レベルのゴールのイメージ

作業の種類


一緒にレビューする図表に書く


仕掛レベル発注者が「言い切っ

た」、開発者が「聞き切った」と言えるレベル

要件定義が完了していなければ、このレベルで実施します。システム化の目的と範囲が明確になっています。

概要編３１ページ～３３ページからの抜粋





作業の種類




充実レベル言い切った／聞き切っ

た内容から「図表に書いてレビュー」を繰り返し、発注者と開発者の合意内容が充実していくレベル

概要編３１ページ～３６ページからの抜粋





作業の種類




完成レベル合意内容が管理され、

発注者と開発者の双方が「合意内容を確認できた」と言えるレベル

外部設計工程の成果物の最終承認直前までのレベル

概要編３１ページ～３６ページからの抜粋



合意形成の進め方（４つの作業）レベル仕掛充実完成


作業の種類



発注者は要件定義の結果を伝えます。

• システム化の目的・範囲

• 運用時や保守拡張時の操作や業務

• 業務遂行において変えることのできない制約条件（業務や組織構造、連携システムなどにより生じる制約、及び業務上の法令や規則など）

正しく伝えるために、発注者が言い切ること、開発者が聞き切ることです。

概要編３１ページ～４１ページからの抜粋






作業の種類

一緒にレビューする


開発者は

設計書の記述上の約束事を共通ルールとして記述します。

発注者から聞き切った情報を反映して書きます。

レビューで指摘された欠陥を修正します。



図表に書く





作業の種類


開発者は

共通ルール自体にもれ／矛盾がないことをチェックします。

「工程成果物」が共通ルールに沿っていることをチェックします。

他の技術領域の「工程成果物」を含め、整合をチェックします。




図表に書く





作業の種類

発注者の要件と開発者の設計に齟齬がないことをレビューします。

発注者は開発者が想定していない前提や運用がないかをレビューします。

システム化の目的と範囲に照らし合わせて、「工程成果物」が正しく書かれていることをレビューします。




図表に書く



外部設計の工程

合意形成の進め方(合意成熟度と4つの作業)再掲

合意形成を図るための作業

言い切る／聞き切る図表に書く


一緒に

レビューする

図表に書く


一緒に

レビューする




（要件定義から）

（次工程へ）合意成熟度のレベル

仕掛

完成

充実



システム振舞い編の紹介要件定義プロセスで作成される業務フローや業務処理定義書を元に、

システム化する範囲を識別し、その範囲の設計を発注者と開発者が合意するためのコツを、４つの「工程成果物」を中心に解説。

サーバアプリケーション

システム振舞い

＋

システム利用作業または機能の一覧

他の「工程成果物」に共通に適用される図表の記述に関するルール、および「工程成果物」の構成要素の整理分類に関するルール

No. 業務中機能小機能1 発注書作成・・・2 発注書再利用・・・3 入力支援・・・4 発注書申請・・・5 承認者自動設・・・6 代理承認者設・・・

発注書作成

発注書申請

システム化業務一覧業務全体を俯瞰する流れ図

（業務フロー）において、システム化する部分を識別したもの

販売部門出荷部門（倉庫）

仕入先

進捗登録

顧客登録物件仮押

顧客の登録

意思の確認

テナント契約

システム化業務フロー

システム利用作業と機能の内容

システム化業務説明概要

事前条件

管理者権限を持ったユーザでログインしていること。

事後条件

入力データユーザ情報(画面) 出力データ

備考なし

5:ユーザ情報の変更を要求す

■利用者のアクション

1:ユーザ情報の一覧を要求す

3:変更するユーザを選択し、4:データベースからユーザの詳細情報を取得し、利用者へ返す。

6:データベースの該当するユーザ情報を変更する。

ユーザを情報を変更する。データベースのユーザ情報が変更されること。

ユーザ情報(テーブル)基本シナリオ

■システムのアクション

2:データベースからユーザ情報の一覧を取得し、利用者へ返す。

並行分岐

／同期合流

システム対象外の

帳票

条件分岐

／合流

システムによる

帳票

データの流れ作業

制御の流れシステムによる

バッチ処理

業務データシステム化業務

(システム利用作業)

記号記号の意味記号記号の意味

並行分岐

／同期合流

システム対象外の

帳票

条件分岐

／合流

システムによる

帳票

データの流れ作業

制御の流れシステムによる

バッチ処理

業務データシステム化業務

(システム利用作業)

記号記号の意味記号記号の意味

システム振舞い共通ルール



画面編の紹介要件定義、外部設計工程で作成される業務フローやシステム化業務

フローを元に、導き出されるユーザインターフェースの１つである「画面」を設計するためのコツを、6つの「工程成果物」を中心に解説。

画面遷移・レイアウト共通ルール

画面一覧画面間の遷移関係を示した図。画面から画面への遷移と画面遷移を起こすキッカケとなるイベント。

条件分岐がある場合は、その条件と対応する分岐遷移

画面レイアウトと画面遷移に関する共通ルールおよび諸々の画面（群）が準じる典型的なレイアウトや遷移のポリシ

システムで使用する画面の一覧

項目・イベント発生オブジェクト名、それらに対応する画面部品（ボタン、入力出力項目など）およびその配置

No 分類画面名画面ID

…

1 入力フォーム

ペット登録画面 S-01 …


販売者登録画面

S-02 …


ログイン画面 S-05 …

… … … … …

余白

ユーティリティエリコンテンツエリア

フッターエリア

20% 60% 20%

ヘッダーエリアコンテンツエリア

（main）コンテンツエリア

（sub2）

80ﾋﾟｸ

80ﾋﾟｸ

60ﾋﾟｸ

画面遷移

画面レイアウト

画面アクション明細画面遷移に伴って起動させる動作

アクションの処理概要

アクションの処理詳細

①顧客情報の入力チェック②検索処理入力された情報をもとに顧客情報テーブルを検索する③-1 合致するデータが存在しない場合顧客情報を登録し、顧客登録画面を初期表示する③-2 合致するデータが存在した場合エラーメッセージを表示する

入力された情報をもとに顧客情報を登録する

画面入出力項目一覧

画面を介して入出力する項目の外部仕様

識別ID

表示用のラベル部品の種類入力

表示桁数

入力桁数

データ型入力制約

1 ユーザ名ラベル × 18 - 文字列 - ○ ユーザ名値2 新しいパスワーテキストボック △ 18 10 文字列パスワード入力パターン × -3 再入力パスワーテキストボック △ 18 10 文字列パスワード入力パターン × -4 名前（姓）テキストボック △ 19 18 文字列 × -5 名前（名）テキストボック △ 19 18 文字列 - × -6 Ｅメールアドレステキストボック ○ 39 38 文字列 Eメール入力パターン × -7 電話テキストボック ○ 19 18 文字列電話番号入力パターン × -8 住所１テキストボック ○ 39 38 文字列 - × -9 住所２テキストボック ○ 39 38 文字列 - × -

初期表示



データモデル編の紹介開発対象システムのデータモデルを設計するためのコツを、４つの

「工程成果物」を中心に解説。

データモデルデータ辞書

ユーザ企業内で利用するデータをモデル化して表現したもの

エンティティとリレーションを表現するシンボルを用いて作図する。

ユーザ企業内で利用するデータに関する規則集

ER図

データの最小単位であるデータ項目を定義

ドメイン一覧／定義

データ項目定義

コード一覧／定義

データ項目をカテゴリ分けするための基準

データの内部構造や値が決まっているデータ項目の仕様を定義

その他資料

エンティティ一覧エンティティの一覧

項番エンティティ名説明1 顧客・・・2 商品・・・3 受注・・・

項番エンティティ名説明1 顧客・・・2 商品・・・3 受注・・・

エンティティ名およびエンティティごとの属性の一覧

エンティティ定義エンティティ名商品

項番属性名型桁 PK 説明1 商品番号 X 10 P ・・・2 商品名 X 100 ・・・3 商品区分コードX 3 ・・・

・・・

エンティティ名商品

項番属性名型桁 PK 説明1 商品番号 X 10 P ・・・2 商品名 X 100 ・・・3 商品区分コードX 3 ・・・

・・・

業務とエンティティの関係を表現したもの

CRUD図エンティティ

顧客

受注

受注明細

機能

顧客登録

受注登録

受注明細登録

顧客検索

C

R

R

R

C

R C

製品

R

エンティティ顧客

受注

受注明細

機能

顧客登録

受注登録

受注明細登録

顧客検索

C

R

R

R

C

R C

製品

R

ファイル一覧／定義システム間でやりとりされるデータファイルの一覧／詳細



外部インタフェース編の紹介外部インタフェースについての「コツ」を、４つの「工程成果物」を中

心に解説。

開発対象業務システム

相手先業務システム

やりとりされるデータ

（名称、内容）

外部インタフェースの対象領域

データのやりとりの特性データのやりとりの方向、手段／方法データのやりとりのタイミング

システムＡ

システムＢ

システムＣ

システムＣ

エスケープの規定

外部インタフェース処理説明

・レコード間では次の規則に従っていること。①レコードヘッダレコードの送信件数、レコードフッタレコードの送信件数、ならびにディテールヘッダレコードの数は一致していること。②ディテールヘッダレコードの受注明細件数、ディテールフッタレコードの受注明細件数、ならびに後続するディテールボディレコードの件数③ディテールヘッダレコードの受注金額合計と後続するディテールボディレコードの販売単価×購入数量の合計は一致していること。④レコードヘッダレコードの送信時刻とレコードフッタレコードの送信時刻は一致していること。

・受信側で上記の規則に従っていないデータを受信した場合には、途中でデータが欠落したものとみなし、送信エラー扱いとすること。

・受信側は外部インタフェースレコードを受信したら、受信したレコードが上記に示す規則に従っているかを確認する。規則に従った外部インタフェースレコードであった場合には、送信元に対して「受信成功」のメッセージを送信する。規則に従っていない場合には「送信エラー」のメッセージを送信する。

・送信対象の受注情報がない場合は、レコードヘッダレコードとレコードフッタレコードだけを送信し、その際の送信件数は０とする。

データ量メッセージ長

受注管理システム UNIX(HP-UX11i) 送信可変５００Byte(max)

通信先通信先プラットフォーム送信/受信

エラー時の対応

エラー時のファイルを破棄し、ファイルを再生成後にリトライする。

外部インタフェース処理説明

外部システムとのデータのやりとりの方式について、概要を記述したもの

外部システム関連図

システム間のデータの送受信関係を図示したもの

外部インタフェース一覧出力入力相手先システム情報(To) (From) 自システム名システム名既／新

1 7800001 受注情報 ○ 受注管理システム販売管理システム既存

2 7800002 商品出荷状況情報 ○ 受注管理システム販売管理システム既存

3 7800003 商品情報 ○ 受注管理システム販売管理システム既存

4 7800004 新規顧客情報 ○ 受注管理システム顧客管理システム既存

5 7800005 顧客更新情報 ○ 受注管理システム顧客管理システム既存

6 7800006 受注処理ログ情報 ○ 受注管理システム処理証跡管理システム

既存

7 7800007 信用照会問合せ情報 ○ 受注管理システムクレジット信用照会システム(外部）

既存

8 7800008 信用照会結果情報 ○ 受注管理システムクレジット信用照会システム(外部）

既存

9 6800001 出荷指示情報 ○ 販売管理システム集配信システム既存10 6800002 配送結果情報 ○ 販売管理システム集配信システム既存11 6800009 販売管理処理ログ情

報○ 販売管理システム処理証跡管理シス

テム既存

No 外部インタフェースID 外部データ名

外部インタフェースを一覧化したもの

No PKEY 項目名属性桁数必須説明1 1 送信時刻 VARCHAR2 12 ○ 送信処理を開始した時刻

（yyyymmdd/hhmmssの形式）2 送信件数 NUMBER 2 ○ 送信する受注件数（＝ディテールヘッダレコード数）

No PKEY 項目名属性桁数必須説明1 1 受注番号 VARCHAR2 12 ○ 受注（あるいは取消）処理時に採番した番号2 2 受注区分 VARCHAR2 1 ○ 受注あるいは取消の区分、１：受注、０：取消3 顧客コード VARCHAR2 12 ○ 受注を受けた顧客の顧客コード4 受注金額合計 NUMBER 12 ○ 受注金額あるいは取消金額

（＝ディテールボディの単価×購入数量の合計）5 受注日時 VARCHAR2 15 ○ 受注あるいは取消が成立した日時

（yyyymmdd/hhmmssの形式）6 受注明細件数 VARCHAR2 2 ○ 後続するディテールボディーレコード数7 支払区分 VARCHAR2 1 ○ 支払方法区分

（D:送品時支払、C:クレジット支払、S:振込)8 クレジット番号 VARCHAR2 16 クレジット支払いの場合のクレジット番号9 クレジットユーザ名 VARCHAR2 16 クレジット支払いの場合のクレジット所有者名

10 届け先住所 VARCHAR2 100 顧客情報で登録されている住所と異なる場合の送付先住11 届け先氏名 VARCHAR2 50 顧客情報で登録されている住所と異なる場合の送付先氏12 届け先電話番号 VARCHAR2 8 顧客情報で登録されている住所と異なる場合の送付先電

話番号9 希望配送日 VARCHAR2 8 配送希望日9 希望配送時間帯 VARCHAR2 1 配送時間帯区分(1：午前中、2:13-15、3:15-18、4:18-20)

No PKEY 項目名属性桁数必須説明1 1 注文番号 NUMBER 2 ○ 受注した注文明細毎の番号（1から昇順）2 2 商品コード CHAR 12 ○ 受注した商品の商品コード3 3 商品単価 NUMBER 6 ○ 受注時点での商品単価（受注時は必須）4 4 購入数量 NUMBER 2 ○ 受注あるいは取り消した商品数5

No PKEY 項目名属性桁数必須説明1 1 終了レコード2 2 受注明細件数 NUMBER 12 ○ 受注明細件数

（ディテールヘッダの受注明細件数と同じ）3

No PKEY 項目名属性桁数必須説明1 1 送信時刻 VARCHAR2 12 ○ 送信処理を開始した時刻

（yyyymmdd/hhmmssの形式）

レコードフッタ

ディテールヘッダ

ディテールボディ

ディテールフッタ

外部インタフェース項目説明

外部インタフェースに含まれる項目に関する定義



バッチ編の紹介バッチ処理の外部設計とバッチ処理以外の設計要素との接点にあた

るコツを、４つの「工程成果物」を中心に解説。

外部設計の「工程成果物」

システム化業務一覧

システム化業務フロー

システム化業務説明書

帳票

外部インタフェース

データモデル

システム振舞いの「機能」情報システムの一括処理

内部設計書要件定義書

画面

バッチ処理一覧バッチ処理定義

バッチバッチ処理フロー

バッチ処理共通ルール

業務処理定義書

ｼｽﾃﾑ機能階層図

業務流れ図



帳票編の紹介開発対象となる業務システムで帳票として扱われる出力成果物を設

計するためのコツを、５つの「工程成果物」を中心に解説。

見出し

項目１項目２項目３項目４

□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□

見出し


□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□

見出し


□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□□□□ □□□□ □□□□□ □□□

帳票一覧

作成する帳票を一覧化したもの

種類サイズ文字詰表示桁数内部桁数フォーマット出力編集参照先エンティティ参照カラム【ヘッダ部】

1 ページ番号 MSゴシック 8 右詰 3 3 数字(ZZ9)2 伝票内通しページ番号 MSゴシック 8 右詰 3 3 数字(ZZ9) 通番ページ編集ルールに従う3 通番ページ番号 MSゴシック 8 右詰 3 3 数字(ZZ9) 通番ページ編集ルールに従う

4 出力日、出力時刻 MSゴシック 8 左詰 16 14YYYY/MM/DD△H24:MI(出力日と出力時刻の間は半角空白を空けること）

出力時のシステム時刻を設定（伝票単位に更新）

【伝票ヘッダ】伝票単位に出力5 出荷元コード MSゴシック 10 左詰 10 10 文字列出荷トランザクション部門コード6 出荷元名 MSゴシック 10 左詰 28 28 文字列（日本語）部門マスタ表示用部門名7 伝票番号 MSゴシック 10 左詰 10 10 文字列出荷トランザクション出荷Ｎｏ8 届け先コード MSゴシック 10 左詰 10 10 文字列出荷トランザクション納品先コード9 届け先名 MSゴシック 10 左詰 10 10 文字列（日本語）出荷トランザクション納品先名

10 届け先住所１ MSゴシック 10 左詰 40 40 文字列（日本語）出荷トランザクション納品先住所１11 届け先住所２ MSゴシック 10 左詰 40 40 文字列（日本語）出荷トランザクション納品先住所２12 売上区分 MSゴシック 10 左詰 1 1 文字列出荷トランザクション売上区分13 発注区分 MSゴシック 10 左詰 1 1 文字列出荷トランザクション発注区分14 支払期限（年） MSゴシック 10 左詰 4 4 数字支払期限マスタ支払期限15 支払期限（月） MSゴシック 10 左詰 2 2 数字(Z9)16 支払期限(日） MSゴシック 10 左詰 2 2 数字(Z9)

【明細行】17 NO MSゴシック 10 左詰 2 2 数字(Z9) １から昇順にカウントアップ18 品番 MSゴシック 10 左詰 15 15 文字列出荷明細トランザクション品番19 商品名 MSゴシック 10 左詰 24 24 文字列（日本語）商品マスタ商品名20 単価 MSゴシック 10 左詰 10 7 数字（\Z,ZZZ,ZZ9）商品マスタ単価21 数量 MSゴシック 10 左詰 3 3 数字(ZZ9) 出荷明細トランザクション数量22 合価 MSゴシック 10 左詰 14 10 数字(\Z,ZZZ,ZZZ,ZZ9) 合価＝単価×数量

23 消費税額 MSゴシック 10 左詰 10 7 数字（\Z,ZZZ,ZZ9）消費税額＝(単位消費税額×数量）

商品マスタ単位消費税額

24 備考 MSゴシック 10 左詰 24 24 文字列（日本語）出荷明細トランザクション備考【合計行】

25 合計金額 MSゴシック 10 左詰 16 12 数字(\ZZZ,ZZZ,ZZZ,ZZ9) 合計金額＝Σ（合価）26 仮受消費税 MSゴシック 10 左詰 14 10 数字(\Z,ZZZ,ZZZ,ZZ9) 仮受消費税＝Σ（消費税額）

編集様式フォントNo

表示属性項目名

帳票項目説明

帳票レイアウトに基づいて印字されるデータ項目の属性情報を記載したもの

ZZ9／ZZ9 (ZZ9)

YYYY/MM/DD 24:59

出荷元コード XXXXXXXXXX出荷部門 NNNNNNNNNNNNNN

伝票番号 XXXXXXXXXX お届け先コード XXXXXXXXXXお届け先名 NNNNNNNNNNNNNN 御中売上区分 Xお届け先住所 NNNNNNNNNNNNNNNNNNNNN 発注区分 X

NNNNNNNNNNNNNNNNNNNNN 支払期限 YYYY年MM月DD日

No123456789

1011121314151617181920

合計金額うち消費税

以上、確かに納品致しました。●●県△△市□□町４－２１－２２株式会社　　◇◇◇◇◇◇◇◇

ZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮ






ZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮ

ZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮ


ZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮ

ZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮZZ\Z,ZZZ,ZZＮＮＮＮＮＮＮＮＮＮＮＮXXXXXXXXXXXXXXX \Z,ZZZ,ZZZ,Z \Z,ZZZ,ZZ ＮＮＮＮＮＮＮＮＮＮＮＮ




納品書

1 2 3

4

5

67 8

9

10

11

12

13

納品明細

16px

10px 10px

10px

10px

単　価数量商品名品　番合　価消費税備　考

\Z,ZZZ,ZZZ,ZZZ,Z\Z,,ZZZ,ZZZ,Z

10px

10px

ヘッダ部

伝票ヘッダ部（２ページ目以降は、売上区分、発注区分、支払期限は印

明細行部（25行を超えたら改ページする）

合計行部（最終ページにのみ印刷すること）

14 15 16

17 18 19 20

21

22 23 24

25

26

帳票レイアウト

帳票上で印字されるデータの出力位置、大きさなどを示したもの

処理説明サブシステム名販売管理帳票名納品書業務名販売管理帳票ＩＤ RZCD-01機能名納品書出力出力様式汎用紙用紙サイズＡ４横モノクロレーザ帳票分類明細表改ページ条件あり出力制御条件あり帳票作成方法バッチ出力なし

処理説明全般本帳票は、出荷に伴う納品書を作成するものである。

本帳票は、出荷トランザクションに格納されたデータと出荷明細トランザクションに格納されたデータをもとに納品書を作成する。本帳票は、出荷トランザクションに格納された出荷元コード、伝票番号をキーとして１つの納品書を作成する。出荷される商品の明細データは出荷明細トランザクションに格納されており、必要なデータは発注番号をキーとして抽出する。

改ページ条件発注番号が変わる毎に改ページを行う。同一の発注番号で納品書に印字される出荷明細（納品明細）が２０件を超える場合には、20件毎に改ページを行う。同一の発注番号で改ページが発生する場合には伝票ヘッダ部、フッタ部の処理が異なるので注意のこと。発注番号が変わる毎に合計行部の印字内容も変わるので注意のこと。

ヘッダ部ヘッダ部は改ページされる毎に作成する。ページ番号伝票番号が変わることに１にリセットする。改ページされたら１カウントアップする。伝票内通しページ同一の伝票番号における総ページ数を示す。

同一の伝票番号の明細行は２０件毎に改ページされるので、出荷明細トランザクションにある同一の伝票番号を持つ明細行数の和から総ページ数を算出する。

通番ページ番号本帳票の通しページである。１から改ページ毎に１カウントアップする。出力日、出力時刻印刷処理の行われたシステム時刻を設定する。この時刻は伝票番号毎にリセットする。

伝票ヘッダ部伝票ヘッダ部は改ページされる毎に作成する。同一の伝票番号の納品書が複数枚にわたる場合には、2ページ目以降は売上区分、発注区分、支払い期限は印字しない。

出荷元情報出荷元コード出荷トランザクションの部門コードを設定する。出荷部門部門コードをキーとして部門マスタを参照し、このコードに合致する表示用部門名を設定する。

納品先情報伝票番号出荷トランザクションに格納されている出荷Ｎｏを設定する。お届け先コード出荷トランザクションに格納されている納品先コードを設定する。お届け先名出荷トランザクションに格納されている納品先名を設定する。お届け先住所１出荷トランザクションに格納されている納品先住所１を設定する。お届け先住所２出荷トランザクションに格納されている納品先住所２を設定する。

帳票編集定義

出力項目のデータ転記／編集、改ページ、ヘッダ／フッタの編集要件を示したもの

No 帳票ID 帳票名作成周期出力様式用紙サイズ

プリンタ種別帳票分類改ページ条件

出力制約条件

業務機能作成方法

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横その他明細表販売請求管理オンライン出力

帳票の用途、物理的な属性、動作環境、運用要件などについてまとめたもの

サブシステム名販売管理帳票名商品一覧リスト帳票分類一覧表業務名販売管理帳票ＩＤ RZAB-01 出力枚数 100P／回機能名商品管理作成方法バッチ出力作成環境サーバ出力様式 CSV 用紙サイズ A４横プリンタ種別その他出力タイミング月次保存期間－改ページ条件なし出力制御条件なしセキュリティ条件なし指定プリンタなし再出力可利用部門 ○○部門担当者（●●さん）現行帳票名概要商品管理機能の商品情報一覧画面で表示されている商品リストの一覧を出力する

商品一覧は、商品コード、商品名、商品名（カタカナ）、単価、販売開始時期、当月販売可否、当月販売可能数を掲載する。商品の出力順序は商品コード順である。

備考【利用頻度】月１回【出力条件】そのまま印刷可能な状態とすること。【帳票廃止可能性】電子化し再利用できるなら廃止可

帳票概要



言い切る／聞き切るためのコツの例



図表に書くためのコツの例



もれ／矛盾をチェックするためコツの例



一緒にレビューするためのコツの例



コツの集計(概要編より）278 言い切る／聞き切る 44 図表に書く 101 もれ／矛盾をチェックする 22 一緒にレビューする 94

発注者が事前に意識する

17・言い切る/聞き切る５・システム化業務一覧７・システム化業務フロー２・全レベルでレビュー(要件との整合) ３

・システム化業務フロー１１・全レベルでレビュー(設計書の正しさ) ３・システム化業務説明４・仕掛レベルのレビュー５・システム振舞い共通ﾙｰﾙ５・充実レベルのレビュー８・工程成果物間の関連２・充実・完成レベルのレビュー５

60・言い切る/聞き切る６・画面一覧６・画面一覧２・設計書レビューの進め方８

・画面遷移５・画面遷移１・画面全体に渡る共通事項のレビュー５・画面レイアウト４・画面レイアウト３・画面の一連の動きのレビュー４・画面入出力項目一覧３・画面遷移・ﾚｲｱｳﾄ共通ﾙｰﾙ６・１つの画面のレビュー１０・画面アクション明細６・画面入出力項目一覧２・画面遷移・ﾚｲｱｳﾄ共通ﾙｰﾙ８・工程成果物間の関連１・工程成果物間の関連４

84・言い切る/聞き切る８・ＥＲ図４・エンティティ・属性を抽出する３

・エンティティ一覧５・データモデルの概要を説明する１・ＣＲＵＤ図４・データモデルの詳細を説明する１１

・データの変化を確認する３・業務とデータの関係を確認する２・他ｼｽﾃﾑとやりとりするﾃﾞｰﾀを確認する３・業務量を確認する１

45・言い切る/聞き切る１０・外部システム関連図１・もれ／矛盾をチェックする２・一緒にレビューする７９

・外部インタフェース一覧２・外部インタフェース項目説明３

・外部インタフェース処理説明１

35・言い切る/聞き切る７・バッチ処理一覧２・もれ／矛盾をチェックする１・一緒にレビューする４

・バッチ処理フロー４・バッチ処理定義２・バッチ共通ルール３

23・言い切る/聞き切る８・帳票レイアウト２・もれ／矛盾をチェックする２・一緒にレビューする８８

・帳票項目説明１・帳票概要１・帳票編集定義１

31

帳票編

８５２８８

・発注者が事前に意識する

バ

ッチ編

７１１１４０

フ

ェー

ス

編

イ

ン

タ

外

部・発注者が事前に意識する

１０７２７９

デー

タモデル編

８１３０２４０

画面編

６３６１５２７０

振舞い編

システム

５２９２２４０


どのような場面で使うことを想定して作ったか？・・・活用のヒントとして

1. 開発標準に沿った設計業務を補足するコツ集として設計に関するドキュメントを介して、ＳＩベンダの開発担当者間、あ

るいは開発担当者とユーザ企業情報システム部門・ユーザとの間のスムーズな意思疎通をはかるために利用する。

2. 教育コンテンツの素材集としてＳＩベンダやユーザ企業の情報システム部門を中心に、各社の教育コ

ンテンツの素材集として利用する。

3. レビューに臨む際の心得として情報システム開発のステークホルダ間のコミュニケーションを円滑に

するために、レビューのコツを利用する。

どのように使ったらよいか？



どのように作ったか？・・・活用のヒントとして

1. 設計書からのコツの抽出各社の設計書を持ち寄り、自社の設計書にはない自社の設計書に取り込むと有益と考えられる工夫された部分を抽出

2. 経験からのコツの抽出各人の成功事例や失敗事例から、設計書には表現出来ていないが、肝となる押さえるべきポイントを出し合いブレーンストーミング

3. これまでの成果の吟味「発注者ビューガイドライン」(2008/7)、その「活用と拡張」(2009/4)等の成果を見直し、読者にとってわかりやすい表現を


活用事例・・・活用のヒントとして


# 企業（順不同）状況

１㈱ＮＴＴデータ開発手順に適用。具体的には、発注者ビューガイドラインをベースに成果物の記述項目と図の凡例を見直し。また、”コツ”については社内の既存のチェックリストと統合。

２富士通㈱標準開発プロセスの設計書の記述要項、記述例、ワークシートの改善を実施済み。

３日本電気㈱社内向けの設計ガイドとして、開発プロセスに合わせてどの作業、どの設計ドキュメントで適用するかを他の設計ガイドと連携させ独自にガイドとして再編集して利用。

４㈱日立製作所標準開発プロセスの設計書の記述要項、記述例、ワークシートの改善を実施済み。

５㈱構造計画研究所社内規定「機能設計書記述要領」の１つとして組み入れ、公開。

６東芝ソリューション㈱

情報システム開発標準群の１つとして組み入れ、社内公開。また、コツの使用について優先度表を作成し、併せて公開。

７日本ユニシス㈱社内の（開発関連）知財として管理し展開（公開）するとともに、SE向け説明会等での（書籍も含めた知識の）活用、説明会の実施など。）

８ＴＩＳ㈱社内向け設計ガイドに発注者ビューガイドラインの記述要素を取り込み。発注者ビューガイドライン自体も参考文書として社内公開。

９沖電気工業㈱ 2008年度より、開発標準に適用。具体的には、発注者ビューガイドラインをそのまま採用せずに、システム設計書作成規定の「参考資料」として組み入れております。

10 ㈱インテックガイドラインと社内設計標準の関連付けを実施。その対比表を基に適切な局面でガイドの該当箇所を参照し、活用するように社内に案内。

11 ㈱東京証券取引所社内の参考情報とするとともに、社内システム開発プロセスへの組込みを検討中。

12 清水建設㈱ 2008年上期に特定アプリケーションの開発案件において、「画面編」を適用し、評価を実施。


「発注者ビューガイドラインの活用と拡張～機能要件の合意形成を目指して～」（ 2009年3月31日）からの抜粋・要約



# 会社（順不同）状況

13 IPA ＳＥＣ 2009年度IPA内でSEC以外の業務でのシステム開発において、設計ドキュメントへのガイド記載趣旨の反映を実施。


IPA事例の紹介・・・活用のヒントとして

現在、2011年頃開始予定の、ＩＴパスポート試験のCBT化に向けたシステム開発を進めている。※CBT： Computer Based Testing

外部設計を開始する前に、受注した企業の設計標準とガイド記載内容とのギャップを洗い出し、

ガイド記載内容が有効と判断された部分について、設計標準に反映。（ドキュメント作成基準書、画面設計基準書、帳票設計基準書等）



悩み・気づき・ヒント‼ 設計書レビュー時に、

基本的なことの指摘が多くありませんか？

そんな時には「機能要件の合意形成ガイド」を一度見てみよう。

→そこには発注者と開発者間の合意をより良くするためのヒントがあります。

‼ テスト結果の確認や検収時に、手直し要望が多くありませんか？

‼ カットオーバ後に、すぐ手直しということが多くありませんか？


おわりに


情報処理推進機構：ソフトウェアエンジニアリングhp.mht

ダウンロードはこちらから･･･http://sec.ipa.go.jp/

以上です。

ご清聴ありがとうございました。

http://sec.ipa.go.jp/�

http://sec.ipa.go.jp/�

http://sec.ipa.go.jp/

http://sec.ipa.go.jp/

software engineering center - ipaシステム振舞い編 外部インタフェース編 イ ン...

Documents

software engineering center - ipaシステム振舞い編外部インタフェース編イン...