Cette commande est utilisée pour importer les instances
dans l’espace de travail local. Seul l'import à partir d’un fichier .ta2 est
possible. L'import d'instances est lancé automatiquement par la commande rpp
--automaticMigration. 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 --import [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.
|
Non |
trace.log |
--importType |
Type d'import |
Oui |
ta2 |
--fromFile |
Nom du fichier en entrée |
Oui |
|
--location |
Localisation de la cible (référentiel) |
Oui |
|
--overwrite |
Ecrasement des fichiers existants |
Non |
false |
--generatedDataFile |
Emplacement et nom du fichier technique .xml à
générer lors de l'import |
Non |
imported_data_refer.xml dans
le répertoire .metadata (refer correspondant
au code du référentiel) |
--report |
Fichier de rapport d'erreurs de l'import |
Non |
.pacmigration.log du
répertoire .metadata de l'espace de travail |
--overwriteReport |
Ecrasement du fichier de rapport d'erreur |
Non |
false - par défaut, ajout
au fichier existant |
--multisession |
Import, dans le même espace de travail, de données
issues de plusieurs sessions Pacbase. Ce paramètre
est généré automatiquement si le paramètre--previousSessionFolder est
indiqué dans la commande de migration automatique.
|
Non |
|
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.
Exemples
rpp.bat --import --fromFile
D:/Working/Misc/PGMCUO.ta2 --location TEST01 --importType ta2 --overwrite
--log d:/utmp/trace.log --data d:/Working/JbyWks
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