› Workflow › Business processes › Design a basic process › Add an activity › Activity types › Microsoft activities › Azure blob storage export activity › Configure Azure blob storage export activity

Configure Azure blob storage export activity

Use the following procedure to configure a process, case, case fragment, business rule, or custom service to add an Azure blob storage export activity.
  1. Add an activity to the map.

    By default, the Configuration tab is open in the properties panel of the activity.

  2. Change the default Name of the activity to something meaningful.
  3. On the Type list, select Microsoft > Azure blob storage export.
  4. Configure the following properties.
    Azure storage

    The name of the Microsoft Azure storage that is configured for blobs in TotalAgility Integration.

    The Azure storage integration name must be the same in the importing and exporting machines; otherwise, an error occurs.

    Folder

    The location from where the files are exported. The location can be a dynamic variable (process/server) or a static value.

    • For an on-premise environment, the variable can be a String or a Folder.

    • For on-premise multi-tenant and Azure environments, you can only use a Folder variable.

    Container name

    The name of the container to which the files are exported. The name can be a dynamic variable (process/server) or a static value.

    Blob name

    Optional. A String variable that holds the name of the blob.

    If blob already exists

    Select what must be done if a blob already exists (same file name) in the container.

    • Overwrite (default): Overwrites the existing blob.

    • Rename: Renames the latest blob by adding current timestamp to the end of the existing name.

    • Suspend job: Suspends the job.

    Metadata

    Metadata is a pair of key-value character strings. You can set metadata to store additional information for the blobs. The key and value fields support dynamic (process/server variables) or static types.

    To add a metadata, perform the following procedure.

    1. Click .

    2. In the Key box, enter a name for the key.

    3. In the Value box, enter a value for the value.

    4. Click Add.

    5. Add more metadata as needed.

    To edit a metadata, click and modify the required fields.

    To delete a metadata, click .

    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.

    The key and value fields within an index tag are case-sensitive character strings that support dynamic (process/server variables) or static values. If numbers, dates, times, or special characters are used, they are saved as strings.

    An index tag can include the following characters:

    • Lowercase letters (a-z)

    • Uppercase letters (A-Z)

    • Digits (0-9)

    • Space (" ")

    • Special characters ("+", "-", ".", "/", ":", "=", and "_")

    When exporting blobs to Azure blob storage, you can add index tags to the blobs, so that the blobs can be searched based on the tags.

    To add an index tag, perform the following procedure.

    1. Click .

    2. In the Key field, enter a name for the key.

      The maximum length of the key is 128 characters.

    3. In the Value field, enter a value for the key.

      The maximum length of the value is 256 characters.

    4. Click Add.

    5. Add more index tags as needed. You can add a maximum of 10 tags for a blob.

    To edit an index tag, click and modify the required fields.

    To delete an index tag, click .

    Blob URL

    A String variable used to store the path to the new blob that is returned.

  5. Click Save.

At runtime when this activity is processed:

  • A new blob is created as a ZIP ​ with the exported contents that includes:

    • Documents folder: Contains the image file or PDF of each document. The file name is the ID of the document.

    • FieldData folder: Contains a CSV in which a row is maintained for each document type with the document ID and the field/value pairs.

    • Content_types.xml file: Contains a list of the file types available in the ZIP.

  • ZIP is exported as a blob to the configured container.

  • If configured, the blob retains the index tags and metadata.

  • The blob name is based on the variable ir defaults to Job_jobid.zip. If a blob with the same name already exists, then the file is overwritten or renamed, or the job is suspended depending on the design time setting.

  • The URL of newly created blob is returned as a unique path to the blob.