[三流君] －－＞ [ＶＢＡで楽しく] －－＞ [バックナンバー一覧]
－－＞ No.168 詳細な設計って？

詳細な設計って？

今回は、よく、メールで問い合わせを受ける
詳細設計について、乱暴に書いてみます。
詳細設計のイロハではないので、一部拾い読みをしてください。
※三流プログラマーに文句を言いながら読むのが正しい読み方です。

発行内容

詳細な設計って？

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

あるいいかげんな上司や先輩から、
下記のように簡単な機能概要と画面のラフ書きをもらいました。

目的：フォーム上にWebのデータを表示する。

・URL を 入力することができるようにする。
・出力するweb上のテーブルを選択可能とする
・出力するExcelシートを選択可能とする。

↑オイオイ、これが要求仕様か？かんべんしてよ、目的と３行のみかよ。
　ここから、お客さんのやりたいことを読み取るの？
　※要求仕様のまとめ方もネタになりそうだけど、今回はパス。

画面イメージ:

URL [ ________________________ ]
      ↑現在のURLを表示、入力修正後はそのページへ切り替える
  Webの画面を表示する。
    ・
　　・　※ユーザーが自由にクリックしたりできる
　　・
　Webの画面を表示する。

TABLE                  ブック          シート
[           ]          [新規        ]  [新規        ]
[           ]          [aaa.xls     ]  [            ]
[           ]          [bbb.xls     ]  [            ]
[           ]          [ccc.xls     ]  [            ]
↑リストボックス

と選択可能とする。

 _____________
 |EXCELへ出力| 
 ~~~~~~~~~~~~~

/*
 * ２．こんなの設計じゃないよ 何が足りないか？
*/

さて、こんな紙切れ１枚渡されて、あなたはプログラムを作れますか？
作れないですよね。
設計者と製作者が一緒だから、頭の中でまとまってますが、
これが通常の開発で、設計と作成が違うと、まずいですよね。

私の中でわかってますが、読者やもしお願いする担当者にこれを渡しても
？？？だと思います。

何が足りないか？

全てです、出直して来い or オレも打ち合わせに同行させろ
と言いたいですが、少し冷静になって、

細かい話をすると、
コントロールの名前
~~~~~~~~~~~~~~~~~~
が
画面設計に無い。（名前ぐらい自由に付けたいといった担当者も居ますが）
^^^^^^^^^^^^^^^
※コーディング規則が社内にある会社と無い会社によって違ったり、
　先輩の趣味、自分のこだわりとか、これもネタになるんだけど。。。
　コントロール名、日本語だけは止めてねと言われたことあったり。
　私が日本語のコントロール名が好きな話は置いといて、

動作が不明、詳細が書いていない。
^^^^^^^^^^^~~~~~~~~~
言葉で少し説明があるが、動作イメージが書いていない、
これでは、処理が伝わっていないので目的と違うプログラムを作成してしまいます。

そこで、少し修正しました。

URL [ ________________________ ] (txtURL)
      ↑現在のURLを表示、入力修正後はそのページへ切り替える

  Webの画面を表示するエリア (AxWebBrowser1)
    ・
　　・　※ユーザーが自由にクリックしたりできる
　　・
　Webの画面を表示する。

TABLE                  ブック          シート
[           ]          [新規        ]  [新規        ]
[           ]          [aaa.xls     ]  [            ]
[           ]          [bbb.xls     ]  [            ]
[           ]          [ccc.xls     ]  [            ]
(lstWEBTABLE)          (lstBOOK)       (lstSHEETS)
↑リストボックス

 _____________
 |EXCELへ出力| (btnTOEXCEL)
 ~~~~~~~~~~~~~

()はコントロール名とします。

これで、使用するコントロールのイメージが画面に付きました。
次は、必要ないけど行数稼ぎでコントロール一覧を付けてもイイですね。

名称          種類              備考
txtURL        テキストボックス
AxWebBrowser1 WebBrowser        IEのコントロール、別DLL参照
lstWEBTABLE   リストボックス
lstBOOK       リストボックス
lstSHEETS     リストボックス
btnTOEXCEL    ボタン

あまり、一覧とかこだわると、
じゃ文字表示にしか表示ラベルも一覧に載せるのか？
と
極論を言われるけど、意味無いのは載せないでＯＫでしょう。

※ラベルのコントロール名まで書いていたら、その先輩はある意味怖かったり。。。
　一緒には仕事したくない、そんな細かさも時には必要だったりするんだけど。

次に、コントロールに対しての処理でしょう。
処理＝イベント、タイミングと読み替えてもＯＫかなぁ。
~~~~~~~~~~~~~~~~~~~~~~~~~~

フォームが読み込まれたら、初期ページを表示する
通常実際にコードは書かないけど、こんな感じで書いてあれば、
_Loadのイベントに、初期ページのコードを書けばいいんだぁ

Private Sub Form1_Load( _
              ByVal sender As System.Object, _
              ByVal e As System.EventArgs _
              ) Handles MyBase.Load
    'フォーム読み込みと同時に、初期ページを表示する
    Me.Me.AxWebBrowser1.GoHome() '初期ページに移動する
End Sub
※vb.netのサンプルです

