Stream components

The 2022.1 release of Helix Core Server introduced a featured called Stream components. Stream components allow stream client views to include other stream views. By referencing another stream, using the component syntax, that stream becomes a component of the consuming stream. Similar to import template paths, a stream component allows the stream client access to files outside of the current stream, but without the maintenance issues associated with keeping template paths up to date. For more details, see Stream Components in Helix Core Command-Line (P4) Guide.

Tip

It is a best practice to check out the stream spec before making changes, and only check in the stream when you are sure the changes are suitable for you and the other members of your team. See Edit a stream privately (recommended).

Stream components in P4V

To use the stream component feature in P4V,

  1. Create or edit a stream. (See Creating streams or Editing stream specs)

  2. In the Advanced tab Components section, specify one or more streams as components of your stream. For example,

//streams/A might have two component definitions such as

readonly dirB //streams/B
readonly dirC //streams/C@4

where //streams/B is at head and //streams/C@4 is at change 4.

When you save the stream definition, by default you are prompted to Get Latest so that the component files are added to your workspace view. (To change the default, see Behavior preferences for Update files when modifying workspace mappings.)

The View: field of the stream spec shows the effect of adding the stream components.

Note

The stream components feature is only available if your administrator has enabled it.

If the P4V version is prior to the 2022.2 release, Stream > Advanced lacks the Components section, but any stream components are listed in the Additional Fields section.

Find in streams dialog

The Find in Streams dialog uses the Source Path Type column to indicate import when the addition of a stream component causes the Path Type column to show import&, which indicates that a stream is importing a Stream View from a stream component.