Flow targets

Flow targets specify the sources and destinations of incoming and outgoing change sets. In a team setting, most workspaces have flow targets. Streams have flow targets only if they are part of a stream hierarchy.

Every workspace has a default flow target and a current flow target. Initially, these targets are both the same. The default flow target of a workspace, typically a stream, is initialized and set current when the workspace is created. The current flow target is the source of all incoming change sets and the destination of all outgoing change sets.

In a typical workflow, change sets that are delivered by other team members to one of your workspace flow targets display as incoming change sets for your workspace. Change sets that you create in your workspace display as outgoing change sets destined for a workspace flow target. The set of incoming and outgoing changes for a specific workspace is a function of workspace flow targets and workspace contents. If you change the flow target for a workspace, new incoming and outgoing change sets might be displayed, and existing ones might not. If your workspace includes change sets that are created by other users and those change sets are not present in a new flow target, they are classified as outgoing even though you did not create them.

A workspace that never collaborates with another workspace or stream has no flow targets and cannot accept or deliver change sets. This type of workspace, which is private to its owner, provides a way to manage changes and back them up in the repository but not to share them.

Flow scope

By default, all components in a workspace use the current flow target. You can use the workspace editor to add flow targets or change their scope so that not all components use them. For example, you can specify additional flow targets for some of the components in a workspace, or decide that a specific component must not flow to or from specific flow targets. (Removing a component from all flow targets makes all changes to it private to the workspace).

Flow direction

You can change the flow direction of the flow target. If you set the flow direction of the flow target to incoming, the repository workspace can only accept changes from the stream or repository workspace. If you set the flow direction to outgoing, the repository workspace can only deliver changes to the stream or repository workspace. You can also set the current incoming/outgoing flow and default incoming/outgoing flow direction. By default, the flow target is added with the flow direction as incoming and outgoing.