Teneo Developers

Language Object basics

Introduction

Language Objects are reusable documents or containers that holds a TLML syntax; Language Objects can be anything from lists of synonyms and figures of speech over idioms or thematically related words, and they are used to anticipate the wide variety of user inputs.

The syntax language used is Teneo Linguistic Modeling Language (TLML); an introduction to this can be found here while an extended reference manual is available here.

Available Language Objects

From a solution, users have access to the following collections of Language Objects:

  • Language Object located in the solution, and
  • Language Objects available in any lexical resource assigned to the solution

Language Objects located in the solution are under full control of the Teneo Studio user and these can be managed and modified in any way; Language Objects from a lexical resource (e.g. Teneo Lexical Resources) can be viewed and used in TLML syntaxes but not modified.

Naming a Language Object

When naming a Language Object, it is recommended to follow the naming conventions used by the Teneo Lexical Resources, on top of that the below requisites must be followed:

  • the name must be unique within the solution
  • the name is written in upper-case
    Lower cased characters are automatically upper cased by Teneo
  • the name cannot contain any reserved characters
    Any special characters or blank spaces are automatically converted into underscore by Teneo
  • the name cannot end with .ENTITY

If a Language Object in the solution shares its name with a Language Object in an assigned lexical resource, the Language Object located in the solution is always chosen by Engine over the Language Object in the assigned lexical resource.

Syntax Editor

A Language Object's syntax or condition is written using Teneo Linguistic Modeling Language (TLML); the Language Object can contain plain words, references to other Language Objects and/or Entities and even references to annotations. The different words or references must be separated by operators to indicate how they relate to each other.

To use a Language Object in the Syntax editor (or as an entry in an Entity), its name must be preceded by the percentage sign (%) and written in capitalized letters; Teneo Studio will automatically capitalize letters written after the percentage sign.
To obtain Language Object suggestions, type % followed by the first letter(s) of the Language Object to add, then press Ctrl + space on the keyboard for suggestions and lastly select the Language Object from the suggestions menu.

Check out the Teneo Linguistic Modeling Language summary for an introduction to the TLML syntax or see the full TLML reference manual here.
For an overview of what the Syntax editor itself has to offer, check out this page.

Open

Create

Edit

Save

Close

Teneo Studio Desktop

To close a Language Object, either:

  • Click the X in the top, right corner of the Language Object window
  • Click the Close button available in the top ribbon
  • In the Language Object backstage, click Close in the left-side menu

Should there be unsaved changes, Teneo Studio prompts the user to Save or Close without saving.

Teneo Studio Web

To close a Language Object in Teneo Studio Web:

  • First, remember to Save if any changes were performed in the Language Object to preserve these; Teneo Studio will prompt the user to save if unsaved changes are detected
  • Next, simply navigate back by using the back arrow of the browser.

Delete

Teneo Studio Desktop

To delete a Language Object from the solution, follow the below steps:

  • Select the Language Object in the Solution Explorer
  • In the top ribbon of Teneo Studio, click Delete
  • A confirmation message will be displayed, click Delete again If the Language Object is in use, an Item in Use message will appear, click Select All to delete anyhow or Continue to cancel deletion (the user can also click the X in the box to cancel the deletion).

For more information, please see Delete documents.

Teneo Studio Web

To delete a Language Object from the solution, follow the below steps:

  • Navigate to the folder where the Language Object is saved
  • Hovering over the Language Object, an icon of a recycle bin appears in the right side of the browser window, click it
  • The user will be prompt to confirm the deletion of the Language Object:
    • Click Delete to perform a usage check before deletion
    • Click Delete without usage check to delete directly
    • Click Cancel to cancel the action

Note that deletion of a Language Object currently cannot be undone in Teneo Studio Web, for this action please refer to the Recycle Bin available in Teneo Studio Desktop.