仕様書 書く側 と 受取り側(要求仕様書、基本設計書、詳細設計書)

[VBA系メニューへ] [質問掲示板] [バックナンバー目次]




こんにちは、Ken3です。

/* * 1.今回のキッカケ */

あんまり気にすること無いんだけど、ログ取ってると気になります。 http://www.ken3.org/cgi-bin/cnt/log100.asp で、リンク元の検索キーワードを拾ってると、 仕様書でヒットした来場者がタマに来てます。 サンプルプログラムを一生懸命書いてるけど、 実際は仕様書が在って、そこからプログラムだしなぁ・・ と初心に帰って、VBA系のメルマガで仕様書から作りハジメマシタ。 [No.66 Access ユーザーマスターのチェックとメニュー切り替え] http://www.ken3.org/backno/backno_vba14.html#66 いつものパターンで、一人n役で書きます。 ※流し読みして下さいね。 [関数仕様書のお話]もヨロシクです。

/* * 2.初期段階、大まかな要求を聞く */

案件在ったら、即技術者連れて打ち合わせの会社もあれば、 見積もり提案活動までは営業さんがやったりと会社によって様様だと思います。 ※まったくウチの技術者は/営業は・・・といろいろと不満も在ると思います。 とある入力センターに打ち合わせに向かいました。 ※作り話だよ 客先担当者のお話 >私の希望は、アクセスの画面を開いたときに、フォームが出てオペレーターは入力の >み、パスワードを持つ担当者が、検索、修正ができるようにしたいと思っています > >その場合、オペレーターに自分が入力したデータだけを打ち出させて、目検してもら >いたいのですがその日、自分が入力したデータだけを打ち出すことができるでしょう >か --- そんなシステムを作りたいかぁ。 出されたお茶を上司より先に手をつけながら、フト考える。 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~オイオイ(笑) あんまり話したくないけど、沈黙が続くのもイヤだしなぁ。 三流プログラマーKen3 まずは、管理者とオペレーターで使える機能に制限を持たせたいんですね。 管理者の機能は ・ユーザーマスターのメンテナンス ・検索と修正機能 ・納品用の印刷や納品用CSV作成などの出力機能 オペレーターの機能は ・データの入力機能 ・入力データの目検用の印刷機能 共通機能は、 ・ログイン画面 こんな感じでいいですか? 口頭で速射砲のように想像した機能を話す。 >あの〜、何を言っているのか?サッパリなんですが?イメージが沸かなくて。 こっちもサッパリわかんないよ、、もっと詳しく聞かないと、、、 と掲示板ならケンカ?売るんだけど(怖いよね掲示板やMLって)、 仕事を貰う立場なので横の営業は無視して話を続ける。 そうですよね(苦笑しながら)※笑顔でかわすって必要ですよたぶん(笑)、 では、次回の打ち合わせの時、案を作って持ってきます、 あっ、その時までに入力するデータの項目とサイズを教えてもらえませんか? あと、差し障りが無ければ実際に入力する伝票を次回お借りしたいです。 それと、 >えっ、まだあるの? できたら集計印刷のイメージを教えてもらえると助かります。 次回の打ち合わせに私が用意するもの ・システム化の案 ・概算見積もり お客様に用意してもらうもの ・入力データの項目とサイズ、実際に使用している伝票 ・集計印刷のイメージとレイアウトはラフな手書き 次回の打ち合わせは3日後の午後はご都合のほうは? それとも事前にFAX送りましょうか? >いいですよ、見積もりと提案3日後に聞きましょう 作成中に質問あったら名刺のE−Mailに問合せしても平気ですか? >はい、大丈夫ですよ やりやすいお客さん ~~~~~~~~~~~~~~~~~~ システムの全体像をラフながらまとめている(打ち合わせの時資料が初回からある) 予算取り、社内の根回しが済んでいる(システム化に前向き) やりにくいお客さん ~~~~~~~~~~~~~~~~~~ 何をしたいかがわからない(笑) 夢のシステムを語ってくれるがコンピュータ化は難しいとクギをさすとむくれてしまう やりにくいシステム屋との打ち合わせ風景 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ とにかく黙っている、話さない(会話が無い) 専門的な話を始める 打ち合わせの議事録、好きですか?嫌いですか? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 議事録作ってメールでまわせ、、そんな指示を受けた時、あなたの反応は? 必要性は感じつつ、チッオレ様が作るのかよ/面倒だなぁ 不用紙のムダだから適当に作るか・・・なんて思ったアナタ、 打ち合わせを思い出しながらまとめるとやることや聞き漏らしたことがわかるので、 議事録作成は嫌いだけど作ったほうがいいですよ。 今回の決定事項 ^^^^^^^^^^^^^^ ・特に無し(無駄な時間を過ごした←とは自分の日記に書いてね) まずは、決定した議題は必要かなぁ。 えっ、そんなの書いてても次回に神様(お客様)の一声でくつがえるって? でも決定事項は確認のメモだと思って書いておいてね。 次回持ち越し、検討項目 ^^^^^^^^^^^^^^^^^^^^^^ 今回決まらなかったことを書きます。持ち帰って双方検討する事柄など。 例では >次回の打ち合わせに私が用意するもの >・システム化の案 >・概算見積もり >お客様に用意してもらうもの >・入力データの項目とサイズ、実際に使用している伝票 >・集計印刷のイメージとレイアウトはラフな手書き の部分を議事録に載せる、まぁ自分の作業予定だと思って書いてよ。 次回打ち合わせ予定 ^^^^^^^^^^^^^^^^^^ ヒマな担当者だと楽なんだけど、 大きな予算を動かせたり、重要システムの担当者 中小企業だと社長さん直接なので、 次回の打ち合わせの日時決めれたら決めたほうがいいです。 合わせて、見積もり提出の期限も聞きましょう。 打ち合わせたのが木曜日で相手の会社が月曜日午前中全体ミーティングの会社だと、 余裕を見て週明け提出すると、さらに一週間決済まで待たされたり・・・ 作業のタイミングを合わせる意味でも聞いておいたほうがいいですよ。 日時・場所・参加者(敬称略)なんてのは、 ムダにキーボード打つだけだからイラナイ(うそです)

