View impacted targets

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

Web client: View impacted targets

You can review the build details for impacted targets in the web client.

To view impacted targets:

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

    If you do not select any objects, impacted targets are displayed for the current project/stream.

  2. On the toolbar, click Build , and select Show Impacted Targets. The Show Impacted Targets wizard opens.

  3. Select the following options and click Next:

    Option Description
    Build configuration Select the build configuration for which you want to view impacted targets.
    Build stage  Select a deployment stage. To select a work area, select <none>.
    Build area Select a build or work area.

  4. Specify target selections for the target list:

    Option Description
    Show all targets from build configuration Displays all targets from the build configuration.
    Show final targets only Does not display intermediate targets.
    Show foreign items Displays items that are related to items in a different project or stream.
    Show side-effect targets Displays files created at the same time as the main target, such as a compile listing.
    Show predicted targets Display targets based on the item's previous revision. This is relevant when the selected revision has not yet been built.
    Include targets impacted by related requests Requests only: Considers child requests as well as the parent request.

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

    For each target, the following build dependency information is displayed:

    Field Description
    Target The name of the target, as defined in Dimensions Build.
    Filename The file name 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 Build Config (explicit) and BOM (implicit).

    • <blank>: No matches were found for the selected objects.
    Build Config The build configuration you selected. The configuration version may be different from that in the Build configuration list (the latter is ignored when this data is processed).
    Details

    Can be one of the following:

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

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

  5. Click Cancel to exit the wizard.

Back to top

Desktop client: View impacted targets

You can review the build details for impacted targets in the desktop client.

To view impacted targets:

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

  2. From the Request, Project/Stream, or Item menu, select Impacted Targets. The Impacted Targets wizard opens.

  3. Select the following options and click Next:

    Option Description
    Build configuration Select the build configuration for which you want to view impacted targets.
    Build stage  Select a deployment stage. To select a work area, select <none>.
    Build area Select a build or work area.

  4. Specify target selections for the target list:

    Option Description
    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.

    If you change target selections, click Query to repopulate the target list.

    For each target, the following build dependency information is displayed:

    Field Description
    Target The name of the target, as defined in Dimensions Build.
    Filename The file name 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 Build Config (explicit) and BOM (implicit).

    • <blank>: No matches were found for the selected objects.
    Build Config The build configuration you selected. The configuration version may be different from that in the Build configuration list (the latter is ignored when this data is processed).
    Details

    Can be one of the following:

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

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

  5. Click Close to exit the wizard.

Back to top

See also: