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".