Table of Contents

Data store

Data store

Data storesA data store is a built-in database in Boost.space Integrator. You can use data stores to store data from scenarios or transfer data between individual scenarios or scenario runs. Your account includes data stores, so you do not have to register at a third-party service. allow you to store data from scenarioA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive. or transfer data between individual scenariosA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive. or scenario runs. You can use data stores to store data from apps during scenario execution. Data stores are similar to a simple database.

The data storeA data store is a built-in database in Boost.space Integrator. You can use data stores to store data from scenarios or transfer data between individual scenarios or scenario runs. Your account includes data stores, so you do not have to register at a third-party service. app’s modules allow you to add, replace, update, retrieve, delete, search, or count records in your Boost.space IntegratorPart of the Boost.space system, where you can create your connections and automate your processes. data store.

You can view and manage your data stores and the data they contain in the data stores section of Boost.space Integrator.

	Note
	The various examples of use can be found here.

Getting started with data stores

Prerequisites

A data store created

In order to use the data store modules, it is necessary to create a data store in your Boost.space Integrator account.

Creating a data store in Boost.space Integrator

Click Data stores in the left menu.
Click Add data store.
Enter settings for the new data store.

Data store name

Enter the name for the data store. E.g. Contacts

Data StructureWhen you create a data store, you need to create a data structure that formats your data store in Boost.space Integrator. Think of the data store as a spreadsheet and the data structure as the headers. The data structure defines the kind of data (i.e. text, numeric, etc.) that the data store records. You can view and manage your data...

A data structure, is a list of the columns for a table, that indicates the column name and data type.

You have three options:

Select the data structure that has been already created
Leave the field emptyIf you don’t select a data structure, the database will only contain the primary key. Such a database type is useful if you only want to save keys and are only interested in knowing whether or not a specific key exists in the database.
Add a new data structureClick the Add button to create a new data structure.

Please see the Setting Up the Data Structure section of this article.

Data storage size in MB

Allocate the size for the data store from your total Internal data storage.

Setting up the data structure

To set up the data structure, open the Add data structure window.

You can access this dialog by clicking the Add button when creating or editing the data store:

Data structure name

Enter the name for the data structure you are going to create.

Specification

There are two options for how you can specify the data store columns.

Click the Add item button to specify the properties of one column manually.Enter the Name and Type for the data store column and define corresponding properties.
Use the Generator button to determine the columns from the sample data you provide.For example, the following JSON sample data:
```
{   "name":"John",   "age":30,   "phone number": {   "mobile":"987654321",   "landline":"123456789"   }   }
```
creates three columns (name, age, phone number) with phone number as a collection of mobile and landline.

The empty columns in the data store view:

You can then add values to the data store manually or using the Boost.space Integrator data store modules.

Strict

If enabled, the data structure will be compared to the structure of the payload and if the payload contains extra items not specified in the data structure, the payload will be rejected.

Actions

Add/Replace a Record

Adds or replaces a record in the data store.

	Warning
	The module throws an error when you try to add the record which is already in the data store under the same name and the Overwrite an existing record option is disabled.

Data store

Select or add the data store where you want to create a record.

Key

Enter the unique key. The key can be used later to retrieve the record. If you leave this field blank, the key will be generated.

Overwrite an existing record

Enable this option to overwrite the record. The record you want to overwrite must be specified in the Key field above.

Record

Enter the desired values to the record’s fields.

	Caution
	The maximum size of the record in data store is 15 MB!

Update a Record

Updates a record in the selected data store.

Data store

Select or add the data store where you want to create a record.

Key

Enter the unique key of the record you want to update.

Insert missing record

Enable this option to create a new record if the record with the specified key doesn’t already exist.

Record

Enter the desired values to the record’s fields that you want to update.

	Caution
	The maximum size of the record in data store is 15 MB!

Get a Record

Retrieves a record from the selected data store.

Data store	Select the data store you want to retrieve a record from.
Key	Enter the unique key of the record you want to retrieve.
Return Wrapped Output	Choose if you want the output to be returned in the same way that the `Search records` module returns data.

Check the Existence Of a Record

Returns the value true if the record exists in the specified data store or false if the record doesn’t exist in the data store.

Data store	Select the data store you want to check for the record existence.
Key	Enter the key of the record you want to check for existence

Delete a Record

Deletes a specified record from the selected data store.

Data store	Select the data store you want to check for the record existence.
Key	Enter the key of the record you want to delete.

Delete All Records

Deletes all records from the selected data store.

Data store

Select the data store you want to delete all records from.

Search Records

Performs a search for records based on filter settings.

Data store Select the data store you want to check for the record’s existence.

Filter

Set the filter for the search.

Select the column, operator and required value (search term) for the search.

	Tip
	If you use the datetime operators, you need to provide a value in a date format. Use the `parseDate` functionFunctions you can use in Boost.space Integrator - create, update, delete, get, search. for this purpose.

Sort

Key	Select the column name you want to sort the results by.
Order	Select whether you want to sort results in the ascending or descending order.

Limit Set the maximum number of search results Boost.space Integrator will return during one execution cycleA cycle is the operation and commit/rollback phases of scenario execution. A scenario may have one or more cycles (one is the default)..

Continue the execution of the route even if the module returns no results If enabled, the scenario will not be stopped by this module.

Count Records

Returns the number of records in the selected data store.

Data store

Select the data store whose records you want to count.

Managing records in data stores

Boost.space Integrator allows you to view, update, and delete the records in your data store.

To manage records in your data store, click Data stores in the left menu, then click Browse next to your data store.

This shows the editing interface for data store records.

Adding and editing records

Click Add to add new records to the data store. You can add multiple records by clicking Add multiple times. Newly inserted records are highlighted in green.

Click an existing field to change it. Changed records are highlighted in yellow.

Click Save to save all your changes to the data store. Click Discard changes to throw away any changes you have made, including added records and edited records.

	Note
	You cannot use Discard changes to get back records that you have deleted.

Deleting records

To delete records from your data store, first select the records you want to delete by selecting the check boxes next to the records. Then, click the Delete icon.

	Note
	You cannot roll back deleted records.

Troubleshooting

Restoring lost data from your data store

There is no automated process to restore lost values in your data stores. However, there is a manual approach that you can use to fix the issue.

To locate and restore the missing data, follow these steps:

Open the specific scenario where the missing items were stored.
Review the execution history and identify the instances where items were inserted into the data store.
Copy the identified missing data into your data store.

Out of space error

The reason you are getting a message that states that you are out of space is because you currently have a datastore that has already been assigned your allocated datastore storage.

Please edit any of your existing data stores to free up space.

Click Edit.
Reduce the data storage size.

You can now add a new data store.

	Caution
	Make sure that while creating a new data store you do not assign all of your space to only one record unless you need it.