Azure Services Module

Overview

The Azure Service module provides Decisions with the ability to integrate with Azure Service Bus. Azure Service Bus is an enterprise-level message broker that supports point-to-point and Publish/Subscribe message queues.

The module provides Flow steps to send messages to an Azure Queue and functionality to connect and process messages.

Prerequisites

• Existing Microsoft Azure Service Bus Account
• Installation of the Azure Services Module

Creating an Azure Service Bus Queue

The Azure portal can be used to create new queues. To access the Azure portal, an Azure account will be needed. Once the account is created, to create a new queue:

1. From the Home page in the Azure portal, select Service Bus service.
2. If no Namespace is created, define a namespace
3. Select or create a Resource group, enter a Namespace name, Location, and Pricing tier. Select Review + Create to leave the remaining settings as default.
4. Once the namespace is created, the page will refresh while the namespace is being deployed. Select Go to Resource.
5. In the left navigation panel, under Entities, select Queues
6. Select the add Queue action.
7. Provide a name for the queue, and set the Max delivery count. For this example, other options were set to default values.
8. Select Create button to create the queue.

   
   

Adding an Azure Queue

1. Navigate to System > Jobs and Events > Message Queues. Click ADD AZURE QUEUE.
   
2. On the Add Azure Queue window, configure the options with the correct information. When complete, click SAVE.

   Configuration Options	Function
   Display Name	The name of the Queue as it will be displayed in Decisions.
   Messaging Type	Determines the messaging type, either point to point (Queue) or subscription-based
   Queue Name	The name of the queue as it appears in Azure, or the name for the topic that Decisions will be subscribed to.
   Subscription Name*	Prompts for the name of the subscription for topics. This setting is hidden unless the messaging type is subscription based.
   Session ID	An optional field that must be filled if the setting is enabled on the Azure Service Bus Queue. A session ID will need to be used to identify which messages will be sent to Decisions. Decisions will receive any messages containing a matching ID.
   Custom Connection String	Used to override the Connection String configured in System > Azure Service Bus Settings. The connection string is the endpoint to establish a private connection to the Service Bus Queue

Viewing Azure Queue configuration

Within the Azure portal, the configuration information such as the queue name can be found here. To access the overview page:

1. From the Home page in the Azure portal, select Service Bus service.
2. In the left navigation panel, select Queues, then select a queue
3. The overview page will be displayed. The queue name can be found in the top left corner, along with additional configuration settings

Azure Service Bus Settings

The Azure Service Bus settings contain only one configuration, the Default Connection String. This is used to define for authentication and authorization to the Azure Service Bus.

Retrieving the connection string

The connection string is located under the shared access policy for the resource. The Primary Connection String will be the field that needs to be copied to Decisions. To locate the connection string:

1. From the portal, select the Service Bus namespace
2. Navigate to Settings > Shared Access Policy in the left navigation menu.
3. Select the RootManageSharedAccessKey Policy. Copy the Primary Connection String.