4. The StreamBrowser : Working in the StreamBrowser : Working with Stream Properties

Working with Stream Properties
A stream property is a name/value pair you associate with a stream. Values can be strings or files. For example, you might want to create a property named nightly_build for your build stream, and specify a log file as its value -- 2_20_14_build.txt. You can use special stream properties, called reserved properties, to set display characteristics of streams in the StreamBrowser. See Using Reserved Properties for more information. Note that stream properties are not TimeSafe; if you edit or remove a property, you cannot roll back to the prior name/value pair.
This section describes how to create and manage stream properties using the AccuRev GUI. You can also set and manage stream properties -- including reserved stream properties -- using the AccuRev CLI. See setproperty of the CLI User’s Guide or the CLI help for more information.
Note: Do not confuse stream properties with configuration settings for a stream (such as stream name and basis time). You manage a stream’s configuration settings through the Change Stream dialog box. See Reconfiguring a Stream for more information.
Creating a Stream Property
To create a stream property:
1.
Alternatives: If the stream already has one or more properties defined for it, you can click the stream properties icon (), or choose Actions > Properties from the menu.
The Stream Properties dialog box appears.
Tip: Both the Name and Value columns can be resized.
2.
Click the Add button.
The Set Stream Property dialog box appears.
3.
4.
Note: You cannot use reserved words streamStyle or streamCustomIcon when setting stream properties using the AccuRev GUI. See Using Reserved Properties for more information.
For a file value, type the full path and file name in the entry field, or click the Browse... button to navigate your file system and select the file. (See Working with File Type Values for more information on using files for stream property values.)
Tip: To use a stream property as a "tag" or label, leave the Value field empty.
5.
The Set Stream Property dialog box closes, and the new stream property appears in the Stream Properties dialog box.
Note: If you specify a file for the stream property value, AccuRev displays only the file’s name, and not its full path, in the Value field of the Properties for Stream: list.
6.
If you want to add another stream property, click Apply to save your work and then return to Step 2. Otherwise, click Ok to save your work and close the Stream Properties dialog box.
Editing a Stream Property
When you edit a stream property, you can change its value (including the value type), but you cannot change the property’s name. To rename a stream property, first remove the stream property as described on page 158 and then create a new stream property with the name you want.
To edit a stream property:
1.
Alternatives: Click the stream properties icon () on the stream, or choose Actions > Properties from the menu.
The Stream Properties dialog box appears.
2.
The Set Stream Property dialog box appears. For example:
3.
4.
The Set Stream Property dialog box closes, and the revised stream property appears in the Stream Properties dialog box.
5.
If you want to edit another stream property, click Apply to save your work and then return to Step 2. Otherwise, click Ok to save your work and close the Stream Properties dialog box.
Removing a Stream Property
To remove a stream property:
1.
Alternatives: Click the stream properties icon () on the stream, or choose Actions > Properties from the menu.
The Stream Properties dialog box appears.
2.
Tip: You can use Shift+ click and Ctrl+ click to select multiple stream properties.
The properties you selected are removed from the Stream Properties dialog box.
3.
If you want to remove another stream property, click Apply to save your work and then return to Step 2. Otherwise, click Ok to save your work and close the Stream Properties dialog box.
Working with File Type Values
If you create a stream property that uses a file as its value, you can:
AccuRev displays the Save As dialog box, which you can use to save a local copy of the file associated with the stream property.
AccuRev displays a copy of the file in the editor associated with that file type.
Note that, in either case, you are not working with the file that was uploaded to the AccuRev Server when you created the stream property. If you change the local copy of the file and want to use the new version for the stream property value, you must edit the stream property and specify the file’s full path and file name as you did when you first created the property.
Using Reserved Properties
AccuRev supports reserved stream properties streamStyle and streamCustomIcon, which you can use to modify the display characteristics of any stream you choose:
streamStyle can be used to specify a stream color using a hex value. By default, dynamic streams have a white background and workspaces have a light yellow background. If you want, you can change the background color. You might want to manually highlight streams of interest, or use a script to set a stream color based on events -- to set a build stream to red if the build fails, and green when the build passes, for example.
streamCustomIcon can be used to set characteristics you might want to associate with a build stream. Such characteristics include:
You can define both streamStyle and streamCustomIcon reserved properties for the same stream, as shown in the int stream in the following illustration.
Unlike other stream properties, reserved properties can be set only through the CLI. See setproperty of the CLI User’s Guide or the CLI help for more information.

Micro Focus