2008.07.28

納品時のメールの注意点

ソフトウェア開発部品質管理(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.○○をダウンロードしてインストールして下さい。


納品を行う際のメールを作成するときの一番のポイントは、
納品物を受け取る方がスムーズに環境設定を行うことが出来るよう、
相手の方の立場に立った、わかりやすいメールを心がけるということです。

参考にしてみてください。

コメントを投稿

(いままで、ここでコメントしたことがないときは、コメントを表示する前にこのブログのオーナーの承認が必要になることがあります。承認されるまではコメントは表示されません。そのときはしばらく待ってください。)

photo
matsumoto