compare

2 つのワークスペース/ストリーム/ベースライン/スナップショットを比較して、 ベースラインと変更セットの違いを示します。

目的

フロー要素の対を検査し、2 つの間で異なる ベースラインおよび変更セットを示します。

表示は、デフォルトで、次のような項目の階層として 示されます。

フローの向き (着信/発信)
	コンポーネント
		ベースライン
			変更セット
				ワークアイテム
				ファイル・システム・エンティティー

-w/--reroot スイッチを使用して、 階層内のワークアイテムの位置を上下に変更することができます。

ベースラインおよび変更セット には、作成者および提出時間情報があります。「作成者」フィールドのフォーマットは、 -C/--format-contributor スイッチを使用して変更できます。また、提出時間のフォーマットは、 -D/--format-date スイッチを使用して変更できます。

概要

前述のとおりです。ログイン・モード、ローカルにロードされたワークスペース、 またはアンロードされたワークスペースで実行できます。

オプションおよび引数

-d  |  --dir ] workspace-path
scm load または scm share によって作成されたローカル・ワークスペースのパス名。このサブコマンドは、現行作業ディレクトリーとして workspace-path を設定して実行します。現行作業ディレクトリーがローカル・ワークスペース内にある場合は、このオプションを省略できます。
-P  |  --password ] password for user ID in repository
指定されたリポジトリー内の、指定されたユーザー ID のパスワード。このオプションがコマンド行に組み込まれない場合は、パスワードを入力するようプロンプトが表示されます。scm login コマンドを使用して証明書を保管したリポジトリーの、URI またはニックネームを指定している場合、このオプションは無視されます。
-r  |  --repository-uri ] repository URI
このアクションの実行元となるリポジトリーを指定します。 scm login コマンドを使用してリポジトリー証明書を保管した場合、これらの保管した証明書に指定したニックネームを使用できます。
-u  |  --username ] user ID in repository
指定されたリポジトリー内に存在するユーザー ID を指定します。 scm login コマンドを使用して証明書を保管したリポジトリーの、URI またはニックネームを指定している場合、このオプションは無視されます。
-c  |  --component ] arg ...
ベースライン引数を名前で指定する 場合にのみ使用されます。ベースラインが見つかるコンポーネントを示します。
-C  |  --format-contributor ] arg
コントリビューターのリスト方法を示します。単一の引数は、 以下のフィールドを置き換えたストリングです。
  • {userid} – 固有のユーザーのリポジトリー・ユーザー ID に置き換えられます。
  • {name} – リポジトリーにリストされている、ユーザー名に置き換えられます。
  • {email} – リポジトリーにリストされている、ユーザーの E メール・アドレスに置き換えられます。
  • {itemid} – リポジトリー内のユーザー固有の内部 ID に置き換えられます。この値は、人間にとって意味がある、または人間が読み取り可能な値とはみなされません。
-D  |  --format-date ] arg
日付の表示方法を指定します。単一の引数は、 Java の SimpleDateFormatter http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html により渡されるストリングです。
-f  |  --flow-directions ] arg
着信する変更/発信する変更のみが表示されるように制限します。次のいずれかでなければなりません。
  • 'i' – 着信する変更
  • 'o' – 発信する変更
  • 'b' – 着信する変更と発信する変更の両方
-I  |  --include-types ] arg
リストしたタイプの項目のみが含まれるようにします。引数として、 以下のいずれかの文字を含むストリングを指定できます。
  • 'd' – フローの向き。最上位の要素です。
  • 'c' – コンポーネント。
  • 'b' – ベースライン。
  • 'w' – ワークアイテム。
  • 's' – 変更セット。
  • 'f' – ファイル・システムの変更。

デフォルトでは、ファイル・システムの変更を除く すべてのタイプが表示されます (すなわち、"dcbws")。

-p  |  --prune ] arg
階層から空のノードを除去します。値として、以下の文字を含むストリングを指定できます。
  • 'd' – 空のフローの向きを除去することを示します。
  • 'c' – 変更されていないコンポーネントを除去することを示します。

