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