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.