Porovnání

Porovnání dvou pracovních prostorů/proudů/úrovní baseline/snímků a zobrazení rozdílných úrovní baseline a sad změn.

Účel

Vyšetřit dvojice prvků toku a zobrazit, které úrovně baseline a sady změn se u nich liší.

Zobrazení je prezentováno jako hierarchie položek, standardně:

Flow direction (incoming/outgoing)
	Component
		Baseline
			Change set
				Work item
				Filesystem entities

Pozici pracovní položky v hierarchii lze zvýšit nebo snížit pomocí přepínače -w/--reroot.

Úrovně baseline a sady změn mají informace o autorovi a času doručení. Formát pole autor lze změnit pomocí přepínače -C/--format-contributor, zatímco formát času doručení lze změnit pomocí -D/--format-date.

Stručný přehled

Stejné jako jinde. Může být spuštěno v přihlášeném režimu, v lokálně načteném pracovním prostoru nebo v nenačteném pracovním prostoru.

Volby a argumenty

-d  |  --dir ] cesta-k-pracovnímu-prostoru
Název cesty k lokálnímu pracovnímu prostoru vytvořenému příkazem scm load nebo scm share. Tento podpříkaz se spouští s cestou-k-pracovnímu-prostoru nastavenou jako aktuální pracovní adresář. Tuto volbu můžete vynechat, pokud je aktuální pracovní adresář v lokálním pracovním prostoru.
-P  |  --password ] heslo pro ID uživatele v úložišti
Heslo pro zadané ID uživatele v uvedeném úložišti. Pokud tato volba není uvedena v příkazovém řádku, budete vyzváni k zadání hesla. Pokud jste zadali identifikátor URI nebo přezdívku, pro kterou jste uložili pověření pomocí příkazu scm login, bude tato volba ignorovaná.
-r  |  --repository-uri ] identifikátor URI úložiště
Určuje úložiště, ve kterém se má tato akce provést. Pokud jste pověření k úložišti uložili pomocí příkazu scm login, můžete použít přezdívku, kterou jste zadali pro toto uložené pověření
-u  |  --username ] ID uživatele v úložišti
Určuje ID uživatele existující v uvedeném úložišti. Pokud jste zadali identifikátor URI nebo přezdívku, pro kterou jste uložili pověření pomocí příkazu scm login, bude tato volba ignorovaná.
-c  |  --component ] arg ...
Použit je pouze tehdy, když je názvem specifikován argument úrovně baseline. Označuje komponentu, v níž lze nalézt úroveň baseline.
-C  |  --format-contributor ] arg
Určuje, jak mají být vypisováni přispěvatelé. Samostatný argument je tvořen řetězcem, u něhož jsou nahrazena následující pole:
  • {userid} – Nahrazuje se jedinečným ID uživatele úložiště pro uživatele.
  • {name} – Nahrazuje se jménem uživatele, jak je uvedeno v úložišti.
  • {email} – Nahrazuje se e-mailovou adresou uživatele, jak je uvedeno v úložišti.
  • {itemid} – Nahrazuje se jedinečným interním ID uživatele v úložišti. Tato hodnota není myšlena jako hodnota smysluplná nebo čitelná pro člověka.
-D  |  --format-date ] arg
Určuje způsob zobrazování data. Samostatný argument je tvořen řetězcem, který bude předáván prostřednictvím objektu SimpleDateFormatter http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html prostředí Java.
-f  |  --flow-directions ] arg
Omezuje zobrazování tak, aby se zahrnuly pouze příchozí/odchozí změny. Musí mít jednu z následujících hodnot:
  • 'i' – Příchozí změny.
  • 'o' – Odchozí změny.
  • 'b' – Příchozí i odchozí změny.
-I  |  --include-types ] arg
Obsahuje pouze položky uvedených typů. Argumentem je řetězec, který může obsahovat libovolný z následujících znaků:
  • 'd' – Směr toku. Nejvyšší prvek.
  • 'c' – Komponenta.
  • 'b' – Úroveň baseline.
  • 'w' – Pracovní položka.
  • 's' – Sada změn.
  • 'f' – Změna systému souborů.

Standardně jsou zobrazeny všechny typy kromě změn systému souborů (tj. "dcbws").

