comparer

Comparez deux espaces de travail, flux, versions de référence, images instantanées en indiquant les versions et les groupes de modifications qui diffèrent.

Objectif

Analyse une paire d'éléments de flux et indique les versions de référence et les groupes de modifications qui diffèrent entre les deux.

L'écran se présente par défaut sous la forme d'une hiérarchie d'éléments :

Sens du flux (entrant/sortant)
	Composant
		Version de référence
			Groupe de modifications
				Elément de travail
				Entités Système de fichiers

Vous pouvez remonter ou descendre les éléments de travail dans la hiérarchie avec l'option -w/--reroot.

Les versions de référence et les groupes de modifications ont des informations d'auteur et d'heure de distribution. Le format de la zone d'auteur peut être modifiée avec l'option -C/--format-contributor et celui de l'heure de distribution, avec l'option -D/--format-date.

Synopsis

Identique à elsewhere. Peut être exécuté en mode Connecté, dans un espace de travail chargé localement ou 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 listés. L'argument est une chaîne qui peut contenir n'importe lesquels des caractères suivants :
  • 'd' – Sens de flux. Le premier élément.
  • 'c' – Composant.
  • 'b' – Version de référence.
  • 'w' – Elément de travail.
  • 's' – Groupe de modifications.
  • 'f' – Modification de système de fichiers.

Par défaut, tous les types sont indiqués, sauf les modifications de système de fichiers (ex. : “dcbws”).

-p  |  --prune ] arg
Supprimer les noeuds vides de la hiérarchie. La valeur peut être constituée d'une chaîne contenant les caractères :
  • 'd' – Indication que les sens de flux vides doivent être supprimés.
  • 'c' – Indication que les composants inchangés doivent être supprimés.

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

-S  |  --Show ] arg
Contrôle l'affichage des valeurs d'option/zones. La valeur peut contenir :
  • 'c' – Indique que le contributeur doit être affiché. Les contributeurs auteurs apparaissent dans les versions de référence et les groupes de modifications.
  • 'd' – Indique que les dates doivent être affichés. Les dates correspondent aux dates de modifications dans les groupes de modifications et aux dates de création des versions de référence.
  • 'i' – Indique que les éléments de travail doivent être affichés comme enfants des groupes de modifications. Si l'option n'est pas incluse, les éléments de travail sont affichés dans le cadre de la description des groupes de modifications.

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

-w  |  --reroot ] arg
Indique que les noeuds d'éléments de travail doivent être remontés dans la hiérarchie affichée. La valeur doit correspondre à l'un des éléments suivants :
  • 'r' – Pour root, indique que tous les types d'élément doivent être affichés sous un élément de travail.
  • 'd' – Indique que les éléments de travail doivent être affichés sous le sens de flux, ce qui implique que tous les composants seront affichés sous les éléments de travail.
  • 'c' – Indique que les éléments de travail doivent être affichés sous les composants, ce qui implique que tous les groupes de modifications seront affichés sous les composants.
  • 'b' – Indique que les éléments de travail doivent être affichés sous les versions de référence, ce qui implique que tous les groupes de modifications seront affichés sous les éléments de travail.

Par défaut, les éléments de travail sont affichés sous les groupes de modifications.

Exemples

Pour générer un journal de modifications avec le minimum d'informations superflues, utilisez :

$ scm compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I w -S "" -f i
Work Item 60074: Permet de définir les autorisations des zones de projet et d'équipe dans l'interface utilisateur Web
Work Item 62945: Définit un type de génération Jazz Foundation
Work Item 63040: TCT031b: Traduction Jazz - plus de variables
Work Item 63053: L'importation de modèle de l'interface utilisateur Web ne permet pas de modifier la personnalisation des éléments de travail
Work Item 63091: Tenez compte des paramètres régionaux de zone de projet lors de la création des événements de modification et des flux de rendu
Work Item 63266: Erreurs CHKPII dans les fichiers COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER
Work Item 63371: ProcessFeedRenderer.getProcessAreaChangeDetails doit être réécrit pour accepter la traduction

L'utilisation de “-I w” limite l'affichage aux éléments de travail, “-S ''” élimine le bruit supplémentaire dans la liste d'élément de travail et “-f” i” permet aux modifications sortantes ne ne pas interférer avec les modifications entrantes.
Pour générer un journal de modifications qui regroupe les modifications de système de fichiers sous l'élément de travail et le groupe de modifications et fournit un format de date spécifique :

$ 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: Erreurs CHKPII dans les fichiers 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
Work Item 63371: ProcessFeedRenderer.getProcessAreaChangeDetails doit être réécrit pour accepter la traduction
  traite le scénario dans lequel la catégorie est connue, mais n'a pas un message distinct 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 convertir des éléments de travail en parent de groupes de modifications et -D pour définir le format de date. Les alias et les UUID sont supprimés avec les options initiales “-u” et “-a”.

Commentaires en retour

Etes-vous satisfait ? Vous pouvez faire part de vos commentaires à l'adresse Jazz.net (enregistrement requis) : Commentaire dans les forums ou soumettre un bogue