/* * 3.要求仕様をまとめる */

基本仕様/要求仕様をまとめる 機能概要 ~~~~~~~~ 管理者は、 ・ユーザーマスターのメンテナンス  オペレータと管理者のマスターを登録・修正・削除する機能 ・検索と修正機能  データテーブルからデータの検索、修正を行う機能 ・納品用の印刷や納品用CSV作成などの出力機能  リスト(紙)の出力と納品データ(CSV)の作成機能 を操作 オペレーターは ・データの入力機能  データを入力する(登録機能) ・入力データの目検用の印刷機能  登録されたデータの確認リストを印刷する  ※各担当者、自分が入力した分のみリストを出力する を操作 共通機能 ・ログイン  管理者とオペレータの切り替えが起動時のログイン画面で出来ること。 と日本語で書いててOKかなぁ。チョイラフ過ぎだけどカンベンしてね。 ページ数稼ぎのオマケは動作環境 OS:Windows 使用アプリ:MS Access2000 開発言語:VBA とか、書いておけばOKかなぁ。 要求仕様書/基本設計書に入れるか、詳細設計に入れるか微妙だけど、 大体1機能1画面かサブ入れて2・3画面なので、 画面の流れと一緒に機能を説明すると、 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ お客さんもなんとなくイメージつかんでくれるよ 画面の遷移図を作成する ~~~~~~~~~~~~~~~~~~~~~~ まぁ、1機能1画面だから機能一覧と似ちゃうけど Windoes起動   ↓ xxxx.mdb をダブルクリックして起動する ログイン画面の表示 |   +----- 終了ボタン Accessの終了 | +----- ログインボタン データチェック後、       管理者メニュー ・・・ (A)       オペレータメニュー ・・(B)       どちらかのメニューを表示する 管理者メニュー | +----- マスターメンテナンス マスターメンテ画面を起動 | +----- 管理帳票印刷 管理帳票印刷画面へ | +----- CSV納品ファイルの作成 納品ファイル作成画面へ | +----- 作業終了  管理者メニューを閉じてログイン画面へ オペレータメニュー   | +----- データ入力 データ入力画面の表示 | +----- 目検 入力データを印刷する | +----- 作業終了  オペレータメニューを閉じてログイン画面へ 画面をさらっと書いたら、 使わないシステムはまず無いと言われる、ファイル関係かなぁ。 ファイル仕様 ~~~~~~~~~~~~ ページ稼ぎの一覧を作成して MST_USER ユーザーマスターテーブル T_DATA 入力データ管理テーブル ユーザーマスターテーブル 概要 管理者・オペレータをログイン処理で判断するために、 ユーザーID、パスワード、管理区分をが保存されている 作成:システム管理者がユーザーマスターメンテで作成 使用:ログイン機能で使用 入力データ管理テーブル 概要 入力原票のデータが保存される 付帯項目として入力オペレータの情報/入力日付を持つ 作成:オペレータの入力処理 使用:入力、印刷、CSV作成・・・・ 出力(印刷)帳票 ~~~~~~~~~~~~^~ 目検用確認リスト ・・・・ オペレータが入力データを確認するためのリスト 納品用リスト ・・・・・・ 規定フォーマットに印刷する納品用の成果物 [ 目検用確認リスト ] 概要 オペレータが入力した自分の分だけをリスト印刷したもの。 入力完了後にオペレータ自身が出力、入力票(原票)と目で確認する >こんな感じで書いてると、では?確認してミスを見つけたら?どうするの? >なんて疑問が浮かんでくる、浮かんできたら質問・確認項目に入れておく >実際に自分が業務を進めていたらどうなるか?想像しながら書く [ 納品用リスト ] 概要 データと一緒に納品する印刷物(規定フォーマットに印刷する納品用の成果物) 印刷範囲は作成したCSVデータと一緒 >なんて一行で書いてるけど、ここでも疑問が発生してくるよね >お馬鹿が納品前にコーヒーこぼした? >や >客先で紛失、再出力してほしいと2・3日後に再出力の依頼が来た時? >再出力の処理は必要か? ※概要をまとめている時、再出力処理の必要性に気が付いたりする。  まぁ、再出力は最低限の機能といえばそれまでなのだが(笑)  作成前の設計書の重要性、なんとなく理解できましたか?

