Microsoft Visual SourceSafe タスク ユーザーマニュアル

作成者

• Craig Cottingham
• Andrew Everitt
• Balazs Fejes 2
• Glenn_Twiggs@bmc.com
• Martin Poeschl (mpoeschl@marmot.at)
• Phillip Wells
• Jon Skeet (jon.skeet@peramon.com)
• Nigel Magnay (nigel.magnay@parsec.co.uk)
• Gary S. Weaver
• Jesse Stockall

目次

• はじめに
• タスク

はじめに

これらのタスクは、Microsoft Visual SourceSafe SCMへのインターフェースを提供します。 org.apache.tools.ant.taskdefs.optional.vss パッケージは、VSS機能をサポートするためのシンプルなフレームワークと、頻繁に使用されるVSSコマンドをカプセル化したいくつかのApache Antタスクで構成されています。これらのコマンドはデスクトップで使用することもできますが、主に自動ビルドシステムで使用することを目的としています。

実行時に CreateProcess error=2 が発生した場合は、ss.exe が見つからないことを意味します。コマンドラインから実行できるかどうかを確認してください。パスを変更するか、ssdir プロパティを設定する必要がある場合があります。

タスク

タスクの説明

VssGet

説明

Microsoft Visual SourceSafeに対してGETコマンドを実行するタスク。

version、date、labelの属性を2つ以上指定した場合、version、date、labelの順序で1つだけ使用されます。

パラメータ

version、date、labelのいずれか1つのみを指定する必要があることに注意してください

例

ユーザー名 me とパスワード mypassword を使用して、VSSプロジェクト $/source/myproject に対してgetを実行します。これにより、Release1 というラベルが付いたファイルが再帰的に取得され、ローカルディレクトリ C:\mysrc\myproject に書き込まれます。ローカルファイルは書き込み可能になります。

<vssget localPath="C:\mysrc\myproject"
        recursive="true"
        label="Release1"
        login="me,mypassword"
        vsspath="$/source/aProject"
        writable="true"/>

VssLabel

説明

Microsoft Visual SourceSafeに対してLABELコマンドを実行するタスク。

指定されたバージョンまたはファイルまたはプロジェクトの現在のバージョンにラベルを割り当てます。

パラメータ

例

ユーザー名 me とパスワード mypassword を使用して、VSSプロジェクト $/source/aProject の現在のバージョンに Release1 というラベルを付けます。

<vsslabel vsspath="$/source/aProject"
          login="me,mypassword"
          label="Release1"/>

VSSファイル $/source/aProject/myfile.txt のバージョン4に 1.03.004 というラベルを付けます。このバージョンに既にラベルが付いている場合、操作（およびビルド）は失敗します。

<vsslabel vsspath="$/source/aProject/myfile.txt"
          version="4"
          label="1.03.004"/>

VssHistory

説明

パラメータ

変更を確認したいユーザーの名前

期間の指定

• 評価する期間を指定するには、さまざまな方法があります
• 2つの日付間の変更：fromDate と toDate の両方を指定します
• 特定の日付より前の変更：toDate を指定します
• 特定の日付より後の変更：fromDate を指定します
• 特定の日付のX日前の変更：toDate と（負の）numDays を指定します

例

特定の日付のX日後の変更：fromDate と numDays を指定します

<vsshistory vsspath="$/myProject" recursive="true"
            fromLabel="Release1"
            toLabel="Release2"/>

Release1 と Release2 の間のすべての変更を表示します。

<vsshistory vsspath="$/myProject" recursive="true"
            fromDate="01.01.2001"
            toDate="31.03.2001"/>

2001年1月1日から2001年3月31日までのすべての変更を表示します（ドイツでは、日付はロケールに従って指定する必要があります）。

<tstamp>
  <format property="to.tstamp" pattern="M-d-yy;h:mma"/>
</tstamp>

<vsshistory vsspath="$/myProject" recursive="true"
            numDays="-14"
            dateFormat="M-d-yy;h:mma"
            toDate="${to.tstamp}"/>

過去2週間のすべての変更を表示します。

説明

VssCheckin

パラメータ

例

Y、N、または空。VSSからの質問にどのように回答するかを指定します。

<vsscheckin vsspath="$/test/test*"
            localpath="D:\build\"
            comment="Modified by automatic build"/>

ローカルディレクトリ D:\build を使用して、プロジェクト $/test 内の test* という名前のファイルをチェックインします。

説明

VssCheckout

Microsoft Visual SourceSafeに対してCHECKOUTコマンドを実行するタスク。

パラメータ

例

ファイルのローカルコピーを取得するように動作を設定します。

<vsscheckout vsspath="$/test"
             localpath="D:\build"
             recursive="true"
             login="me,mypass"/>

プロジェクト $/test をディレクトリ D:\build に再帰的にチェックアウトします。

説明

パラメータ

例

VSSに追加するローカルファイルを指定します

<vssadd localpath="D:\build\build.00012.zip"
        comment="Added by automatic build"/>

build.00012.zip という名前のファイルを、現在の作業ディレクトリ（vsscp を参照）のプロジェクトに追加します。

説明

VssCp

Microsoft Visual SourceSafeに対してCP（Change Project）コマンドを実行するタスク。

パラメータ

例

現在のプロジェクトにするプロジェクトを指定するSourceSafeパス。

<vsscp vsspath="$/Projects/ant"/>

現在のVSSプロジェクトを $/Projects/ant に設定します。

説明

VssCreate

Microsoft Visual SourceSafeに対してCREATEコマンドを実行するタスク。

パラメータ

例

プロジェクトの作成中にエラーが発生した場合に失敗します。

<vsscreate vsspath="$/existingProject/newProject"/>