compare

Zwei Arbeitsbereiche/Datenströme/Referenzkonfigurationen/Momentaufnahmen vergleichen und die abweichenden Referenzkonfigurationen und Änderungssets zeigen.

Zweck

Ein Paar von Datenflusselementen untersuchen und zeigen, welche Referenzkonfigurationen und Änderungsssets zwischen den beiden voneinander abweichen.

Die Anzeige zeigt eine Hierarchie der Elemente, die standardmäßig wie folgt ausssieht:

Datenflussrichtungen (eingehend/abgehend)
	Komponente
		Referenzkonfiguration
			Änderungsset
				Arbeitselement
				Entität des Dateisystems

Die Position der Arbeitselemente in der Hierarchie kann mit dem Schalter '-w/--reroot' angehoben oder herabgesenkt werden.

Referenzkonfigurationen und Änderungssetzs enthalten Informationen zum Autor und zur Übergabezeit. Das Format des Autorenfelds kann mit dem Schalter '-C/--format-contributor' geändert werden, und das Format der Übergabezeit mit dem Schalter '-D/--format-date'.

Übersicht

Same as elsewhere. Kann im Anmeldemodus, in einem lokal geladenen Arbeitsbereich oder in einem nicht geladenen Arbeitsbereich ausgeführt werden.

Optionen und Argumente

-d  |  --dir ] pfad_des_arbeitsbereichs
Der Pfadname eines lokalen Arbeitsbereichs, der durch den Befehl scm load oder scm share erstellt wurde. Dieser Unterbefehl wird mit dem aktuellen Arbeitsverzeichnis als Wert für pfad_für_arbeitsbereich ausgeführt. Sie können diese Option übergehen, wenn sich das aktuelle Arbeitsverzeichnis in einem lokalen Arbeitsbereich befindet.
-P  |  --password ] kennwort_für_benutzer-id_in_repository
Das Kennwort für die angegebene Benutzer-ID im benannten Repository. Wenn diese Option in der Befehlszeile nicht angegeben wird, werden Sie zur Eingabe eines Kennworts aufgefordert. Wenn Sie eine Repository-URI oder einen Kurznamen angegeben haben, für den Sie Berechtigungsnachweise mithilfe des Befehls scm login gespeichert haben, wird diese Option ignoriert.
-r  |  --repository-uri ] repository-uri
Gibt das Repository an, in dem diese Aktion ausgeführt werden soll. Wenn Sie Berechtigungsnachweise für das Repository mit dem Befehl scm login gespeichert haben, können Sie den Kurznamen verwenden, den Sie für diese gespeicherten Berechtigungsnachweise angegeben haben.
-u  |  --username ] benutzer-id_in_repository
Gibt eine Benutzer-ID an, die in dem genannten Repository vorhanden ist. Wenn Sie eine Repository-URI oder einen Kurznamen angegeben haben, für den Sie Berechtigungsnachweise mithilfe des Befehls scm login gespeichert haben, wird diese Option ignoriert.
-c  |  --component ] arg ...
Nur dann verwendte, wenn ein Baseline-Argument mach Name angegeben ist. kennzeichnet die Komponente, in der die Baseline gefunden werden kann.
-C  |  --format-contributor ] arg
Gibt an, wie Mitwirkende aufgelistet werden sollen. Das einzelne Argument ist eine Zeichenfolge, in der die folgenden Felder ersetzt sind:
  • {userid} – Wird ersetzt durch die eindeutige Repository-Benutzer-ID des jeweiligen Benutzers.
  • {name} – Wird ersetzt durch den Namen des Benutzers, wie im Repository aufgelistet.
  • {email} – Wird ersetzt durch die E-Mail-Adresse des Benutzers, wie im Repository aufgelistet.
  • {itemid} – Wird ersetzt durch die eindeutige interne ID des Benutzers, wie im Repository aufgelistet. Dieser wert ist nicht aussagekräftig vom Sinn her.
-D  |  --format-date ] arg
Gibt an, wie Datumsangaben angezeigt werden sollen. Das einzelne Argument ist eine Zeichenfolge, die den SimpleDateFormatter http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html von Java durchläuft.
-f  |  --flow-directions ] arg
Die Anzeige eingrenzen, um nur eingehende und abgehende Änerungen aufzunehmen. Muss einer der folgenden Werte sein:
  • 'i' – eingehende Änderungen
  • 'o' – abgehende Änderungen
  • 'b' – Sowohl eingehende als auch abgehende Änderungen
