Adding and changing workspace flow targets

Every workspace has one or more flow targets that specify the sources and destinations of incoming and outgoing change sets. You can modify the list of workspace flow targets and specify any one of them as the default.

About this task

Most repository workspaces have a default flow target that was established when the workspace was created. This flow target is typically a stream (the stream that you specified when you selected Flow with a stream when creating the workspace, or the stream from which you created a repository workspace), but it can also be another workspace. If you want to accept change sets from other sources or deliver them to other targets, you can use the Repository Workspace Editor to add and remove flow targets as needed.

You can also 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.

Procedure

  1. In the Pending Changes or Team Artifacts view, right-click your repository workspace and click Open.
  2. Navigate to the Flow Targets area of the Repository Workspace editor.
    All of the flow targets for the workspace are displayed. The default flow target and current flow target (which is typically the default flow target) are identified in the Default Flow and Current Flow columns.
  3. Click Add in the Flow Targets area.
    (To remove a workspace flow target, select it and click Remove.)
  4. In the Select a Stream or Workspace window, choose the flow target to search for.
    If the flow target that you want to add is not displayed, you can enter a text string to search for a stream or workspace whose name matches all or part of it. If you are not sure of the name of the stream or workspace but know the name of its owner, you can enter the name of the owner to see a list of streams or workspaces that are associated with that owner.
  5. Select an entry from the Recently Accessed Matches list and click OK to add the selected flow target.
  6. Click Save to save your changes.
  7. Optional: To change the flow direction for a repository workspace:
    1. In the Flow Targets area, select the repository workspace or stream and click Change Flow.
    2. In the Change Flow Target Direction window, select the direction of the flow of the selected target and click OK.
    3. In the Repository Workspace editor, click Save.
    Note: You can also set the current incoming/outgoing flow and default incoming/outgoing flow. The Pending Changes view displays the current flow direction.

Results

The new flow targets are added to the workspace. If any component in the workspace contains change sets that are not present in any of the new flow targets, those change sets are displayed in the Outgoing folder for the component when the flow target is set as the current flow target. If any of the new flow targets contain change sets that are not present in a component in the workspace, those change sets are displayed in the Incoming folder for the component when the flow target is set as the current flow target.

What to do next

Note: By default, all components in the workspace flow to and from the current flow target. You can edit any of the flow targets to specify that only a subset of components should be included in flows to and from that target. To edit a flow target, select it and click Edit. Flow targets that have been edited to specify a non-default flow scope are distinguished by the string (scoped) in the Flow targets list.