作成者
Curtis White (cwhite at aracnet dot com),
Sean P. Kane (spkane at genomatica dot com),
Rob Anderson (Anderson.Rob at vectorscm dot com), および
Sean Egan (sean at cm-logic dot com)
バージョン 1.6 — 2003/02/25
Apache Ant は、ClearCase で作業するためのいくつかのオプションのタスクを提供します。これらのタスクは、cleartool プログラムを使用した様々な ClearCase コマンドに対応しています。Ant で利用可能な現在のタスクは、重要な ClearCase コマンドのごく一部に対応しているだけです。
ClearCase クラスから派生し、その ClearCase コマンドに固有の機能を追加することで、さらに多くのタスクを簡単に追加できます。
重要: これらのタスクはすべて、コマンドラインで cleartool を必要とします。タスクが `IOException`、特に Windows で `error=2` で失敗した場合は、これが原因です。
ClearCase に cleartool checkin コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| viewpath | コマンドが動作する ClearCase ビューファイルまたはディレクトリへのパス | いいえ |
| comment | コメントを指定します | いいえ; 2 つのうち 1 つのみ使用できます |
| commentfile | コメントを含むファイルを指定します | |
| nowarn | 警告メッセージを抑制します | いいえ |
| preservetime | 変更時刻を保持します | いいえ |
| keepcopy | .keep 拡張子を持つファイルのコピーを保持します | いいえ |
| identical | 元のファイルと同一の場合でも、ファイルをチェックインできます | いいえ |
| failonerr | コマンドが失敗した場合に例外をスローします | いいえ; デフォルトは true |
ファイル c:/views/viewdir/afile に対して ClearCase `checkin` を実行します。ファイル acomment.txt からのコメントテキストが、コメントとして ClearCase に追加されます。すべての警告メッセージは抑制されます。元のファイルと同一の場合でも、ファイルはチェックインされます。
<cccheckin viewpath="c:/views/viewdir/afile"
commentfile="acomment.txt"
nowarn="true"
identical="true"/>
ClearCase に cleartool checkout コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| viewpath | コマンドが動作する ClearCase ビューファイルまたはディレクトリへのパス | いいえ |
| reserved | ファイルを予約済みとしてチェックアウトするかどうかを指定します | はい |
| out | 異なるファイル名で書き込み可能なファイルを作成します | いいえ |
| nodata | ファイルをチェックアウトしますが、そのデータを含む編集可能なファイルは作成しません | いいえ |
| branch | ファイルをチェックアウトするブランチを指定します | いいえ |
| version | `/main/LATEST`（またはコンフィグスペクで選択されたもの）以外のバージョンをチェックアウトできます | いいえ |
| nowarn | 警告メッセージを抑制します | いいえ |
| comment | コメントを指定します | いいえ; 2 つのうち 1 つのみ使用できます |
| commentfile | コメントを含むファイルを指定します | |
| notco | 現在のビューに既にチェックアウトされている場合に失敗します。falseに設定すると無視されます。 Ant 1.6.1 以降 |
いいえ; デフォルトは true |
| failonerr | コマンドが失敗した場合に例外をスローします。 Ant 1.6.1 以降 |
いいえ; デフォルトは true |
ファイル c:/views/viewdir/afile に対して ClearCase `checkout` を実行します。abranch というブランチで予約済みとしてチェックアウトされます。すべての警告メッセージは抑制されます。「Some comment text」がコメントとして ClearCase に追加されます。
<cccheckout viewpath="c:/views/viewdir/afile"
reserved="true"
branch="abranch"
nowarn="true"
comment="Some comment text"/>
ClearCase に cleartool uncheckout コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| viewpath | コマンドが動作する ClearCase ビューファイルまたはディレクトリへのパス | いいえ |
| keepcopy | .keep 拡張子を持つファイルのコピーを保持するかどうかを指定します | いいえ |
| failonerr | コマンドが失敗した場合に例外をスローします。 Ant 1.6.1 以降 |
いいえ; デフォルトは true |
ファイル c:/views/viewdir/afile に対して ClearCase `uncheckout` を実行します。c:/views/viewdir/afile.keep という名前のファイルのコピーが保持されます。
<ccuncheckout viewpath="c:/views/viewdir/afile" keepcopy="true"/>
ClearCase に cleartool update コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| viewpath | コマンドが動作する ClearCase スナップショットビューファイルまたはディレクトリへのパス | いいえ |
| graphical | 更新中にグラフィカルダイアログを表示します | いいえ |
| log | ClearCase が書き込むログファイルを指定します | いいえ |
| overwrite | ハイジャックされたファイルを上書きするかどうかを指定します | いいえ |
| rename | ハイジャックされたファイルに .keep 拡張子を付けて名前を変更することを指定します | いいえ |
| currenttime | 変更時刻を現在時刻として書き込むことを指定します。 preservetime とは相互に排他的です。 | いいえ |
| preservetime | 変更時刻を VOB 時刻から保持することを指定します。 currenttime とは相互に排他的です。 | いいえ |
| failonerr | コマンドが失敗した場合に例外をスローします。 Ant 1.6.1 以降 |
いいえ; デフォルトは true |
スナップショットビューディレクトリ c:/views/viewdir で ClearCase `update` を実行します。グラフィカルダイアログが表示されます。出力は log.log にログされ、ハイジャックされたファイルは上書きされます。変更時刻は現在時刻に設定されます。
<ccupdate viewpath="c:/views/viewdir"
graphical="false"
log="log.log"
overwrite="true"
currenttime="true"
rename="false"/>
ClearCase に cleartool mklbtype コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| typename | 作成するラベルタイプの名前 | はい |
| vob | VOB の名前 | いいえ |
| replace | 同じタイプの既存のラベル定義を置換します | いいえ |
| global | VOB 全体、またはこの VOB を使用する VOB にグローバルなラベルタイプを作成します。 | いいえ; 2 つのうち 1 つのみ使用できます、デフォルト ordinary=true |
| ordinary | 現在の VOB でのみ使用できるラベルタイプを作成します。 | |
| pbranch | 特定の要素のバージョンツリー内のブランチごとに 1 回、ラベルタイプを使用できるようにします | いいえ |
| shared | ClearCase による所有権チェックの方法を設定します。詳細については、ClearCase のドキュメントを参照してください。 | いいえ |
| comment | コメントを指定します | いいえ; 2 つのうち 1 つのみ使用できます |
| commentfile | コメントを含むファイルを指定します | |
| failonerr | コマンドが失敗した場合に例外をスローします。 Ant 1.6.1 以降 |
いいえ; デフォルトは true |
VERSION_1 という名前のラベルタイプを作成するために ClearCase `mklbtype` を実行します。これは通常のタイプとして作成されるため、現在の VOB でのみ使用できます。「開発バージョン 1」というテキストがコメントとして追加されます。
<ccmklbtype typename="VERSION_1"
ordinary="true"
comment="Development version 1"/>
ClearCase に cleartool mklabel コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| typename | ラベルタイプの名前 | はい |
| viewpath | コマンドが動作する ClearCase ビューファイルまたはディレクトリへのパス | いいえ |
| replace | 同じブランチにある同じタイプのラベルを置換します | いいえ |
| recurse | viewpath の下の各サブディレクトリを処理します | いいえ |
| version | ラベルを付ける特定のバージョンを識別します | いいえ |
| vob | VOB の名前 | いいえ |
| comment | コメントを指定します | いいえ; 2 つのうち 1 つのみ使用できます |
| commentfile | コメントを含むファイルを指定します | |
| failonerr | コマンドが失敗した場合に例外をスローします。 Ant 1.6.1 以降 |
いいえ; デフォルトは true |
バージョン 2（\main\2）の main ブランチの下にあるファイル c:/views/viewdir/afile に対して ClearCase `mklabel` を実行します。「Some comment text」というテキストがコメントとして追加されます。すべてのサブディレクトリを再帰的に処理します。
<ccmklabel viewpath="c:/views/viewdir/afile"
comment="Some comment text"
recurse="true"
version="\main\2"
typename="VERSION_1"/>
ClearCase に cleartool rmtype コマンドを実行するタスク。
| 属性 | 値 | 必須 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| typekind | 作成するタイプの種類。有効なタイプは
|
はい | ||||||||||||||
| typename | 削除するタイプの名前 | はい | ||||||||||||||
| ignore | トリガータイプでのみ使用されます。事前操作トリガーが削除を妨げる場合でも、トリガータイプの削除を強制します | いいえ | ||||||||||||||
| rmall | タイプとそのタイプオブジェクトのすべてのインスタンスを削除します | いいえ | ||||||||||||||
| comment | コメントを指定します | いいえ; 2 つのうち 1 つのみ使用できます | ||||||||||||||
| commentfile | コメントを含むファイルを指定します | |||||||||||||||
| failonerr | コマンドが失敗した場合に例外をスローします。Ant 1.6.1 以降 | いいえ; デフォルトは true |
VERSION_1 という名前のラベルタイプ（lbtype
）を削除するために ClearCase `rmtype` を実行します。ファイル acomment.txt からのコメントテキストがコメントとして追加されます。タイプオブジェクトを含む、タイプのすべてのインスタンスが削除されます。
<ccrmtype typekind="lbtype"
typename="VERSION_1"
commentfile="acomment.txt"
rmall="true"/>
ClearCase に cleartool lock コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| replace | 既存のロックを置換することを指定します | いいえ |
| nusers | オブジェクトを依然として変更できるユーザーを指定します | いいえ |
| obsolete | オブジェクトを廃止済みとしてマークすることを指定します | いいえ |
| comment | コメントフィールドの入力方法を指定します | いいえ |
| pname | ロックするオブジェクトのパス名を指定します。 | いいえ |
| objselect | 廃止。代わりに objsel を使用してください。 | いいえ |
| objsel | ロックするオブジェクトを指定します。 Ant 1.6.1 以降 |
いいえ |
| failonerr | コマンドが失敗した場合に例外をスローします。 Ant 1.6.1 以降 |
いいえ; デフォルトは true |
オブジェクト stream:Application_Integration@\MyProject_PVOB に対して ClearCase `lock` を実行します。
<cclock objsel="stream:Application_Integration@\MyProject_PVOB"/>
ClearCase に cleartool unlock コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| comment | コメントフィールドの入力方法を指定します | いいえ |
| pname | ロック解除するオブジェクトのパス名を指定します。 | いいえ |
| objselect | 廃止。代わりに objsel を使用してください。 | いいえ |
| objsel | ロック解除するオブジェクトを指定します。 Ant 1.6.1 以降 |
いいえ |
| failonerr | コマンドが失敗した場合に例外をスローします。 Ant 1.6.1 以降 |
いいえ; デフォルトは true |
オブジェクト stream:Application_Integration@\MyProject_PVOB に対して ClearCase `unlock` を実行します。
<ccunlock objsel="stream:Application_Integration@\MyProject_PVOB"/>
ClearCase に cleartool mkbl コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| comment | コメントを指定します | いいえ; 2 つのうち 1 つのみ使用できます |
| commentfile | コメントを含むファイルを指定します | |
| baselinerootname | ベースラインに関連付ける名前を指定します。 | はい |
| nowarn | 警告メッセージを抑制します | いいえ |
| identical | 前のベースラインと同一の場合でも、ベースラインを作成できます。 | いいえ |
| full | フルベースラインを作成します。 | いいえ |
| nlabel | ラベルなしでベースラインを作成できます。 | いいえ |
| failonerr | コマンドが失敗した場合に例外をスローします。 Ant 1.6.1 以降 |
いいえ; デフォルトは true |
v:\ApplicationCC の統合ビューで ClearCase `mkbl` を実行します。前のベースラインと同一の場合でも実行されます。新しいベースラインは増分ベースラインで、Application_Baseline_AUTO という名前になります。
<ccmkbl baselinerootname="Application_Baseline_AUTO"
identical="yes"
full="no"
viewpath="v:\ApplicationCC"/>
Ant 1.6.1 以降
ClearCase に cleartool mkattr コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| viewpath | コマンドが動作する ClearCase ビューファイルまたはディレクトリへのパス | はい |
| replace | 属性が既に存在する場合は、属性の値を置換します | いいえ |
| recurse | viewpath の下の各サブディレクトリを処理します | いいえ |
| version | 属性を付ける特定のバージョンを識別します | いいえ |
| typename | 属性タイプの名前 | はい |
| typevalue | 属性タイプに付ける値 | はい |
| comment | コメントを指定します | いいえ; 2 つのうち 1 つのみ使用できます |
| commentfile | コメントを含むファイルを指定します | |
| failonerr | コマンドが失敗した場合に例外をスローします。 | いいえ; デフォルトは true |
ファイル c:/views/viewdir/afile に対して ClearCase `mkattr` を実行し、値が 34445 の属性 BugFix を付けます。
<ccmkattr viewpath="c:/views/viewdir/afile"
typename="BugFix"
typevalue="34445"/>
Ant 1.6.1 以降
ClearCase に cleartool mkdir コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| viewpath | コマンドが動作する ClearCase ビューディレクトリへのパス | はい |
| comment | コメントを指定します | いいえ; 2 つのうち 1 つのみ使用できます |
| commentfile | コメントを含むファイルを指定します | |
| nocheckout | 要素作成後にチェックアウトしません | いいえ |
| failonerr | コマンドが失敗した場合に例外をスローします。 | いいえ; デフォルトは true |
ディレクトリ c:/views/viewdir/adir に対して ClearCase `mkdir` を実行し、自動的にチェックアウトしません。
<ccmkdir viewpath="c:/views/viewdir/adir"
nocheckout="true"
comment="Some comment text"/>
Ant 1.6.1 以降
ClearCase に cleartool mkelem コマンドを実行するタスク。
| 属性 | 値 | 必須 |
|---|---|---|
| viewpath | コマンドが動作する ClearCase ビューファイルまたはディレクトリへのパス | はい |
| comment | コメントを指定します | いいえ; 2 つのうち 1 つのみ使用できます |
| commentfile | コメントを含むファイルを指定します | |
| nowarn | 警告メッセージを抑制します | いいえ |
| nocheckout | 要素作成後にチェックアウトしません | いいえ |
| checkin | 作成後に要素をチェックインします | いいえ |
| preservetime | 変更時刻を保持します（チェックインの場合） | いいえ |
| master | メインブランチの所有権を現在のサイトに割り当てます | いいえ |
| eltype | 要素作成時に使用する要素タイプ | いいえ |
| failonerr | コマンドが失敗した場合に例外をスローします。 | いいえ; デフォルトは true |
要素タイプが text_file のファイル c:/views/viewdir/afile に対して ClearCase `mkelem` を実行し、作成後にファイルを チェックインします。
<ccmkelem viewpath="c:/views/viewdir/afile"
eltype="text_file"
checkin="true"
comment="Some comment text"/>