Utilice el programa de utilidad bfimport para importar definiciones de proyectos y otros objetos en la interfaz de usuario anteriormente exportados en un archivo XML. Puede también utilizar el programa de utilidad Importa para importar objetos seleccionados desde el archivo XML.
Este tema describe la sintaxis del mandato bfimport y proporciona detalles de utilización.
bfimport
bfimport [-L] <nombre_archivo>
bfimport [-p -I -s -S -e -c -C -u -T -f -d -r ] <nombre_archivo.xml>
bfimport [-L | [-p -I -s -S -e -c -C -u -T -f -d -r ]] <nombre_archivo.xml>
Las contraseñas de autorización de servidor de los servidores no se incluyen en el archivo de exportación; deberá especificar manualmente las contraseñas de autorización de servidor.
De forma predeterminada, durante la importación, si un objeto existe con el mismo nombre que un objeto importado, el nombre del objeto que está siendo importado será modificado para impedir que se sobregrabe el objeto de la base de datos. Como alternativa, puede seleccionar sustituir objetos con la opción -r si existe un objeto con el mismo nombre. En el caso de objetos de instantánea, los objetos se comparan según el UUID en lugar de su nombre.
De forma predeterminada, los objetos son denominados por bfimport y se utiliza el siguiente convenio de denominación:
<nombre_objeto>_IMPORT_<número>
Durante el cambio de nombre, los objetos de instantánea pierden su nombre de instantánea y son importados como una nueva instantánea base o de nivel de padre, incluso si el objeto de instantánea es un hijo de una instantánea padre.
Para obtener detalles sobre el cambio de nombre, consulte el apartado Cambiar el nombre y sustituir objetos al realizar la importación.
Para sustituir objetos, deberá especificar a opción -r. La opción de sustitución sobregraba los objetos existentes. Con los archivos de exportación en la versión 7.0.2 y anteriores, los archivos de instantánea no son sustituidos sino redenominados utilizando el convenio <nombre_objeto>_IMPORT_<número>. Con archivos de exportación de la versión 7.1, los objetos de instantánea se sustituyen si sus UUID coinciden.
Un archivo XML de exportación creado por el mandato bfexport o por el mandato de punto .export.
Encontrar el programa de utilidad bfimport en el directorio de instalación de Build Forge.
El mandato bfimport debe poder encontrar el archivo buildforge.conf y acceder a la base de datos de Build Forge. Ejecute bfimport desde el directorio donde se encuentra buildforge.conf, que es <bfinstall> en Windows y <bfinstall>/Platform en UNIX y Linux.
Para enumerar los objetos de Build Forge en el archivo XML, especifique únicamente la opción -L y el nombre del archivo XML. El siguiente ejemplo muestra una salida parcial del mandato.
|
Para importar todos los objetos en un archivo XML, especifique las opciones de los objetos que desea importar, tal como se muestra en el siguiente ejemplo. Los objetos se redenominan durante la importación. Una sentencia muestra si la importación ha tenido éxito.
|
Opción | Descripción |
---|---|
<nombre_archivo.xml> | El nombre del archivo XML que contiene los objetos de Build Forge
que desea importa. Un archivo XML debe ser creado utilizando el mandato
bfexport o el mandato de punto .export. El nombre de archivo XML es obligatorio
y debe proporcionar el nombre de la vía de acceso si el archivo XML no está en el directorio
actual, el directorio desde el que ejecuta el mandato
bfexport. Si el nombre de archivo contiene espacios, deberá rodear el nombre de comillas. |
-L | Enumera los objetos en el archivo XML de exportación y sus nombres de objetos. Utilice esta opción sola, no la especifique con otras opciones de bfimport. La salida de la opción -L puede enviarse a stdout o redirigirse a un archivo XML o de texto. |
-p | Importa los datos de configuración del archivo XML. Los datos de configuración del proyecto
incluyen datos de definición de paso y proyecto, incluye variables de
código. Durante la redenominación, se importa un nombre de proyecto en la interfaz de usuario como <nombre_proyecto>_IMPORT_<número>. |
-I | Importa proyectos encadenados o bibliotecas referencias a nivel de proyecto
o nivel paso. Durante la redenominación, un proyecto encadenado o biblioteca se importa en la interfaz de usuario como <nombre_proyecto_o_biblioteca>_IMPORT_<número> en la interfaz de usuario. |
-S | Importa los objetos de selector definidos en la interfaz de usuario. Durante la redenominación, se importa un selector en la interfaz de usuario como <nombre_selector>_IMPORT_<número>. |
-s | Importa los objetos de servidor definidos en la consola de gestión,
si se especifica la opción -s para bfexport. Durante la redenominación, se importa un servidor en la interfaz de usuario como<nombre_servidor>_IMPORT_<número>. Las contraseñas de autorización de servidor de los servidores no se incluyen en el archivo XML de exportación; deberá especificar manualmente las contraseñas de autorización de servidor. |
-e | Importa los entornos y sus variables referenciadas a nivel de proyecto o
paso. Durante la redenominación, se importa un entorno como <nombre_entorno>_IMPORT_<número>. |
-c | Clases de importación referenciadas por proyectos. Durante la redenominación, se importa una clase como <nombre_clase>_IMPORT_<número>. |
-C | Importa recopiladores asignados a los servidores del proyecto, si se ha especificado
la opción -C para bfexport. Durante la redenominación, un recopilador se importa como <nombre_recopilador>_IMPORT_<número>. |
-u | Importa usuarios miembros de los grupos de acceso designados para recibir notificaciones
de correo electrónico, si se ha especificado la opción -g en
bfexport. Durante la redenominación, la información de los usuarios se importa como <usuarios>_IMPORT_<número> |
-T | Importa las plantillas de notificación creadas por usuarios asignadas a proyectos y pasos, si se ha especificado
la opción -n para bfexport. Durante la redenominación, se importa una plantilla de notificación como <nombre_plantilla>_IMPORT_<número>. |
-f | Importa los archivos de registro asignados a pasos de proyecto si se ha especificado
la opción -n con bfexport. Durante la redenominación, los archivos de registro se importan como <nombre_filtro>_IMPORT_<número>. |
-d | Importa los controladores de dominio LDAP definidos en la interfaz de usuario, si se ha especificado
la opción -L con bfexport. Durante la redenominación, los archivos de registro se importan como <controlador_dominio_LDAP>_IMPORT_<número>. |
-r | Sustituye los objetos importados en lugar de cambiarles el nombre. De forma predeterminada,
los objetos importados son redenominados utilizando el siguiente
convenio de denominación:
Con objetos de la versión 7.1, si especifica la opción de sustitución, el mandato bfimport sobregraba los objetos en la interfaz de usuario de la versión 7.1. Los objetos de instantánea de la versión
7.0.2 y anteriores no son sustituidos. Son redenominados
utilizando el siguiente convenio de denominación:
Importante: Los objetos de instantánea se evalúan por sustitución por UUID en lugar de por nombre.
Para obtener más información, consulte el apartado Cambiar el nombre y sustituir objetos al realizar la importación. |