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"