Select an index of a message array

To select an array entry, here are the three (3) ways:

Directly indexing Process in Speech Analytics in which the Speech Application Service retrieves transcribed interactions, and builds a semantic index based on this data. to a specific entry
Selecting the first matching entry for a defined condition
Selecting the last matching entry for a defined condition

Selecting an array entry

As part of the customized attribute mapping, the selector will choose the first array entry with matching criteria and selectorLast will choose the last array entry with matching criteria. Each option is described in detail in the following definition table:

Option	Description
index Repository of transcribed interactions, which are used for analysis in Speech Analytics.	Allows you to indicate which value in a sequence you want to use. Specifying a negative one (-1) indicates that the last array entry should be selected. Other negative values are ignored. Example: (5) – selects the 5th item (-1) – selects the last item, regardless of array length Example: Folder<event> Array<participants> [2] [0]: Str<purpose> = customer ; Str<address> = 5551234 ; Str<name> = Bob [1]: Str<purpose> = agent ; Str<address> = 5556789 ; Str<name> = Charlie If we want to extract out the address from index one (1) from the participants array, the extraction syntax is event.participants(1).address which results in '5556789' being tagged to the attribute.
selector	Use the selector syntax for a given entry index into an array that can be dynamically chosen based on a field within the array. Assuming a data structure as follows: Example: Folder<event> Array<participants> [2] [0]: Str<purpose> = customer ; Str<address> = 5551234 ; Str<name> = Bob [1]: Str<purpose> = agent ; Str<address> ; Str<name> = Charlie If we want to extract out the customer address field, the extraction syntax is event.participants(selector:purpose=customer).address
selectorLast	Allows you to indicate a specific array entry based on a key-value criteria provided. The key and value are separated by the equals (=) character. The 'selectorLast' will choose the last array entry with matching criteria. Example: Folder<event> Array<participants> [4] [0]: Str<purpose> = customer ; Str<address> = 5551234 ; Str<name> = Bob [1]: Str<purpose> = agent ; Str<address> = 5556789 ; Str<name> = Charlie [2]: Str<purpose> = queue Entity that represents demand in WFM. Queues help predict workload by multiplying the volume of customer interactions by their expected handling time. ; Str<address> = 8888 ; Str<name> = first_queue [3]: Str<purpose> = queue ; Str<address> = 9999 ; Str<name> = second_queue If we want to extract out the address field of the last queue, the extraction syntax is event.participants(selectorLast:purpose=queue).address which results in '9999' being tagged to the attribute.

Option

Description

index Repository of transcribed interactions, which are used for analysis in Speech Analytics.

Allows you to indicate which value in a sequence you want to use.

Specifying a negative one (-1) indicates that the last array entry should be selected. Other negative values are ignored.

Example: (5) – selects the 5th item (-1) – selects the last item, regardless of array length

Example:

Folder<event>

Array<participants> [2]

[0]: Str<purpose> = customer ; Str<address> = 5551234 ; Str<name> = Bob

[1]: Str<purpose> = agent ; Str<address> = 5556789 ; Str<name> = Charlie

If we want to extract out the address from index one (1) from the participants array, the extraction syntax is

event.participants(1).address which results in '5556789' being tagged to the attribute.

selector

Use the selector syntax for a given entry index into an array that can be dynamically chosen based on a field within the array. Assuming a data structure as follows:

Example:

Folder<event>

Array<participants> [2]

[0]: Str<purpose> = customer ; Str<address> = 5551234 ; Str<name> = Bob

[1]: Str<purpose> = agent ; Str<address> ; Str<name> = Charlie

If we want to extract out the customer address field, the extraction syntax is

event.participants(selector:purpose=customer).address

selectorLast

Allows you to indicate a specific array entry based on a key-value criteria provided. The key and value are separated by the equals (=) character.

The 'selectorLast' will choose the last array entry with matching criteria.

Example:

Folder<event>

Array<participants> [4]

[0]: Str<purpose> = customer ; Str<address> = 5551234 ; Str<name> = Bob

[1]: Str<purpose> = agent ; Str<address> = 5556789 ; Str<name> = Charlie

[2]: Str<purpose> = queue Entity that represents demand in WFM. Queues help predict workload by multiplying the volume of customer interactions by their expected handling time. ; Str<address> = 8888 ; Str<name> = first_queue

[3]: Str<purpose> = queue ; Str<address> = 9999 ; Str<name> = second_queue

If we want to extract out the address field of the last queue, the extraction syntax is

event.participants(selectorLast:purpose=queue).address which results in '9999' being tagged to the attribute.