/* * 4.詳細の設計 */

詳細設計 ~~~~~~~~ プログラムの作成開始のレベルまで落すのが理想です。 テーブル(ファイル)フォーマット ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ データベースの形式、物理格納場所、レコード長なんて昔ながらの項目があるけど、 シンプルに、必要な項目があればOKかなぁ。 ※会社にもよると思います。  こんなのワープロ化するなら、Accessでテーブル作って、  そのまま印刷、それを設計書にするのもアリですが、、、。 MST_USER ユーザーマスターテーブル F_USER_ID Text(10) 10文字まで、GusetやA001などのコード 重複不可 F_NAME Text(20) ユーザーの名前 小林君や遠藤君 F_PASS Text(20) パスワード F_KUBUN True/False True管理者、False一般オペレータ T_DATA 入力データ管理テーブル F_NO オートナンバー   ・   ・  客先から後で聞く   ・ F_INPUT text(文字型)  入力したユーザーのID 画面レイアウトと動作仕様 ~~~~~~~~~~~~~~~~~~~~~~~~ [ログイン画面 F_LOGIN] 画面イメージ USER [ ________ ] ▼ コンボボックスで選択 PassWord [ ********** ] ┌────┐ │ログイン│ └────┘ ┌──────┐ │システム終了│ └──────┘ ユーザーを選択、パスワード入力後、ログインボタンを押してください。 動作仕様 コントロール名   処理内容 ログインボタン   USERとパスワードが合っているかチェックする           エラー時:メッセージを表示して再入力 正常時:管理者フラグを判断して次のメニューを表示               a.管理者メニュー b.オペレータメニュー システム終了ボタン 終了確認メッセージを出力し、はいの時、Accessを終了 >※動作仕様は、イベントに対応して書いてあげると、作るほうは楽かなぁ。 よくあるコード入力後のチェック処理などは、 商品コード入力 入力後(データ更新後)、商品マスター検索、データチェック とか書いておくと、作りやすい [管理者メニュー画面 F_MENU_KANRI] ┌────────┐ │ マスターメンテ │ └────────┘ ┌────────┐ │ 管理帳票印刷 │ └────────┘ ┌────────┐ │納品ファイル作成│ └────────┘ ┌────────┐ │ 終 了 │ └────────┘ [オペレータメニュー画面 F_MENU_OP] ┌─────┐ │ 入 力 │ └─────┘ ┌─────┐ │目検用印刷│ └─────┘ ┌─────┐ │ 終 了 │ └─────┘ 印刷(帳票)レイアウト ~~~~~~~~~~~~~~~~~~~~~~ イメージを貰っていないのでまだ。 まぁ、ラフに書いて、打ち合わせ後に修正するか。 レイアウト、、、これも作ってから現物を設計書に添付するほうが楽だったり、、 でも、現物を作る人(作った人)は、何見て作ったのか疑問があるが・・・

