Merge pull request #211480 from jonburchel/pr97513

Pr97513

Author: prmerger-automator[bot]

articles/data-factory/data-flow-parse.md

@@ -1,5 +1,5 @@
 ---
-title: Parse data transformation in mapping data flow
+title: Parse data transformations in mapping data flow
 description: Parse embedded column documents
 author: kromerm
 ms.author: makromer
@@ -41,21 +41,31 @@ Use the expression builder to set the source for your parsing. This can be as si
 * Source JSON data: ```{"ts":1409318650332,"userId":"309","sessionId":1879,"page":"NextSong","auth":"Logged In","method":"PUT","status":200,"level":"free","itemInSession":2,"registration":1384448}```
   * Expression: ```(level as string, registration as long)```
 
+* Source Nested JSON data: ```{"car" : {"model" : "camaro", "year" : 1989}, "color" : "white", "transmission" : "v8"}```
+* Expression: ```(car as (model as string, year as integer), color as string, transmission as string)```
+
 * Source XML data: ```<Customers><Customer>122</Customer><CompanyName>Great Lakes Food Market</CompanyName></Customers>```
   * Expression: ```(Customers as (Customer as integer, CompanyName as string))```
 
+* Source XML with Attribute data: ```<cars><car model="camaro"><year>1989</year></car></cars>```
+* Expression: ```(cars as (car as ({@model} as string, year as integer)))```
+* Note: If you run into errors extracting attributes (i.e. @model) from a complex type, a workaround is to convert the complex type to a string, remove the @ symbol (i.e. replace(toString(your_xml_string_parsed_column_name.cars.car),'@','')
+), and then use the parse JSON transformation activity. 
+
 ### Output column type
 
-Here is where you'll configure the target output schema from the parsing that will be written into a single column. The easiest way to set a schema for your output from parsing is to click the 'Detect Type' button on the top right of the expression builder. ADF will attempt to autodetect the schema from the string field which you are parsing and set it for you in the output expression.
+Here's where you'll configure the target output schema from the parsing that will be written into a single column. The easiest way to set a schema for your output from parsing is to select the 'Detect Type' button on the top right of the expression builder. ADF will attempt to autodetect the schema from the string field, which you're parsing and set it for you in the output expression.
 
 :::image type="content" source="media/data-flow/data-flow-parse-2.png" alt-text="Parse example":::
 
-In this example, we have defined parsing of the incoming field "jsonString" which is plain text, but formatted as a JSON structure. We're going to store the parsed results as JSON in a new column called "json" with this schema:
+In this example, we have defined parsing of the incoming field "jsonString", which is plain text, but formatted as a JSON structure. We're going to store the parsed results as JSON in a new column called "json" with this schema:
 
 `(trade as boolean, customers as string[])`
 
 Refer to the inspect tab and data preview to verify your output is mapped properly.
 
+Use the Derived Column activity to extract hierarchical data (that is, your_complex_column_name.car.model in the expression field)
+
 ## Examples
 
 ```