Processing a flat file with Azure Logic Apps

Mon, 28 Nov 2016 21:56:24 +0000

[Update: 5th Aug 2018 – This post is still relevant especially the integration account, schemas and maps and I have written a new blog that builds on this one and integrates into SQL - Using Azure Logic Apps to Import CSV to SQL Server]

A lot of companies require the transfer of files in order to transact business and there is always a need to translate these files from one format to another. Logic Apps provides a straight forward way to build serverless components that provide the integration points into your systems. This post is going to look at Logic apps enterprise integration to convert a multi-record CSV file into and XML format. Most of the understanding for this came from the following post:

https://seroter.wordpress.com/2016/09/09/trying-out-standard-and-enterprise-templates-in-azure-logic-apps/

Logic Apps can be created in Visual Studio or directly in the Azure Portal using the browser. Navigate to the azure portal https://portal.azure.com click the plus button at the top of the right hand column, then Web + Mobile then Logic App

Complete the form and click Create

This will take a short while to complete. Once complete you can select the logic app from you resource list to start to use it.

If you look at my recent list

You can see the logic app I’ve just created but you will also see my previous logic app and you will also notice that there is also an integration account and an Azure function. These are both required in order to create the necessary schemas and maps required to translate the CSV file to XML.

The integration account stores the schemas and maps and the Azure function provides some code that is used to translate the CSV to XML.

An integration account is created the same way as a logic app. The easiest way is to click on the plus symbol and then search for integration

Click on Integration Account then Create

Complete the form

Then Create. Once created you can start to add your schemas and maps

You will now need to jump into Visual Studio to create your maps and schemas. You will need to install the Logic Apps Integration Tools for Visual Studio

You will need to create a schema for the CSV file and a schema for the XML file. These two blog posts walk you through creating a flat file schema for a CSV file and also a positional file

I created the following two schemas

Once you have create the two schemas you will need to create a map which allows you to map the fields from one schema to the fields in the other schema.

In order to upload the map you will need to build the project in Visual Studio to build the xslt file.

The schemas and map file project can be found in my repository on GitHub

To upload the files to the integration account, go back to the Azure portal where you previously selected the integration account, click Schemas then Add

Complete the form, select the schema file from your Visual Studio project and click OK. Repeat this for both schema files. You do the same thing for the map file. You will need to navigate to your bin/Debug (or Release) folder to find the xslt file that was built. Your integration account should now show your schemas and maps as uploaded

There’s one more thing to do before you can create your logic app. In order to process the transformation some code is required in an Azure Function. This is standard code and can be created by clicking the highlighted link on this page. Note: If you haven’t used Azure Functions before then you will also need to click the other link first.

This creates you a function with the necessary code required to perform the transformation

You are now ready to start your logic app. Click on the Logic App you created earlier. This will display a page where you can select a template with which to create your app.

Close this down as you need to link your integration account to your logic app.

Click on Settings, then Integration Account and pick the integration Account where you previously uploaded the Schemas and Map files. Save this and return to the logic app template screen.

Select VETER Pipeline

Then “Use This Template”. This is the basis for your transformation logic. All you need to do now is to complete each box.

In Flat File Decoding & XML Validation, pick the CSV schema

In the transform XML

Select the function container, the function and the map file

All we need to do now is to return the transformed xml in the response message. Click “Add an Action” on Transform XML and search for Response.

Pick the Transformed XML content as the body of the response. Click save and the URL for the logic app will be populated in the Request flow

We now have a Request that takes the CSV in the body and it returns the XML transform in the body of the response. You can test this using a tool like PostMan or Fiddler to send in the request to the request URL above.

There is also a test CSV file in my repository on GitHub which can be used to test this.

My next post covers how I diagnosed a fault with this Logic App

BlackMarble SOA/BizTalk Event

Thu, 03 Jul 2008 09:44:55 +0000

Thanks to everyone who sat and listened to my presentations on BizTalk RFID, ESB and ISB. I hope that you found them useful.

As promised here are the links:

Biztalk RFID : http://www.microsoft.com/biztalk/en/us/rfid.aspx

Blue C Sushi : http://www.microsoft.com/casestudies/casestudy.aspx?casestudyid=201405

ESB Guidance : http://msdn.microsoft.com/en-us/library/cc487894.aspx

Robert's Blog on installing ESB: ESB Guidance Setup Walk through (DRAFT)

Biztalk Services/ISB: http://biztalk.net/

Oslo in a nutshell

Wed, 30 Apr 2008 10:10:01 +0000

What is Oslo all about? According to Microsoft's Burley Kawasaki at Architect Insight, Oslo is a new way to build connected applications where services are extended from client to cloud and models become the mainstream part of development. Oslo is not a product but a way of working. http://www.microsoft.com/soa/products/oslo.aspx.

Other things of interest from Architect Insight include the ConfigWeb sample (from Stock Trader) for configuring enterprise web applications (http://msdn.microsoft.com/en-us/netframework/bb499684.aspx). The Internet Service bus and biztalk services (http://biztalk.net/Default.aspx).

Steve Spencer's Blog - Biztalk

Processing a flat file with Azure Logic Apps

BlackMarble SOA/BizTalk Event

Oslo in a nutshell