• ベストアンサー

外部仕様書の書き方

はじめまして いつもお世話になっております。 今日から 外部仕様書を書くということになったのですが 普通の企業ならある文書フォーマットというのが 私の会社にはありません。 しかしぐぐってみても標準フォーマットなどが なく 困っています。 外部仕様書とはどのように書くのでしょうか どうぞよろしくお願い致します。

質問者が選んだベストアンサー

  • ベストアンサー
  • A98JED
  • ベストアンサー率28% (221/778)
回答No.2

お客さんに説明する為のものですので、お客さんが分かる形式で作るしかありません。 お客さんに、過去のプロジェクトの外部仕様書を見せていただいたらいかがでしょうか。 外部仕様書の必要要件の確認と参考のために見せてくださいといえば 見せてくれると思います。 全くそういうものが無かった場合には先輩に頼むしか無いでしょう。 必ず書かなくてはならないものとして ・システムの大まかな概要を規定   目的、対象など ・システム持つ機能の規定   機能、処理など ・システムのインタフェースの規定  外部システムとの連携や手入力の手段やデータ、機器についての規格など さらに盛り込んでおけばもっと良いものとして ・ハードウェアの構成  サーバー/クライアント台数や性能(CPU、ハードディスク、メモリなど) ・実行環境OSや使用するアプリケーションなど  OSの種類(windows、Linaxなど)DBMSの種類(Oracle、SQLserverなど)およびそのバージョン、それぞれのサーバーや端末でどれを使用するのか。 ・開発に使用するプログラミング言語の決定  言語の種類およびバージョン(C++、JAVA、VB.NETなど) ・開発に要する費用予算額、期間、稼動の順序  開発に必要な機材、OSやアプリケーションソフトウェアの購入はどちら持ちか。いつまでにどのような機能をどのような順で開発し稼動させるか。 http://www.ipa.go.jp/security/fy12/contents/crack/sekitoku/gaibusekeisyo.pdf

haru0925
質問者

お礼

ありがとうございます。 今回の外部仕様書というのは 会社内部での外部仕様書ということで 上司=お客様と考えて作成しなくてはいけないようです。

その他の回答 (1)

回答No.1

仕様書の種類は多種多様で、 企業によっても異なりますが、 とりあえず、うちの場合で回答します。 外部仕様書はしいて言えば、ブロック図みたいなもんです。 作りたい物を大まかな機能で分け、 その機能がどのような形でほかと結びついているのかを示します。 小さい規模のシステムならば、ここでファイル単位の説明まで落とし込んでもかまいません。 (小さいというのは、ほぼ単機能の業務をこなす場合のみです。) 内部仕様書は、その大まかな機能を、 関数レベルにまで落とし込んだものです。 とはいえ、関数の中の詳細まで書く必要はありません。 こんな関数があれば、システムができる。ということを示すだけです。 (っていうか、関数の中身まで書いていたら、仕事にならない)

haru0925
質問者

お礼

ありがとうございます。 外部仕様書を上司に提出した後 内部仕様書を書き プログラムを組むそうですが それが残り一ヶ月・・・ 間に合うかわかりませんが 頑張ってやってみたいと思います

