Add Scheduled Build Job Dialog Box

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

- Use the Scheduled Build Job Details tab to specify the basic details of the build job schedule (see below).

- Use the Recurrence Tab to set the frequency of the recurrence.

- Use the Range of Recurrence Tab to specify when the recurrence will start and end.

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: aClick Provide passwords for selected areas. The Set Build Password(s) dialog box appears. bType and confirm a password for each user. cClick 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