Skip to content

Commit f9ddaf0

Browse files
author
ecfan
committed
Draft updates
1 parent 4b6d8c5 commit f9ddaf0

File tree

5 files changed

+162
-104
lines changed

5 files changed

+162
-104
lines changed

articles/logic-apps/create-standard-workflows-visual-studio-code.md

Lines changed: 34 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: logic-apps
55
ms.suite: integration
66
ms.reviewer: estfan, azla
77
ms.topic: how-to
8-
ms.date: 03/12/2025
8+
ms.date: 03/17/2025
99
ms.custom: engagement-fy23, devx-track-dotnet
1010
# Customer intent: As a logic apps developer, I want to create a Standard logic app workflow that runs in single-tenant Azure Logic Apps using Visual Studio Code.
1111
---
@@ -222,7 +222,7 @@ After you create the required workspace, follow the prompts to create your proje
222222
>
223223
> If you don't select this option, and you later try to add a managed connector
224224
> operation when you build your workflow, you can't continue because the operation
225-
> information pane shows an endlessly-spinning waiting symbol.
225+
> information pane shows a spinning circle that doesn't stop.
226226
227227
1. For the Azure resource group, select **Create new resource group**. Enter the resource group name to use.
228228

@@ -315,11 +315,11 @@ If you need to delete an item from the designer, [follow these steps for deletin
315315

316316
If the action doesn't appear in the initial results, next to the connector name, select **See more**, for example:
317317

318-
:::image type="content" source="media/create-standard-workflows-visual-studio-code/add-send-email-action.png" alt-text="Screenshot shows workflow designer and Add an action pane with action search results, and selected See more option.":::
318+
:::image type="content" source="media/create-standard-workflows-visual-studio-code/add-send-email-action.png" alt-text="Screenshot shows workflow designer and Add an action pane with action search results, and selected See more options.":::
319319

320320
1. When the action's authentication pane appears, select **Sign in** to create a connection to your email account.
321321

322-
:::image type="content" source="media/create-standard-workflows-visual-studio-code/send-email-action-sign-in.png" alt-text="Screenshot shows action named Send an email (V2) with selected sign in button.":::
322+
:::image type="content" source="media/create-standard-workflows-visual-studio-code/send-email-action-sign-in.png" alt-text="Screenshot shows actions named Send an email (V2) with selected sign in button.":::
323323

324324
1. Follow the subsequent prompts to authenticate your credentials, allow access, and allow returning to Visual Studio Code.
325325

@@ -642,7 +642,7 @@ To test your workflow, follow these steps to run a debugging session and find th
642642

643643
1. Copy and save the **Callback URL**, which looks similar to the following URL for the **When an HTTP request is received** trigger in this example:
644644

645-
`http://localhost:7071/api/<workflow-name>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>`
645+
**`http://localhost:7071/api/<workflow-name>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>`
646646

647647
:::image type="content" source="media/create-standard-workflows-visual-studio-code/find-callback-url.png" alt-text="Screenshot shows workflow overview page with callback URL.":::
648648

@@ -703,7 +703,7 @@ To test your workflow, follow these steps to run a debugging session and find th
703703
| **Cancelled** | The action was running but received a request to cancel. |
704704
| **Failed** | The action failed. |
705705
| **Running** | The action is currently running. |
706-
| **Skipped** | The action was skipped because the immediately preceding action failed. An action has a `runAfter` condition that requires that the preceding action finishes successfully before the current action can run. |
706+
| **Skipped** | The action was skipped because the immediately preceding action failed. An action has a **`runAfter`** condition that requires that the preceding action finishes successfully before the current action can run. |
707707
| **Succeeded** | The action succeeded. |
708708
| **Succeeded with retries** | The action succeeded but only after one or more retries. To review the retry history, in the run history details view, select that action so that you can view the inputs and outputs. |
709709
| **Timed out** | The action stopped due to the time-out limit specified by that action's settings. |
@@ -783,9 +783,9 @@ To find the fully qualified domain names (FQDNs) for these connections, follow t
783783

784784
The following example **connections.json** file contains two connections, an Office 365 connection and an AS2 connection. Both use managed identities for authentication and have the following **`connectionRuntimeUrl`** values, respectively:
785785

786-
- Office 365: `"connectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1`
786+
- Office 365: **`"connectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1`
787787

788-
- AS2: `"connectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2`
788+
- AS2: **`"connectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2`
789789

790790
```json
791791
{
@@ -898,7 +898,7 @@ Deployment for the Standard logic app resource requires a hosting plan and prici
898898
1. For the Azure storage account to use with workflows that enable saving run history information, choose from the following options:
899899

900900
- **Create new storage account**
901-
- Select from existing existing Azure storage accounts, if any exist.
901+
- Select from existing Azure storage accounts, if any.
902902

903903
This example selects **Create new storage account**.
904904

@@ -936,7 +936,7 @@ Deployment for the Standard logic app resource requires a hosting plan and prici
936936

937937
1. When you're ready to deploy, in the confirmation message, select **Deploy**.
938938

939-
Visual Studio Code starts to create and deploy the necesssary resources to publish your logic app to Azure.
939+
Visual Studio Code starts to create and deploy the necessary resources to publish your logic app to Azure.
940940

941941
1. To view and monitor the deployment process, on the **View** menu, select **Output**.
942942

@@ -1058,7 +1058,9 @@ After you deploy your logic app from Visual Studio Code to the Azure portal, con
10581058

10591059
1. Sign in to the [Azure portal](https://portal.azure.com) with your Azure account.
10601060

1061-
1. In the Azure title search box, enter your logic app name, which should appear as a result in the **Resources** section. Select your logic app.
1061+
1. In the Azure title search box, enter your logic app name, which should appear as a result in the **Resources** section. Select your logic app to open the resource.
1062+
1063+
:::image type="content" source="media/create-standard-workflows-visual-studio-code/find-deployed-workflow-azure-portal.png" alt-text="Screenshot shows Azure search box with logic app name entered.":::
10621064

10631065
1. On the logic app menu, under **Workflows**, select **Workflows**.
10641066

@@ -1106,31 +1108,33 @@ During workflow execution, your logic app workflow emits telemetry along with ot
11061108

11071109
1. On the **Application Insights** page, select **Turn on Application Insights**.
11081110

1109-
1. After the **Application Insights** page updates, in the **Change your resource** section, select from the following options:
1111+
1. After the **Application Insights** page updates, in the **Change your resource** section, select from the following options:
11101112

11111113
- **Create new resource**
11121114

1115+
Azure creates resources for Application Insights and a Log Analytics workspace using the current subscription and resource group. If you want to use a different subscription and resource group, see [Create a new Application Insights resource](/azure/azure-monitor/app/create-workspace-resource?tabs=portal), and then return to this page.
1116+
11131117
| Property | Description |
11141118
|----------|-------------|
11151119
| **New resource name** | Either accept the generated name or provide another name. |
11161120
| **Location** | Select an Azure region. |
1117-
| **Log Analytics workspace** | Select an existing workspace, if any exists. Otherwise, a default workspace is created for you. For more information, see [Log Analytics workspace overview](/azure/azure-monitor/logs/log-analytics-workspace-overview). |
1121+
| **Log Analytics workspace** | Select an existing workspace, if any. Otherwise, a default workspace is created for you. For more information, see [Log Analytics workspace overview](/azure/azure-monitor/logs/log-analytics-workspace-overview). |
11181122

11191123
- **Select existing resource**:
11201124

1121-
1. For the subscription, select the Azure subscription for the Application Insights resource.
1125+
1. Select the Azure subscription for your Application Insights resource.
11221126

1123-
1. From the Application Insights resources associated with the subscription, select the resource you want.
1127+
1. Select your Application Insights resource.
11241128

1125-
1. After the pane updates, at the bottom, select **Apply**.
1129+
1. When you're done, at the page bottom, select **Apply**.
11261130

11271131
#### Open Application Insights from your logic app
11281132

11291133
1. In the [Azure portal](https://portal.azure.com), find and open your deployed logic app.
11301134

11311135
1. On the logic app menu, under **Monitoring**, select **Application Insights**.
11321136

1133-
1. On the **Application Insights** page, select **View Application Insights data**.
1137+
1. On the **Application Insights** page, select the link for your Application Insights resource.
11341138

11351139
After Application Insights opens, you can review various metrics for your logic app. For more information, see these articles:
11361140

@@ -1145,13 +1149,13 @@ After Application Insights opens, you can review various metrics for your logic
11451149

11461150
### Designer fails to open
11471151

1148-
When you try to open the designer, you get this error, **"Workflow design time could not be started"**. If you previously tried to open the designer, and then discontinued or deleted your project, the extension bundle might not be downloading correctly. To check whether this cause is the problem, follow these steps:
1152+
When you try to open the designer, you get this error, **"Workflow design time could not be started"**. If you previously tried to open the designer, and then discontinued or deleted your project, the extension bundle might not correctly download. To check whether this reason is the cause, follow these steps:
11491153

11501154
1. In Visual Studio Code, open the Output window. From the **View** menu, select **Output**.
11511155

11521156
1. From the list in the Output window's title bar, select **Azure Logic Apps (Standard)** so that you can review output from the extension, for example:
11531157

1154-
![Screenshot that shows the Output window with "Azure Logic Apps" selected.](./media/create-standard-workflows-visual-studio-code/check-output-window-azure-logic-apps.png)
1158+
:::image type="content" source="media/create-standard-workflows-visual-studio-code/check-output-window-azure-logic-apps.png" alt-text="Screenshot shows Output window with scope list and Azure Logic Apps (Standard) selected.":::
11551159

11561160
1. Review the output and check whether this error message appears:
11571161

@@ -1173,7 +1177,7 @@ When you try to open the designer, you get this error, **"Workflow design time c
11731177

11741178
### New triggers and actions are missing from the designer picker for previously created workflows
11751179

1176-
Single-tenant Azure Logic Apps supports built-in actions for Azure Function Operations, Liquid Operations, and XML Operations, such as **XML Validation** and **Transform XML**. However, for previously created logic apps, these actions might not appear in the designer picker for you to select if Visual Studio Code uses an outdated version of the extension bundle, `Microsoft.Azure.Functions.ExtensionBundle.Workflows`.
1180+
Single-tenant Azure Logic Apps supports built-in actions for Azure Function Operations, Liquid Operations, and XML Operations, such as **XML Validation** and **Transform XML**. However, for previously created logic apps, these actions might not appear in the designer picker for you to select if Visual Studio Code uses an outdated version of the extension bundle, **`Microsoft.Azure.Functions.ExtensionBundle.Workflows`.
11771181

11781182
Also, the **Azure Function Operations** connector and actions don't appear in the designer picker unless you enabled or selected **Use connectors from Azure** when you created your logic app. If you didn't enable the Azure-deployed connectors at app creation time, you can enable them from your project in Visual Studio Code. Open the **workflow.json** shortcut menu, and select **Use Connectors from Azure**.
11791183

@@ -1189,13 +1193,13 @@ To fix the outdated bundle, follow these steps to delete the outdated bundle, wh
11891193

11901194
1. On your computer, browse to the following folder, which contains versioned folders for the existing bundle:
11911195

1192-
`...\Users\<user-name>\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows`
1196+
**`...\Users\<user-name>\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows`
11931197

11941198
1. Delete the version folder for the earlier bundle, for example, if you have a folder for version 1.1.3, delete that folder.
11951199

11961200
1. Now, browse to the following folder, which contains versioned folders for required NuGet package:
11971201

1198-
`...\Users\<user-name>\.nuget\packages\microsoft.azure.workflows.webjobs.extension`
1202+
**`...\Users\<user-name>\.nuget\packages\microsoft.azure.workflows.webjobs.extension`
11991203

12001204
1. Delete the version folder for the earlier package.
12011205

@@ -1209,32 +1213,32 @@ The missing triggers and actions now appear in the designer.
12091213

12101214
When a run fails, and you inspect the run in monitoring view, this error might appear on a trigger or action that has a longer name, which causes the underlying Uniform Resource Identifier (URI) to exceed the default character limit.
12111215

1212-
To resolve this problem and adjust for the longer URI, edit the `UrlSegmentMaxCount` and `UrlSegmentMaxLength` registry keys on your computer by following the steps below. These key's default values are described in this topic, [Http.sys registry settings for Windows](/troubleshoot/iis/httpsys-registry-windows).
1216+
To resolve this problem and adjust for the longer URI, edit the **`UrlSegmentMaxCount`** and **`UrlSegmentMaxLength`** registry keys on your computer by following the steps below. These key's default values are described in this topic, [Http.sys registry settings for Windows](/troubleshoot/iis/httpsys-registry-windows).
12131217

12141218
> [!IMPORTANT]
12151219
>
12161220
> Before you start, make sure that you save your work. This solution requires you
12171221
> to restart your computer after you're done so that the changes can take effect.
12181222

1219-
1. On your computer, open the **Run** window, and run the `regedit` command, which opens the registry editor.
1223+
1. On your computer, open the **Run** window, and run the **`regedit`** command, which opens the registry editor.
12201224

12211225
1. In the **User Account Control** box, select **Yes** to permit your changes to your computer.
12221226

12231227
1. In the left pane, under **Computer**, expand the nodes along the path, **HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters**, and then select **Parameters**.
12241228

1225-
1. In the right pane, find the `UrlSegmentMaxCount` and `UrlSegmentMaxLength` registry keys.
1229+
1. In the right pane, find the **`UrlSegmentMaxCount`** and **`UrlSegmentMaxLength`** registry keys.
12261230

12271231
1. Increase these key values enough so that the URIs can accommodate the names that you want to use. If these keys don't exist, add them to the **Parameters** folder by following these steps:
12281232

12291233
1. From the **Parameters** shortcut menu, select **New** > **DWORD (32-bit) Value**.
12301234

1231-
1. In the edit box that appears, enter `UrlSegmentMaxCount` as the new key name.
1235+
1. In the edit box that appears, enter **`UrlSegmentMaxCount`** as the new key name.
12321236

12331237
1. Open the new key's shortcut menu, and select **Modify**.
12341238

1235-
1. In the **Edit String** box that appears, enter the **Value data** key value that you want in hexadecimal or decimal format. For example, `400` in hexadecimal is equivalent to `1024` in decimal.
1239+
1. In the **Edit String** box that appears, enter the **Value data** key value that you want in hexadecimal or decimal format. For example, **`400`** in hexadecimal is equivalent to **`1024`** in decimal.
12361240

1237-
1. To add the `UrlSegmentMaxLength` key value, repeat these steps.
1241+
1. To add the **`UrlSegmentMaxLength`** key value, repeat these steps.
12381242

12391243
After you increase or add these key values, the registry editor looks like this example:
12401244

@@ -1248,9 +1252,9 @@ To resolve this problem and adjust for the longer URI, edit the `UrlSegmentMaxCo
12481252

12491253
When you try to start a debugging session, you get the error, **"Error exists after running preLaunchTask 'generateDebugSymbols'"**. To resolve this problem, edit the **tasks.json** file in your project to skip symbol generation.
12501254

1251-
1. In your project, expand the folder that's named **.vscode**, and open the **tasks.json** file.
1255+
1. In your project, expand the **.vscode** folder, and open the **tasks.json** file.
12521256

1253-
1. In the following task, delete the line, `"dependsOn: "generateDebugSymbols"`, along with the comma that ends the preceding line, for example:
1257+
1. In the following task, delete the line, **`"dependsOn: "generateDebugSymbols"`**, along with the comma that ends the preceding line, for example:
12541258

12551259
Before:
12561260

0 commit comments

Comments
 (0)