Référence bfimport

L'utilitaire bfimport vous permet d'importer dans l'interface utilisateur des définitions pour les projets et d'autres objets précédemment exportés vers un fichier XML. Vous pouvez aussi utiliser l'utilitaire d'importation pour importer les objets sélectionnés dans le fichier XML.

Cette rubrique décrit la syntaxe de la commande bfimport et fournit des détails d'utilisation.

Syntaxe

bfimport

bfimport [-L] <nom_fichier>
bfimport [-p -I -s -S
-e -c -C -u -T -f -d -r ] <nom_fichier.xml>
bfimport
[-L | [-p -I -s -S -e -c -C -u -T -f -d -r ]] <nom_fichier.xml>

Restrictions et consignes

Les mots de passe d'autorisation d'accès aux serveurs ne sont pas inclus au fichier d'exportation ; vous devez les entrer manuellement.

Par défaut, si ,lors de l'importation, un objet portant le même nom que l'objet importé existe, ce dernier est renommé pour éviter que l'objet de la base de données soit écrasé. Sinon, vous pouvez choisir de remplacer les objets par l'option -r si un objet portant le même nom existe. Pour les objets de cliché, ils sont comparés par identificateur unique universel (plutôt que par nom).

Par défaut, les objets sont renommés par la commande bfimport et la convention de dénomination suivante est utilisée :

<nom_objet>_IMPORT_<numéro>

Pour renommer, les objets de cliché perdent leur nom de cliché et sont importés en tant que nouveau cliché de base ou de niveau parent, même si l'objet de cliché est un enfant du cliché parent.

Pour obtenir des détails sur les changements de nom, voir Changement de nom et remplacement d'objets lors de l'importation.

Pour remplacer des objets, vous devez indiquer l'option -r. L'option de remplacement écrase les objets existant. Pour les fichiers d'exportation de la version 7.0.2 et inférieure, les objets de cliché ne sont pas remplacés. Ils sont renommés à l'aide de la convention <nom_objet>_IMPORT_<numéro>. Pour les fichiers d'exportation de la version 7.1, les objets de cliché sont remplacés.

Pré-requis

Avant de faire appel à l'utilitaire bfimport, vérifiez que les conditions prérequises suivantes sont remplies :
  • Un fichier XML d'exportation créé par la commande bfexport ou par la commande point .export.
  • Recherchez l'utilitaire bfimport dans votre répertoire d'installation Build Forge.
  • La commande bfimport doit pouvoir rechercher le fichier buildforge.conf et accéder à la base de données Build Forge. Exécutez la commande bfimport à partir du répertoire dans lequel se trouve buildforge.conf, c'est-à-dire <rép_install_bf> sous Windows et <rép_install_bf>/Platform sous UNIX et Linux.
    Remarque : Si le projet que vous importez comporte un groupe de notification et que ce dernier n'est pas un groupe intégré, tel que Responsable de génération, Développeur, Invité, Opérateur, Gestionnaire système, vous devez créer un groupe d'accès avant l'importation.

Syntaxe

Pour effectuer des tâches d'importation de projet usuelles, utilisez les options de commande suivantes :
  • Pour afficher la syntaxe de commande, utilisez la commande bfimport sans option.
  • Pour afficher une liste récapitulative des objets Build Forge dans le fichier XML ainsi que leurs noms, utilisez la commande bfimport -L <nom_fichier.xml>.
  • Sur la plateforme zLinux, vous devez exécuter la commande sous la forme bfexport.pl. Pour toutes les autres plateformes, la commande ne requiert aucune extension.
  • Si vous n'indiquez aucune option, aucun objet n'est importé. Vous devez indiquer des options pour importer les objets individuels.
  • Si vous indiquez des options pour des objets qui n'existent pas, l'utilitaire d'importation passe les objets qui ne figurent pas dans le fichier XML et importe les objets qui s'y trouvent.

Exemples

Pour répertorier les objets Build Forge® figurant dans le fichier XML, indiquez uniquement l'option -L et le nom du fichier XML. L'exemple suivant affiche un résultat de commande partiel.

C:\Program Files\IBM\Build Forge>bfimport -L samples\projects\basic.xml
10/07/2008 5:31:55 PM: Import: 7624: CRRBF20081I: Importing export
file from a 7.0.10025 version console.
Project : [Basic Sample]
	Tag Variable : [MAJ]
	Tag Variable : [MIN]
	Step : [Checkout Source]
	Step : [Update Applet Version]
	Step : [Create Baseline]
Environment : [Basic Environment]
Class : [Production]
Filter : []
Selector : [Web Server]
Selector : [Local Server]

Pour importer tous les objets dans un fichier XML, indiquez les options des objets à importer, comme indiqué dans l'exemple suivant. Les objets sont renommés lors de l'importation. Une instruction de réussite s'affiche si l'importation a aboutit.

