rpp --importJournal

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 disponibles
Options 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

Vos commentaires