create_baseline_record.pl

El script create_baseline_record.pl es un ejemplo de cómo utilizar la API de ClearQuest para crear y llenar un registro ALMBaseline.

El script Perl create_baseline_record crea un registro ALMBaseline. Esta operación conecta el nuevo registro ALMBaseline de nuevo a la línea base de UCM. Llena el registro ALMBaseline con las nuevas ALMActivities que encuentra. El registro ALMBaseline incluye referencias a los registros ALMActivity encontrados en la línea base de UCM. El script ejecuta una comparación con el registro ALMBaseline almacenado anteriormente. El script busca en las actividades de UCM actividades entregadas o cuya base haya cambiado a una secuencia y crea referencias a ALMActivities en el registro ALMBaseline. No es necesario que cree un registro ALMBaseline para cada línea base de UCM.

Puede compilar, probar y crear release a nivel de componente creando líneas bases. Es posible que una oferta de producto incluya todas las líneas base de los componentes de la oferta. En este ejemplo, el producto se compone de todos los componentes. Para simular que no es UCM, puede utilizar estas opciones de la línea de mandatos: -add_composed_of_baseline <línea base> and -add_pvob_or_location <ubicación>. Debe utilizar estas dos opciones para cada línea base compuesta. Dados una línea base y un nombre de pvob, se añade una referencia de registro de ALM correspondiente al nuevo registro de línea base en el campo Compuesto de líneas base.

El script create_baseline_record.pl se puede ejecutar desde la línea de mandatos y tiene la opción -help para obtener información sobre todas las opciones de la línea de mandatos.

Configuración de un registro de línea base en un proyecto nuevo

Un proyecto nuevo puede ser cualquier proyecto en el que no se ha realizado ningún trabajo de UCM anterior o un proyecto nuevo que se ha creado para trabajar con ALM. Las líneas base importadas en UCM son etiquetas importadas desde ClearCase y que incluyen líneas base de componentes iniciales. Para líneas base importadas para determinar la secuencia, puede pasar la secuencia en el script create_baseline_record.pl con la opción -ucmstream o puede crear una nueva línea base en el proyecto. Necesita como mínimo una actividad completada para crear una línea base. Si pasa esta nueva línea base al script create_baseline_record.pl, el script puede determinar la secuencia ya que se ha creado en el proyecto y no se ha importado. Si más adelante importa una etiqueta, debe crear una línea base en el proyecto posteriormente y utilizar esta nueva línea base con el script create_baseline_record.pl.

Nota: si fuerza una línea base con la opción mkbl -identical, causa dependencias de todos los componentes del proyecto que pueden impedirle volver a configurar el proyecto en el futuro.

Ejemplos de la línea de mandatos

El script de Perl se encuentra en el directorio pkg_util para la versión del paquete ALMWork que utilice (por ejemplo, <directorio de instalación>\IBM\RationalSDLC\ClearQuest\packages\ALMWork\1.0\pkg_util en Windows, y <directorio de instalación>/IBM/RationalSDLC/ClearQuest/packages/ALMWork/1.0/pkg_util en el sistema UNIX y en Linux). Puede copiar los scripts de ejemplo en el entorno de construcción y personalizarlos.

Se proporcionan versiones actualizadas de los scripts con cada nuevo release de ALM. Si dispone de copias personalizadas de los scripts, debe comparar los nuevos scripts de ejemplo para ver si hay cambios y aplicarlos en sus scripts personalizados, si es necesario.

Para Windows® (cmd.exe):
set ALM="C:\path\to\almscripts"
ratlperl "%ALM%\create_baseline_record.pl" ^
-user ReleaseEngineer -pw "" -dbname ALM -dbset CQMS.ALM.HOST ^
-projectid ALM00000002 ^
-baseline BASELINE01 ^
-pvob project_vob01 ^
-logfile %ALM%\logs\BASELINE01.log
Para el sistema UNIX® y Linux® (/bin/sh):
ALM="/path/to/almscripts"
cqperl "${ALM}/create_baseline_record.pl" \
-user ReleaseEngineer -pw "" -dbname ALM -dbset CQMS.ALM.HOST \
-projectid ALM00000002 \
-baseline BASELINE01 \
-pvob project_vob01 \
-logfile "${ALM}/logs/BASELINE01.log"

Comentarios