Teneo Developers

Advanced search

Teneo Studio includes a simple search box in the Home tab and an advanced search in the Search tab.

Search area in the Home tab

In the search box of the Home tab, it is possible to perform simple searches, while the Search tab contains more options and possibilities to specify the search criteria.

Advanced Search tab

Advanced search

Follow the below steps to run an advanced search:

  1. Click the Search tab
  2. Type a full word or an Document Number in the text search box Asterisk (*) can be used to specify if the search should contain, start or end with the specified word
  3. Either choose one of the preset searches (please see below) or just select the Object Types and properties to search across.
  4. Once the Object Types and properties are selected, click Search

Preset searches

The following pre-set search options are available in Teneo Studio:

  • None: no object types or properties are selected; this will search throughout everything in the solution and can be very slow (depending on the size of the solution). Also, use this preset search to clear all the types and properties before selecting these for the next search.
  • Quick: the Quick preset search selects Language Objects, Entities and Flows as Object Types and the Name in the General properties.
  • All: this preset search will select all Object Types and Properties.
  • Scripts: the preset Scripts search automatically chooses the Object Types and Properties in a solution where scripts might be available and search through these objects/properties, for example Flow scripts and global scripts.
  • Condition: the preset Condition search automatically chooses the Object Types and Properties in a solution where conditions might be available and search through these objects/properties, for example Language Object conditions or Intent Triggers' match requirements.

Available Object Types and Properties

It is possible to design the search as needed depending on what the user needs to find in the solution, the following list includes the Object Types available to search for. Note that each Object Type has different searchable properties available which can also be selected as per needs.

Searchable Object TypesSearchable Properties
Language ObjectName, Description, Id, Positive Example, Negative Example, Condition, Alias
EntityName, Description, Id, Positive Example, Negative Example, Entry Value
FlowName, Description, Id, Flow Resume Prompt, Flow Scripts
ClassName, Id, Training Data
(Intent) TriggerName, Id, Description, Positive Example, Negative Example
TransitionName, Description, Id, Positive Example, Negative Example
Prompt (Trigger)Name, Description, Id, Prompt Trigger Expression
Match RequirementsLanguage Object Name, Entity Name, Class Id, Condition Name, Condition, Scripted Context Id, Script Name, Script Expression, Variable Id
Data ActionsListener Name, Listener Condition, Listener Operation, Script Name, Script Expression, Language Object Name, Entity Name
Output NodeName, Description, Id, URL, Answer Text, Resume Prompt, Output Parameter Key, Output Parameter Value, Skip Condition Expression
Script NodeName, Description, Id, Execution Script
Flow Link NodeName, Description, Id, Target Flow Id
Junction NodeName, Description, Id
ListenerName, Description, Condition, Listener Operation
VariableName, Description, Value
Metadata AssignmentValue
Global ScriptsSession and Engine Scripts

Search button options

The Search button, when clicking the little, black arrow, gives the following search options:

  • Current Solution: this option searches through the currently open solution
  • All Solutions: this option searches through all the available solutions in the server
  • Current Solution and its referenced Lexical Resources: this option searches through the currently opened solution and its referenced lexical resources
  • All Solutions and All Lexical Resources: this option searches through all the available solutions and all the available lexical resources in the server

TIP: To find, for example, all available Entities in a lexical resource, type "*.entity" in the text field and choose between the search optionsCurrent Solution and its referenced Lexical Resources or All Solutions and All Lexical Resources. This will display all the available Entities, for a better overview sort for example by location.

Search results

The search results are displayed in the main window of Teneo Studio. The list of results include, in the first column to the left, the object types' icon (Flows, Language Objects, Entities, ...) of where the text string was found, then the Name column and lastly the location (in which solution/lexical resource does the object live).

The search results can be sorted by either the Object Type, Name or Location by clicking in the top of each column.

The following documents in a solution and/or environment can be opened from the Search results:

In the current solutionIn another solution (same environment)
EntitiesEntities
FlowsFlows
Language ObjectsLanguage Objects
Integrations
Listeners
Scripted Contexts
Scripts

Double-click the object to open in read-only mode or while holding the Alt key down to open in edit mode, objects from another solution are always opened in read-only mode.

Search and copy across solutions

Search for objects across all the solutions by clicking the Search All Solutions option. This allows, for example, to copy Flows, Entities and Language Objects across solutions located in the same Teneo Studio environment.

To do this, just run a search (using the All Solutions) option, select the objects to copy and hold the Ctrl key down while dragging and dropping them into a folder. Alternatively, use the Copy and Paste buttons available in the top ribbon of Teneo Studio.

Search for usages of a Flow

If you need to find out where a certain Flow is being referenced from, follow these steps:

  • In the Solution Explorer, open the folder where the Flow is located
  • Right-click the Flow to open the context menu
  • Select Copy Id to Clipboard
  • Click the Search tab in the top of Teneo Studio
  • Click the text search box and paste the Id into the box (use Ctrl+v on the keyboard)
  • Select the Flow Link Node under Object Type
  • Ensure that the Target Flow Id property is selected
  • Lastly, click the Search button

Search for usages of Sub-flows

Use the advanced search to find places where linked Flows are applied (either Sub-flows or regular Flows linked to from other Flows).

When a Flow link node has been given a name or description, these can be searched for by following the below steps:

  1. Go to the Search tab
  2. Under the Object Type, select Flow Link Node
  3. Under the General properties, select Name and/or Description
  4. Type the name or description of the Flow link node in the search text field
  5. Click Search

If no specific name or description has been given to the Flow link node, then search for the Target Flow Id property of the child Flow; this way, in the search results all the Flows containing a Flow link node pointing to that child Flow are displayed. To perform this search, follow the below steps:

  1. Right-click the Sub-flow or the regular Flow used by other Flows and select the Copy Id to clipboard option
  2. Go to the Search tab
  3. Under the Object type, select Flow Link Node
  4. Under Other properties, select Target Flow Id
  5. Paste the copied Id into the search text box
  6. Click Search

Search for Language Objects and Entities

Use the advanced search to find Language Objects or Entities located in a lexical resource either assigned to the solution or available in the server.

The following properties of Language Objects and Entities are searchable in Teneo Studio:

  • Name
  • Description
  • Id
  • Positive Example
  • Negative Example
  • Condition (only Language Objects)
  • Alias (only Language Objects)
  • Entry Value (only Entities)

To perform a search for Language Objects or Entities in a referenced lexical resources, follow the below steps:

  • Click the Search tab in the main Teneo Studio window
  • Click None to clear the preset search
  • Next, click Language Object and/or Entity
  • In the right side of the top ribbon, the specific properties for Language Objects and Entities will appear, by default all properties are selected, deselect the ones not needed in the search
  • Now, in the Search field (to the far left) write the word to search for It is possible to search for complete Language Object or Entity names, parts of an object's name or simply the object type's suffix. The unknown parts of the name can be filled with an * (asterisk).
  • Last, click the lower part of the Search button. This will open a dropdown menu, select Current Solution and its referenced Lexical Resources to search only in referenced lexical resources, or All Solutions and All Lexical Resources to search in all solutions and lexical resources in the server.