-I  |  --include-types ] arg
Nur Elemente mit den aufgelisteten Typen einschließen. Das Argument ist eine Zeichenfolge, die eines der folgenden Zeichen enthalten kann:
  • 'd' – Datenflussrichtung. Das oberste Element.
  • 'c' – Komponente.
  • 'b' – Referenzkonfiguration.
  • 'w' – Arbeitselement.
  • 's' – Änderungsset.
  • 'f' – Dateisystemänderung.

Standardmäßig werden alle Typen mit Ausnahme von Dateisystemänderungen angezeigt (z. B. 'dcbws').

-p  |  --prune ] arg
Leere Knoten aus der Hierarchie entfernen. Der Wert kann aus einer Zeichenfolge bestehen, die folgenden Zeichen enthält:
  • 'd' – Gibt an, dass leere Datenflussrichtungen entfernt werden sollen.
  • 'c' – Gibt an, dass nicht geänderte Komponenten entfernt werden sollen.

Standardmäßig wird nichts entfernt.

-S  |  --Show ] arg
Steuert, welche Optionswerte/Felder angezeigt werden. Der Wert kann Folgendes enthalten:
  • 'c' – Gibt an, dass der Kontributor angezeigt werden soll. Autorenkontributoren werden in Referenzkonfigurationen und Änderungssetzs angezeigt.
  • 'd' – Gibt an, dass die Daten angezeigt werden sollen. Daten werden in Änderungssets als Änderungszeiten und in Referenzkonfiguration als Erstellungszeiten angezeigt.
  • 'i' – Gibt an, dass die Arbeitselemente als untergeordnete Elemente von Änderungssets angezeigt werden sollen. Wenn sie nicht eingeschlossen wurden, werden Arbeitselemente nur als Teil der Beschreibung des Änderungssets angezeigt.

Standardmäßig werden alle Felder angezeigt.

-w  |  --reroot ] arg
Gibt an, dass die Arbeitselementknoten in der angezeigten Hierarchie nach oben verschoben werden sollen. Einer der folgenden Werte muss angegeben werden:
  • 'r' – Für Root. Gibt an, dass alle Elementtypen unter einem Arbeitselement angezeigt werden sollen.
  • 'd' – Gibt an, dass Arbeitselemente unter der Datenflussrichtung angezeigt werden sollen. Dies bedeutet, dass alle Komponenten unter Arbeitselementen angezeigt werden.
  • 'c' – Gibt an, dass Arbeitselemente unter Komponenten angezeigt werden sollen. Dies bedetuet, dass alle Änderungssets und Referenzkonfigurationen unter Komponenten angezeigt werden.
  • 'b' – Gibt an, dass Arbeitselemente unter Referenzkonfigurationen angezeigt werden sollen. Dies bedeutet, dass alle Änderungssets unter Arbeitselementen angezeigt werden.

Standardmäßig werden Arbeitselemente unter Änderungssets angezeigt.

Beispiele

Verwenden Sie Folgendes, um ein Änderungsprotokoll mit einem Minimum an nicht relevanten Informationen zu generieren:

$ 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

Die Verwendung von “-I w” grenzt die Anzeige auf Arbeitselement ein, “-S ''” verhindert Störungen in der Arbeitselementzeile, und “-f” i” stellt sicher, dass abgehende Änderungen nicht mit eingehenden Änderungen vermischt werden.
Verwenden Sie Folgendes, um ein Änderungsprotokoll zu generieren, das Dateisystemänderungen unter dem Arbeitselement und dem Änderungsset gruppiert und ein spezielles Datumsformat bereitstellt:

$ 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

Beachten Sie die Verwendung von '-w', durch die Arbeitselemente zu übergeordneten Elemente von Änderungssets gemacht werden, und von die Verwendung von '-D', mit der das Datumsformat festgelegt wird. Aliasnamen und UUIDs werden mit den Anfangsoptionen '-u' und '-a' unterdrückt.

Feedback

Waren die Informationen hilfreich? Sie können auf Jazz.net (Registrierung erforderlich) Feedback geben: Comment in the forums oder submit a bug