Adding Build Job Schedules

Follow this procedure to add a new build job schedule.

NOTE Before you add a build job schedule you must first create a build configuration and configure the Scheduler Service.

To add a build job schedule:

1. In Dimensions Build click the Build Scheduling tab.

2. In the navigation pane click Scheduling and select the Dimensions project containing the build configuration where you want to add a schedule.

3. In the menu area click Schedule or in the Scheduled Build Jobs section of the content pane click New.

The Add Scheduled Build Job dialog box appears.

4. From the Dimensions Project list select a Dimensions project.

5. From the Build Configuration list select a build configuration. To build all configurations select All configurations.

6. From the Version list select the version of the build configuration that you want to build. If you are building all configurations this option is set to Latest and you cannot change it.

7. From the Build Area list select the build area where you want the build configuration to be built. To build all build areas associated with the build configuration select All areas. If you are building all configurations this option is set to All areas and you cannot change it.

When you setup the build configuration and attached a build area, 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:

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

2. Type and confirm a password for each user.

3. Click Save.

8. From the Build Target list select the build target to be built. To build all build targets for the build configuration select All targets. If you are building all configurations this option is set to All targets and you cannot change it.

9. To specify a start time for the build job schedule do the following:

1. Click the down arrow to the right of the Start Time field.

The calendar picker appears.

2. From the Month list select a month, or use the left and right arrows to scroll through the months.

3. From the Year list select a year.

4. Select a date. 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).

5. From the Time lists select an hour, minute, and PM or AM.

6. To use this start time click the tick button at the top right corner of the calendar picker.

The start time appears in the Start Time field.

10. From the Time Out list optionally specify the minutes, hours, or days after which the build job is terminated if it has not finished.

11. Select the Execute clean-up script before build checkbox 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).

12. Select the Do not transfer sources checkbox if you do not want copies of the source files retrieved to the build area.

13. Select the Do not preserve targets checkbox if you do not want the target files to be preserved in Dimensions.

14. (If you are preserving targets) From the Select Dimensions Project for targets preservation list, select the Dimensions project to receive the target files produced by the build. This list is not displayed if you select the Do not preserve targets option.

15. If this is a one-time schedule for a future build job that you do not want to repeat, click OK. The new build job schedule is added to the content pane.

NOTE If passwords are required at runtime for the build areas but you have not specified them (see step 7), you are prompted for the passwords.

To set the schedule to recur see Scheduling the Frequency and Range of Recurring Build Jobs.

Managing Build Configurations

Configuring the Scheduler Service

Scheduling the Frequency and Range of Recurring Build Jobs

Modifying Build Job Schedules

Deleting Build Job Schedules