Add Scheduled Build Job Dialog Box

The Add Scheduled Build Job dialog box allows you to add a new build job schedule.

Scheduled Build Job Details Tab

Field

Description

Rules and Guidelines

Dimensions Project

Select the Dimensions project containing the build configuration to which you want to add a schedule.

 

Build Configuration

Select the build configuration you are going to build.

To build all configurations select All configurations.

Version

Select the version of the build configuration you are going to build.

If you are building all build configurations this option is set to Latest and you cannot change it.

Build Area

Select the build area where you are going to build the targets.

Note: When you attached a build area to the build configuration, if you specified that a password is required at runtime, the Provide passwords for selected areas link appears to the right of the Build Area list.

To enable access by the users to the build areas when the scheduled job is run, you must provide a password for each user. Do the following:

a        Click Provide passwords for selected areas. The Set Build Password(s) dialog box appears.

b        Type and confirm a password for each user.

c        Click Save.

  • To build all build areas associated with the build configuration select All areas.

  • If you are building all build configurations this option is set to All areas and you cannot change it.

Build Target

Select the target that you are going to build

  • To build all build targets for the build configuration select All targets.

  • If you are building all build configurations this option is set to All targets and you cannot change it.

Start Time

Specify the time the build job schedule will start to run. To display the calendar picker click the arrow to the right of the field.

Dates with a light grey background occur on Saturdays and Sundays. Dates with a dark grey background occur in different months and you cannot select them (choose the next or previous month).

Timeout

Select the minutes, hours, or days after which the build job is terminated if it has not finished.

Optional

Execute clean-up script before build

Select this check box to have the clean-up script defined in the build configuration executed before the build begins (all files in the build area are removed before the build begins).

 

Do not transfer sources

Select this check box if you do not want copies of the source files retrieved to the build area.

 

Do not preserve targets

Select this check box if you do not want the target files to be preserved in Dimensions.

 

Select Dimensions Project for targets preservation

Select the Dimensions project to receive the target files produced by the build, or accept the default value of The same as parent Project.

Is only displayed if Do not preserve targets is unchecked.

Recurring

Displays the tabs that control the recurrence of the build job schedule.

 

Recurrence Tab

Range of Recurrence Tab

Recurrence Tab

Use the Recurrence Tab of the Add/Edit Scheduled Build Job dialog boxes to specify or modify the frequency of the recurrence of the build job. Select one of the following options and specify an interval:

Field

Description

Rules and Guidelines

Hourly

Specify the interval in hours that the build job will recur.

 

Daily

Specify the interval in days that the build job will recur.

 

Weekly

Specify the interval in weeks that the build job will recur.

Specify an interval in weeks and select the day(s) that the build job will repeat. For example, you can specify that the build job will repeat every week on Monday and Friday.

Monthly

Specify the interval in months that the build job will recur.

Specify the day and the month that the build job will repeat, for example day 16 of month 12.

Range of Recurrence Tab

Add Scheduled Build Job Dialog Box

Edit Scheduled Build Job Dialog Box

Range of Recurrence Tab

Use the Range of Recurrence Tab of the Add/Edit Scheduled Build Job dialog boxes to specify or modify when the recurrence of the build job will start and end.

Field

Description

Rules and Guidelines

Start

Specify the date and time the build job schedule will start to recur. To display the calendar picker click the arrow to the right of the field.

Dates with a light grey background occur on Saturdays and Sundays. Dates with a dark grey background occur in different months and you cannot select them (choose the next or previous month).

No end date

The build job recurs indefinitely until you modify or delete the build job schedule.

 

End after

Specify the number of times the build job will be repeated.

Maximum: 1000

End by

Specify the date that the build job will end by. To display the calendar picker click the arrow to the right of the field.

Dates with a light grey background occur on Saturdays and Sundays. Dates with a dark grey background occur in different months and you cannot select them (choose the next or previous month).

Add Scheduled Build Job Dialog Box

Range of Recurrence Tab

Edit Scheduled Build Job Dialog Box