デフォルトでは、 何も除去されません。

-S  |  --Show ] arg
表示されるオプションの値/フィールドを制御します。値として、以下を指定できます。
  • 'c' – コントリビューターを表示することを示します。ベースラインおよび変更セットに 作成者コントリビューターが表示されます。
  • 'd' – 日付を表示することを示します。日付は、変更セットでは変更時、ベースラインでは作成時 の日付が表されます。
  • 'i' – ワークアイテムを変更セットの子として表示することを示します。この引数が指定されていない 場合、ワークアイテムは変更セット記述の一部としてのみ表示されます。

デフォルトでは、すべてのフィールドが表示されます。

-w  |  --reroot ] arg
表示される階層で、ワークアイテム・ノードを上に移動することを示します。値は、以下のいずれかでなければなりません。
  • 'r' – ルートにすること、つまり、すべての項目タイプをワークアイテムの下に表示することを示します。
  • 'd' – ワークアイテムをフローの向きの下に表示することを示します。つまり、すべてのコンポーネント は、ワークアイテムの下に表示されます。
  • 'c' – ワークアイテムをコンポーネントの下に表示することを示します。つまり、すべての変更セット およびベースラインは、コンポーネントの下に表示されます。
  • 'b' – ワークアイテムをベースラインの下に表示することを示します。つまり、すべての変更セット は、ワークアイテムの下に表示されます。

デフォルトでは、ワークアイテムは、変更セットの下に表示されます。

無関係な情報を最小限にした変更ログを生成するには、以下のように指定します。

$ scm compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I w -S "" -f i
Work Item 60074: Allow defining permissions for project and team areas in the Web UI
Work Item 62945: Set up some sort of Jazz Foundation build
Work Item 63040: TCT031b: Jazz Translations - more variables
Work Item 63053: Web UI template import doesn't allow change to workitem customization
Work Item 63091: Consider project area locale when creating change events and rendering feeds
Work Item 63266: CHKPII errors in COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER files
Work Item 63371: ProcessFeedRenderer.getProcessAreaChangeDetails should be re-written to accommodate translation

「-I w」を使用すると、ワークアイテムのみが表示されるように制限されます。 「-S ''」は、ワークアイテム行に余分な情報が表示されないようにします。 「-f i」は、発信する変更が着信する変更と混ざらないようにします。
ファイル・システムの変更 をワークアイテムおよび変更セットの下にグループ化し、特定の日付形式を示す変更ログを生成する場合は、 以下のように指定します。

$ scm -u n -a n compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I wfs -w d -S d -D "EEE, d MMM yyyy HH:mm:ss Z" -f i
Work Item 63266: CHKPII errors in COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER files
  No comment Fri, 7 Nov 2008 16:52:24 -0500
    /com.ibm.team.process.definitions.server/data/agile/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/eclipseway/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/openup/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/scrum/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/simple/attachments/template.properties
Work Item 63371: ProcessFeedRenderer.getProcessAreaChangeDetails should be re-written to accommodate translation
  handle case where category is known but doesn't have a distinct message Thu, 6 Nov 2008 16:49:09 -0500
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/messages.properties
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/ProcessFeedRenderer.java
  Merges Thu, 6 Nov 2008 19:50:52 -0500
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/messages.properties
Work Item 63416: Not externalized string for translatable attribute for declared domain adapter
  No comment Fri, 7 Nov 2008 16:46:56 -0500
    /com.ibm.team.process.ide.ui/plugin.properties
    /com.ibm.team.process.ide.ui/plugin.xml

-w の指定により、 ワークアイテムが変更セットの親になります。-D の使用により、日付形式が設定されます。別名および UUID は、 最初の「-u」および「-a」オプションにより抑止されます。

フィードバック

この情報はお役に立ちましたか? Jazz.net でフィードバックをお送り頂けます (登録が必要です): フォーラムにコメントを記入したり、バグを送信したりすることができます。