Skip to content

Commit

Permalink
Merge pull request #26812 from MSFTMan/enterpriseintegration
Browse files Browse the repository at this point in the history
update the transforms document
  • Loading branch information
Ja-Dunn authored Jun 30, 2016
2 parents 8da1cca + 9da1700 commit 2c766fd
Show file tree
Hide file tree
Showing 6 changed files with 42 additions and 3 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,47 @@ The Enterprise integration Transform connector converts data from one format to
A Transform, which is also known as a map, consists of a Source XML schema (the input) and a Target XML schema (the output). You can use different built-in functions to help manipulate or control the data, including string manipulations, conditional assignments, arithmetic expressions, date time formatters, and even looping constructs.

## How to create a transform?
You can create transform by using Visual Studio using the [Enterprise Integration SDK](https://aka.ms/vsmapsandschemas). When you are finished creating and testing the map, you upload the transform into your integration account.
You can create a transform/map by using the Visual Studio [Enterprise Integration SDK](https://aka.ms/vsmapsandschemas). When you are finished creating and testing the transform, you upload the transform into your integration account.

## How to use a transform
After you upload the transform into your integration account, you can use it to create a Logic app. The Logic app will then run your transformations whenever the Logic app is triggered (and there is input content that needs to be transformed).

**Here are the steps to use a transform**:

### Prerequisites
In the preview, you will need to:
- [Create an Azure Functions container](https://ms.portal.azure.com/#create/Microsoft.FunctionApp "Create an Azure Functions container")


>[AZURE.TIP] Make a note of the the name of the Azure Functions container, you will need it in the next step.

- [Add a function to the Azure Functions container](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F201-logic-app-transform-function%2Fazuredeploy.json "This template creates a webhook based C# azure function with transform capabilites to use in logic apps integration scenarios")


>[AZURE.TIP] Make a note of the the name of the function, you will need it in the next step.
Now that you've taken care of the prerequisites, it's time to create your Logic app:

1. Create a Logic app and [link it to your integration account](./app-service-logic-enterprise-integration-accounts.md "Learn to link an integration account to a Logic app") that contains the transform.
2. Add a **Request - When an HTTP request is received** trigger to your Logic app
![](./media/app-service-logic-enterprise-integration-transforms/transform-1.png)
3. Add the **Transform XML** action by first selecting **Add an action**
![](./media/app-service-logic-enterprise-integration-transforms/transform-2.png)
4. Enter the word *transform* in the search box in order to filter all the actions to the one that you want to use
![](./media/app-service-logic-enterprise-integration-transforms/transform-3.png)
5. Select the **Tansform XML** action
![](./media/app-service-logic-enterprise-integration-transforms/transform-4.png)
6. Select the **FUNCTION CONTAINER** that contains the function you will use. This is the name of the Azure Functions container you created earlier in these steps.
7. Select the **FUNCTION** you want to use. This is the name of the Azure Function you created earlier.
8. Add the XML **CONTENT** that you will transform. Note that you can use any XML data you receive in the HTTP request as the **CONTENT**. In this example, select the body of the HTTP request that triggered the Logic app.
9. Select the name of the **MAP** that you want to use to perform the transformation. The map must already be in your integration account. In an earlier step, you already gave your Logic app access to your integration account that contains your map.
10. Save your work
![](./media/app-service-logic-enterprise-integration-transforms/transform-5.png)

At this point, you are finished setting up your map. In a real world application, you may want to store the transformed data in an LOB application such as SalesForce. You can easily as an action to send the output of the transform to Salesforce.

You can now test your transform by making a request to the HTTP endpoint.

## Features and use cases

Expand All @@ -34,8 +74,7 @@ You can create transform by using Visual Studio using the [Enterprise Integratio
- You can do a direct data copy between the schemas. In the Mapper included in the SDK, this is as simple as drawing a line that connects the elements in the source schema with their counterparts in the destination schema.
- When creating a map, you view a graphical representation of the map, which show all the relationships and links you create.
- Use the Test Map feature to add a sample XML message. With a simple click, you can test the map you created, and see the generated output.
- Upload existing Azure BizTalk Service maps (.trfm) and use all the benefits of the Transform API App.
- When you create the map, you don't need to add a schema. When your map is ready, add it to the Transform API App and you're ready to go.
- Upload existing maps
- Includes support for the XML format.


Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 2c766fd

Please sign in to comment.