Skip to content

Commit 94c741d

Browse files
committed
Additional edits
1 parent 46e51b2 commit 94c741d

1 file changed

Lines changed: 21 additions & 19 deletions

File tree

articles/connectors/connectors-create-api-servicebus.md

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ For the Service Bus managed connector, the maximum message size is limited to 1
9090

9191
### Increase timeout for receiving and sending messages
9292

93-
In Standard workflows that use the Service Bus built-in operations, you can increase the timeout for receiving and sending messages. For example, to increase the timeout for receiving a message, [change the following setting in the Azure Functions extension](../azure-functions/functions-bindings-service-bus.md#install-bundle):
93+
In Standard workflows that use the Service Bus built-in operations, you can increase the timeout for receiving and sending messages. For example, to increase the timeout for receiving a message, change the setting in the following code example in the [Azure Functions extension](../azure-functions/functions-bindings-service-bus.md#install-bundle):
9494

9595
```json
9696
{
@@ -140,11 +140,11 @@ To increase the timeout for sending a message, [add the **ServiceProviders.Servi
140140
141141
### Service Bus built-in connector triggers
142142

143-
For the Service Bus built-in connector, non-session triggers follow a *continuous-polling trigger pattern* that the connector fully manages. This pattern has the trigger constantly check for messages in the queue or topic subscription. Session triggers follow the *long-polling trigger pattern*; its configuration is governed by the Azure Functions setting, [**clientRetryOptions:tryTimeout**](../azure-functions/functions-bindings-service-bus.md#hostjson-settings). Currently, the configuration settings for the Service Bus built-in trigger are shared between the [Azure Functions host extension](../azure-functions/functions-bindings-service-bus.md#hostjson-settings), which is defined in your logic app's [**host.json** file](../logic-apps/edit-app-settings-host-settings.md), and the trigger settings defined in your logic app's workflow, which you can set up either through the designer or code view. This section covers both settings locations.
143+
For the Service Bus built-in connector, non-session triggers follow a *continuous-polling* trigger pattern, which the connector fully manages. In this pattern, the trigger constantly checks for messages in the queue or topic subscription. By contrast, session triggers follow the *long-polling* trigger pattern; their configuration is governed by the Azure Functions setting, [**clientRetryOptions:tryTimeout**](../azure-functions/functions-bindings-service-bus.md#hostjson-settings). The configuration settings for the Service Bus built-in trigger are shared between the [Azure Functions host extension](../azure-functions/functions-bindings-service-bus.md#hostjson-settings), which is defined in your logic app's [**host.json** file](../logic-apps/edit-app-settings-host-settings.md), and the trigger settings defined in your logic app's workflow, which you can set up either through the designer or code view. This section covers both settings locations. Note the following details about Service Bus triggers:
144144

145145
* Some built-in triggers, such as the **When messages are available in a queue** trigger, can return one or more messages. When these triggers fire, they return between one and the number of messages.
146146

147-
The built-in trigger named **When messages are available in a queue (V1)** doesn't support the parameter named **Maximum message batch size**. Make sure that you use the V2 version instead. To use a trigger where the parameter isn't supported, you can still control the number of messages received by adding the `maxMessageBatchSize` parameter to the trigger definition in the host.json file. To find this file, see [Edit host and app settings for Standard logic apps](../logic-apps/edit-app-settings-host-settings.md).
147+
* The built-in trigger named **When messages are available in a queue (V1)** doesn't support the parameter named **Maximum message batch size**. If you use this parameter, ensure that you use the V2 version instead. To use a trigger where the parameter isn't supported, you can control the number of messages received by adding the `maxMessageBatchSize` parameter to the trigger definition in the host.json file. To find this file, see [Edit host and app settings for Standard logic apps](../logic-apps/edit-app-settings-host-settings.md).
148148

149149
```json
150150
"extensions": {
@@ -154,7 +154,7 @@ For the Service Bus built-in connector, non-session triggers follow a *continuou
154154
}
155155
```
156156

157-
You can also enable concurrency on the Service Bus trigger, either through the designer or in code, for example:
157+
* You can enable concurrency on a Service Bus trigger, either through the designer or in code, for example:
158158

159159
```json
160160
"runtimeConfiguration": {
@@ -176,15 +176,15 @@ For the Service Bus built-in connector, non-session triggers follow a *continuou
176176

177177
* Mimic the behavior of the Service Bus managed connector trigger, which has a 30-second long poll when no messages are found.
178178

179-
You can change this delay, but make sure that you carefully test any changes to the default value:
179+
Although you can change this delay, make sure that you carefully test any changes to the default value:
180180

181-
```json
182-
"workflow": {
183-
"settings": {
184-
"Runtime.ServiceProviders.FunctionTriggers.DynamicListenerEnableDisableInterval": "00:00:30"
181+
```json
182+
"workflow": {
183+
"settings": {
184+
"Runtime.ServiceProviders.FunctionTriggers.DynamicListenerEnableDisableInterval": "00:00:30"
185+
}
185186
}
186-
}
187-
```
187+
```
188188

189189
* [Some scenarios exist where the trigger can exceed the concurrency settings](../logic-apps/logic-apps-workflow-actions-triggers.md#change-waiting-runs-limit). Rather than fail these runs, Azure Logic Apps queues them in a waiting state until they can be started. The [`maximumWaitingRuns` setting](../logic-apps/edit-app-settings-host-settings.md#trigger-concurrency) controls the number of runs allowed in the waiting state:
190190

@@ -277,16 +277,18 @@ If you use the Service Bus managed connector, you need this endpoint URL if you
277277

278278
1. On the namespace menu, select **Overview**.
279279

280-
1. On the **Overview** pane, find the **Host name** property, and copy the fully qualified name, which looks like **<*your-Service-Bus-namespace*>.servicebus.windows.net**.
280+
1. On the **Overview** pane, expand **Essentials**, and find the **Host name** property.
281+
282+
1. Copy the fully qualified name, which looks like **<*your-Service-Bus-namespace*>.servicebus.windows.net**, and save it for later use.
281283

282284
<a name="add-trigger"></a>
283285

284286
## Step 3: Option 1 - Add a Service Bus trigger
285287

286288
The following steps use the Azure portal, but with the appropriate Azure Logic Apps extension, you can also use these tools to create logic app workflows:
287289

288-
* Consumption workflows: [Visual Studio Code](../logic-apps/quickstart-create-logic-apps-visual-studio-code.md)
289-
* Standard workflows: [Visual Studio Code](../logic-apps/create-single-tenant-workflows-visual-studio-code.md)
290+
* Consumption workflows: [Create Consumption logic app workflows with Visual Studio Code](../logic-apps/quickstart-create-logic-apps-visual-studio-code.md)
291+
* Standard workflows: [Create Standard logic app workflows with Visual Studio Code](../logic-apps/create-single-tenant-workflows-visual-studio-code.md)
290292

291293
### [Consumption](#tab/consumption)
292294

@@ -338,11 +340,11 @@ The steps to add and use a Service Bus trigger differ based on whether you want
338340

339341
By default, the Service Bus built-in connector is a stateless connector. To run this connector's operations in stateful mode, see [Enable stateful mode for stateless built-in connectors](enable-stateful-affinity-built-in-connectors.md). Service Bus built-in non-session triggers follow the [*push-trigger* pattern](introduction.md#triggers), while session-based triggers provide polling capability.
340342

341-
1. In the [Azure portal](https://portal.azure.com), and open your Standard logic app resource with a blank workflow in the designer.
343+
1. In the [Azure portal](https://portal.azure.com), open your Standard logic app resource with a blank workflow in the designer.
342344

343345
1. In the designer, [follow these general steps to add the Azure Service Bus built-in trigger that you want](../logic-apps/create-workflow-with-trigger-or-action.md?tabs=standard#add-trigger).
344346

345-
This example continues with the built-in auto-complete trigger named **When messages are available in a queue**. This trigger reads the message from a service bus. If the logic app can get the message and save the trigger response to storage, the trigger automatically completes the message. If a failure happens instead, the trigger abandons the message. These behaviors only apply to stateful workflows. For stateless workflows, the auto-complete or abandon decision happens only after the run completes.
347+
This example continues with the built-in auto-complete trigger named **When messages are available in a queue**. This trigger reads the message from a service bus. If the logic app can receive the message and save the trigger response to storage, the trigger automatically completes the message. If a failure happens instead, the trigger abandons the message. These behaviors apply only to stateful workflows. For stateless workflows, the auto-complete or abandon decision happens only after the run completes.
346348

347349
1. If prompted, provide the following information for your connection. When you're done, select **Create new**.
348350

@@ -403,7 +405,7 @@ Service Bus managed triggers follow the [*long-polling trigger* pattern](#servic
403405
| **Queue type** | No | The type for the selected queue |
404406
| **How often do you want to check for items?** | Yes | The polling interval and frequency to check the queue for items |
405407

406-
:::image type="content" source="./media/connectors-create-api-azure-service-bus/service-bus-trigger-managed-standard.png" alt-text="Screenshot that shows the workflow of a Standard logic app with a Service Bus-managed trigger, and example trigger information.":::
408+
:::image type="content" source="./media/connectors-create-api-azure-service-bus/service-bus-trigger-managed-standard.png" alt-text="Screenshot that shows the workflow of a Standard logic app with a Service Bus managed trigger, and example trigger information.":::
407409

408410
1. To add any other available properties to the trigger, open the **Add new parameter** list, and select the properties that you want.
409411

@@ -421,8 +423,8 @@ Service Bus managed triggers follow the [*long-polling trigger* pattern](#servic
421423

422424
The following steps use the Azure portal, but with the appropriate Azure Logic Apps extension, you can also use the following tools to build logic app workflows:
423425

424-
* Consumption workflows: [Visual Studio Code](../logic-apps/quickstart-create-logic-apps-visual-studio-code.md)
425-
* Standard workflows: [Visual Studio Code](../logic-apps/create-single-tenant-workflows-visual-studio-code.md)
426+
* Consumption workflows: [Create Consumption logic app workflows with Visual Studio Code](../logic-apps/quickstart-create-logic-apps-visual-studio-code.md)
427+
* Standard workflows: [Create Standard logic app workflows with Visual Studio Code](../logic-apps/create-single-tenant-workflows-visual-studio-code.md)
426428

427429
### [Consumption](#tab/consumption)
428430

0 commit comments

Comments
 (0)