この間excelファイルの出力機能を実装したので記事を書くことにしました。 今回は下記のような順で解説していきます。 前書きプログラミングする場合、excelファイルを出力する機能はよくあるニーズでしょう。 excelファイルの出力機能を備えば、大量のデータをexcelファイルに出力することができるようになります。後で、ユーザがOffice Excelアプリで開くことができるので参照、編集にも便利になりますね。 そして、データ一括入力の一環として事前にフォーマット（仕様）付きのexcelファイルを出力すると、システムに登録したいデータをそのexcelファイルに書き込み、後でシステムに読み込ませることができるので、大量データの登録作業も楽になるでしょう（データを1件ずつ入力するよりは）。 データの出力、入力には一番簡単なCSVファイルを使うのもよくありますが、ケース・バイ・ケースでしょう。C

基本設計を終えて、次は詳細設計。 だけど詳細設計書ってうまく書けないんだよな。。 プログラムもあまり経験してこなかったし。 いったい何を書けばいいのか。。

詳しすぎる詳細設計書 - SiroKuro Page の続きです。前の記事ではブクマありがとうございました。 はてな界隈の拒否反応を見る限り、詳しすぎる詳細設計書に良い印象を持ってる人は少なそうです。もっとも、私は良い面も持っていると思っていまして、 プログラマの技術的知識や業務的知識の量に左右されることなく、一定の品質を保つことができる なんてメリットがあります。属人性の排除ですね。 あたりまえですね。実は設計者が書いたプログラムを詳細設計書と呼んでいるんですから。しかもテストどころか処理系に食わせてすらいないプログラムです。悪く言えば机上の空論です。良く言えば……絵に描いた餅？ プログラマの技能に左右されないかわりに設計書の品質に左右されるので、一定の品質が「悪い方に一定」だったりすることもあって、色々と下流工程の鬱憤が溜まりそうです。既に溜まっていますね、ごめんなさい。 本題：古き悪

SIerの常識：「誰が書いても同じソースコードになるように、詳細な実装方法の記述された設計書を書かなければならない」 プログラマの常識：「誰が書いても同じソースコードになるような設計書は書くだけ無駄、誰が書いても同じ振る舞いをするように、詳細に振る舞いを記述した設計書を書かなければならない。」 プログラムを作るうえで設計書や、仕様書の類は欠かすことができない だが、設計書や仕様書をちゃんと作っているプロジェクトでもよくデスマーチに陥っている。 なぜか？「設計書に記載するべき内容が間違っている」からだ。 （設計が間違っている場合も多々あるが。） 間違ったことをまじめにやっても良い結果は得られない。 「誰が書いても同じコード」は大事なことなのか - yvsu pron. yas 昨日、大手SIerの方々と話をする機会があって、そこで出てきたのが、「誰が書いても同じコード」になることが重要で、そ

詳細設計書の書き方については黙っていられないので、ちょっと意見を言わせてもらう。 私も「詳しすぎる詳細設計書 - SiroKuro Page」で示されているようなコードと１対１に対応したような詳細設計書は、書くだけ無駄だと思っている。ただ、ちゃんとした詳細設計書をつくるなら、処理内容（内部の処理の実装方法）の書き方をどのように実装言語に合せるかではなく、処理内容を一切書かないようにするべきだと考えている。 なぜなら、処理内容をいくら詳細に記述したところで、それは仕様ではなくコードであり、仕様の代わりに記述したコードでは、バグも含めて記述されているため、そのコードのみでは正しいか間違っているかを判定できないからだ。 コードの他にどういった動作が正しいのかを判定する基準が必要で、その基準が仕様であり、詳細設計書にはその仕様を記述する必要があると考えている。 現に、例として示された処理概要では、

WEBアプリ開発のプロジェクトで詳細設計書を一から作成することになったので、 これを機に「詳細設計書に必要な最低限の記載内容」の再確認とメモ書きφ(..) また別プロジェクトで一から書くことになった時の判断基準にするためにも。 本題に入る前に、前提知識をザックリと。 詳細設計書は、上流工程の 「要件定義」 クライアントの要望とその要望をどのように叶えるのかを明確にする。 ↓ 「外部設計」 要件定義で決まった内容をもとに、画面や帳票、操作性などのユーザーインターフェースを設計する。 外部システムと連携する部分の仕様を設計し、内部設計の土台を作る。 ↓ 「内部設計」 外部設計で決まった内容をもとに、システムとして何を使ってどう実現していくかを具体的に定めていく。←★ここの工程で必要になる設計書 一先ず、 ・外部設計で作成する「基本設計書」はどちらかというとクライアント向けの設計書。 ・内部設計