-p  |  --prune ] arg
Odebere prázdné uzly z hierarchie. Hodnota může být tvořena řetězcem obsahujícím znaky:
  • 'd' – Označuje, že prázdné směry toku by měly být odebrány.
  • 'c' – Označuje, že nezměněné komponenty by měly být odebrány.

Ve výchozím nastavení se nic neodstraňuje.

-S  |  --Show ] arg
Řídí, které nepovinné hodnoty/pole se zobrazí. Hodnota může obsahovat následující:
  • 'c' – Označuje, že by měl být zobrazen přispěvatel. Autoři-přispěvatelé budou zobrazeni u úrovní baseline a u sad změn.
  • 'd' – Označuje, že by měla být zobrazena data. Data jsou zobrazena jako čas úpravy u sady změn a čas vytvoření u úrovně baseline.
  • 'i' – Označuje, že pracovní položky by měly být zobrazeny jako podřízené prvky sad změn. Není-li obsažen, pracovní položky budou zobrazeny pouze jako část popisu sady změn.

Standardně jsou zobrazena všechna pole.

-w  |  --reroot ] arg
Označuje, že uzly pracovních položek by měly být v zobrazené hierarchii posunuty nahoru. Hodnota musí být jedna z následujících:
  • 'r' – Pro kořenovou složku označuje, že všechny typy položek by měly být zobrazeny pod pracovní položkou.
  • 'd' – Označuje, že pracovní položky by měly být zobrazeny pod směrem toku, což znamená, že všechny komponenty budou zobrazeny pod pracovními položkami.
  • 'c' – Označuje, že pracovní položky by měly být zobrazeny pod komponentami, což znamená, že všechny sady změn a úrovně baseline budou zobrazeny pod komponentami.
  • 'b' – Označuje, že pracovní položky by měly být zobrazeny pod úrovněmi baseline, což znamená, že všechny sady změn budou zobrazeny pod pracovními položkami.

Standardně jsou pracovní položky zobrazeny pod sadami změn.

Příklady

Chcete-li vygenerovat protokol změn s minimem vnějších informací, použijte:

$ scm compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I w -S "" -f i
Pracovní položka 60074: Umožňuje definici oprávnění pro oblasti projektu a oblasti týmu ve webovém UI. Pracovní položka 62945: Vytvoření určitého druhu sestavení Jazz Foundation. Pracovní položka 63040: TCT031b: Jazz Translations - více proměnných. Pracovní položka 63053: Import šablony webového UI neumožňuje změnit přizpůsobení pracovní položky. Pracovní položka 63091: Zvažte národní prostředí oblasti projektu při vytváření událostí změn a vykreslení kanálů. Pracovní položka 63266: Chyby CHKPII v souborech COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER.
Pracovní položka 63371: ProcessFeedRenderer.getProcessAreaChangeDetails by měl být přepsán, aby akceptoval překlad
.

Použití "-I w" omezuje zobrazení pracovních položek, "-S ''" brání vnějšímu šumu na řádku pracovní položky a "-f" i" zajistí, že odchozí změny se nesmíchají s příchozími změnami.
Chcete-li vygenerovat protokol změn, který seskupí změny systému souborů pod pracovní položku a sadu změn a poskytne specifický formát dat:

$ 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 rrrr HH:mm:ss Z" -f i
Pracovní položka 63266: Chyby CHKPII v souborech COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER
  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
Pracovní položka 63371: ProcessFeedRenderer.getProcessAreaChangeDetails by měl být přepsán, aby akceptoval překlad
  případ zpracování, kdy je kategorie známá, ale nemá zřetelnou zprávu 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
Pracovní položka 63416: Neexternalizovaný řetězec pro přeložitelný atribut pro deklarovaný adaptér domény
  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

Povšimněte si použití -w, které pracovní položku učiní nadřízeným prvkem sady změn, a -D, které nastaví formát dat. Aliasy a UUID jsou potlačeny pomocí počátečních voleb "-u" a "-a".

Váš názor

Byla tato pomoc užitečná? Zpětnou vazbu můžete poskytnout na stránkách Jazz.net (registrace je požadována): Komentář na fóru nebo odeslat chybu