Referencia de bfexport

Utilice el mandato bfexport para exportar datos de proyectos a un archivo XML con nombre o para enviar datos de proyecto al terminal de pantalla (stdout) para su visualización. Un archivo de exportación contiene datos de configuración del proyecto para un único proyecto o una única instantánea.

Sintaxis

bfexport

bfexport [-l]

bfexport [-l] <nombre_proyecto>
bfexport [-c "<comentario>"] [-f <nombre_archivo>] [-g] [-s] [-C] [-L ] [-n ] 
<nombre_proyecto> | <nombre_proyecto> <nombre_instantánea> | <id_proyecto>

Uso

Para completar las tareas de exportación de proyectos, utilice estas opciones de mandato:
  • Para mostrar la sintaxis del mandato, utilice bfexport sin especificar opciones.
  • Para enumerar los nombres de proyectos e ID de proyectos almacenados en la base de datos de Build Forge, utilice bfexport -l.

    Los nombres de instantáneas se añaden al nombre de proyecto en la salida del mandato: <ID_proyecto>: <nombre_proyecto> – <nombre_instantánea>

  • Para enviar datos de proyecto a un archivo XML, bfexport -f <nombre_archivo>. Debe especificar la opción -f <nombre_archivo> para generar un archivo que pueda utilizarse para importar datos de proyectos.
  • En la plataforma z/Linux, deberá ejecutar el mandato como bfexport.pl. En el resto de las plataformas, el mandato no requiere ninguna extensión.

Requisitos previos y restricciones

Encontrar el programa de utilidad bfexport en el directorio de instalación de Build Forge.

Las contraseñas de autorización de servidor de los servidores no se incluyen en el archivo de exportación; después de la importación, deberá especificar manualmente las contraseñas de autorización de servidor en la interfaz de usuario.

El mandato bfexport debe poder encontrar el archivo buildforge.conf y acceder a la base de datos de Build Forge. Ejecute bfexport desde el directorio donde se encuentra buildforge.conf, que es <bfinstall> en Windows y <bfinstall>/Platform en UNIX y Linux.

Ejemplos

Para grabar la salida en un archivo, utilice la opción -f <nombre_archivo>. En el siguiente ejemplo, helloworld es el nombre del archivo de salida y se utiliza el ID de proyecto en lugar del nombre del proyecto.

bfexport -c "Guardando una copia del proyecto antes de efectuar cambios" 
 -f helloworld 675B57CC-8366-11DD-B2E0-043C04E44E1A

Para exportar sólo la instantánea del proyecto predeterminada, utilice <nombre_proyecto>.

bfexport -f helloworld proyecto_prueba

Para exportar una instantánea de un proyecto, utilice <nombre_proyecto> <nombre_instantánea>.

bfexport -f helloworld proyecto_prueba instantánea_1

Si la instantánea del proyecto padre no es el proyecto predeterminado, deberá especificar el <nombre_proyecto> seguido de la palabra clave parent para exportar la instantánea del proyecto padre.

bfexport -f helloworld proyecto_prueba parent

Descripción de opciones

Opción Descripción
<nombre_proyecto> El nombre del proyecto que desea exportar. El nombre del proyecto o el ID del proyecto es necesario. Si el nombre del proyecto contiene espacios, deberá rodear de comillas el nombre.

Especifique el nombre de proyecto después de las opciones de mandato.

<nombre_instantánea> El nombre de la instantánea de proyecto que exportar; el nombre del proyecto es necesario, tal como se muestra en la siguiente sintaxis:
<nombre_proyecto> <nombre_instantánea>

Especifique el nombre de proyecto y el nombre de instantánea después de las opciones de mandato. Si el nombre de proyecto o de instantánea contiene espacios, deberá rodear de comillas el nombre.

<id_proyecto> El identificador del proyecto que exportar. El ID de proyecto es un UUID. El ID de proyecto o nombre de proyecto es obligatorio.

Especifique el ID de proyecto después de las opciones de mandato.

-f <nombre_archivo> Un nombre de archivo XML para la salida de bfexport. Si no proporciona un nombre de vía de acceso, se utilizará el directorio de trabajo actual. Si el nombre de archivo contiene espacios, deberá rodear el nombre de comillas.

Si no proporciona un nombre de archivo, la salida de bfexport se envía a stdout.

Nota: Utilice stdout sólo para visualizar. No redirija stdout a un archivo; el archivo resultante incluirá mensajes de registro y no podrá ser utilizado como un archivo de importación para el mandato bfimport o para el programa de utilidad de importación de la interfaz de usuario.
parent Una palabra clave requerida para exportar una instantánea de proyecto padre si el padre no es la instantánea de proyecto predeterminada.

Especifique la palabra clave parent después del nombre de instantánea del proyecto:

bfexport -f helloworld proyecto_prueba parent
-l Lista los proyectos en la base de datos por nombre e ID de proyecto. No puede utilizar la opción -l con otras opciones.
- c "<comentario>" Incluye comentarios. Debe rodear de comillas los comentarios (por ejemplo, "mi versión 50 del proyecto"). El comentario se añade al elemento XML <buildforge>.
-g Guarda en el archivo XML los usuarios miembros de los grupos de acceso designados para recibir notificaciones. Los usuarios y sus propiedades se listan en el elemento XML <usuario>. Require -s.
-s Guarda en el archivo XML los servidores definidos en la consola de gestión. Los servidores y sus propiedades se enumeran en el elemento XML <server> junto con cualquier información <auth> y <collector>.
-L Guarda en el archivo XML los controladores de dominio LDAP definidos en la interfaz de usuario. Los controladores de dominio LDAP y sus propiedades se listan en el elemento XML <ldap>.
-n Guarda en el archivo XML las plantillas de notificación asignadas al proyecto y pasos. Las plantillas de notificación y sus propiedades se listan en el elemento XML <mail-template>.
-C Guarda en el archivo XML los recopiladores asignados a los servidores del proyecto. Los recopiladores y sus propiedades se listan en el elemento XML <collector>. Require -s.

Resolución de problemas

Si se encuentra errores que indican que no se pueden encontrar bibliotecas o archivos de informe, asegúrese de que la vía de acceso a las bibliotecas se ha establecido de forma correcta.

Los valores correctos se encuentran en <bfinstall>/rc/buildforge. Compruebe la variable de la vía de acceso a la biblioteca así como otras variables establecidas en dicho archivo. Si es necesario, restablézcalas y, a continuación, expórtelas.


Comentarios