Teneo Developers

Bulk Import

Currently the options and functionalities described in this page apply only toTeneo Studio Desktop

The Bulk Import feature of Teneo Studio allows users to create Language Objects, Entities and Question and Answer (Q&A) pairs outside Teneo Studio in a csv file and later import these into the solution.

This page describes the process of bulk import from within Teneo Studio; to read more about the file format and setup please see bulk import formats

Execute a bulk import

To execute a bulk import follow the below steps:

  • In the Solution Explorer, select the folder for the documents to import
  • Click Bulk Import in the top ribbon of Teneo Studio
  • Now, browse to the location of the csv file and click Open

Bulk Import button

Alternatively, it is possible to execute the bulk import by right-clicking the selected folder and choose Bulk Import from the context menu.

Bulk Import through the context menu

Dragging/dropping a csv file onto the Solution Explorer also allows to execute a bulk import; dragging/dropping to a folder saves the documents in the selected folder

Validation

Teneo Studio performs a validation of the csv file to import; when the validation is done, a pop-up window prompts the user to select between the following options:

  • Click Preview to visualize an example of one of the documents to import
  • Continue with the import by clicking Yes, or
  • Cancel the import by clicking No

Validation

Teneo Studio starts the file import and displays a progress bar; click Run in Background to keep working in Teneo Studio while the import takes place.

Successful bulk import

When the import has finished, Teneo Studio informs the user about the bulk import results displaying a confirmation of the completed import.

Bulk Import results

The newly created documents now appears in the folder(s) in Teneo Studio.

Newly created documents

TIP: if both Language Objects, Entities and Q&A pairs are to be imported, it might be a good idea to first import the Language Objects/Entities, as this way these documents can be used as, for example, TLML Syntax Matches of Flow triggers and transitions

Troubleshooting

Validation check

Teneo Studio performs a series of checks to validate the format and setup of the csv file to be imported. If the validation fails, the import is cancelled and an error message displayed informing the user about the issues encountered in the file (find more information in the next section).

The validation process verifies only the format of the csv file and that the mandatory fields and tags are added correctly. It does not check any other aspects, such as TLML Syntax, and therefore it is recommended to always check the syntax of Language Objects or Matches after an import has finished.

Warnings and errors

As mentioned in the above section, when the validation of the csv file fails, an error message is displayed.

Example of Bulk import validation results

By hovering over any of the errors, more information related to the error is displayed to the user indicating in which part of the csv file the error was detected.

Hoovering over an error gives more information

Duplicate names

When performing a bulk import of Language Objects or Entities, Teneo Studio does not accept a file containing duplicates, i.e. several Language Objects with the same name or alias, nor will it accept a file containing Language Object/Entity names or aliases already present in the solution.

When performing a bulk import of Q&A pairs, if a Flow name is not unique within a folder, Teneo Studio will rename the imported Q&A pair's name by adding a number to the end of the name.