View impacted targets

You can view the targets impacted by items, a request, or a project/stream. This enables you to check what targets may need to be rebuilt if you change a source file.

To view impacted targets:

  1. In the desktop client, select the items, request, or project/stream for which you want to view impacted targets.

  2. In the toolbar, click Build and select Impacted Targets.

    Or from the Item, Request, or Project/Stream menus, select Impacted Targets.

    The Impacted Targets wizard opens.

  3. From the Build Configuration list, select the build configuration for which you want to view impacted targets.

  4. From the Build Stage list, select a deployment stage. To select a work area, select <none>.

  5. From the Build Area list, select a build or work area, and click Next.

  6. Choose target selections for the target list:

    Deployment analysis Runs dependency analysis.
    Predicted (using soft relationships) Displays targets based on a previous revision of an item. This is relevant when the selected revision has not yet been built.
    Foreign (cross project dependencies) Displays items that are related to items in a different project or stream.
    Side effect (from observed builds) Displays built items created at the same time as the main target, such as a compile listings and secondary targets.
    Configuration analysis Analyzes the build configuration.
    Final targets only Does not display intermediate targets.
    All targets Displays but does not necessarily select all targets in the build configuration.
    Targets impacted by related requests (requests only) Considers child requests as well as the parent request.
  7. If you change target selections, click Query to repopulate the target list.

    For each target in the Targets list the following build dependency information is displayed:

    Target The name of the target, as defined in Dimensions Build.
    Filename The filename of the target or mask, as defined in Dimensions Build.
    Found In

    The relationship of the objects that you are going to build to the target. Can be one of the following:

    • 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.

    Build Config The build configuration that you selected. The configuration version may be different from that in the Build configuration list (the latter is ignored when this data is processed).

    Can be one of the following:

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

    • Foreign. Related to an item in a different project or stream.

  8. Click Close.

Back to top

See also: