Configure Azure blob storage import activity
-
Add an activity to the map.
By default, the Configuration tab is open in the properties panel of the activity.
- Change the default Name of the activity to something meaningful.
- On the Type list, select .
-
Configure the following properties.
Azure storage The name of the Microsoft Azure storage that is configured for blobs in TotalAgility Integration. See Configure an Azure Storage connection.
The Azure storage integration name must be the same when importing a process configured on another system; otherwise, the name will be shown as Unknown when you view the activity configuration.
Container name The name of the container from which to get the blobs. The name can be a dynamic variable (process or server) or a static value.
Index tags Blob index tags categorize data in a storage account using key-value tag attributes.
These tags are exposed as a searchable multi-dimensional index to find data within a single container or all containers in a storage account.
Index tags only support String data type.
-
You can map all TotalAgility simple data types, including the fields of the document type. However, they are converted to String data type.
-
Queries support dates in ISO 8601 UTC format.
You can add multiple tags in a search criteria, and they operate according to the logical AND rule. When multiple tags are used, filters are applied with lexicographic sorting. For more information on these limitations, refer to the Microsoft website.
At runtime, the search is performed only in the specified container based on all the defined index tags. However, if the container is not specified, then the search is performed across all the containers in the storage account. Only the blobs that match the search criteria are imported into the configured folder and deleted from the container; the rest of the blobs remain in the container.
To set a search criteria, perform the following procedure.
-
Click .
-
In the Key field, enter the name of key.
-
On the Operator list, select the required operator. Available options are:
"=", ">", ">=", "<", and "<=".
-
In the Value field, enter the value for the key. The value can be a dynamic variable (process/server) or a static value.
-
Click Add.
-
Define more tags as needed.
To edit an index tag, click and modify the required fields.
To delete an index tag, click .
Import success indicator A boolean variable that holds the import status.
Suspend job if import fails Clear the checkbox if you do not want the job to be suspended if the import fails. (Default: Selected)
Blobs not imported A Complex variable that displays the list of blob names that have failed to import along with the error information.
Folder The folder variable that holds the imported blobs.
At runtime, the documents are added to the folder. If the folder is not available, the folder is created and then the documents are added to it.
-
-
Click
Save.
When you execute this activity:
-
On a successful import, blobs in the container are added as documents to the configured folder.
-
The "Import success indicator" is updated based on the import status.
-
If the import fails, the job is suspended if "Suspend job if import fails" is selected, and the "Import success indicator" is set to false.
-
The names and the errors of the failed blobs are recorded in the Complex variable (if the variable is mapped).
-
Successfully imported blobs are deleted from the container so that they are not processed again.
-