Referência bfimport

Use o utilitário bfimport para importar definições para projetos e outros objetos para a UI que foi anteriormente exportada para um arquivo XML. Você pode também usar o utilitário Importação para importar objetos selecionados do arquivo XML.

Este tópico descreve a sintaxe do comando bfimport e fornece detalhes de uso.

Sintaxe

bfimport

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

Restrições e Considerações

Senhas de autorização do servidor para servidores não são incluídas no arquivo de exportação; você deve inserir manualmente as senhas de autorização do servidor.

Por padrão, ao importar, se existir um objeto com o mesmo nome de um objeto importado, o objeto que está sendo importado é renomeado para evitar que o objeto do banco de dados seja sobrescrito. Ou então, você pode optar por substituir objetos com a opção -r se um objeto com o mesmo nome já existir. Em caso de objetos de captura instantânea, os objetos são comparados por UUID ao invés de pelo nome.

Por padrão, os objetos são renomeados por bfimport e a seguinte convenção de nomenclatura é utilizada:

<object_name>_IMPORT_<number>

Para renomear, os objetos de captura instantânea perdem o nome de captura instantânea e são importados como uma nova captura instantânea no nível pai ou base, mesmo se o objeto de captura instantânea for um filho de uma captura instantânea pai.

Para obter detalhes sobre como renomear, consulte Renomeando e Substituindo Objetos na Importação.

Para substituir objetos, você deve especificar a opção -r. A opção de substituição sobrescreve os objetos existentes. Para arquivos de exportação 7.0.2 e anteriores, os objetos de captura instantânea não são substituídos; em vez disso, eles são renomeados usando a convenção <object_name>_IMPORT_<number>. Para arquivos de exportação 7.1, objetos de captura instantânea são substituídos se as UUIDs corresponderem.

Pré-requisitos

Um arquivo de exportação XML que foi criado pelo comando bfexport ou pelo comando com pontos .export.

Encontre o utilitário bfimport no diretório de instalação do Build Forge.

O comando bfimport deve ser capaz de encontrar o arquivo buildforge.conf e acessar o banco de dados do Build Forge. Execute bfimport a partir do diretório em que buildforge.conf está localizado, o qual está em <bfinstall> no Windows e em <bfinstall>/Platform no UNIX e Linux.

Uso

Para concluir tarefas de importação comuns, utilize estas opções de comando:
  • Para exibir sintaxe de comando, utilize bfimport sem opções.
  • Para exibir uma lista de resumo dos objetos do Build Forge no arquivo XML e seus nomes, use bfimport -L <file_name.xml>
  • Na plataforma zLinux, você deve executar o comando como bfexport.pl. Para todas as outras plataformas, o comando não exige uma extensão.
  • Se você não especificar uma opção, nenhum objeto será importado. Você deve especificar opções para importar objetos individuais.
  • Se você especificar opções para objetos que não existem, o utilitário de importação ignorará os objetos que não estão no arquivo XML e importará os objetos que estão no arquivo.

Exemplos

Para listar os objetos do Build Forge no arquivo XML, especifique a opção -L e o nome do arquivo XML apenas. O exemplo a seguir exibe saída de comando parcial.

C:\Program Files\IBM\Build Forge>bfimport -L samples\projects\basic.xml
10/07/2008 5:31:55 PM: Import: 7624: CRRBF20081I: Importando arquivo
de exportação de um console da versão 7.0.10025.
Projeto : [Basic Sample]
	Variável de Tag: [MAJ]
	Variável de Tag: [MIN]
	Etapa: [Checkout Source]
	Etapa: [Update Applet Version]
	Etapa: [Create Baseline]
Ambiente: [Basic Environment]
Classe: [Production]
Filtro: []
Seletor: [Web Server]
Seletor: [Local Server]

Para importar todos os objetos em um arquivo XML, especifique as opções dos objetos a serem importados, conforme mostrado no exemplo a seguir. Os objetos são renomeados na importação. Uma instrução bem-sucedida é exibida se a importação foi bem-sucedida.

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

