Frequently Asked Questions
Here are the answers to some common questions about Teneo Studio.
Is it possible to save the Auto-test results?
Yes; the Auto-test results can be downloaded in Excel format, to do so:
- Click Get Report in the upper right corner of the Auto-test view
- In the Save as window, select the folder where to save the report, give the file a name and lastly click Save
- The Auto-test report will now be downloaded to the selected folder.
How to cancel the Auto-test process?
The Cancel test button is available when the Auto-test has initialized.
How to create a new Language Object or Entity from the Condition editor?
To create a new Language Object or an Entity from the Condition editor, follow these steps:
- In the Condition editor, while holding the Alt key down, click on a Language Object or Entity which doesn't exist (printed in red and crossed out), alternatively double-click the object
- The Folder Browser window will open, choose the folder where the new object should be created
- Click Ok
- The new Language Object/Entity window opens, fill in the details for the Language Object as described here or for the Entity as described here
- Remember to Save the new object to preserve all the changes.
How to open a Language Object or Entity from the Condition editor?
To open a Language Object or an Entity from the Condition editor, simply double-click to open in read-only mode, or press the Alt key down while double-clicking to open in edit mode.
How to obtain Language Object and Entity suggestions in the Condition editor?
To obtain suggestions for Entities and Language Objects in the Condition editor, type
% followed by the first letters of the Entity or Language Object you want to add, and then press Ctrl+space on the keyboard.
To get suggestions based on a single word, type the whole word (without the percentage sign) and then press Ctrl+space.
Can I add comments in the Condition editor?
Use comment tags to insert comments in Condition editors (Condition Match Requirements, Language Objects) or expressions (in scripts, Listeners, skip conditions, Prompt Triggers, etc.).
In Condition editors add comment lines by using
== as a beginning tag and
== again as an end tag.
In script expressions, use multi-line comment tags; multi-line comment tags consist of the open comment tag
/* and then the comment themselves followed by the closing comment tag
*/. Line breaks are allowed in this case.
How to make a Script node or Junction the first node after the Intent Trigger?
To make a Script node or a Junction node the first node after the Flow Intent Trigger, follow these steps:
- Select the Script or Junction node in the Flow graph
- Click Set Start Node in the top ribbon
- Link up the rest of the nodes in the Flow graph by dragging a line from the new start node onto the first node of the (rest of the) Flow structure
Read more about nodes and transitions here.
What are the advantages of using multiple Flow Triggers?
When multiple Flow Intent Triggers are used, these can be ordered separately in the Intent Trigger Ordering and different Listeners can be used for each of the.
For more information, please consult the Flow section.
How to add a default Output?
To add a default Output to the solution, create a Prompt Trigger Flow with a
true expression which is always active.
Read more about Prompt Trigger Flows.
Can I add Continue and Get Input transitions from the same Flow node?
If having both outgoing Continue and Get Input Transitions on the same Flow node, the Engine will stop there and wait for the next input; so when there is one outgoing Get Input transition, the other outgoing Transition(s) on the node should also be set to Get Input.
My Flow does not work as expected, what can I do?
If a Flow is not working as expected, check the following:
- Make sure there are no typos in the user input
- check the Intent Triggers' Match Requirements
- Make sure all recent changes are saved
- If a different Flow is triggered, check the Intent Trigger Ordering
Another Flow with a similar Match Requirement may be interfering with the tested Flow, make sure that the Intent Trigger with the more specific Match Requirement has a higher ranking.
- If the same Flow is always triggered for any user input, the Flow probably have an empty Condition Match Requirement
- Check the operations on the Listeners
- Check the Variable names and make sure they are the same as the ones used in the code
- Make sure there are no references to invalid Language Objects or Entities
- Make sure a transition is not set as Get Input when it should have been set to Continue.
How to create a copy of a Language Object, Entity or Flow?
It is possible to create a copy of a Language Object, Entity, or Flow in the same folder by pressing the Ctrl key down while dragging and dropping the object into the folder in question.
When you do this, a copy of the object will be created and the resulting object will be renamed by adding the
_x suffix (where 'x' is a sequential number starting with 1). Bear in mind that the Id of the object will be new; for more information about moving and copying objects, please see here.
Why can I not move a Flow, Entity or Language Object?
This may be do to the fact that the Flow, Entity, or Language Object that you are trying to move is locked by another user. You should wait until the object is unlocked.
Sometimes, this may also occur when the operation has not been completed in the database. Check for the status of the Communicating icon in the lower left hand corner of Teneo Studio; if the current status is Ready it means that all operations in the Backend have been completed.
Why are some options disabled in the top ribbon?
By default, double-clicking Flows, Language Objects, and Entities in the list view (Solution Explorer view) opens the objects in read-only mode.
When opened in read-only mode, it is not possible to edit the objects and hence the edit options are disabled (and not displayed in the top ribbon of the object).
To open a Flow, Language Object, or Entity in edit mode, select the object in the list view and click Edit in the top ribbon of Teneo Studio; alternatively, keep the Alt key pressed while double-clicking the object.
In addition, when local users open solutions of which they are not the owner, all objects in the solution are shown in read-only view. This means that it will not be possible to make any changes at all. This view is also displayed when clicking the Open master button in a Flow of a Local solution in a Localization setup. Language Objects and Entities from an assigned Lexical Resource are also always opened in read-only mode.
How to find out where a Language Object or Entity is used?
Both Language Objects and Entities have a Used by panel available in the left side of the object's window. Here the user can see the list of Flows, Language Objects, Entities, and Listeners where the current object is used.
Where can I find the Id of a Flow, Entity, Language Object, Class, etc.?
The Id of an object can be obtained by right-clicking the object in the Solution Explorer view, and selecting Copy Id to Clipboard in the context menu. Use Ctrl+v on the keyboard to paste the Id wherever needed. By following these steps it is also possible to copy the Id's of Flow nodes in an open Flow.
Opening the Class Manager, the Id of a Class is available at the bottom of the Class details view; for more information please see the Class Management topic.
How can I find the Entities available in my solution?
To list all Entities available in a solution, including any assigned lexical resource(s), go to the Search tab of Teneo Studio.
Write *.entity in the search text field and choose the option Current Solution and its referenced Lexical Resources by clicking the lower part of the Search button.
The available Entities will now be displayed in the search results view. Order them, for example, by Location for a better overview.
To list all the Entities available within the solution (not in a lexical resource), follow the above steps, but simply click the Search (Current Solution) button to obtain the Search results.
Read more about Entities.
How to open a Language Object or Entity from the Entity editor?
To open an Entity or a Language Object from the Entity editor, simply right-click the name of the Language Object or Entity, in the context menu select to Open in read-only mode or to Edit the object.
What is the difference between disabling and deleting a Flow, Language Object or Entity?
By disabling an object, the user can keep an object in the solution, for example, while developing the object for future use, but not have it affecting the solution at run time.
By deleting an object, it is moved from the solution to the Recycle Bin, and it is not possible to develop the object further.
For more information related to deletion of objects, please see here.
How can I find out where an Integration is used?
- Go to Integration in Teneo Studio (Solution tab > Resources > Integration)
- Choose the Integration for which you wish to search
- Click the Search button
- Teneo Studio will perform the search for the Integration and takes the user to the Search results view once done.
How can I turn a solution into a Lexical Resource?
Visit the topic Create lexical resources to learn more about this.
What is the difference between disabling a Metadata definition and turning off auto-logging?
These are different concepts:
Auto-logging is the automatic logging of a metadata definition at transaction, Flow or session level.
When auto-logging is off, you will still be able to assign metadata definitions at transaction level and this information will be logged.
However, when a metadata definition is disabled, the metadata is not logged.
Read more about Metadata here.
How can I create new publication environments?
Only users with user permissions to add and edit publication environments can create a new publication environment, information on how to do it is available here.
To manage user permissions, please contact your system administrator.
Incidents can be logged via Artificial Solutions' Jira system. Username and password to access the ticketing system are supplied separately.
Is a solution unpublished when I delete a publication environment?
When an environment is deleted, the solution will be unpublished unless specified otherwise in the dialogue box that appears when clicking Delete environment.
If you want to delete the environment, but you do not want to unpublish the solution, click Delete without unpublishing.
Clicking Delete will delete the environment and unpublish the solution.
Read more related to Publish.
Why can I not publish the solution?
There can be several reasons for a user not being able to publish, for example, restricted user permissions or a Flow inconsistency in the solution in which case the user should check if the Try Out is working properly, click Reload Engine to check if the Engine restarts without warnings. If there is a Flow inconsistency, solve the inconsistencies and try to publish again.
For more information related to publish, please visit the Publish page.
Can I find Flows, Entities, Language Objects, Classes, etc. if I know their Id?
When receiving Engine errors (in the Try Out) or other kinds of errors, you will usually see the Ids corresponding to the Flows, Entities, or Language Objects where those errors occurred. Teneo Studio allows the user to find Flows, Entities, and Language Objects by searching for Ids by following the below steps:
- Click the Search tab of Teneo Studio
- Enter the Id in the search box
- Select the Object Type (in this case: Language Object, Entity, or Flow)
- Select Id in the General properties area
- Click Search
The search results view will display the object found by the Id (if available in the currently opened solution); double-click to open the object.
How can I find out from where a Flow has been referenced?
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 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
The search results will display a list of Flows containing Flow links where the entered Id is referenced.
Can I, in my solution, see objects available in other solutions?
Use the Search all solutions option available in the Search tab to find Language Objects, Entities, Flows, etc. in other solutions on the same environment. For example, to see Flows or objects from other solutions and copy them to the current solution.
Read more in the Advanced search page.
I deleted some objects accidentally; how can I restore them?
Teneo Studio provides a Recycle Bin from which deleted documents can be restored if needed; look here for further information.
How can I add a local user to the list of Solution Owners?
In order to have full access to a solution, the user needs to be either a solution owner or a global user otherwise the user is not able to edit anything in the solution. As a global user one can also add other users as solution owners if they should be granted full access to the solution.
Global users can add themselves as solution owners of any of the solutions on the environment, to do so follow the below steps:
- Go to the backstage of Teneo Studio (Solution tab)
- Click Solution in the left-side menu
- Select Owners in the top of the view
- Click Edit
- In the list of available users, click Add me as owner
- To add other users as solution owners, double-click the users' names to add them to the Owners list.
Local users who wishes to own a solution need to request the solution owner to add them to the list of Owners.
Can I merge two solutions?
You can merge two solutions following the instructions in the Merge solutions section.
I get a GetResponse timed out error message when branching
Usually, to solve this issue, it is enough to Reload the solution list to see the refreshed list of solutions that have been created.
Can I save without having to add a message to the history?
Yes, the dialogue box which prompts the user to add a comment to the history when saving Flows, Entities, Language Objects, Intent Trigger Ordering, etc. can be omitted by keeping the Alt key pressed while clicking Save.
For many document types, it is also possible to select the Save without comment option when clicking the down-arrow of the Save button.
Can I manage user permissions?
In order to manage user permissions you need to be a system administrator with access to Teneo Manager; else please contact your system administrator.
Where can I find log files and crash logs?
The log files and crash logs of Teneo Studio are stored in the following folder paths:
- Log files:
- Crash logs:
Where can I see the Teneo Studio version and the server address?
To see information related to the Teneo Studio version and the server address, click the Solution tab to go to the backstage of Teneo Studio and select About in the left-side menu to open the About page.
Why does the Tryout not work?
If the Tryout doesn't work, it might be due to Engine warnings due to, for example, a Flow inconsistency or a self-referring Language Object; check the warning message(s) to find out the exact reason for this.
Warning and Error messages are displayed in both Tryout views, but for more information it is recommended to open the advanced Tryout window. To see the full log file outside Teneo Studio, right-click in the Tryout to get the option to export log files in the context menu.