関連するQ&A

  • 外部委託していたテスト仕様書の評価にかなりの時間がとられます。どうのように短縮されてますか?また、見積もりされてますか?

    テスト仕様書作成を外部委託しているのですが、委託先から提出される仕様書を確認する作業に多くの時間がさかれます。 委託作業の評価はどうのように対応されてますか? 私はプロジェクトリーダで管理もしていますが、作業要員の一人でもあり、評価にかかる時間は見積もりには考慮していませんでした。弊社は親会社からソフト開発全般を請負受注しております。外部委託するのは弊社の都合なので、外部委託した作業の評価という時間は見積もりに入れれない気がするのですが、どうでようか? このような際はどのように見積もってられますか? 委託先には過去の別プロジェクトで作成したテスト仕様書をサンプルとして渡してします。一部ファイルの分け方など、サンプルと異なる指定をしていますが、基本的にはサンプルと同じ書き方で、と指定しています。一度に提出されると見切れないので、1週間に一度提出してもらって確認しています。作業は私の会社内ではなく、委託先企業で行ってもらっています。 お尋ねしたいのですが、修正依頼する際、このように作業場所が離れている場合どのような形で修正内容を伝えておられますか? 私は最初のうちは指摘文書リストで指摘したのですが、文書では具体的にどのように直してよいかわかりにくいということなので、テスト仕様書で具体的に文書に削除/追加内容がわかるように手を加えて、噴出しなどをつけて提供しています。しかし、これがまた時間がかかるんですよねぇ。

  • 仕様書の見本等参考になるものはないでしょうか?

    システム仕様書~内部設計書等で参考になるもの-サンプルを探しています。 ○○風に書くべきだ・○○を書く等の仕様書論みたいな書籍はいくつか見つかるのですが、インターネット・本屋を探しましたが、見つけれませんでした。 本物の仕様書は企業秘密なので、公開されているものは皆無でしょうが、オープンなプロジェクトや仮想上のシステムの仕様書等、何か公開されているもので参考になるものはないでしょうか? 探しているのは、システム設計書・外部・内部等上中位層の仕様書です。 電化製品等でも参考になると思うので、電化製品等でもすごく歓迎です。 ※建設業界だと「標準仕様書」なるものが存在するのですが、ソフトウェアではこういったものはないのでしょうか?

  • 仕様に無い解像度の外部ディスプレイ

    外部ディスプレイを買おうとしています。 外部ディスプレイが最大UXGA 1600x1200までサポートしているが、WSXGA+ 1680x1050が仕様に書かれていないPC(具体的にはhttp://panasonic.jp/pc/support/products/y2c/spec.html)に、最適解像度が WSXGA+ のディスプレイ(具体的にはhttp://www1.jp.dell.com/content/products/productdetails.aspx/e207wfp)を繋いだ場合、UXGAでの表示は出来そうですが、WSXGA+ での表示はやはり出来ないのでしょうか? それとも総ピクセル数が最大のUXGAより小さいので可能でしょうか? 無理やりUXGAで使うと実際のピクセル数と合わないのでぼやけると思われ、可能ならWSXGA+で使いたいです。 それが駄目なら、より高価なUXGA標準20インチか、より安価なSXGA標準19インチにしようかと思っています。 SXGA+標準のディスプレイがあれば一番なのですが、無いですよね。

  • 外部SVGファイルを埋め込むには

    XHTML 1.1文書に外部image/svg+xmlオブジェクトを埋め込む場合、仕様上は <img src="alter.svg" alt="some description" width="88" height="31" /> で良いのでしょうか? ご回答よろしくお願い致します。

    • ベストアンサー
    • HTML
  • BSP仕様とは?

    セラミック、ケイ素系の加工品を勉強しております。 仕様内容で、標準仕様とBSP仕様とあります。 BSP仕様とは一体どの様な意味でしょうか? 困ってます。御教示頂きたいです。 宜しくお願い申し上げます。

  • ナビを外部から隠すには?

    いつもお世話になっております。 ホンダ車に社外のインダッシュナビを付けているのですが、 外部からモニターなどがまる見えです。そして取られました…。(泣) また同じものを付けるのですが、なにかカバーというか、 外から見て純正ナビと見間違える様な感じにできないものでしょうか? そういうものがありましたら、教えてください。 よろしくお願い致します。

  • SEが仕様書を書けない

    SEから仕様書作成を依頼されたユーザーです。 かなり有名な日本の企業なのですが、SEが仕様書をユーザーに依頼するのは、変ではないでしょうか。 普通、システムの仕様書は、SEが書くものとばかり思っていました。 ソフトも機能不十分で、あまり良いものではありません。

  • アプリケーションの仕様書の作り方

    アプリケーションの仕様書の作り方 趣味で携帯電話用のアプリを作っています。最近になり作った数も増え、少しは複雑な事も出来るようになりました。そうなってくると、後で自分が作った物を再利用したくても、何を考えて作ったのか全く思い出せません。何かしら文書の形で資料を残さねばとは思うのですが、仕様書のようなものを作ったことが無いので、どうすれば良いか皆目見当がつきません。 ぱっと思いつくところでは ・どんなアプリか:概要 ・動作フロー ・変数一覧(デバイスリスト) ・関数一覧 ・通信を伴う部分では、リクエストURLやパラメータ などがあるかと思います。こんなフォーマットで作ると良い、こんな事を書くと良い、といったアドバイスを頂けたらありがたいです。よろしくお願いします。

  • 見積仕様書の書式について

    私は一般産業用設備機械の会社から仕事をもらっていますが その会社には見積仕様書のフォーマットがありません。 どなたか提供いただけるサイト等ありませんか? なんとしてでも入手したいです。

  • 仕様書の表記について

    仕様書を書くにあたって数字や文字を表記する場合に "zzz9"とか時間では"yyyy/mm/dd"と表記すると思うのですが、それらの標準的な説明を書いたURLとかご存知のかたおられますでしょうか? 検索してもうまく検索できませんでした・・・ 具体的に何が知りたいかと言いますと ここに表示する値は数字何桁であるとか、ここには英数字のみとか 文字列何文字とかっていうフォーマットを表記したいのです。 よろしくお願いします。

専門家に質問してみよう