C:\Program Files\IBM\Build Forge>bfimport -p -I -s -S -e -c -C -u -T -d -f 
"samples\projects\basic.xml"

Descriptions des options

Option Description
<nom_fichier.xml> Le nom du fichier d'exportation XML qui contient les objets Build Forge® à importer. Le fichier XML doit être créé à l'aide de la commande bfexport ou de la commande point .export. Le nom du fichier XML est obligatoire et vous devez indiquer le nom de fichier si le fichier XML n'est pas le répertoire actuel, celui à partir duquel vous exécutez la commande bfexport.

Si le nom de fichier contient des espaces, vous devez mettre le nom entre guillemets.

-L

Répertorie les objets dans le fichier d'exportation XML ainsi que leurs noms d'objets. Utilisez cette option seule ; ne l'indiquez pas avec d'autres options bfimport. Le résultat de l'option -L peut être envoyé vers la sortie standard ou réacheminé vers un fichier XML ou un fichier texte.

-p Importe les données de configuration du projet à partir du fichier XML. Les données de configuration du projet incluent des données de définition du projet et de l'étape, y compris les variables de balises.

Lors du changement de nom, un nom de projet est importé dans l'interface utilisateur sous la forme <nom_projet>_IMPORT_<numéro>.

-I Importe des projets ou des bibliothèques chaîné(e)s référencé(e)s au niveau du projet ou de l'étape.

Lors du changement de nom, un projet ou une bibliothèque chaîné(e) est importé(e) dans l'interface utilisateur sous la forme <nom_projet_ou_bibliothèque>_IMPORT_<numéro>.

-S Importe les objets de sélecteur définis dans l'interface utilisateur.

Lors du changement de nom, un sélecteur est importé dans l'interface utilisateur sous la forme <nom_sélecteur>_IMPORT_<numéro>.

-s Importe les objets de serveur définis dans la console de gestion si l'option -s est indiquée pour la commande bfexport.

Lors du changement de nom, un serveur est importé dans l'interface utilisateur sous la forme <nom_serveur>_IMPORT_<numéro>.

Les mots de passe d'autorisation d'accès aux serveurs ne sont pas inclus dans le fichier d'exportation XML ; vous devez les entrer manuellement.

-e Importe des environnements ainsi que leurs variables référencées au niveau du projet ou de l'étape.

Lors du changement de nom, un environnement est importé sous la forme <nom_environnement>_IMPORT_<numéro>.

-c Importe les classes référencées par les projets.

Lors du changement de nom, une classe est importée sous la forme <nom_classe>_IMPORT_<numéro>.

-C Importe les collecteurs attribués aux serveurs pour le projet si l'option -C option est indiquée pour la commande bfexport.

Lors du changement de nom, un collecteur est importé sous la forme <nom_collecteur>_IMPORT_<numéro>.

-u Importe les utilisateurs membres des groupes d'accès désignés pour la réception des notifications si l'option -g est indiquée pour la commande bfexport.

Lors du changement de nom, les informations destinées aux utilisateurs sont importées sous la forme <utilisateurs>_IMPORT_<numéro>

-T Importe les modèles de notification créés par l'utilisateur et attribués aux projets et aux étapes si l'option -n est indiquée pour la commande bfexport.

Lors du changement de nom, un modèle de notification est importé sous la forme <nom_modèle>_IMPORT_<numéro>.

-f Importe les filtres de journal attribués aux étapes du projet si l'option -n est indiquée pour la commande bfexport.

Lors du changement de nom, les filtres de journal sont importés sous la forme <nom_filtre>_IMPORT_<numéro>.

-d Importe les contrôleurs de domaine LDAP définis dans l'interface utilisateur si l'option -L est indiquée pour la commande bfexport.

Lors du changement de nom, les filtres de journal sont importés sous la forme <contrôleur_domaine_LDAP>_IMPORT_<numéro>.

-r Remplace les objets importés au lieu de les renommer. Par défaut, les objets importés sont renommés et la convention de dénomination suivante s'applique :
<nom_objet>_IMPORT_<numéro>

Pour les objets 7.1, si vous indiquez l'option de remplacement, la commande bfimport écrase les objets dans l'interface utilisateur pour les objets 7.1.

Pour les objets 7.0.2 et inférieur, les objets de cliché ne sont pas remplacés. Ils sont renommés à l'aide de la convention de dénomination suivante :
<nom_objet>_IMPORT_<numéro>
Important : Les objets de cliché sont évalués en vue de leur remplacement par leur identificateur unique universel (plutôt que par leur nom).

Pour plus de détails, voir Changement de nom et remplacement d'objets lors de l'importation.


Feedback