Viewing Call Details

Viewing Call Details

The Call Details tab lists the calls returned by a Call Viewer query, and displays the events associated with these calls. Clicking an event in the left pane displays the properties of the event class in the right pane. To customize the display of calls and call events on the Call Details tab, use the Event Types and Advanced Event Filtering tabs, as described in the following sections.

• Event Types allows the user to select a set of events for display on the Call Details tab.

• Advanced Event Filtering allows the use of event properties to further narrow down the display on the Call Details tab.

Selecting the Events Displayed on the Call Details Tab

Use the Event Types tab to configure the list of events displayed on the Call Details tab. Typically, different sets of events are chosen, based on the analytical task the user is performing. Events are grouped into broad profiles, described in the following table.

To select the events displayed on the Call Details tab

1. In Call Viewer, click the Event Types tab.

2. Expand an event profile to display the individual events contained in the profile.

3. Click a profile to include all events in the profile, or click individual events.

4. On the Query menu, select Execute.

5. On the Call Details tab, in the left pane, expand individual calls to view the events.

6. To select subsets of events within the profile, toggle the check box next to individual events. It is possible to select multiple event profiles simultaneously. Any event that is contained in either profile will be displayed.

   Note  To ensure that the appropriate events appear in the logs for a collection of event types, the server administrator must set up the appropriate logging filters on Microsoft Speech Server.

   Note  Selecting an event class specified in the Event Types listings selects only event instances of that actual class, and not any of its subclasses. For example, selecting OnRecoEvent shows successful speech recognition events, but not successful DTMF recognition events, because the DTMF events are a subclass of the OnRecoEvent. The correct DTMF event is ExtendableRecogntionEvent, and this event should be selected explicitly in the Call Details tab to view these events.

Creating Custom Event Type Profiles

The previous section described using default event profiles to configure the list of events displayed on Call Details tab. The following procedure describes creating custom event profiles. Event profiles are stored on the local computer.

To create a custom event profile

1. In Call Viewer, click the New button.

2. In the Edit Profile dialog box, in Profile name, enter a name for the profile.

3. In Available events, select an event, and then click Add to add it to Displayed events.

4. Click OK.

Transporting Custom Event Profiles from Computer to Computer

Event profiles are time consuming to create and administrators often work on different computers. To use an event profile on a different computer, copy the file CallViewerEventProfiles.xml to the target computer. CallViewerEventProfiles.xml can be found at this path: Documents and Settings\<username>\Local Settings\Application Data\Microsoft Corporation\Microsoft Speech Application SDK 1.1\SDKTools\Log Analysis, and should be copied to the same path on the target computer.

Using Event Properties to Configure the Call Details View

Use the Advanced Event Filtering tab to further select the events displayed by using event properties as a filter. For example, a filter can be created to show only Task events where the CompletionState property shows some kind of failure value. Event filters are saved as part of the query.

Creating an advanced filter for an event has no effect unless that event, or any event derived from it, is selected in the Event Types tab. For more information on the event hierarchy displayed on the Advanced Event Filtering tab, see the Event Logging Class Hierarchy topic.

To use event properties for further filtering of events

1. In Call Viewer, click the Advanced Event Filtering tab.

2. Expand the event hierarchy to locate and select the desired event for filtering, and then click Edit.

3. In the edit dialog box, click the cell in the Property column to display the drop-down list box.

4. Select a property to filter on, select an Operator value, and enter a value to filter for.

5. Enter additional query rows if needed, and then click OK.

6. On the Query menu, click Execute.

The following example filter shows only TaskComplete events where the CompletionState property has a fail value of some kind.

TaskComplete where CompletionState like %Fail%

Queries specified on the Advanced Event Filtering pane can be used not only to filter the events that are viewed but also to filter the set of calls that are viewed. To apply the query to call selection, on the Call Filtering pane, select Hide all calls not containing events matched by the filters specified in the Advanced Event Filtering.

Listening to the Audio Associated with a Call

For QASummary logging classes with an associated listen element, and for ListenElementCompleteEvent classes, it is possible to listen to the recorded audio from the call. The playback includes audio from the entire duration of the listen.

Note  If bargein is enabled, the recording might include fragments of the prompt quietly being recorded as part of the listen, especially if the user is talking over a speaker phone. Prompt-only audio is not available from the .etl log files.

Note  Audio playback in Call Viewer for QASummary events is not available if the ListenElementFiredEvent is not present in the Call Viewer database. This is the case regardless of whether audio data is recorded in the log. To avoid this problem, ensure that the set of logging filters active on Microsoft Speech Server includes the ListenElementFiredEvent.

Note  When using the RecognitionAudio logging filter, the ListenElementCompleteEvent is recorded, while ListenElementFiredEvent is not recorded. In this case, if a recognition results in a silence, then the audio played back in Call Viewer may be incorrect.

To listen to recorded audio

1. In Call Viewer, on the Call Details tab in the left pane, expand a call.

2. Select either a QASummary event class with an associated listen element, a ListenElementCompleteEvent event class, or a RecognitionCompleteEvent event class.

3. In the lower right corner of Call Viewer, click Play Audio.

Exporting the Audio Associated with a Call

When accessing the audio in a call as described in the procedure in the previous section, it is possible to use Windows Media Player to export the audio to a .wav file.

Exporting recorded audio to a .wav file

1. Follow the first two steps in the previous procedure, under the heading "To listen to recorded audio".

2. In the lower right corner of Call Viewer, select Use Windows audio player, and click Play Audio.

3. In Windows Media Player, on the File menu, click Save As.

4. In the Save As dialog box, in File Name, enter a file name with a .wav extension.

5. Click Save.

See Also

Call Viewer