Teneo Developers

Working with Trigger relations

Intent Trigger relations

Relations between User Intent triggers are objects in their own right and can be managed too, just like the User Intent Triggers. In the top ribbon of the Intent Trigger Ordering window, the user will, in the Home tab, find the following areas related to managing relations: Triggers, Relations and Suggest Ordering.

Top ribbon of Ordering window

In this section the user will find described the Triggers and Relation areas, for ordering suggestions, please see the Suggest Ordering section.

Islands & singletons
Islands refers to the grouping of related Intent Triggers within an order group. Islands are created by Teneo Studio when asking for trigger ordering suggestions or when users manually create a relation between two Intent Triggers.
An Intent Trigger which has no relation to any other Intent trigger is called a singleton.

Selecting relations

Relations can be selected in different ways:

  • Select a single relation by clicking on the relation
  • Select multiple relations that are not close together by keeping the Ctrl key pressed while clicking each relation
  • Select multiple relations that are close together, e.g. in the same island, by dragging the cursor across the concerned relations while keeping the Shift key pressed.

Triggers area

Within the Triggers area of the top ribbon in the Home tab, the user will find the options Open, Extract and Bridge, Merge and Move.

Triggers area

Open

Open gives the options to either Open or open and Edit the flow of a selected trigger.

Extract, Bridge, Extract and Bridge

Extract and Bridge

Extract or Extract and Bridge gives the following three options:

  • Extract extracts the selected triggers as connected group(s), the order between all the triggers before the extracted group and after is not guaranteed
  • Bridge creates new relations from all triggers leading to this trigger and to all triggers after this trigger
  • Extract and Bridge extracts the selected triggers as connected group(s), the order between all the triggers before the extracted group and after remains unchanged

Extract

Use Extract to cut out one or more Intent Triggers from an island, maintaining any immediate relation of the selection.

Extract

  1. User Intent triggers C and D are selected
  2. User clicks Extract
  3. The extraction results in trigger C and D maintaining their relation while no relation is maintained nor added between Trigger B and the rest of the island

Bridge

Use Bridge to create a relation from all Intent Triggers preceding the selection to all Intent Triggers immediately after the selection.

Bridge

  1. User Intent triggers C and D are selected
  2. User clicks Bridge
  3. The bridging results in trigger C and D maintaining their relation while a new relation bridges from trigger B to trigger E

Extract and Bridge

Use Extract and Bridge to combine the above two functionalities, extracting the selection and bridging over the gap they created.

Extract and Bridge

  1. User Intent triggers C and D are selected
  2. User clicks Extract and Bridge
  3. The extraction and bridging results in trigger C and D maintaining their relation in a new island while the relation from trigger B is being bridged to trigger E

Merge

The Merge function makes it possible to join two islands of related Intent Triggers which reside within the same order group. New relations are created by replacing the selected relation in one island with the selected Intent Trigger(s) of the other island. After the merge, all other relations from before the merge remains the same.

Merge

  1. User Intent triggers B and C are selected
  2. The relation between trigger D and E is selected
  3. User clicks Merge
  4. Trigger B and trigger C are now merged into the island of trigger D and E maintaining preceding and following relations by adding a new relation from trigger D to triggers B and C and adding relations from trigger B and C to trigger E

Move

Use Move to cut a selection of triggers from an island of related Intent Triggers and paste them into another location by replacing the selected relation. Any preceding or following relations are left as is.

  1. Triggers B and C are selected
  2. The relation between trigger D and E is selected
  3. User clicks Move
  4. Trigger B and C are now moved into the island of trigger D and E while trigger A has become a singleton

Relations area

Relations area

In the Relations area, the user finds buttons such as Add and Delete, but also Delete and Bridge, Reverse and Select Redundant.

Add

Add a relation between two Intent Triggers by selecting the two Intent Triggers by pressing Ctrl+click and clicking the Add button in the top ribbon.

Add relation

  1. Triggers A and B are selected
  2. User clicks Add
  3. A relation (an arrow) is added between trigger A and trigger B

It is also possible to draw the relation with the mouse by clicking the Intent Trigger which should be the start of the relation and maintaining the mouse-button down while drawing an arrow to the Intent Trigger which should be the next in the relation.

Delete

This button deletes the selected relation(s), alternatively the user can press the keyboard's Delete button after making the selection.

Delete and Bridge

The Delete and Bridge button provides the following possibilities:

  • Bridge
  • Delete and Bridge

Bridge

Use Bridge to add new relations between the Intent Triggers leading to the from trigger for this relation to the to trigger; and add new relations leading from the from trigger of this relation to the triggers after the to trigger of this relation.

  1. The relation between trigger B and trigger C is selected
  2. User clicks Bridge
  3. A relation bridging over trigger B is added from trigger A to trigger C, and a relation bridging over trigger C is added from trigger B to trigger D

Delete and Bridge

Use Delete and Bridge to delete the currently selected relation and bridge over it.

Delete and Bridge

  1. The relation between trigger B and trigger C is selected
  2. User clicks Delete and Bridge
  3. The selected relation is deleted while new relations bridge from trigger A to trigger C and from trigger B to trigger D

Reverse

Use the Reverse button to turn the direction of a selected relation around.

Reverse

  1. Relation between trigger A and trigger B is selected
  2. User clicks Reverse
  3. The relation is reversed and now starts at trigger B and ends at trigger A

Select redundant

Redundant relations are implicit relations which have been made explicit. The redundant relations are calculated every time the user saves the ordering and are displayed with a dashed arrow to highlight the redundancy and draw the user's attention to these.

Use Select Redundant to select all redundant relations in all order groups.

Protect relations

It is possible to protect relations to avoid making changes to the specific relation(s) unintentionally and also to avoid the Suggest Ordering to perform any changes to the relation(s). To know more, please check out the Protect relations section here.