Merge pull request MicrosoftDocs#1677 from MicrosoftDocs/anneta-json

first pass on JSON and other functions

Author: gregli-msft

powerapps-docs/maker/TOC.yml

@@ -410,7 +410,7 @@
           - name: CountRows
             href: ./canvas-apps/functions/function-table-counts.md
           - name: Data types
-            href: ./canvas-apps/functions/data-types.md	    
+            href: ./canvas-apps/functions/data-types.md
           - name: DataSourceInfo
             href: ./canvas-apps/functions/function-datasourceinfo.md
           - name: Date
@@ -485,6 +485,8 @@
             href: ./canvas-apps/functions/function-now-today-istoday.md
           - name: IsType
             href: ./canvas-apps/functions/function-astype-istype.md
+          - name: JSON
+            href: ./canvas-apps/functions/function-json.md
           - name: Language
             href: ./canvas-apps/functions/function-language.md
           - name: Last

powerapps-docs/maker/canvas-apps/formula-reference.md

@@ -25,7 +25,7 @@ Formulas combine many elements.  Listed below are:
 Other elements include:
 
 * [All operators](functions/operators.md)
-* [Controls and their properties](reference-properties.md)
+* [Controls and their properties](reference-properties.md)
 * [Data types](functions/data-types.md)
 
 ## A
@@ -181,7 +181,10 @@ Other elements include:
 
 **[IsToday](functions/function-now-today-istoday.md)** – Checks whether a date/time value is sometime today.
 
-**[IsType](functions/function-astype-istype.md)** – Checks whether a record reference  refers to a specific entity type.  
+**[IsType](functions/function-astype-istype.md)** – Checks whether a record reference  refers to a specific entity type.
+
+## J
+**[JSON](functions/function-json.md)** - Generates a JSON text string for a table, a record, or a value.
 
 ## L
 **[Language](functions/function-language.md)** – Returns the language tag of the current user.

powerapps-docs/maker/canvas-apps/functions/data-types.md

