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