About Project and Stream Relationships

A project or stream can have the following relationships with other Dimensions objects.

Sub-Projects and Baselines

Projects can contain other projects in a hierarchical relationship (does not apply to streams). In the My Current Project view you can see any sub-projects that are related to your current project and you can access the items within them. A sub-project has a relative path, or folder offset, defined in conjunction with its relationship to the parent. This is used to determine the location of the item files that is used in item operations such as get, check out, or check in.

NOTE  This feature may not have been enabled in your UI profile.

For example there is a project called MainProject that has a project called Package1 related to it as a sub-project, with an offset path of "shared/package1". If MainProject was set as your current project and had a root folder set to "C:\Development\MainProject", this would mean that items in the top-level folder of project Package1 would have their files checked out by default to C:\Development\MainProject\shared\package1. An item in Package1 with a project path of include\header.h would therefore be checked out to C:\Development\MainProject\shared\package1\include\header.h.

You could also set your current project to Package1 with the root folder set to C:\Development\Child1. In this case the item with a project path of include\header.h would be checked out to C:\Development\Child1\include\header.h.

A baseline can also be used as a sub-collection of items within a project. In this case, when you get the items from the baseline into your work area they are copied by default to a path relative to the root folder specified by the folder offset defined in its relationship to the parent project in the same way as for a sub-project.