Cette commande est utilisée pour importer, dans Rational
Programming Patterns, des mises à jour extraites du journal Pacbase ou du fichier produit
par la procédure MIBU de personnalisation de la
migration. Le fichier à importer doit avoir une extension .ta2 mais
son nom ne doit pas être MIBR. L'import des mises
à jour du journal est lancé automatiquement par la commande rpp
--automaticMigration dans le cadre d'une migration progressive.
Vous pouvez cependant aussi lancer cette commande à part.
Remarque : Le numéro de version de Pacbase est inclus dans
le fichier .ta2. Si la version incluse dans ce
fichier n'est pas compatible avec la version courante de Rational
Programming Patterns, l'import n'est pas exécuté et une erreur est
générée. Le contrôle ne descend pas jusqu'au niveau sous-version (Y09A
par exemple).
Syntaxe
rpp.bat --importJournal [options]
Paramètres
Tableau 1. Liste des
paramètres disponiblesOptions |
Commentaires |
Obligatoire |
Valeurs par défaut |
--data |
Chemin d'accès à l'espace de travail utilisé |
Oui |
|
--log |
Nom du fichier journal Le début de ce fichier rappelle les paramètres saisis
lors du lancement des procédures de migration Pacbase.
|
|
trace.log |
--fromFile |
Nom du fichier .ta2 en
entrée. Ce fichier ne doit pas se nommer MIBR.ta2. |
Oui |
|
--fromDataFile |
Emplacement et nom du fichier technique .xml à
prendre en compte lors de l'import |
Oui |
|
--location |
Référentiel cible |
Oui |
|
--generatedDataFile |
Emplacement et nom du fichier technique .xml à
générer lors de l'import |
|
imported_data_refer.xml dans
le répertoire .metadata, refer correspondant
au référentiel cible |
--report |
Fichier de rapport d'erreurs de l'import |
|
pacmigration.log du
répertoire .metadata de l'espace de travail |
--overwriteReport |
Ecrasement du fichier de rapport d'erreurs |
|
false - par défaut, ajout
au fichier existant |
Pour son utilisation ultérieure, le fichier script
créé contenant les commandes SCM doit être complété avec les informations
suivantes :
- Code de l'utilisateur sous Rational Team Concert
- Nom du flux dans lequel les projets seront remontés
- Adresse du serveur Rational Team Concert
- Chemin du répertoire où se trouvent les exécutables lscm
Le fichier technique .xml créé
à la fin de l'import est nécessaire en cas d'import ultérieur.
Ce fichier rassemble des informations qui n'ont pas été reprises dans
le métamodèle Rational Programming Patterns ainsi que la liste des
instances préalablement importées.
Le fichier de rapport
d'erreurs de l'import synthétise le contenu du fichier
.ta2 importé
en affichant les informations suivantes :
- Le contexte de l'import comme la base, l'utilisateur, la session,
la Bibliothèque et la date.
- Le remplacement des caractères spéciaux.
- Les statistiques des instances présentes dans le fichier .ta2.
Ces chiffres incluent les instances dupliquées par les procédures
de migration.
- Les erreurs détectées lors de l'import.
- Les Structures de Données et les Dialogues dupliqués par l'import.
- Le nombre d'instances réellement importées et le nombre d'instances
présentes dans le fichier .ta2. Le nombre d'instances
réellement importées peut être inférieur au nombre d'instance présentes
dans le fichier .ta2 dans le cas de l'import
d'une nouvelle session Pacbase dans
le même espace de travail. Dans ce cas, les instances qui n'ont pas
été modifiées ne sont pas comptabilisées dans les instances importées.
- Le nombre d'entités de design modifiées, créées ou supprimées.
Exemple
rpp.bat --import --fromFile
C:/import/IMPORT1.ta2 --location IMPORT --importType ta2 --overwrite
--data C:/workspaces/batchWks --log C:/import/out/trace.log --generatedDataFile
C:/import/out/genData.xml
rpp.bat --importJournal --fromFile C:/import/Journal_IMPORT2.ta2
--fromDataFile C:/import/out/genData.xml --location IMPORT --data
C:/workspaces/batchWks --log C:/import/out/traceJournal.log --generatedDataFile
C:/import/out/genData.xml