Modifying Build Configurations

To modify an existing build configuration, there are two procedures, depending on whether you want to modify the properties and scripts, or the build areas, targets, sources, and options.

To modify the properties or scripts of an existing build configuration:

  1. In the Build Administration Console, select the Build Management tab if it is not selected already.

  2. Expand the Dimensions Projects tree until you can see the build configuration that you want to modify.

  3. Select the build configuration. The Build Configuration Details, Build Areas, and other related sections appear in the content pane.

  4. Check out the build configuration if it is not checked out already.

  5. Click the Edit/View icon.

  6. The Edit Build Configuration dialog box appears.

  7. Use the Properties tab to edit the project details and time out details, as described in Setting Build Configuration Properties.

  8. Use the Pre-Script tab to edit or specify the details of the script, if any, that is to be executed before the build is launched (but after source files have been transferred to the build area). See Modifying a Build Configuration Script.

  9. Use the Main Script tab to edit or specify the details of the main script. See Modifying a Build Configuration Script.

  10. Use the Post-Script tab to edit or specify the details of the script, if any, that is to be executed after the build is launched. See Modifying a Build Configuration Script.

  11. Use the Clean-Up Script tab to edit or specify the details of the script, if any, that is to be executed before the build is launched (and before any source files are transferred into the build area). See Modifying a Build Configuration Script.

To modify the build configuration details, build areas, targets, sources, build options, or build option groups associated with a build configuration:

  1. In the Build Administration Console, click the Build Management tab.

  2. Expand the Dimensions Projects tree until you can see the build configuration that you want to modify.

  3. Check out the build configuration if it is not checked out already.

  4. Select the project containing the build configuration. The Build Configurations Details section appears, along with the tabs for Build Areas, Build Targets, and Build Options.

  5. To edit the project details and time out details, click the pencil icon next to the Build Configuration Details section title. Make the desired changes as described in Setting Build Configuration Properties.

  6. To change a build area used by the build configuration, select the build area and click the pencil icon next to the Build Areas section title. Make the desired changes as described in Modifying Build Areas.

  7. To change a build target used by the build configuration, select the build target and click the pencil icon next to the Build Targets section title. Make the desired changes as described in Modifying Build Targets.

  8. To change a build source used by the build configuration, click the Sources tab, then select the check box next to the build source to be edited and click the pencil icon next to the Build Targets section title. Make the desired changes as described in Modifying Build Sources.

  9. To change a build option used by the build configuration, select the build option and click the pencil icon next to the Build Options section title. Make the desired changes as described in Modifying Build Options.

  10. To change a build option group used by the build configuration, click the Option Groups tab, then select the check box next to the build option group to be edited and click the pencil icon next to the Option Groups section title. Make the desired changes as described in Modifying Build Option Groups.