Descrições de Opções

Opção Descrição
<file_name.xml> O nome do arquivo XML de exportação que contém os objetos do Build Forge a serem importados. O arquivo XML deve ser criado utilizando o comando bfexport ou o comando com pontos .export. O nome do arquivo XML é necessário e é necessário fornecer o nome do caminho se o arquivo XML não estiver no diretório atual, o diretório a partir do qual o comando bfexport é emitido.

Se o nome do arquivo contiver espaços, você deverá colocá-lo entre aspas.

-L

Lista os objetos do arquivo XML de exportação e seus nomes de objetos. Utilize essa opção sozinha; não a especifique com nenhuma outra opção bfimport. A saída da opção -L pode ser enviada para stdout ou redirecionada para um arquivo de texto ou XML.

-p Importa dados de configuração do projeto a partir do arquivo XML. Os dados de configuração do projeto incluem dados de definição da etapa e do projeto, incluindo variáveis de tag.

Ao renomear, um nome de projeto é importado para a UI como <project_name>_IMPORT_<number>.

-I Importa projetos ou bibliotecas encadeados que são referidos no nível do projeto ou da etapa.

Ao renomear, um projeto ou biblioteca encadeado é importado para a UI como <project_or_library_name>_IMPORT_<number> na UI.

-S Importa os objetos do seletor que são definidos na UI.

Ao renomear, um seletor é importado para a UI como <selector_name>_IMPORT_<number>.

-s Importa os objetos do servidor que são definidos no Console de Gerenciamento, se a opção -s for especificada para bfexport.

Ao renomear, um servidor é importado para a UI como <server_name>_IMPORT_<number>.

Senhas de autorização do servidor para servidores não são incluídas no arquivo XML de exportação; você deve inserir manualmente as senhas de autorização do servidor.

-e Importa ambientes e suas variáveis que são referidas no nível do projeto ou da etapa.

Ao renomear, um ambiente é importado como <environment_name>_IMPORT_<number>.

-c Importa classes que são referidas por projetos.

Ao renomear, uma classe é importada como <class_name>_IMPORT_<number>.

-C Importa coletores que são designados aos servidores para o projeto, se a opção -C for especificada para bfexport.

Ao renomear, um coletor é importado como <collector_name>_IMPORT_<number>.

-u Importa usuários que são membros dos grupos de acesso designados para receber notificações por e-mail, se a opção -g for especificada para bfexport.

Ao renomear, as informações de usuários são importadas como <users>_IMPORT_<number>

-T Importa os modelos de notificação criados pelo usuário que são designados a projetos e etapas, se a opção -n for especificada para bfexport.

Ao renomear, um modelo de notificação é importado como <template_name>_IMPORT_<number>.

-f Importa os filtros de registro que são designados a etapas do projeto, se a opção -n for especificada para bfexport.

Ao renomear, os filtros de registro são importados como <filter_name>_IMPORT_<number>.

-d Importa os controladores de domínio do LDAP definidos na UI, se a opção -L for especificada para bfexport.

Ao renomear, os filtros de registro são importados como <LDAP_domain_controller>_IMPORT_<number>.

-r Substitui os objetos importados em vez de renomeá-los. Por padrão, os objetos importados são renomeados e a seguinte convenção de nomenclatura é utilizada:
<object_name>_IMPORT_<number>

Para objetos 7.1, se você especificar a opção de substituição, o comando bfimport substituirá objetos da UI para objetos 7.1.

Para objetos 7.0.2 e anteriores, os objetos da captura instantânea não são substituídos. Eles são renomeados utilizando a seguinte convenção de nomenclatura:
<object_name>_IMPORT_<number>
Importante: objetos de captura instantânea são avaliados para substituição por UUID ao invés de pelo nome.

Para obter detalhes, consulte Renomeando e Substituindo Objetos na Importação.


Feedback