Building Items


Follow this procedure to build one or more items. The items that you build are sources related to targets in a build configuration; the targets affected by the source items are the output of the build. You can also specify a wildcard as a source for a target. For example, if you specify *.java as the source for the target WebApp.jar, when you build any Java file the target WebApp.jar is built.

You can only build items if the Dimensions project/stream to which they belong has one or more build configurations. For details about creating build configurations see the Dimensions CM Build Tools User’s Guide or the Dimensions Build online help.

If you are building to deployment areas you must first assign them to the Dimensions project/stream associated with the build configuration. For details see the Deployment Guide.

You cannot build multiple item revisions that are at different stages.

About Build Configurations

The Build Configurations list in the Build wizard only displays build configurations:

In the example above Build_configuration_1 contains Item_1 that affects Target_1 and is displayed in the Build Configuration list. However, Build_configuration_2 is not displayed as the item it contains does not affect any targets.

The Build Configuration list shows the latest checked in versions of the build configurations in the following format:

<build configuration name>;<version>

For example, if you have two versions of the build configuration ANT_JAVA that are checked in, ANT_JAVA;1 and ANT_JAVA;2, the list displays:


PRIVILEGES  Build from a project/stream


To build items:

  1. In the desktop client open the project/stream containing the items that you want to build.

  2. In the My Current project/Stream window expand the Catalog node and select Items. In the Items object window select the items that you want to build.

  3. Note: You can also use other methods to display items that you want to select. For example, you can use the Find Item dialog box, run an item report, or open the Folders and Items view.

  4. From the Item menu select Build Items.

  5. The Build wizard appears. The first line displays the name of the current Dimensions project or stream.

  6. From the Build configuration list select the build configuration that you want to build.

  7. From the Build Stage list select the deployment stage at which the targets will be built. To build in a work area select <none>.

  8. From the Build Area list select the build or work area where the targets will be built. To build all deployment areas associated with the stage select <All areas>.

  9. If required, in the Build Area User field enter the ID of the Dimensions user who owns the build area. You also need to enter and confirm their password.

  10. If you are building in a work area do the following:

  11. If you select All or Selected Only you can also select the option Apply system date/time to downloaded files.

  12. Click Next.

  13. To capture the build outputs and check them into Dimensions CM, select the option Check in build outputs automatically.

  14. If you are checking in build outputs do the following:

  15. "QLARIUS_CR_44", "QLARIUS_CR_43"

  16. Click Next.

  17. Select build options:

  18.       Targets only in the current stage: only builds targets whose source is at the correct stage.

  19. Enter additional options in the Other build options field.

  20. Click Next.

  21. Choose target selections for the target list:

  22. If you change target selections, click Re-query to repopulate the target list.

  23. From the Build Targets list select one or more targets to build. The list displays all targets that are impacted by the objects that you selected to build. For each target in the list the following build dependency information is displayed:

  24.       Build Config: matches a rule in a build configuration (explicit relationship).

          BOM: named in a bill of materials (BOM) from a previous build (implicit relationship).

          Build Config/BOM: matches both of the above (explicit and implicit).

          <blank>: no matches were found for the selected objects.

          Prediction: the relationship is based on a previous revision of the item.

          Foreign: is related to an item in a different project or stream.


  25. Click Next.

  26. A summary of the build command that will be executed is displayed.

  27. Click Finish and monitor the progress of the build.

Related Topics

About Dimensions Build

Building Baselines

Building Projects or Streams

Building Requests

Viewing Impacted Targets

Auditing a Dimensions Project/Stream