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