@@ -29,7 +29,7 @@ This article provides details for the data types that canvas apps support. When
 | **DateTime** | A date with a time, in the time zone of the app's user. | **DateTimeValue( "May 16, 2019 1:23:09 PM" )** |
 | **GUID** | A [Globally Unique Identifier](https://en.wikipedia.org/wiki/Universally_unique_identifier). | **GUID()**<br>**GUID( "123e4567-e89b-12d3-a456-426655440000" )** |
 | **Hyperlink** | A text string that holds a hyperlink. | **"http://powerapps.microsoft.com"** |
-| **Image** | A [Universal Resource Identifier (URI)](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier)  text string to an image in .jpeg, .png, .svg, .gif, and other common web-image formats. | **MyImage** added as an app resource<br>**"https://northwindtraders.com/logo.jpg"**<br>**"appres://blobmanager/7b12ffa2..."** |
+| **Image** | A [Universal Resource Identifier (URI)](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier) text string to an image in .jpeg, .png, .svg, .gif, or other common web-image format. | **MyImage** added as an app resource<br>**"https://northwindtraders.com/logo.jpg"**<br>**"appres://blobmanager/7b12ffa2..."** |
 | **Media** | A URI text string to a video or audio recording. | **MyVideo** added as an app resource<br>**"https://northwindtraders.com/intro.mp4"**<br>**"appres://blobmanager/3ba411c..."** |
 | **Number** | A floating-point number. | **123**<br>**-4.567**<br>**8.903e121** |
 | **Option set** | A choice from a set of options, backed by a number. This data type combines a localizable text label with a numeric value. The label appears in the app, and the numeric value is stored and used for comparisons. | **ThisItem.OrderStatus** |

powerapps-docs/maker/canvas-apps/functions/function-colors.md

@@ -15,52 +15,56 @@ search.app:
   - PowerApps
 ---
 # Color enumeration and ColorFade, ColorValue, and RGBA functions in PowerApps
-Using built in color values, defining custom colors, and using alpha channel.
+
+Use built-in color values, define custom colors, and use the alpha channel.
 
 ## Description
 
-The **Color** enumeration is an easy way to access the colors defined by HTML's Cascading Style Sheets (CSS). For example, **Color.Red** returns a pure red color.  The list of these colors is included at the end of this article.
+By using the **Color** enumeration, you can easily access the colors that are defined by HTML's Cascading Style Sheets (CSS). For example, **Color.Red** returns pure red. You can find a list of these colors at the end of this topic.
+
+The **ColorValue** function returns a color based on a color string in a CSS. The string can take any of these forms:
 
-The **ColorValue** function returns a color based on a CSS color string.  The string can be in one of three forms:
-- **CSS color name:**  For example **"RoxyBrown"** or **"OliveDrab"**.  Spaces are omitted.  See the list of supported colors below.
-- **6 digit hex value:** For example **"#ffd700"** (which is the same as **"Gold"**).  The string is in the format "#*rrggbb*" where *rr* is the two hexadecimal digit red portion, *gg* the green, and *bb* the blue.  
-- **8 digit hex value:** For example **"#ff7f5080"** (which is the same as **"Coral"** with a 50% alpha channel).  The string is in the format "#*rrggbbaa*" where *rr*, *gg*, and *bb* are identical to the 6 digit form.  Alpha channel is represented by *aa* with "00" representing fully transparent and *ff* representing fully opaque.   
+- **CSS color name:** **"RoxyBrown"** and **"OliveDrab"** are examples. These names don't include spaces. The list of supported colors appears later in this topic.
+- **6-digit hex value:** As an example **"#ffd700"** is the same as **"Gold"**. The string is in the format "#*rrggbb*" where *rr* is the red portion in two hexadecimal digits, *gg* is the green, and *bb* is the blue.
+- **8-digit hex value:** As an example, **"#ff7f5080"** is the same as **"Coral"** with a 50% alpha channel. The string is in the format "#*rrggbbaa*" where *rr*, *gg*, and *bb* are identical to the 6-digit form. The alpha channel is represented by *aa*: **00** represents fully transparent, and **ff** represents fully opaque.
 
-The **RGBA** function returns a color based on Red, Green, and Blue color components.  It also includes an alpha channel used for mixing colors of objects layered on top of one another.  Alpha varies from 0 or 0% which is fully transparent and invisible to 1 or 100% which is fully opaque and completely blocks out layers below.
+The **RGBA** function returns a color based on red, green, and blue components. The function also includes an alpha channel for mixing colors of controls that are layered in front of one another. An alpha channel varies from 0 or 0% (which is fully transparent and invisible) to 1 or 100% (which is fully opaque and completely blocks out any layers behind a control).
 
-The **ColorFade** function returns a brighter or darker version of a color.  The amount of fade varies from -1 which fully darkens a color to black, to 0 which has no impact on the color, to 1 which fully brightens a color to white.
+The **ColorFade** function returns a brighter or darker version of a color. The amount of fade varies from -1 (which fully darkens a color to black) to 0 (which doesn't affect the color) to 1 (which fully brightens a color to white).
 
-## Alpha channel  
+## Alpha channel
 
-Controls in a canvas app can be layered on top of one another.  Each layer can control its transparency to the layers below it.  As a result colors will mix with one through the layers.  For example, this diagram shows how the three primary colors mix with an alpha setting of 50%:
+In a canvas app, you can layer controls in front of one another and specify the transparency of a control to any controls that are behind it. As a result, colors will blend through the layers. For example, this diagram shows how the three primary colors mix with an alpha setting of 50%:
 
-![](media/function-colors/alpha-primary.png)
+> [!div class="mx-imgBorder"]
+> ![Three primary colors with an alpha setting of 50%](media/function-colors/alpha-primary.png)
 
-Alpha blending can also be done with images.  Not all image file formats supports an alpha channel; PNG files do while Jpeg files do not. In this example, a PNG file with a red 50% alpha squiggle, the same red color that was used in the previous example, is layered over the top of the green and blue circles from the previous example:  
+You can also blend images in file formats that support alpha channels. For example, you can't blend .jpeg files, but you can blend .png files. The next graphic shows the same red, green, and blue colors from the previous example, but the red color appears as a squiggle (instead of a circle) in a .png file with a 50% alpha channel:
 
-![](media/function-colors/alpha-image.png)
+> [!div class="mx-imgBorder"]
+> ![Red squiggle with an alpha setting of 50% in front of blue and green circles](media/function-colors/alpha-image.png)
 
-All the **Color** enumeration values and the **ColorValue** function when used with color names or a 6 digit hexadecimal value use an alpha setting of 100% or fully opaque. 
+If you specify a **Color** enumeration value or you build a **ColorValue** formula with a color name or a 6-digit hexadecimal value, the alpha setting is 100%, which is fully opaque.
 
 ## Syntax
 
 **Color**.*ColorName*
 
-* *ColorName* - Required.  A Cascading Style Sheet (CSS) color name.  See list below of possible enumeration values.
+- *ColorName* - Required.  A Cascading Style Sheet (CSS) color name. The list of possible enumeration values appears at the end of this topic.
 
 **ColorValue**( *CSSColor* )
 
-* *CSSColor* - Required.  A Cascading Style Sheet (CSS) color definition.  Both names of CSS colors, such as "OliveDrab", and hex values, such as "#6b8e23" and "#7fffd420", may be used. Hex values can either be in the form "#rrggbb" or "#rrggbbaa". 
+- *CSSColor* - Required.  A Cascading Style Sheet (CSS) color definition. You can specify either a name, such as **OliveDrab**, or a hex value, such as **#6b8e23** or **#7fffd420**. Hex values can take the form of either #*rrggbb* or #*rrggbbaa*.
 
 **RGBA**( *Red*, *Green*, *Blue*, *Alpha* )
 
-* *Red*, *Green*, *Blue* - Required.  Color component values, ranging from 0 (no saturation) to 255 (full saturation).
-* *Alpha* - Required.  Alpha component, ranging from 0 (fully transparent) to 1 (fully opaque). You can also use a percentage, 0% to 100%.
+- *Red*, *Green*, *Blue* - Required.  Color-component values, which range from 0 (no saturation) to 255 (full saturation).
+- *Alpha* - Required.  Alpha component, which ranges from 0 (fully transparent) to 1 (fully opaque). You can also use a percentage, 0% to 100%.
 
 **ColorFade**( *Color*, *FadeAmount* )
 
-* *Color* - Required.  A color value such as **Color.Red** or the output from **ColorValue** or **RGBA**.
-* *FadeAmount* - Required.  A number between -1 and 1.  -1 fully darkens a color to black, 0 has no impact on the color, and 1 fully brightens a color to white. You can also use a percentage from -100% to 100%
+- *Color* - Required.  A color value such as **Color.Red** or the output from **ColorValue** or **RGBA**.
+- *FadeAmount* - Required.  A number between -1 and 1. -1 fully darkens a color to black, 0 doesn't affect the color, and 1 fully brightens a color to white. You can also use a percentage from -100% to 100%.
 
 ## Built-in colors