Azure Services Module
  • 17 Jan 2023
  • 3 Minutes to read
  • Dark
    Light

Azure Services Module

  • Dark
    Light

Article summary

Azure Service Bus Module deprecated !!!
Azure Service Bus Module has been deprecated from the latest release of Decisions V8.9. Users can use the Azure Service module for Azure Service Bus message queues.

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 following section covers the setup and configuration of a broker/message queue and is intended to serve as an example resource to integrate with Decisions. The example highlights the values needed to connect a message queue to Decisions and is meant for informational and troubleshooting purposes.  

Please refer to the product's official documentation for a more in-depth and detailed guide on configuring a message queue for use in production environments.

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 OptionsFunction 
    Display NameThe name of the Queue as it will be displayed in Decisions.
    Messaging TypeDetermines the messaging type, either point to point (Queue) or subscription-based
    Queue NameThe 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 IDAn 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 StringUsed 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.




For further information on Modules, visit the Decisions Forum.

Was this article helpful?