Managing global configurations

A global configuration groups configurations of several designs, and of other global configurations, into one consistent context. The users select a global configuration to see and link the right version of each design. When SECollab creates a project, it creates the stream <project> - Initial stream, the default global configuration of the project. For the concepts, see Configuration Management.

The Global configurations entry of the project administration lists the global configurations of the project, with their origin, their dates and their description.

Global configurations page

Use the Stream, Baseline and All buttons to filter the kind of global configuration. Use the Active and Archived buttons to show the active or the archived global configurations. The Actions column contains these icons:

Action Available on Effect
Edit Streams and baselines Changes the title and the description.
Create a baseline Streams Freezes the current state of the stream, with its contributions, in a new baseline. Type a title and an optional description, then click OK.
Create a baseline dialog
Create a stream Baselines Starts a new stream from the baseline, for example to prepare a new version.
Archive Streams and baselines, except the initial stream of the project Moves the global configuration to the Archived list. You can restore it from this list.
Delete Streams and baselines, except the initial stream of the project Deletes the global configuration, after a confirmation.

Managing the contributions of a stream

A contribution is a configuration that a global configuration contains. Click the title of a global configuration to open its details page. The tree on the left shows the contributions. The panel on the right shows the properties and the contributions of the selected item.

Details page of a global configuration

To add a contribution to a stream:

  1. Click Add a configuration.
  2. In the Configuration selection dialog, select the Project area. The list contains the current project and the projects that it uses (see Setting up a system of systems).
  3. Select the kind of configuration: Review Context, Global Configuration or Design Configuration. Design Configuration is available for the current project only: a global configuration cannot contain a design of another project.
  4. For a design configuration, select the design, then select its stream or one of its baselines. For a global configuration, select its stream or one of its baselines.
    Configuration selection dialog
  5. Click OK.

To change the order of the contributions, drag a first-level contribution in the tree to its new place. The order decides which configuration SECollab uses when the same component appears more than once (see Component skews).

To remove a first-level contribution, select it in the tree, click the arrow next to its title in the right panel, then click Delete. SECollab asks for a confirmation. The configuration still exists, but it no longer contributes to the global configuration.

When a contribution cannot be loaded, for example because its configuration was deleted, the tree shows a broken link icon and the right panel shows the message "Configuration could not be loaded". The Delete button is then next to the title.

Depending on how a design is published, its stream is not always added to the global configuration of the project. If the users do not see a design in a global configuration, add the stream of the design with Add a configuration. In a baseline, you cannot add, remove or reorder the contributions: create a new stream from the baseline first.

Setting up a system of systems

A system of systems (SoS) groups several projects. The global configuration of the SoS project takes the global configurations of the System projects as contributions, each at the stream or baseline that you select. Each System project keeps its own designs and its own global configurations. A System project can itself group other projects, so the hierarchy can have more than two levels.

  1. In the SoS project, add a project association to each System project: select the built-in friend SECollab (<server URL>), the Configuration Management domain and the System project. See Managing project associations.
  2. In the SoS project, open a global configuration stream and click Add a configuration.
  3. In Project area, select a System project.
  4. Select Global Configuration, then the stream or the baseline of the System project.
  5. Click OK. Do the same for each System project.

In a global configuration of the SoS project, the definitions of the project administration (link types, resource types, queries) come from the SoS project. See Managing your traceability model.

You see the contributions of a System project only if you can read this project. The tree of the details page and the Designs page do not show the configurations of the projects that you cannot read.

Component skews

A component is the container of the configurations of a design or of a project. In a system of systems, the hierarchy can contain several configurations of the same component, for example two versions of the global configuration of one System project. The details page then shows the warning Component skews detected.

SECollab reads the tree from top to bottom, in the order of the contributions, and uses the first configuration of each component that it finds. It ignores the other configurations of this component and their contributions. To choose which configuration SECollab uses, change the order of the contributions.

Click View details to see the skews. For each component, the dialog lists its configurations in their order. Locate in tree selects a configuration in the tree.

The page requires the Create, modify or delete version configurations (streams and baselines) permission.