Configure Azure storage

Last update: April 30, 2024
  • Applies to:
  • Experience Manager as a Cloud Service

CREATED FOR:

  • User
  • Developer

data-integeration

Experience Manager Forms Data Integration provides an Azure storage configuration to integrate forms with Azure storage services. The Form Data Model (FDM) can be used to create Adaptive Forms that interact with Azure server to enable business workflows. For example:

  • Write data into Azure on Adaptive Form submission.
  • Write data in Azure through custom entities defined in Form Data Model (FDM) and conversely.
  • Query Azure server for data and prepopulate Adaptive Forms.
  • Read data from Azure server.

Create Azure storage configuration

Before executing these steps, ensure that you have an Azure storage account and an access key to authorize the access to the Azure storage account.

  1. Navigate to Tools > Cloud Services > Azure Storage.
  2. Select a folder to create the configuration and select Create.
  3. Specify a title for the configuration in the Title field.
  4. Specify the name of the Azure storage account in the Azure Storage Account field.
  5. Specify the key to access Azure storage account in the Azure Access Key field and select Save.

Create Form Data Model

After creating the Azure storage configuration, you can create the Form Data Model. Specify the folder that contains the Azure configuration in the Data Source Configuration field while creating the Form Data Model (FDM). You can then select the configuration from the list of configurations that exist in the specified folder name.

Add Azure services to the Form Data Model

After creating the Form Data Model (FDM) and data model objects, you can add Azure services to the Form Data Model (FDM).

To add Azure services:

  1. In the Edit mode, select the services from the Services section in the left pane and select Add Selected. The selected services display in the Services tab of the Form Data Model (FDM).

    Add Selected Services

  2. In the Services tab, select the service and Edit Properties. Based on the service, define the input or output model objects for the service.

  3. Select Save to save the form data model (FDM).

    The following table describes the available Azure services:

    Service NameDescription
    Get Blob from AzureRetrieve data stored as a Blob in Azure storage using an ID or a name
    Get Blob with binaries URL from AzureRetrieve data stored as a Blob with URL for binaries in Azure storage using an ID or a name
    Save Blob in AzureUse a Blob ID to save data in Azure storage
    Update Blob in AzureUse a Blob ID to update data in Azure storage
    Retrieve list of Blob IDs from AzureRetrieve a list of Blob IDs from Azure based on the number defined in the input request.
    Retrieve SAS URLs for Blobs from AzureRetrieve SAS URLs for Blobs from Azure based on Blob IDs in the input request.
    Delete Blob from AzureUse a Blob ID to delete data from Azure storage

Define a data model object property as a search key

To define a data model object property as a search key:

  1. In the Model tab, select the data model object property and select Edit Properties.
  2. Switch the Search Key toggle option to the ON state. This option is available only for primary data types.
  3. Select Done and then select Save to save the Form Data Model (FDM).

After defining data model object properties as search keys, the hash values are stored in Azure index tags and Base64 encoded values are stored in the Azure metadata.

NOTE
Only 10 search keys are allowed per Azure entity since Azure only allows 10 tags per Blob and properties value marked as search keys are stored in Azure index tags after hashing.

Experience Manager