--- schema_version: "1" id: eaeeb4ed6f6bc1780658ce326081629e4a74567b7d3251f361c5cbfc26c5e6c2 title: Azure Service Bus Connector 3.6 Examples collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/microsoft-azure-sb-connector/3.6/azure-service-bus-connector-examples.md canonical_url: https://docs.mulesoft.com/microsoft-azure-sb-connector/3.6/azure-service-bus-connector-examples source_site: docs.mulesoft.com content_type: documentation content_hash: d1d24e4660bce6cf1605c513fb629a2a752b016d975fa77f709540627b08ecd2 description: MuleSoft Documentation Site release: "3.6" latest: false --- --- product: Azure Service Bus Connector version: 3.6 --- # Azure Service Bus Connector 3.6 Examples > For the full documentation index, see: https://docs.mulesoft.com/llms.txt The examples in this section show application flows that: - [Sends messages to and receives messages](#send-receive) from Azure Service Bus - [Sends and listens](#send-listen-ack) for messages and receives an acknowledgment using the `MANUAL` acknowledgment type - [Sends and receives batch messages](#batch-send-receive) - [Sends and receives messages using session IDs for session-aware queues](#send-receive-session-ids) - [Using Azure Active Directory connector provider](#using-aad-connector) These examples use variables for some field values. You can either: - Replace the variables with their values in the code - Provide the values for each variable in a properties file and then refer to that file from the connector configuration For more information about using a properties file, see [Configuring Property Placeholders](https://docs.mulesoft.com/mule-runtime/latest/mule-app-properties-to-configure) ## Create a Mule Project After you create a new Mule project and configure your credentials, you can create an application flow for each example by using the provided XML code. To create a Mule project: 1. In Studio, select **File > New > Mule Project**. 2. Enter a name for your Mule project and click **Finish**. 3. Create a file named `mule-app.properties` and save it in `/src/main/resources`. 4. Configure your Azure connection credentials in the file `mule-app.properties`, and include the name of the Azure queue you created, for example: #============================================================== #Connection Parameters #============================================================== # Azure common authentication configuration azure.namespace=myazure queue.name=mytestqueue # Shared Access Signature authentication azure.keyname=SAStokenname azure.key=SAStoken # Azure Active Directory authentication azure.tenantId=TenantId azure.clientId=ClientId azure.clientSecret=ClientSecret 5. Save the file. 6. Open the **Global Element Configuration** and click **Test Connection** to verify your credentials. ## Send and Receive Example This flow shows an example of how to use the **Send** and **Receive From Queue** operations to send and receive messages: ![Example Azure Service Bus flow that uses the Send and Receive From Queue operations](/mulesoft/current/en-us/microsoft-azure-sb-connector/3.6/_images/azure-service-bus-send-receive.png) To create this flow: 1. In the Studio canvas, click **Configuration XML**. 2. Delete all the contents after the line ``. 3. Copy and paste the following XML after the line ``: ```xml

``` 4. When you are prompted to regenerate `doc:id` values, click **Yes**. 5. Save the project. 6. Right-click in the Studio canvas and select **Run project ** to run the project. ## Batch Send and Receive Example This application flow uses the **Send batch** and **Receive Batch** operations to send and receive batches of messages to and from an Azure Service Bus queue. The following screenshot shows the application flow for sending and receiving batch messages: ![Application flow that shows sending and receiving batch messages](/mulesoft/current/en-us/microsoft-azure-sb-connector/3.6/_images/azure-service-bus-send-receive-batch.png) To create this flow: 1. In the Studio canvas, click **Configuration XML**. 2. Delete all the contents after the line ``. 3. Copy and paste the following XML after the line ``: ```xml

``` 4. Save the project. 5. Right-click in the Studio canvas and select **Run project ** to run the project. ## Send, Listen, and Acknowledge the Message Example This application flow uses the **Send** and **Message Listener** operations. The **Message Listener** is using the `MANUAL` acknowledgment type, which means that the application logic is responsible for acknowledging receipt of the message. In this example, that logic is provided by adding the **Complete** operation to the same flow as the **Message Listener**. The following screenshot shows this flow: ![Application flow that shows how the Send, Message Listener, and Complete operations are used](/mulesoft/current/en-us/microsoft-azure-sb-connector/3.6/_images/azure-service-bus-send-listen-manual-ack.png) To create this flow: 1. In the Studio canvas, click **Configuration XML**. 2. Delete all the contents after the line ``. 3. Copy and paste the following XML after the line ``: ```xml

``` 4. When you are prompted to regenerate `doc:id` values, click **Yes**. 5. Save the project. 6. Right-click in the Studio canvas and select **Run project ** to run the project. ## Send and Receive Messages Using Session IDs for Session-Aware Queues Example This application flow uses the **Send** operation and **Message Listener** source. The flow is configured to use session IDs for session-aware queues. ![Four flows that have Scheduler, Set Payload, and Send operations](/mulesoft/current/en-us/microsoft-azure-sb-connector/3.6/_images/azure-service-bus-session-id-1.png) ![Flow that has first Message listener, Logger, Matches regex, another Logger, and error handling](/mulesoft/current/en-us/microsoft-azure-sb-connector/3.6/_images/azure-service-bus-session-id-2.png) ![Flow that has second Message listener, Logger, Matches regex, another Logger, and error handling](/mulesoft/current/en-us/microsoft-azure-sb-connector/3.6/_images/azure-service-bus-session-id-3.png) ![Flow that has third Message listener, Logger, Matches regex, another Logger, and error handling](/mulesoft/current/en-us/microsoft-azure-sb-connector/3.6/_images/azure-service-bus-session-id-4.png) To create this flow: 1. In the Studio canvas, click **Configuration XML**. 2. Delete all the contents after the line ``. 3. Copy and paste the following XML after the line ``: ```xml

``` 4. When you are prompted to regenerate `doc:id` values, click **Yes**. 5. Save the project. 6. Right-click in the Studio canvas and select **Run project ** to run the project. ## Using Azure Active Directory Connector Provider Some organizations use Azure Active Directory to authenticate their instances. Any of the previous examples can be modified to support this scenario. Replace the Shared Access Signature authentication with the Azure Active Directory authentication: ```xml ``` ```xml ``` Ensure that: - Your `mule-app.properties` file contains the **Tenant Id**, **Client Id**, and **Client Secret** fields. - Your app registration contains the proper [permissions and roles](https://learn.microsoft.com/en-us/azure/service-bus-messaging/authenticate-application). ## See Also - [Use Exchange to Discover Connectors, Templates, and Examples](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange) - [Salesforce Help](https://help.salesforce.com)