ソフトウェア開発部品質管理(VSS)チームブログの第5回目です。
今回はメールで成果物を納品する場合に、注意すべき点などをまとめた納品メールの雛形について、紹介します。
納品メールには納品物のリスト、環境設定手順、注意事項等を記述します。
▼納品物のリスト
納品物のフォルダ構成に沿った、階層構造で示すとわかりやすいと思います。
<例> XziNet
∟src
| ∟batch
| ∟@@@.wsf
| ∟Const.vbs
| ∟XziNet.root
|
∟doc
| ∟マスタデータ.mdb
| ∟サーバー環境について.txt
|
∟sql
∟■■■.sql
∟●●●.sql
▼環境設定手順、注意事項など
VSSチームで作成した雛形には、DB環境、ASP環境、.NET環境等、
様々な環境の違いに応じた文面のサンプルを用意し、
初めて納品を行う人でも、注意すべき点、書かなければならない設定方法などが、
一目でわかるようにしています。
また、何度もメールにて納品を行っている人は、チェック項目としても活用できます。
<例>
・ASP環境
[XziNet.root]フォルダをサーバーの[Scripts]フォルダ内にコピーし、
アプリケーションに設定して下さい。
※[XziNet.root]フォルダ内のフォルダ構成については、
添付の[doc]フォルダ内、[サーバー環境について.txt]に記述してありますので
確認して下さい。
また、各種環境設定は、
[\XziNet.root\common\Const.inc]
内の定数に記述してありますので、そちらの環境に合わせて変更して下さい。
同様に、以下のパスにあるメール送信のバッチ用の定数ファイルについても
変更して下さい。
[\src\batch\common\Const.vbs]
・.NET環境
※ソースを送付する場合
各種環境設定は、
[\src\XziNet.root\web.config]
内の、[164行目]~[184行目]にて行ってください。
要変更箇所と記述してある箇所について、そちらの環境に合わせて変更して下さい。
※dllのみを送付する場合
1.DLLについて
[XziNet.root\binフォルダ]配下にファイルの置き換えをお願いします。
2.ストアドプロシージャについて
(1)Windowsのスタートメニューから[Microsoft SQL Server]-[Enterprise Manager]
を起動してください。
(2)[データベース]-[■■■]を選択した状態で、
メニューの[ツール]-[SQLクエリアナライザ]をクリックします。
(3)[SQLクエリアナライザ]のウィンドウにて[クエリ]となっているウィンドウに
[■■■.sql] をドラッグします。
(4)メニューの[クエリ]-[実行(E)]をクリックするとストアドが上書きされます。
(5)[●●●.sql]についても同様に(3)(4)を実行してください。
以上で完了です。
・メールの送信には、別システムと同様に、
Basp21.dllを使用しておりますので、
テスト用サーバーにインストールされていなければ、
[http://www.hi-ho.ne.jp/~babaq/basp21.html]
より、Ver.○○をダウンロードしてインストールして下さい。
納品を行う際のメールを作成するときの一番のポイントは、
納品物を受け取る方がスムーズに環境設定を行うことが出来るよう、
相手の方の立場に立った、わかりやすいメールを心がけるということです。
参考にしてみてください。