Evidence Tree – Interaction History
A map’s interaction history will provide more comprehensive information about queries that are run against the map than the map’s invocation statistics, which only records the volume of queries that have started or finished.
When viewing a map’s interaction history, you will be able to see a record of:
- when a query is started
- any facts that have been injected
- any facts retrieved by datasources
- any questions Rainbird has asked
- any responses that were given by the end user
- any undo operations (when an end user selects the ‘Back’ button)
- any answers Rainbird has returned.
While invocation statistics are always captured and cannot be disabled by a user, interaction history can be enabled and disabled by knowledge authors on a per map version level. By default, no interaction history will be recorded.
To enable interaction history collection for a given version or versions, knowledge authors must version the knowledge map and then on the ‘Live Version’ screen under the ‘Publish’ tab, select the ‘Record interactions’ checkbox next to the version you wish to record interaction history for.
Figure 1: Deselecting the checkbox will no longer record interactions
Note: Unless a version is made ‘Live’, interaction histories will be captured against the draft version.
The interaction history can be viewed in the ‘Stats & Reporting’ section of the ‘Publish’ tab. It gives a detailed review of the interaction that has occurred in any given query session and is available to download.
Figure 2: Interaction history lives under the ‘Stats & Reporting’ section of the publishing tab
In the ‘Stats & Reporting’ tab, the columns in the interaction history table are as follows:
- Date – the date when the query was started
- Version – the version number or ‘Draft’
- Subject – the query subject (limited to 42 characters)
- Relationship – the query relationship (limited to 42 characters)
- Object – the query object (limited to 42 characters)
- Flag – a priority flag
With the exception of the Flag column, the columns can be sorted, and with the exception of the date column, the columns can be filtered.
The Version column filter allows the knowledge authors to specify a particular version number or ‘Draft’.
The Subject, Relationship, Object and Flag column are select boxes. They allow authors to choose a single predefined filter option. In the case of Subject, Relationship and Object this will be based on the instance values.
Within Subject and Object there are two special values ‘- All -’ and ‘- Empty Value -’. ‘All’ removes the filter restriction and ‘Empty Value’ applies the filter to null data entries such as when only a partial query triple is provided.
The flags are colour coded and allow knowledge authors to use them in whichever way they desire, for example, to indicate priority or flag attention to queries that require investigation.
Figure 3: Interaction History screen
Clicking on a given row in the interaction history table will bring up details of the entire session that the query was a part of:
Figure 4: Detailed query breakdown
Figure 5: Clicking on a question will display additional information about the question
Question details include:
Version 1.02 – Last Update: 04/05/2021