create_build_record.pl

The create_build_record.pl script is an example of how to use the ClearQuest® API to create and populate a BTBuild record.

The create_baseline_record Perl script creates a BTBuild record. The script requires an existing ALMBaseline record name, a PVOB name, and the name for the new BTBuild record, as well as values for the ALMBuildStatus, ALMBuildType, and ALMProject fields. One or more BTBuild records can be created from and associated to an ALMBaseline record. Creating a BTBuild record off an ALMBaseline record sets up the associations to allow an ALMActivity list on a ALMTask record to display which BTBuilds the ALMActivity can be found in.

For a given ALMBaseline record one or more BTBuild records can be created from it.
Each BTBuild is associated to each of the ALMActivity records that are listed on the ALMBaseline record.
Each ALMTask record that lists the ALMActivity record lists each BTBuild record the ALMActivity participates in.

The -url option to populates the Build Web URL field on Build Details tab of the BTBuild record that the script creates.

The script should not be modified, and can be run from the command line. It has a -help option for information on all of the command line options.

Command line examples

For Windows (cmd.exe):

set ALM="C:\path\to\almscripts"
ratlperl "%ALM%\create_build_record.pl" ^
-user ReleaseEngineer -pw "" -dbname ALM -dbset CQMS.ALM.HOST ^
-projectid ALM00000002 ^
-pvob project_vob01 ^
-baseline BASELINE01 ^
-build Build_BASELINE01 ^
-buildstatus "Passed" ^
-buildtype "Platform"

For the UNIX system and Linux (/bin/sh):

ALM="/path/to/almscripts"
cqperl "${ALM}/create_build_record.pl" \
-user ReleaseEngineer -pw "" -dbname ALM -dbset CQMS.ALM.HOST \
-projectid ALM00000002 \
-pvob project_vob01 \
-baseline BASELINE01 \
-build Build_BASELINE01 \
-buildstatus "Passed" \
-buildtype "Platform"