Property-path field

This field specifies which property is to be accessed.

It can be a simple as only a property name, in which case the property will be taken from the “current” item of the type specified in the property-type field. For example, the current Message, its “destination”, or its parent Message Clip, Track, or Band.

In order to refer to other properties, a “path” to the property can be given, using the names of the containers of the property, separated by slashes.

For example, for type “Message”, the following path:

Band2/Track3/Clip2/Message5/MyProperty

Refers to the property named “MyProperty” in Message “Message5”, which is contained in Message Clip “Clip2”, in Track “Track3” of Band “Band2”.

If any of the names contain spaces, they must appear at their appropriate places, for example if the names in the above example contained spaces, the path would be:

Band 2/Track 3/Clip 2/Message 5/My Property

“Left” portions of the path may be omitted to provide “relative” paths which reference “current” item(s) and parent(s) according to the context in which the ISSE is used. For example, if the following path were to be used in the above example for a Message property:

Clip 2/Message 5/My Property

The ISSE would be referencing the specified Message Clip “Clip 2” and Message “Message 5” contained within the current Band and Track (since the Band and Track portions of the path were omitted).

There is a subtle difference between types “Destination” and “Target”.

For “Destination”, the path to a Message is given, and the specified item is the Target being used by that Message. For example:

Band5/Track6/Clip2/Message27/TargetPropertyName

For “Target”, a path to any arbitrary Target (by name) in any arbitrary Message Clip is given to specify any Target in any Clip. For example:

Band5/Track6/Clip2/Target7/TargetPropertyName

Note that for Message Clips and Targets, the “local name” (as defined in the Composition or Message Clip) must be used, not the name of the Repository item that is being linked to. (Since a Message Clip or Target can be used multiple times, the Repository Name is not necessarily unique.)