/* * 4.終わりの挨拶(次回はアルのか?(爆)) */

よくわからなかったけど、何か言いたかったの? ・打ち合わせの進め方を少し ・設計書は始めに書くんだよ、納品後の処理じゃないよ って話でした。 読み直すとあれ?何の話だったのだろう? でも、せっかく書いたから発行しちゃえ(爆) 何か読者の心に残れば、うれしいです。 *私の独り言をうまく消化してくださいね。 もう四月も終盤かぁ、そろそろ派遣かなぁのKen3でした。 ~~~~~~~(↑オイオイ) -------------------- 読者からのお便り紹介 -------------------- In message "uhcd.sys 確認。", いちにいさん wrote... >やっぱ、OS毎入れ換えんとダメやね。 >色々と絡みがありそうだし。 >一体何処が違うんやろ。はぁ〜。 > >んじゃ。派遣がんばってね。(女の子が沢山居る職場(笑)) ---- 女の子がたくさん居る職場かぁ・・・ ※たくさん居てもイイ思いで無かったしなぁ(実話(笑)) http://www.ken3.org/etc/500yen/zaitaku.html に転職・SOHO・派遣の情報載せつつ、自分でも探そうとしてるけど、 女の子が多い、そんな条件が検索できるといいね(オイオイ) 社員数100名とかじゃなくて、 男性90名女性10名、男性60名女性40名とか? えっ、女の子にKen3は相手にされないからイミ無いって(笑) まぁ、そんな男女比は置いといて(そんなの載ってないよ)、 たまに平均年齢24.3歳の若い会社とかアピールしてるよね。 人との出会いは何かの縁だから、。。

質問・感想を送る

作者に感想・質問/要望を送る(気軽に質問・感想書いてください)
あなたのお名前(ニックネーム) さん

作者からの返信は、 不用 E-mail で受信したい

三流君のHP主な飛び先

VBA系のメルマガで書いた解説を項目ごとにまとめてます

[VBAでAccessを操作(一般)]
[VBAでAccessのレポートを操作]
[VBAでAccessのUserForm/サブフォームを操作]
[VBA Access から Excel 連携]

[VBA でExcel オブジェクト/プロパティ/メソッド/一般]
[VBA でExcel UserForm(ユーザーフォーム)を操作する]
[VBA ExcelからAccessを操作する]

[VBA Outlookの操作]
[VBA IEの操作]
[VBA テキストファイル(*.txt,*.html,*.csv)の操作]
[VBA標準関数関係とその他解説]

ASP系の解説を項目ごとにまとめてみました

[ASP Form等を使用したデータのやり取り]
[ASP その他処理サンプル]
[ASP テキストファイル処理]
[ASP VBScript関数関係の説明]
[ASP ADOでMdbファイルを使う]
[ASP ADOでExcelと接続してみた]

分類別

[アクセスランキング] [サイトマップ] [リンク先・相互リンク先など]
VBAで楽しくプログラミング 掲示板 バックナンバー メルマガ登録と解除
コンビニのオモテとウラ話 掲示板 バックナンバー メルマガ登録と解除
ASPで遊ぶ、失敗する 掲示板 バックナンバー メルマガ登録と解除
三流プログラマー 業務の愚痴 掲示板 バックナンバー メルマガ登録と解除
初心者にやさしいプログラム 掲示板 バックナンバー メルマガ登録と解除
ネットで稼ぐ本音と失敗談 掲示板 バックナンバー
www.ken3.org(サイト内)から Google を利用して、

Ken3の日記(weblog) -- [広告・副収入系] [プログラマー業務の愚痴] [VBA系の話題] [ASP系の話題] [コンビニ系ネタ] [その他]

その他、宣伝ページです

・[ アンケート/ポイント]などで月500円を必死に稼いでます(笑)
・[ SOHO/在宅プログラマー/派遣]の話題、Webエントリー後の反応など
・[ ネットで小金を稼げるか?]実験中だが成果は無し
※あとは、[パソコン関係の書籍]や[ゲームソフト]、 [パソコンパーツ] をバナーから売ろうとするけど、
 なかなかうまくはいかないよね(笑)

楽天の商品売れ筋ランキング紹介ページ

ドリンク

