Teneo Developers

Working with Trigger relations

Intent Trigger relations

Relations between Intent Triggers are objects in their own right and can be managed too, just like the 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

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

Example

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

Example

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

Example

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.

Example

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.

Example

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.

Example

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

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.

Example

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

Example

Reverse

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

Example

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.

Redundant relation

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.