You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/logic-apps/create-maps-data-transformation-visual-studio-code.md
+21-46Lines changed: 21 additions & 46 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ This how-to guide shows how to create an empty data map, choose your source and
34
34
35
35
- The layout and item positions in Data Mapper are currently automatic and read only.
36
36
37
-
- If you create a mapping between parent (complex) elements in the source and target schemas, the mapper creates a loop that iterates through the child elements. However, you must still explicitly create mappings between the child elements.
37
+
- If you create a mapping between parent elements, which have **Complex** type, in the source and target schemas, the mapper creates a loop that iterates through the child elements. However, you must still explicitly create mappings between the child elements.
38
38
39
39
- To call maps created with Data Mapper, you can only use the **Data Mapper Operations** action named **Transform using Data Mapper XSLT**. [For maps created by any other tool, use the **XML Operations** action named **Transform XML**](logic-apps-enterprise-integration-transform.md).
40
40
@@ -134,7 +134,7 @@ For a straightforward transformation between elements with the same type in the
134
134
135
135
1. On the mapper surface, in the **Source** pane, find the source element that you want to map.
136
136
137
-
- By default, parent elements are automatically expanded to show their children. However, if the parent doesn't appear expanded, expand the parent first so you can create a mapping for a child element.
137
+
- By default, parent elements are automatically expanded to show their children. You can't collapse parent elements.
138
138
139
139
- This example starts mapping from the source element, but you can choose to start mapping from the target element.
140
140
@@ -190,15 +190,11 @@ The following table lists the available function groups and some example functio
190
190
191
191
### Add a function without a mapping relationship
192
192
193
-
The example in this section transforms the source element from String type to DateTime type, which is the target element type. The example starts without creating a mapping and uses the **To Date** function, which takes a single input.
193
+
The example in this section transforms the source element from String type to DateTime type, which is the target element type. The example starts without creating a mapping and uses the **To Date** function, which accepts a single input.
194
194
195
195
1. To view what happens in code while you create the mapping, in the mapper's upper right corner, select **View code**.
196
196
197
-
1. If the **Functions** list isn't visible, in the mapper's upper left corner, select the function icon ().
198
-
199
-
:::image type="content" source="media/create-maps-data-transformation-visual-studio-code/no-mapping-show-functions.png" alt-text="Screenshot shows selected function icon.":::
200
-
201
-
1. In the **Functions** list, find and select the function that you want to use, which adds the function to the mapper surface.
197
+
1. In the **Functions** list, find and select the function that you want to use, which adds the function to the mapper surface. If the **Functions** list is collapsed, in the mapper's upper left corner, select the function icon ().
202
198
203
199
This example selects the **To Date** function, which is in the **Conversion** function group.
204
200
@@ -211,7 +207,7 @@ The example in this section transforms the source element from String type to Da
211
207
> If no mapping exists on the map or if a mapping is selected when you add a function to the
212
208
> map, the function appears but isn't connected to any elements or other functions, for example:
213
209
>
214
-
> :::image type="content" source="media/create-maps-data-transformation-visual-studio-code/disconnected-function-to-date.png" alt-text="Screenshot shows a disconnected function." border="false":::
210
+
> :::image type="content" source="media/create-maps-data-transformation-visual-studio-code/disconnected-function-to-date.png" alt-text="Screenshot shows disconnected function named To Date." border="false":::
215
211
216
212
1. Connect the function to the source and target elements.
217
213
@@ -233,63 +229,42 @@ The example in this section transforms the source element from String type to Da
233
229
234
230
:::image type="content" source="media/create-maps-data-transformation-visual-studio-code/function-to-date-confirm-inputs.png" alt-text="Screenshot shows Input tab for the function named To Date.":::
235
231
236
-
For some data types, such as arrays, the scope for the transformation might also appear available. This scope is usually the immediate element, such as an array, but in some scenarios, the scope might exist beyond the immediate element.
232
+
For some data types, such as arrays, the scope for the transformation might also appear available. This scope is usually the immediate element, such as the array, but in some scenarios, the scope might exist beyond the immediate element.
237
233
238
234
For example, to iterate through array items, see [Create a loop between arrays](#loop-through-array). To perform a task when an element's value meets a condition, see [Add a condition between elements](#add-condition).
239
235
240
-
### Add a function to an existing mapping relationship
241
-
242
-
When a mapping relationship already exists between source and target elements, you can add the function by following these steps:
243
-
244
-
1. On the map, select the line for the mapping that you created.
245
-
246
-
1. Move your pointer over the selected line, and select the **Insert function** plus sign (**+**) that appears, for example:
247
-
248
-
:::image type="content" source="media/create-maps-data-transformation-visual-studio-code/insert-function.png" alt-text="Screenshot shows Visual Studio Code with elements from source and target schemas with mapping relationship and option to Insert function." lightbox="media/create-maps-data-transformation-visual-studio-code/insert-function.png":::
249
-
250
-
1. From the functions list that opens, find and select the function that you want to use.
251
-
252
-
The function appears on the map and is automatically connected between the source and target elements.
253
-
254
236
### Add a function with multiple inputs
255
237
256
-
The example in this section concatenates multiple source element types so that you can map the results to the target element type. The example uses the **Concat** function, which takes multiple inputs.
238
+
The example in this section concatenates multiple source element types so that you can map the results to the target element type. The example uses the **Concat** function, which accepts multiple inputs.
257
239
258
-
1. To view what happens in code while you create the mapping, in the mapper upper right corner, select **View code**.
259
-
260
-
1. If you haven't already, on the mapper surface, [select the source and target elements map](#create-direct-mapping).
261
-
262
-
1. In the map's upper left corner, select **Show functions** ().
263
-
264
-

240
+
1. To view what happens in code while you create the mapping, in the mapper's upper right corner, select **View code**.
265
241
266
-
1.From the functions list that opens, find and select the function that you want to use, which adds the function to the map. If the function doesn't appear visible on the map, try zooming out on the map surface.
242
+
1.In the **Functions** list, find and select the function that you want to use, which adds the function to the mapper surface. If the **Functions** list is collapsed, in the mapper's upper left corner, select the function icon ().
267
243
268
-
This example selects the **Concat** function:
244
+
This example selects the **Concat** function, which is in the **String** function group.
269
245
270
-

246
+
:::image type="content" source="media/create-maps-data-transformation-visual-studio-code/select-function-concat.png" alt-text="Screenshot shows the selected function named Concat.":::
271
247
272
248
> [!NOTE]
273
249
>
274
-
> If no mapping line exists or is selected when you add a function to the map, the function
275
-
> appears on the map, but disconnected from any elements or other functions. If the function
276
-
> requires configuration, a red dot appears in the function's upper right corner, for example:
250
+
> If no mapping exists on the map or if a mapping is selected when you add a function to the
251
+
> map, the function appears but isn't connected to any elements or other functions, for example:
277
252
>
278
-
> 
253
+
> :::image type="content" source="media/create-maps-data-transformation-visual-studio-code/disconnected-function-concat.png" alt-text="Screenshot shows disconnected function named Concat." border="false":::
279
254
280
-
1.Expand the function shape to display the function's details and connection points. To expand the function shape, select inside the shape.
255
+
1.On the mapper surface, select the function shape to view the function details.
281
256
282
-
1.In the function information pane, on the **Properties** tab, under **Inputs**, select the source data elements to use as the inputs.
257
+
1.On the **Input** tab, select the source data elements to use as the inputs.
283
258
284
-
This example selects the **FirstName** and **LastName** source elements as the function inputs, which automatically add the respective connections on the map.
259
+
This example selects the **FirstName** and **LastName**elements in the source schema as the function inputs, which automatically adds the respective mappings to the mapper surface.
285
260
286
-

261
+
:::image type="content" source="media/create-maps-data-transformation-visual-studio-code/function-multiple-inputs.png" alt-text="Screenshot shows multiple source elements as function inputs.":::
287
262
288
-
1. To complete the mapping drag and draw a line between the function's right edge and the target element. You can start either from the target element or from the function.
263
+
1. To complete the mapping, drag and draw a line between the function's right edge and the target element. You can start from either the target element or the function.
289
264
290
-

265
+
:::image type="content" source="media/create-maps-data-transformation-visual-studio-code/function-multiple-inputs-single-output.png" alt-text="Screenshot shows finished mappings between multiple inputs, Concat function, and target element.":::
291
266
292
-
The **Code** pane shows the mapping relationship that you created:
267
+
The **Code** pane shows the mapping relationships that you created:
293
268
294
269

0 commit comments