Skip to content

Commit ddc5936

Browse files
committed
Updates for flat files
1 parent 90efac2 commit ddc5936

File tree

2 files changed

+44
-15
lines changed

2 files changed

+44
-15
lines changed

articles/logic-apps/logic-apps-enterprise-integration-create-integration-account.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -234,7 +234,6 @@ Before you can link your integration account to a Standard logic app resource, y
234234
|----------|-------|
235235
| **Name** | **WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL** |
236236
| **Value** | <*integration-account-callback-URL*> |
237-
|||
238237

239238
1. When you're done, select **OK**. When you return to the **Configuration** pane, make sure to save your changes. On the **Configuration** pane toolbar, select **Save**.
240239

@@ -248,7 +247,6 @@ Before you can link your integration account to a Standard logic app resource, y
248247
|----------|-------|
249248
| **Name** | **WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL** |
250249
| **Value** | <*integration-account-callback-URL*> |
251-
|||
252250

253251
This example shows how a sample app setting might appear:
254252

@@ -417,7 +415,6 @@ If you want to link your logic app to another integration account, or no longer
417415
|----------|-------|
418416
| **Name** | **WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL** |
419417
| **Value** | <*integration-account-callback-URL*> |
420-
|||
421418

422419
1. When you're done, save your changes.
423420

articles/logic-apps/logic-apps-enterprise-integration-flatfile.md

Lines changed: 44 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,29 +7,65 @@ author: divyaswarnkar
77
ms.author: divswa
88
ms.reviewer: estfan, azla
99
ms.topic: how-to
10-
ms.date: 08/23/2022
10+
ms.date: 09/01/2022
1111
---
1212

1313
# Encode and decode flat files in Azure Logic Apps
1414

1515
[!INCLUDE [logic-apps-sku-consumption-standard](../../includes/logic-apps-sku-consumption-standard.md)]
1616

