Merge pull request #196379 from joshuha-msft/20220420-ADFUDF

20220420 ADF UDF docs updates

Author: denrea

articles/data-factory/TOC.yml

@@ -277,6 +277,9 @@ items:
             displayName: cumeDist, denseRank, lag, lead, nTile, rank, rowNumber
           - name: Alphabetical usage details for all functions
             href: data-flow-expressions-usage.md
+      - name: User defined functions
+        href: concepts-data-flow-udf.md
+        displayName: udf, user defined function,data flow library
     - name: Prepare data with Power Query data wrangling
       items:
       - name: Data wrangling overview

articles/data-factory/concepts-data-flow-expression-builder.md

@@ -48,6 +48,9 @@ In mapping data flows, expressions can be composed of column values, parameters,
 
 Mapping data flows has built-in functions and operators that can be used in expressions. For a list of available functions, see the [mapping data flow language reference](data-transformation-functions.md).
 
+### User Defined Functions (Preview)
+Mapping data flows supports the creation and use of user defined functions. To see how to create and use user defined functions see [user defined functions](concepts-data-flow-udf.md).
+
 #### Address array indexes
 
 When dealing with columns or functions that return array types, use brackets ([]) to access a specific element. If the index doesn't exist, the expression evaluates into NULL.

articles/data-factory/concepts-data-flow-udf.md

@@ -0,0 +1,55 @@
+---
+title: User defined functions in mapping data flows
+titleSuffix: Azure Data Factory & Azure Synapse
+description: Learn the concepts of user defined functions in mapping data flow
+author: joshuha-msft
+ms.author: joowen
+ms.service: data-factory
+ms.subservice: data-flows
+ms.custom: synapse
+ms.topic: conceptual
+ms.date: 04/20/2022
+---
+
+# User defined functions in mapping data flow
+
+A user defined function is a customized expression you can define to be able to reuse logic across multiple mapping data flows. User defined functions live in a collection called a data flow library to be able to easily group up common sets of customized functions.
+
+Whenever you find yourself building the same logic in an expression in across multiple mapping data flows this would be a good opportunity to turn that into a user defined function.
+
+## Getting started
+
+To get started with user defined functions, you must first create a data flow library. Navigate to the management page and then find data flow libraries under the author section.
+
+![Screenshot showing the A D F management pane and data flow libraries.](./media/data-flow-udf/data-flow-udf-library.png)
+
+
+
+## Data flow library
+
+From here, you can click on +New button to create a new data flow library. Fill out the name and description and then you are ready to create your user defined function.
+![Screenshot showing the data flow libraries creation pane.](./media/data-flow-udf/data-flow-udf-library-create.png)
+
+## New user defined function
+
+To create a user defined function, from the data flow library you want to create the function in, click the +New button.
+![Screenshot showing the U D F new function button.](./media/data-flow-udf/data-flow-udf-function-new.png)
+
+Fill in the name of your user defined function.
+> [!Note]
+> You cannot use the name of an existing mapping data flow expression. For a list of the current mapping data flow expressions,  see [Data transformation expressions in mapping data flow | Microsoft Docs](data-transformation-functions.md)
+
+![Screenshot showing the U D F new function creation pane.](./media/data-flow-udf/data-flow-udf-function-pane.png)
+
+User defined functions can have zero or more arguments. Arguments allow you to pass in values when your function is called and refer to those arguments in your expression logic. Arguments are automatically named from i1, i2, etc. and you can choose the data type of the argument from the dropdown.
+
+The body of the user defined function is where you specify the logic of your function. The editor provides the full [expression builder | Microsoft Docs](concepts-data-flow-expression-builder.md) experience and allows you to reference your arguments created and any [data transformation expressions in mapping data flow | Microsoft Docs](data-transformation-functions.md).
+
+> [!Note]
+> A user defined function cannot refer to another user defined function.
+
+## Using a user defined function in the expression builder
+
+User defined functions will appear in the mapping data flow expression builder under Data flow library functions. From here, you can use your custom created functions and pass in appropriate arguments (if any) that you've defined.
+
+![Screenshot showing the data flow library in the mapping data flow expression builder.](./media/data-flow-udf/data-flow-udf-expression-builder.png)