Referência bfimport

Use o utilitário bfimport para importar definições para projetos e outros objetos para a interface com o usuário que foram exportados anteriormente 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. Para objetos de captura instantânea, os objetos serão comparados por UUID em vez de por 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 seus nomes de captura instantânea e são importados como uma nova base ou captura instantânea de nível pai, 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

Antes de usar o utilitário bfimport, assegure-se de ter atendido a estes 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.
    Nota: Se um projeto que estiver importando tiver um grupo de notificação e o grupo de notificação não for um grupo integrado, como Build Engineer, Developer, Guest, Operator, System Manager, você deverá criar um grupo de acesso antes de importar.

Uso

Para concluir tarefas de importação comuns, utilize estas opções de comando:
  • Para exibir a sintaxe de comando, use bfimport sem opções.
  • Para exibir uma lista de resumos 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 requer 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 somente. 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 usando o comando bfexport ou o comando dot .export. O nome do arquivo XML é necessário e você deve fornecer o nome do caminho se o arquivo XML não estiver no diretório atual, o diretório do qual emite o comando bfexport.

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. Use esta opção sozinha; não especifique-a com outras opções 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 de LDAP definidos na interface com o usuário, 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 especificar a opção de substituição, o comando bfimport substituirá objetos na interface com o usuário por 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 usando a convenção de nomenclatura a seguir:
<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