compare

Permet de comparer deux espaces de travail/flux/versions de référence/images instantanées via l'affichage de versions de référence et d'ensembles d'artefacts modifiés différents.

Objectif

Permet d'examiner deux éléments de flux et d'afficher les versions de référence et les ensembles d'artefacts modifiés qui diffèrent de l'un à l'autre.

Les informations sont présentées sous la forme d'une hiérarchie d'éléments, soit par défaut :

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

Il est possible de déplacer vers le haut ou vers le bas des éléments de travail de la hiérarchie à l'aide du commutateur -w/--reroot.

Des informations relatives à l'auteur et à l'heure de distribution sont disponibles pour les versions de référence et les ensembles d'artefacts modifiés. Pour modifier le format de la zone relative à l'auteur, utilisez le commutateur -C/--format-contributor et pour modifier le format de l'heure de distribution, utilisez -D/--format-date.

Synopsis

Identique aux autres commandes. Peut s'exécuter en mode connecté dans un espace de travail chargé localement ou dans un espace de travail non chargé.

Options et arguments

-d  |  --dir ] chemin-espace-de-travail
Chemin d'accès d'un espace de travail local créé par scm load ou scm share. Cette sous-commande s'exécute à l'aide de l'option chemin-espace-de-travail définie en tant que répertoire de travail en cours. Vous pouvez omettre cette option si le répertoire de travail en cours se trouve dans un espace de travail local.
-P  |  --password ] mot de passe correspondant à l'ID utilisateur dans le référentiel
Mot de passe correspondant à l'ID utilisateur indiqué dans le référentiel nommé. Si cette option n'est pas incluse sur la ligne de commande, vous êtes invité à fournir un mot de passe. Si vous avez spécifié l'URI ou le pseudonyme d'un référentiel pour lequel vous avez stocké des données d'identification par le biais de la commande scm login, cette option est ignorée.
-r  |  --repository-uri ] URI du référentiel
Indique le référentiel dans lequel cette action doit être exécutée. Si vous avez stocké des données d'identification de référentiel à l'aide de la commande scm login, vous pouvez utiliser le pseudonyme que vous avez fourni pour celles-ci.
-u  |  --username ] ID utilisateur dans le référentiel
Spécifie un ID utilisateur qui existe déjà dans le référentiel nommé. Si vous avez spécifié l'URI ou le pseudonyme d'un référentiel pour lequel vous avez stocké des données d'identification par le biais de la commande scm login, cette option est ignorée.
-c  |  --component ] arg ...
Uniquement utilisé lorsqu'un argument de version de référence est spécifié par nom. Indique le composant dans lequel se trouve la version de référence.
-C  |  --format-contributor ] arg
Spécifie comment les contributeurs doivent être répertoriés. L'argument unique est une chaîne dont les zones suivantes sont remplacées :
  • {userid} – Remplacé par l'unique ID utilisateur de référentiel de l'utilisateur.
  • {name} – Remplacé par le nom d'utilisateur, comme répertorié dans le référentiel.
  • {email} – Remplacé par l'adresse électronique de l'utilisateur, comme répertorié dans le référentiel.
  • {itemid} – Remplacé par ID interne unique de l'utilisateur dans le référentiel. Cette valeur n'est pas considérée comme significative ou lisible.
-D  |  --format-date ] arg
Spécifie le mode d'affichage des dates. L'argument unique est une chaîne transmise à SimpleDateFormatter de Java http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html.
-f  |  --flow-directions ] arg
Limiter l'affichage de manière à n'inclure que les modifications entrantes/sortantes. Il doit s'agir de l'une des valeurs suivantes :
  • 'i' – modifications entrantes
  • 'o' – modifications sortantes
  • 'b' – modifications entrantes et sortantes
-I  |  --include-types ] arg
Inclut uniquement les éléments des types énumérés. L'argument est une chaîne pouvant contenir l'un des caractères suivants :
  • 'd' – Flow direction (direction du flot). Elément placé en haut de la liste.
  • 'c' – Component (composant).
  • 'b' – Baseline (version de référence).
  • 'w' – Work item (élément de travail).
  • 's' – Change set (ensemble des artefacts modifiés).
  • 'f' – Filesystem change (changement du système de fichiers).

Par défaut, tous les types à l'exception des changements du système de fichiers s'affichent (par exemple "dcbws").

-p  |  --prune ] arg
Supprime les noeuds vides de la hiérarchie. La valeur peut consister en une chaîne contenant les caractères :
  • 'd' – Indique que les directions de flot vides doivent être supprimées.
  • 'c' – Indique que les composants inchangés doivent être supprimés.

Par défaut, aucun élément n'est élagué.

-S  |  --Show ] arg
Contrôle les zones/valeurs d'option affichées. La valeur peut contenir les éléments suivants :
  • 'c' – Indique que le contributeur doit s'afficher. Les contributeurs auteurs s'affichent sur les versions de référence et les ensembles d'artefacts modifiés.
  • 'd' – Indique que les dates doivent s'afficher. Les dates affichées sont les heures de modification pour les ensembles d'artefacts modifiés et les heures de création pour les versions de référence.
  • 'i' – Indique que les éléments de travail doivent s'afficher en tant qu'enfants des ensembles d'artefacts modifiés. S'ils ne sont pas inclus, les éléments de travail s'affichent uniquement en tant que composants de la description de l'ensemble d'artefacts modifiés.

Par défaut, toutes les zones sont affichées.

-w  |  --reroot ] arg
Indique que les noeuds des éléments de travail doivent être déplacés vers le haut dans la hiérarchie affichée. Les valeurs suivantes sont possibles :
  • 'r' – (root) indique que tous les types d'élément doivent s'afficher sous un élément de travail.
  • 'd' – Indique que les éléments de travail doivent s'afficher sous la direction du flot, c'est-à-dire que tous les composants apparaissent sous les éléments de travail.
  • 'c' – Indique que les éléments de travail doivent s'afficher sous les composants, c'est-à-dire que tous les ensembles d'artefacts modifiés et versions de référence apparaissent sous les composants.
  • 'b' – Indique que les éléments de travail doivent s'afficher sous les versions de référence, c'set-à-dire que tous les ensembles d'artefacts modifiés apparaissent sous les éléments de travail.

Par défaut, les éléments de travail s'affichent sous les ensembles d'artefacts modifiés.

Exemples

Pour générer un journal des modifications contenant le minimum d'informations parasites, utilisez la commande :

$ 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" permet d'afficher uniquement les éléments de travail, "-S ''" empêche l'apparition d'éléments parasites sur la ligne de l'élément de travail et "-f" i" permet d'éviter tout mélange entre les changements entrants et sortants.
Pour générer un journal des modifications groupant les changements du système de fichiers sous l'élément de travail et proposant un format de date spécifique, entrez la commande suivante :

$ 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

Notez l'utilisation de -w pour faire d'un élément de travail le parent d'un ensemble d'artefacts modifiés et de -D pour définir le format de date. Pour supprimer les alias et les UUID, utilisez les options initiales "-u" et "-a".

Commentaires en retour

Avez-vous obtenu l'aide souhaitée ? Vous pouvez envoyer des commentaires en retour à Jazz.net (inscription nécessaire) : Commentaire dans les forums ou signaler un bogue