Determine a Unique Identifier

The REST-based web service connections return complex data sets in an array-based numbered structure format. Any modification to the array list in the web service can change the index, resulting in the change of the tag position.

The WEBSVC Communication Driver allows array-based lists to be mapped to unique keys (unique identifier) such that the result set is exposed as a structure based on the unique name. To reference the result set by their name instead of by element numbers, you can map the numbered array elements to unique named elements within the result set.

You can select one or more elements of the tag name with unique value across the array results, and set as a unique key (identifier). When a test is executed again, value of the result set, which is now a name-based list instead of numeric index numbers, is displayed in all the tags.

1. Select Select Struct Array Key…

   The Array Struct Key Select dialog appears.

   

2. From the Struct Array Tags (left pane), select the the tags to create a unique key index.

3. Select > to move the tag to the Struct Array Key Tags (right pane). Select < to remove the selected tag from the Struct Array Key Tags list.

4. Select OK.

   The selected array displays in the Unique Identifier for Array based results grid.

5. Select Test again.

   The unique key is inserted in the tag name results under Unique Identifier for Array Based GET Results.

   

   Note: You can select both structured array tags and structured nested array tags as unique identifiers.