Creating streams

Edit online

A stream is a repository object that includes one or more components. Streams are typically used to integrate the work that is done in workspaces. Team members deliver their own changes to the stream and accept changes from other team members into their repository workspaces from the stream.

About this task

You can create a stream to hold the versions of components that represent an important configuration of a system. A milestone release of a software development project is an example of one such configuration. A stable version of an open source software package is another. When team members deliver change sets from their workspaces to a stream and accept change sets that are delivered to the stream by other team members, the stream represents the current state of the development effort for the entire team. When deliveries to a stream are constrained by process controls (requiring code to be free of compilation errors, or reviewed and approved before delivery), the stream becomes a stable source of shared artifacts. All streams are flow targets of workspaces or other streams. Some streams (such as integration streams) have their own flow targets, which are typically established when the stream is created.

A stream can include several components. Any component in the repository can be made part of a stream, though typically the components in a stream have dependencies or functional relationships that make it sensible to group them. After you have created a stream, you can use the Stream editor to add components to it, remove them from it, or change the versions of one or more components in the stream.

Procedure

  1. In the web client, in the upper left, click the Home Menu icon. Expand Change and Configuration Management and click a project name.
  2. On the project page, click Source Control > Welcome to Source Control and, on the Welcome to Source Control page, click Create a stream.
    Note: Alternatively, click Source Control and, under Create, click Stream.
  3. In the New Stream Name field, enter a name for the stream.
    Note: In artifact names (titles), extraneous and redundant whitespace-related characters are removed or collapsed to a single space. For example, an artifact name entered as "<tab>Sample<space><space>Artifact<space>" is normalized to "Sample<space>Artifact".
  4. To change the project or team area that owns the stream, click Change Owner.
  5. To change the default visibility, click Change Visibility.
  6. Optional: In the Description field, enter a brief description for the stream.
  7. Optional: Under Components, complete one of the following steps:
    • To create a new component and add it to the stream, click the New icon Create component.
    • To search for existing components to add to the stream, click the Add icon Add component.
  8. Optional: To add a flow target, in the Flow Targets area, click Add and complete the Select a Stream or Workspace dialog box.
  9. Optional: In the Auto-lock files field, enter file name patterns separated by commas to automatically lock the files when edited.
  10. Click Save.
    Tip: If you want a backup of a stream, you can create a duplicate stream. The duplicate stream contains the same components, flow targets, auto-lock file patterns, and change sets as the original stream.

    To create a duplicate stream, in the stream editor, click the Duplicate stream icon Duplicate stream, type a name and description, and click Save.

    The duplicate stream contains the current versions of the components. To create a stream from a specific point in time, use a snapshot.

    Tip: If you have the administrative permissions, you can delete a stream in the stream editor by clicking the Delete Stream icon Delete stream.

    When you delete a stream, you confirm whether to create a backup snapshot that you can use to recover the stream contents, or to delete the stream without creating a backup.