Cora Knowledge Center

Support

Azure Service Bus activity

Overview

Azure Service bus activity provides a powerful messaging mechanism to integrate your workflow with other applications or services. This activity integrates with Microsoft Azure Service Bus, which is a cloud-based messaging service used to connect and send information between applications, services and devices.

Azure Service Bus and Cora SeQuence

Use the Azure Service Bus activity to listen to messages and start a workflow when data is transferred between different applications and services. 

  • Messages are transferred in a binary format that can contain JSON, XML, or plain text. 
  • The received data is saved in the workflow UACT table, in the Message Body column. 
  • Every message receives a unique Message ID
  • You can set up workflow expressions to extract the message data.

Before you add an Azure Service Bus activity to your workflow, you need to set up the service bus entity in Azure.

The service bus activity can currently work with two types of entity:

  • Queues: one direction communication — one sender to one receiver. The message delivery follows a first in, first out (FIFO) method. That is,  messages are received and processed in the same order in which they enter the queue. The service bus processes only one message at a time. 
  • Topics and subscriptions: one direction communication — one sender to several receivers, through subscriptions. Messages are sent to a topic and delivered to one or more subscriptions. The receiver does not communicate with the topic. Use topics if your activity requires sending messages to several receivers.

Use cases

You can use the Azure Service Bus activity to start several types of processes. For example, you can set up a service bus activity for an inter-bank transfer that requires customer’s approval based on specific conditions. The service bus sends a message to a queue and Cora SeQuence creates a process for the bank’s representative to receive the customer’s approval in writing.

Configure Azure Service Bus activity

Prerequisites

  • Set up the Azure service bus namespace, which is a container for entities, such as queues and topics.
  • Create a queue or topic, depending on your implementation requirement.
    For topics, you need to set up a subscription.
  • Get the service bus Primary Connection String for your service bus namespace.

Procedure

  1. To add an Azure Service Bus activity to your workflow, in the AppStudio, select Integration>Azure Service Bus.
  2. Double clickAzure Service Bus.
  3. On the Azure Service Bus Activity Properties screen, give a significant name to the activity, and then click Next.
  4. On the Job tab, set the following:
  • Name: Enter a name to the actual job performed by the Azure Service Bus activity.
  • Job Host: the list includes the servers on which JES (Job Execution Service) is installed. Do one of the following:
    • Select a server on which to run the job.  
    • Leave the field blank, if you want the system to allocate a server to run the job.
  • Job is enabled: Select this option only after you complete the workflow, or if you want to run the job for testing purposes.
  • Job supports redundancy: option is selected by default. Clear the checkbox if you do not want to enable redundancy.
    For more details on job redundancy settings, see this article
  1. Click Next.
  2. On the Command tab, set the following:
  • Connection String: Enter the primary connection string for your service bus namespace.
  • Entity Path: Enter the name of the queue or topic, depending on what you configured for the service bus. 
  • Client Type: Do one of the following:
    • Queue Client: Select this option if the service bus uses a queue to transfer messages.
    • Subscription Client: Select this option, if the service bus uses a topic to transfer messages.
      • Subscription Name: Enter the name of the subscription that was set up for this topic.
  • Test Connection: Verifies that the parameters you entered are valid, and Cora SeQuence can connect with the service bus. 
  • Require Acknowledgement: If you select this option, the message is kept in the queue until Cora SeQuence acknowledges that it successfully started the process. Only then the message is deleted.
  • Retry Interval: Set the time (seconds) for the job to retry after failure.  
    Maximum value is 999.
  • Max Retry Count: The maximum number of times the system tries to rerun the job.
    Maximum value is 60.
  1.   Click Finish.

Limitations and important notes

  • Cora SeQuence only checks for duplicate messages in the same workflow. 
  • You cannot have two workflows with the same Azure Service Bus activity job definition. If you copy a workflow, redefine the Azure Service Bus job settings. 
  • Cora SeQuence does not support sessions.
  • When you copy or create a new version of a workflow that contains the Azure Service Bus activity, you need to delete the Azure Service Bus activity in the new workflow, and then set it up again.