[三流君] －－＞ [ＶＢＡで楽しく] －－＞ [バックナンバー一覧]
－－＞ 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の入出力なども、必要になってきます。

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

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

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

フィードバック

VBA系の→[掲示板]←を覗く、質問を書き込む

評価・感想

ページフッター(リンクや広告など)

[三流君(TOP ken3.org へ戻る)]
-- [VBA系TOPへ]
---- [VBA系バックナンバー目次へ移動]
------ [VBAでIEを操作 CreateObject("InternetExplorer.application")]・・・実は当店一番人気、VBAでIEを操作するサンプルです
------ [VBAでOutlookの操作 CreateObject("Outlook.Application")]・・・Outlookを使い、メール関係の処理です
------ [Access から Excel 連携 CreateObject("Excel.Application")]・・・人気のAccessからExcelへデータ書き出しなどです
------ [AccessのUserForm/サブフォームを操作]・・・アクセスでフォームを使ったサンプルです
------ [Accessのレポートを操作]・・・レポートを操作してみました
------ [Access クエリー関係やその他関数]・・・あまりまとまってませんが、スポット的な単体関数の解説です
------ [Excel UserForm(ユーザーフォーム)を操作する]・・・エクセルでユーザーフォームを作成して入力などを行ってます
------ [ExcelからAccessを操作する]・・・ExcelからAccessのマクロを起動してみました、
------ [Excel関係関数、その他]・・・その他Excel関係です
------ [VBAでテキストファイル(*.txt,*.html,*.csv)の操作]・・・テキストファイルを使ったサンプルです
------ [VBA 標準関数関係とその他解説]・・・その他、グダグタ解説してます

広告
-- [通販系の売れ筋広告へ] ←主に楽天やAmazonのランキングです
blog
-- [三流君の作業日記] ← 日々の作業を少々
-- [通販あしあと] ← 通販ページの足跡を一覧で羅列

情報を探す

情報を探すならGoogleかな？

↓Web全体、サポート情報(support.microsoft.com)や三流君VBA(ken3.org)から検索する

あとは、項目別にMSでお勉強かな？
◆ マイクロソフトサイトの歩き方
◇ How-To インデックス
◇ FAQ インデックス
◇ スキルレベル別おすすめコンテンツ
◇ テクノロジマップ
◇ テーマ別技術資料一覧

書籍の購入

Webだけじゃさすがに勉強しきれないので、プログラミング関係の書籍も読んでみては？？

コンピュータ書籍の発送がハヤイ専門店

コンピュータの本・専門店

※種類が豊富で探し易いです。※在庫ありが48時間以内発送が急ぎで資料や書籍がほしい時、とても助かります。
お奨め本の目次を見るだけでも勉強になったり

amazon.co.jpでキーワード別チェック

下記、私が設定したキーワードですが、こんな感じで資料や書籍を探ってみては？
[VBA全体を把握する] -- やはり全体をさらっと見たいですよね。
[SQL関連でＤＢ力UP] -- システムはデータベース設計が重要
[ADO接続を探る] -- VBAなのでADO接続を押さえておく
[Windows APIを探る] -- さらにAPIになて知ってれば強力だ！
[.NETを探る] -- と言っても時代は.NETに流れてるし
プログラミング以外でも知りたいことは多くって、
[人間関係] -- で、客先・上司、まわりに気を使い。
[プログラマーの自己啓発] -- プログラムだけじゃなくいろいろと向上したいよ
[コーチング・育成] -- 先輩になったら後輩(部下)の面倒をみてね。
そんなこんなでプログラマーっていろいろと大変なんだってば・・・

詳細な設計って？

発行内容