[コーヒー・ココア] [ソフトドリンク] [ハーブティー] [ビール・地ビール] [ワイン] [中国茶] [中国酒] [日本茶] [日本酒] [水・ミネラルウォーター] [洋酒] [焼酎] [紅茶] [その他(ドリンク)]

グルメ・フード

[キムチ・漬け物] [チーズ・乳製品] [パン] [フルーツ・野菜] [] [惣菜・食材] [中華料理・惣菜] [和風料理・惣菜] [洋風料理・惣菜] [水産物・水産加工品] [] [肉・肉加工品] [菓子] [調味料] [麺類] [その他(フード)]

ファッション

[インナーウェア・ナイトウェア] -- [ショーツ] [ブラジャー] [ストッキング] [キャミソール] [スリップ] [ガードル] [補正下着] [マタニティ用下着] [ナイトウェア]
[カジュアル] -- [Tシャツ] [シャツ] [カットソー] [セーター] [カーディガン] [ジーンズ] [パンツ] [ジャンバー・ブルゾン] [スカート]
[レディース・婦人服] -- [スーツ] [ワンピース] [スカート] [パンツ] [ブラウス] [フォーマル]
[ジュエリー・アクセサリー] -- [指輪] [ネックレス] [ペンダント] [イヤリング] [ピアス] [ブレスレット] [ジュエリーボックス・ケア用品]
[香水] -- [シャネル] [クリスチャン・ディオール] [ジバンシー] [グッチ] [ブルガリ]
[メンズ・紳士服] [メンズ-スーツ] [メンズ-シャツ] [メンズ-トランクス] [メンズ-ブリーフ] [メンズ-ボクサーパンツ] [メンズ-Tシャツ] [トレーナー・パーカー] [メンズ-ポロシャツ] [メンズ-カットソー] [メンズ-セーター] [メンズ-カーディガン] [メンズ-ジーンズ] [メンズ-ジャンバー・ブルゾン]
[バッグ] [] [ベビー・キッズ・マタニティ] [和服] [眼鏡・サングラス] [コンタクト・コンタクト用品] [腕時計] [雑貨・小物] [スイムウェア]

パソコン・家電・AV

[オフィス・サプライ] [コンパクトカメラ] [デジタルカメラ] [ビデオカメラ] [一眼レフカメラ] [ソフトウェア] [パソコン・コンピュータ] [デスクトップパソコン] [ノートパソコン] [モバイル・携帯電話] [周辺機器パーツ] [スキャナ] [プリンタ] [家電・AV] [エアコン・空気清浄機] [オーディオ] [冷蔵庫・冷凍庫] [掃除機] [映像機器]

生活・インテリア

[家具・インテリア] [手芸・クラフト] [文具] [日曜大工・作業用品] [日用品・生活雑貨] [食器・調理用具]

ヘルス・ビューティ

[ダイエット] [健康用品] [サプリメント] [医薬品] [福祉・介護] [美容・化粧品] [スキンケア] [メイクアップ]

スポーツ・アウトドア

[アウトドア] [ウィンタースポーツ] [サッカー] [ストリート系スポーツ] [テニス] [トレーニング] [フィッシング] [マリンスポーツ] [自転車] [野球] [スポーツグッズ] [格闘技グッズ] [その他スポーツ・用品]

フラワー・ガーデン

[エクステリア] [ガーデニング] [フラワー・花] [植木] [観葉植物] [造花]

ホビー・ペット・コレクション

[アート・美術品] [おもちゃ] [ペット・ペットグッズ] [占い・開運] [囲碁・将棋] [楽器] [趣味・コレクターグッズ]

CD・DVD・ゲーム

[CD・カセット] [DVD・LDソフト] [アニメ(DVD・LD)] [ミュージック(DVD・LD)] [洋画] [邦画] [テレビゲーム] [ビデオ] [音楽CD] [R&B] [アニメソング] [ジャズ] [ダンス&ソウル] [ヒップホップ] [ロック・ポップス(洋)] [ロック・ポップス(邦)]

車・バイク

[カー用品] [カーナビ] [カーオーディオ] [タイヤ・ホイール] [洗車用品] [バイク]

ゴルフ

[ゴルフ・クラブ] [ゴルフ・シューズ] [ゴルフ・ウェア] [ゴルフ・バッグ] [ゴルフ・ボール] [ゴルフ・小物] [ゴルフ・トレーニング用具]