17-
Before you send XML content to a business partner in a business-to-business (B2B) scenario, you might want to encode that content first. By building a logic app workflow, you can encode and decode flat files by using the [built-in](../connectors/built-in.md#integration-account-built-in) **Flat File** actions.
18-
19-
Although no **Flat File** triggers are available, you can use a different trigger or action to get or feed the XML content from various sources into your workflow for encoding or decoding. For example, you can use the Request trigger, another app, or other [connectors supported by Azure Logic Apps](../connectors/apis-list.md). You can use **Flat File** actions with workflows in the [**Logic App (Consumption)** and **Logic App (Standard)** resource types](single-tenant-overview-compare.md).
17+
Before you send XML content to a business partner in a business-to-business (B2B) scenario, you might want to encode that content first. If you receive encoded XML content, you'll need to decode that content first. When you're building a logic app workflow in Azure Logic Apps, you can encode and decode flat files by using the **Flat File** built-in connector actions and providing a schema to use for encoding and decoding. You can use **Flat File** actions in multi-tenant Consumption logic app workflows and single-tenant Standard logic app workflows.
2018

2119
> [!NOTE]
22-
> For **Logic App (Standard)**, the **Flat File** actions are currently in preview.
20+
>
21+
> In Standard logic app workflows, the **Flat File** actions are currently in preview.
22+
23+
While no **Flat File** triggers are available, you can use any trigger or action to feed the source XML content into your workflow for encoding or decoding. For example, you can use a built-in connector trigger, a managed or Azure-hosted connector trigger available for Azure Logic Apps, or even another app.
24+
25+
This article shows how to add the **Flat File** encoding and decoding actions to your workflow.
2326

24-
This article shows how to add the Flat File encoding and decoding actions to an existing logic app workflow. If you're new to logic apps, review the following documentation:
27+
For more information, review the following documentation:
2528

26-
* [What is Azure Logic Apps](logic-apps-overview.md)
27-
* [B2B enterprise integration workflows with Azure Logic Apps and Enterprise Integration Pack](logic-apps-enterprise-integration-overview.md)
29+
* [Consumption versus Standard logic apps](logic-apps-overview.md#resource-type-and-host-environment-differences)
30+
* [Integration account built-in connectors](../connectors/built-in.md#integration-account-built-in)
31+
* [Built-in connectors overview for Azure Logic Apps](../connectors/built-in.md)
32+
* [Managed or Azure-hosted connectors in Azure Logic Apps](/connectors/connector-reference/connector-reference-logicapps-connectors)
2833

2934
## Prerequisites
3035

3136
* An Azure account and subscription. If you don't have a subscription yet, [sign up for a free Azure account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
3237

38+
* The logic app workflow, blank or existing, where you want to use the **Flat File** action.
39+
40+
If you have a blank workflow, use any trigger that you want to start the workflow. This example uses the Request trigger.
41+
42+
* Your logic app resource and workflow. Flat file operations don't have any triggers available, so your workflow has to minimally include a trigger. For more information, review the following documentation:
43+
44+
* [Quickstart: Create your first Consumption logic app workflow with multi-tenant Azure Logic Apps](quickstart-create-first-logic-app-workflow.md)
45+
46+
* [Create a Standard logic app workflow with single-tenant Azure Logic Apps](create-single-tenant-workflows-azure-portal.md)
47+
48+
* The flat file [schema](logic-apps-enterprise-integration-schemas.md) to use for encoding and decoding the XML content.
49+
50+
* Based on whether you're working on a Consumption or Standard logic app workflow, you'll need an [integration account resource](logic-apps-enterprise-integration-create-integration-account.md). Usually, you need this resource when you want to define and store artifacts for use in enterprise integration and B2B workflows.
51+
52+
> [!IMPORTANT]
53+
>
54+
> To work together, both your integration account and logic app resource must exist in the same Azure subscription and Azure region.
55+
56+
* If you're working on a Consumption logic app workflow, your logic app resource requires a [link to your integration account](logic-apps-enterprise-integration-create-integration-account.md?tabs=consumption#link-account).
57+
58+
* If you're working on a Standard logic app workflow, you can link your your logic app resource to your integration account, upload encoding schemas directly to your logic app resource, or both, based on the following scenarios:
59+
60+
* If you already have an integration account with the artifacts that you need or want to use, you can link your integration account to multiple Standard logic app resources where you want to use the artifacts. That way, you don't have to upload schemas to each individual logic app. For more information, review [Link your logic app resource to your integration account](logic-apps-enterprise-integration-create-integration-account.md?tabs=standard#link-account).
61+
62+
* Some Azure-hosted integration account connectors, such as AS2, EDIFACT, and X12, let you create a connection to your integration account. If you're just using these connectors, you don't need the link.
63+
64+
* The built-in connectors named **Flat File** and **Liquid** let you select schemas and maps that you previously uploaded to your logic app resource or to a linked integration account, but not both. You can then use these artifacts across all child workflows within the same logic app resource.
65+
66+
So, if you don't have or need an integration account, you can use the upload option. Otherwise, you can use the linking option. Either way, you can use these artifacts across all child workflows within the same logic app resource.
67+
68+
3369
* An [integration account resource](logic-apps-enterprise-integration-create-integration-account.md) where you define and store artifacts, such as trading partners, agreements, certificates, and so on, for use in your enterprise integration and B2B workflows. This resource has to meet the following requirements:
3470

3571
* Is associated with the same Azure subscription as your logic app resource.
@@ -50,10 +86,6 @@ This article shows how to add the Flat File encoding and decoding actions to an
5086
> Currently, only the **Logic App (Consumption)** resource type supports [RosettaNet](logic-apps-enterprise-integration-rosettanet.md) operations.
5187
> The **Logic App (Standard)** resource type doesn't include [RosettaNet](logic-apps-enterprise-integration-rosettanet.md) operations.
5288
53-
* The logic app workflow, blank or existing, where you want to use the **Flat File** action.
54-
55-
If you have a blank workflow, use any trigger that you want to start the workflow. This example uses the Request trigger.
56-
5789
## Limits
5890

5991
Make sure that the contained XML groups in the flat file schema that you generate doesn't have excessive numbers of the `max count` property set to a value *greater than 1*. Avoid nesting an XML group with a `max count` property value greater than 1 inside another XML group with a `max count` property greater than 1.

0 commit comments

Comments
 (0)