Pre-loading an issues form

New issue forms naturally provide default values for each of the attributes. This means that a fresh form has empty TEXT_FIELDS, nothing selected on the X_OF_MANY's, and the first item selected for the ONE_OF_MANY attributes. It's possible, however, to have new issue forms come up with a programmable set of defaults.

There is a line in the Actions file which permits the attachment of a pre-load script. The initial setting of the line is as follows...

preload  n/a  n/a

To enable issue form preloading, replace the first "n/a" in the line above with the name of a script which is to be run. You must either enter the full pathname to the script, or be sure that the script is on the search path for whomever would be running the programs. (A good location for such scripts would be in the $RAZOR_UNIVERSE_DIR/Scripts directory, which is automatically placed on the search path by the rz_prep file.)

In order to set the default values for the issue form, the preload script should make a series of single line entries in the file $RAZOR_PRELOAD (which is an environment variable available to the script). Each line must have the label for the desired attribute, a tab, and the desired setting for each value you wish to establish.

An example preload script is shown below. It preloads the priority of a new issue to be High if the boss is creating it.

#!/bin/sh
if [ "$USER" = "boss" ]
then
    echo "Priority  High" > $RAZOR_PRELOAD
fi

Much more sophisticated arrangements can also be established. For example, a single preload script could look for a $HOME/bin/razor-preload script for each user. If present, it would run this instead of its own code. This would allow each person custom initializations.