Highlight queries

In i2 Analyze, highlight queries can automatically navigate the data in the Information Store on the behalf of users, and present them with answers to the questions that they ask most frequently.

Highlight queries run when a user of i2 Analyze client software chooses a subject record. For example:

  • If the subject record is a car, then a highlight query might find its recent owners or its recent sightings.

  • If the subject is a cellphone, then a highlight query might find which other phones it calls most often - or who owns the phones that it calls most often.

  • If the subject is a person, then a highlight query might return their bank accounts; or the bank accounts that the person's accounts transact with; or the owners of those transacting accounts.

Technical background

Functionally, a highlight query is a predefined, type-specific, multi-level, conditional expand operation. Using the subject entity record as a seed, a highlight query searches the Information Store for entity records of a particular type that are connected to the seed by links of a particular type. After that, it can use those records as the seeds for another, similar search, and so on. The results that users see are the entity records found by the final search that the highlight query performs - which might be the first, or the second, or the sixth.

Because highlight queries are type-specific, they are tightly bound to the Information Store schema. Each entity type in the schema can have its own group of highlight queries that run when the user chooses a record of that type. Since highlight queries are targeted at finding specific relationships in your data, they are not typically portable between different entity types or different i2 Analyze deployments.

User experience

You can categorize highlight queries so that different users see different ones, but as a feature highlight queries are available to all i2 Analyze users. However, the user experience depends a little on which client software they're using.

  • In the i2 Enterprise Insight Analysis Investigate Add On, users can select records from search results or from lists of records that they flagged.

    Selecting a record opens a view that contains the information in the subject, plus a set of highlight panes that display the first five results from each highlight query for that record's type. Each highlight pane also contains a button that the user can click to show more information and more results.

    Alongside the highlight panes is a visualization of the results they contain, and users can click records in the visualization to navigate the results.

  • In the i2 Notebook web client and the Analyst's Notebook desktop client, the same functionality is available through the 360 view feature, which complements the chart and the Record Inspector.

    To choose a record as the subject of a 360 view, users can select it from search results or use the right-click pop-up menu from a chart item. The 360 view opens in a separate panel or window from the rest of the application.

In all cases, the highlight queries that you define are key to the user experience. It's likely that you'll work with users to create the highlight queries that they need.

Automatically generated highlight queries

When a deployment of i2 Analyze starts up for the first time, the server automatically generates a set of highlight queries from the Information Store schema. This set contains one highlight query for each entity type in the schema that appears in at least one list of valid link end types. Each highlight query searches for entity-link-entity structures in which the types of the target link and entity are the first valid types for such structures.

For example, imagine a simple schema that defines four entity types (Address, Car, Cellphone, and Person) and four link types (Calls, Owns, Related, and Resides). According to the link type definitions:

  • Cars can be linked to addresses, through Resides links

  • Cellphones can be linked to other cellphones, through Calls links

  • People can be linked to addresses (through Resides links), to cars and cellphones (through Owns links), and to other people (through Related links)

In this scenario, with the automatically generated highlight queries in place, a user who selects a cellphone record sees a highlight pane containing a list of cellphones that the first cellphone has called. (Calls is the only valid link type for cellphones, and Cellphone is the only valid end type.)

If the user selects a person record, they see a highlight pane containing a list of the cars that the person owns. (Owns is the first valid link type for people, and Car is the first valid end type for such links.)

Custom highlight queries

The automatic mechanism for generating highlight queries is designed only to be a starting point. When you write your own highlight queries, you can make them search for more complex relationships between the subject record and others in the Information Store.

For example, for data that matches the same schema as before, you might enable users to select a person record and see a list of people who reside at the same address (person-address-person), or to whom the subject makes cellphone calls (person-cellphone-cellphone-person).

To create a set of custom highlight queries for your data and your users, you write an XML configuration file that is valid according to an XSD file that is derived from the Information Store schema. Subsequent topics describe how to start, edit, and publish a highlight queries configuration for your deployment of i2 Analyze.