と、プログラマーさんは、わかるかな。
同様に、イベント、タイミング別に処理を書きます。
※設計時に書き漏れとかあるんだけど、そこはご愛嬌、人間関係で（オイオイ）
  間違っても、
  こんなこともわからないのか小僧は？ vs まともなに設計しろ高給取りの課長様
  なんて関係にならないで、先輩の設計の不備を補ってあげたり、
　後輩が聞きにきたら、丁寧に説明しましょうね。

コントロール名：txtURL   テキストボックス
ユーザーがURL入力後、コントロールがフォーカスを失ったら、
入力されたＵＲＬにジャンプする(AxWebBrowser1を操作)

コントロール名：AxWebBrowser1 WebBrowser
読み込み完了後のイベントで、
移動後表示されたURLをtxtURLにセット
lstWEBTABLEをクリアし、
ドキュメントからlstWEBTABLEへテーブル名をセットする。
※テーブル名が無い場合は連番にする
lstBOOK,lstSHEETS,btnTOEXCELを使用不可にする

コントロール名：lstWEBTABLE   リストボックス
テーブルが選択されたら、
lstBOOKをクリアし、新規ブックの固定文字を一番上にセット
lstBOOKを使用可能にする
起動されているExcelオブジェクトを探し、lstBOOKにブック名をセットする。

コントロール名：lstBOOK       リストボックス
リスト内が選択されたら、
新規ブックだったら、lstSHEETSに新規シートをセット、使用可能にして抜ける
選択されたブック内のシートを探し、lstSHEETSにリストアップする(.addする)

コントロール名：lstSHEETS     リストボックス
リスト内のシートが選択されたら、Excel出力ボタン(btnTOEXCEL)を使用可能とする

コントロール名：btnTOEXCEL    ボタン
確認メッセージを表示して
選択されたテーブル(lstWEBTABLE)のデータを
lstBOOK,lstSHEETSへ出力する。

と、ここまで、行数を使って書きましたが、
まだまだ足りなかったりします。
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
えっ、これ以上書くと設計者がコーディングしているようなもの？
まぁ、それくらい書いておくと、意思の疎通がうまくいくかなぁ。

※実は、設計した時点で、できている、
　そんな設計ならバグも少なかったりするんだけど
　手を抜き過ぎて、設計やらないで作り始めると(渡すと)
　痛い目にあったり・・・・

/*
 * ３．終わりの挨拶
*/

どんな情報があれば、プログラムを作り始められるか・・・
意外と奥が深かったりします。
単純な画面１枚を作成するだけなら、名前と動きだけでいいけど、
全体的なデータの流れ、DBの入出力なども、必要になってきます。

今回は、
オブジェクト と イベントが書いてあれば、わかりやすい、
そんな話でした。

あまり、テクニック的なネタじゃないのですが、
何か、感じ取ってくれると、うれしいです。

ＡＢ型の変わり者、三流プログラマーのＫｅｎ３でした。

ページフッター

ここまで、読んでいただきどうもです。ここから下は、三流君のホームページの紹介・案内です
目的の情報が見つかったか？少々心配しつつ、、、

種類別のリンクや広告など

気になったジャンル↓を選択してください。

人気記事(来場者が多いTOP3):
[VBAでIE,WebBrowserを操作]・・・VBAでIE,WebBrowserを操作するサンプルです
[Access から Excel 連携 CreateObject("Excel.Application")]・・・AccessからExcelを操作したりデータの書き出しなどです
[VBAでOutlookの操作 CreateObject("Outlook.Application" )]・・・VBAからOutlookを使い、メール関係を処理するサンプルです
↑上記３つみたいなCreateObjectで他のアプリケーションを操作するサンプルが人気です。

Excel関係:
[Excel UserFormを操作する]・・・エクセルでユーザーフォームを作成して入力などを行ってます
[ExcelからAccessを操作する]・・・ExcelからAccessのマクロを起動してみました、
[Excel関係関数、その他]・・・その他Excel関係です

Access関係:
[Access UserForm/サブフォーム操作]・・・アクセスでフォームを使ったサンプルです
[Access レポート操作]・・・レポートを操作してみました
[Access クエリーやその他関数]・・・あまりまとまってませんが、スポット的な単体関数の解説です

その他：VBAの共通関数やテキストファイルの操作など
[VBAでテキストファイル(TextFile)の操作]・・・普通のテキストファイルを使ったサンプルです
[VBA 標準関数関係とその他解説]・・・その他、グダグタ解説してます

開発時の操作: [F1を押してHELPを見る]/ [Debug.Print とイミディエイトウインドウ]/ [実行時エラーでデバッグ]/ [ウォッチ式とSTOP]/ [参照設定を行う]

仕様書(設計書？) XXXX書類: [基本設計書や要求仕様書]/ [テスト仕様書テストデータ]/ [バグ票]/ [関数仕様書]/ [流れは入力・処理・出力]

※↑文章の味付けが変わっていて、お口に合うかわかりませんが。。。
※※読んで、気分を悪くされたらスミマセン。

Blogとリンク:[三流君の作業日記]/ [VBAやASPのサンプルコード]/ 広告-[通販人気商品の足跡]

[三流君(TOP ken3.org へ戻る)] / [VBA系TOPへ] / [VBA系バックナンバー目次へ移動]

詳細な設計って？

発行内容