The Data Store gives administrators the ability to store data for use within their assistants. Data can be stored at the assistant level within the assistant's data store skill, or at the tenant level within the shared data store functionality, found in the left-hand navigation menu, where multiple assistants can have access to shareable data.
The data / blob is held as key-value pairs. When creating data you give it a key, which is used to retrieve the value in flow, along with its corresponding value.
Search, sort, and filtering options are available over your data in the data store.
Storing Data
Data / blobs can be stored as three types:
- Object (JSON)
- String
- Number
They can be created, updated, and deleted from within an assistant's data store skill, or if you want to store data that can be shared across multiple assistants, you can use the shared data store, which is available from the left-hand navigation. You can also create and update data via the REST endpoints if the data is mastered in an external system.
Secret Blobs
Clicking the Add Secret String button, found on the top right of your screen, allows you to set your data as an unreadable secret. Secret blob values can be retrieved within flow.
Note, that once a value has been set as secret you will not be able to see its contents within the data store. You do have the option of setting a new value.
Secret values can also be set within the data store by using the 'secret' toggle.
Accessing Data in Flow
All flow actions that use variables can now access both the tenant and assistant Data Store directly.
To access the Data Store within flow actions, click on the magic wand icon.
Assistant-level Data Store Export and Import / Backup and Restore
Data Store values can be downloaded in two different ways from within the assistant Data Store skill, each one having a different use
- Backup
- Export
Backup & Restore
Backup is primarily used to save all your assistant's Data Store values for restoration in the future; for example, after changing one or more values and realizing you have made a mistake, you could revert to your backup. It may also be used to duplicate the values from one assistant to another. Backup will make a complete copy of all the values, including all secret values, encrypting them using the password you enter as part of the backup process.
The complete overwrite on restore limits its usefulness in some scenarios, which is where export and import can be used
Export & Import
Exports are useful for migrating values from one assistant to another, a common scenario being the migration of changes from a UAT or development assistant to a production assistant. The key part of export-import is that it will not overwrite secret values or 'import resistant' values on the target system.
Secret values are not overwritten as part of an import, but if those Data Store items do not exist on the target assistant, the keys will be created with a blank value. You can quickly find the blank values by setting the 'empty' filter at the top of the page to 'yes', allowing you to then go through each item and add the required value.
The import resistant setting is useful for protecting integration settings, such as those that connect your Tenjin assistant to a third-party solution, where you may have different integration settings for development, testing, and / or production.
To Import a Data Store value
- Click the More button on the upper right of the screen, and click Import.
- Select the file you are importing.
- Click OK.
Detailed inline help is available from the help button.
To Export a Data Store value
- Click the More button on the upper right of the screen, and click Export.
- Click OK.
Detailed inline help is available from the help button.
To Backup your Data Store value
- Click the More button on the upper right of the screen, and click Backup.
- A password is required to encrypt secret values.
- Click OK.
Detailed inline help is available from the help button.
To Restore your Data Store value
- Click the More button on the screen's upper right, and click Restore.
- Select the file you are importing.
- Enter the password.
- Click OK.
Detailed inline help is available from the help button.
Share this article
Comments
0 comments
Article is closed for comments.