Find Out How

Repeats can be set using CloudTest properties such as the Global Property. In order to do so, one or more global properties is created before the test composition is edited. See Property for an introduction to CloudTest properties.

Setting Repeats using a Global Property List

The following example uses a global property list with two properties, Clip repeat count and Track repeat count. Refer to Create a Global Property for step-by-step instructions to create a global property list.

In the list shown on the right.

• Clip repeat count is set to 2.
• Track repeat count is set to 8. CloudTest uses track repeat count as a virtual user.

1. Open the test composition to edit.

2. Select the track.
3. Right-click the track's Repeat icon and then select Edit Properties.

The Properties tab appears with the track node selected in the list and its settings displayed on the right.

4. In the Properties - General tab, click the Repeat Type drop-down and select "Property: Fixed".

5. Enter the name of the Global Property for the track in the Repeat Value field using the type of property, the name of the property list, and finally, the property, using the following syntax: {%% property-type : property-path %%}.

Note: When specifying a Global Property there are only two fields, property-type and property-path, while when specifying a Custom Property there are three fields: property-type, item-type, and property-path.

For example, {%% global-prop : Demo By Property Fixed/Track repeat count %%}.

Note: This field cannot be used to specify a script— only a property.

7. Select the test clip.
8. Right-click the track's Repeat icon and then select Edit Properties.

The Properties tab appears with the clip node selected in the list and its settings displayed on the right.

9. Select "Property: Fixed" in the Repeat Type drop-down.

9. Enter the namee of the Global Property for the clip in the Repeat Value field.

For example, {%% global-prop : Demo By Property Fixed/Clip repeat count %%}.

Note: This field cannot be used to specify a script— only a property.

Once the repeat value is specified, save the test composition.

Play the test composition. When play is completed, the Result Details dashboard appears (unless a different default dashboard has been defined for this composition. If the dashboard doesn't display, open it, or add the Result Details widget to an existing custom dashboard.

Check the Navigation Tree box in the widget. When you do so, the Navigation tree for the test composition appears as shown on the right.

Using the navigation tree, verify that there are the expected number of virtual users (track repeats) as well as clip repeats. For example, in the sample Global property list above, there were 8 virtual users (e.g. 8 Track repeat counts) with a Clip repeat count of 2 (e.g. the test clip played twice per virtual user).

Additional complexity can easily be built using these techniques. For example, a composition with multiple tracks, each with its own property, or several tracks controlled by a single property, among many other options.

Setting Repeats from a Message Response

A message response that returns an integer can be extracted, placed into a custom clip property, which can then be used to set the repeat count for subsequent test clips via the ""Property: Fixed"" repeat type.

For example, in the screenshot on the right, the "First Clip" executes a message whose response contains an integer, 10, which is then placed into a property. The "First Clip" is set to local scope so that its property can be accessed by elements outside it within the same track

Open the "First Clip" in the Clip Editor, click the Properties tab in the lower panel, and then use the Plus icon to define a custom clip property to store a value. In this case, the value will be populated from a message response that contains an integer. Save the test clip after adding this property.

In the Clip Editor, populate the value of this custom property from the output (e.g. response field) by entering the custom clip property name entered above. The value can be typed, or, click the Property Chooser icon and select the custom property from the displayed properties.

In the example on the right, the Selected: Message1‘s response contains an output field, value1, from which a value is extracted and stored into the custom property called Received count.

In the Composition Editor, select the "Second Clip" and right click to select Edit Properties. In the lower panel, click the Repeat Type drop-down and define "Property:Fixed," using the Repeat Value field to enter the "First Clip" custom property path.

For example, {%% prop : track : First Clip/Received count %%}.

Note: For CloudTest builds earlier than 3925.34 this setting should be entered as {%% prop : First Clip/Received count %%}

Note: Ensure that the "First Clip" has local scope set in the Composition Editor, which is a requirement for external elements to access its data. See Setting and Using Message Scope.

Play the Composition by clicking the Play icon on the Composition Editor toolbar. When play is done, inspect the Result Details widget. Click Navigation Tree to show the hierarchy of composition elements. Note that in the shot on the right the "Second Clip" shows up 10 times.

With "First Clip" selected, click the Events List tab. The response value for value1 should match the total number of clip repeats for the "Second Clip" as shown above.