Merge pull request #113025 from tfitzmac/0428functions1

change code format

Author: PRMerger10

articles/azure-resource-manager/templates/template-functions-object.md

@@ -106,7 +106,7 @@ Determines if an array, object, or string is empty.
 
 | Parameter | Required | Type | Description |
 |:--- |:--- |:--- |:--- |
-| itemToTest |Yes |array, object, or string |The value to check if it is empty. |
+| itemToTest |Yes |array, object, or string |The value to check if it's empty. |
 
 ### Return value
 
@@ -249,13 +249,21 @@ If you need to include a parameter value or variable in the JSON object, use the
 
 ### Example
 
-The following [example template](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/functions/json.json) shows how to use the json function with arrays and objects:
+The following [example template](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/functions/json.json) shows how to use the json function. Notice that you can either pass in a string that represents the object or use **null** when no value is needed.
 
 ```json
 {
     "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {
+        "jsonObject1": {
+            "type": "string",
+            "defaultValue": "null"
+        },
+        "jsonObject2": {
+            "type": "string",
+            "defaultValue": "{\"a\": \"b\"}"
+        },
         "testValue": {
             "type": "string",
             "defaultValue": "demo value"
@@ -264,13 +272,13 @@ The following [example template](https://github.com/Azure/azure-docs-json-sample
     "resources": [
     ],
     "outputs": {
-        "jsonOutput": {
-            "type": "object",
-            "value": "[json('{\"a\": \"b\"}')]"
-        },
-        "nullOutput": {
+        "jsonOutput1": {
             "type": "bool",
-            "value": "[empty(json('null'))]"
+            "value": "[empty(json(parameters('jsonObject1')))]"
+        },
+        "jsonOutput2": {
+            "type": "object",
+            "value": "[json(parameters('jsonObject2'))]"
         },
         "paramOutput": {
             "type": "object",
@@ -284,8 +292,8 @@ The output from the preceding example with the default values is:
 
 | Name | Type | Value |
 | ---- | ---- | ----- |
-| jsonOutput | Object | {"a": "b"} |
-| nullOutput | Boolean | True |
+| jsonOutput1 | Boolean | True |
+| jsonOutput2 | Object | {"a": "b"} |
 | paramOutput | Object | {"a": "demo value"}
 
 ## length

articles/azure-resource-manager/templates/template-functions-resource.md

@@ -2,7 +2,7 @@
 title: Template functions - resources
 description: Describes the functions to use in an Azure Resource Manager template to retrieve values about resources.
 ms.topic: conceptual
-ms.date: 04/06/2020
+ms.date: 04/28/2020
 ---
 # Resource functions for ARM templates
 
@@ -22,9 +22,7 @@ To get values from parameters, variables, or the current deployment, see [Deploy
 
 ## extensionResourceId
 
-```json
-extensionResourceId(resourceId, resourceType, resourceName1, [resourceName2], ...)
-```
+`extensionResourceId(resourceId, resourceType, resourceName1, [resourceName2], ...)`
 
 Returns the resource ID for an [extension resource](../management/extension-resource-types.md), which is a resource type that is applied to another resource to add to its capabilities.
 
@@ -102,9 +100,7 @@ The following example returns the resource ID for a resource group lock.
 
 ## list*
 
-```json
-list{Value}(resourceName or resourceIdentifier, apiVersion, functionValues)
-```
+`list{Value}(resourceName or resourceIdentifier, apiVersion, functionValues)`
 
 The syntax for this function varies by name of the list operations. Each implementation returns values for the resource type that supports a list operation. The operation name must start with `list`. Some common usages are `listKeys` and `listSecrets`.
 
@@ -350,9 +346,7 @@ To get the SAS token, pass an object for the expiry time. The expiry time must b
 
 ## providers
 
-```json
-providers(providerNamespace, [resourceType])
-```
+`providers(providerNamespace, [resourceType])`
 
 Returns information about a resource provider and its supported resource types. If you don't provide a resource type, the function returns all the supported types for the resource provider.
 
@@ -427,9 +421,7 @@ For the **Microsoft.Web** resource provider and **sites** resource type, the pre
 
 ## reference
 
-```json
-reference(resourceName or resourceIdentifier, [apiVersion], ['Full'])
-```
+`reference(resourceName or resourceIdentifier, [apiVersion], ['Full'])`
 
 Returns an object representing a resource's runtime state.
 
@@ -665,9 +657,7 @@ The following [example template](https://github.com/Azure/azure-docs-json-sample
 
 ## resourceGroup
 
-```json
-resourceGroup()
-```
+`resourceGroup()`
 
 Returns an object that represents the current resource group.
 
@@ -745,9 +735,7 @@ The preceding example returns an object in the following format:
 
 ## resourceId
 
-```json
-resourceId([subscriptionId], [resourceGroupName], resourceType, resourceName1, [resourceName2], ...)
-```
+`resourceId([subscriptionId], [resourceGroupName], resourceType, resourceName1, [resourceName2], ...)`
 
 Returns the unique identifier of a resource. You use this function when the resource name is ambiguous or not provisioned within the same template. The format of the returned identifier varies based on whether the deployment happens at the scope of a resource group, subscription, management group, or tenant.
 
@@ -902,9 +890,7 @@ The output from the preceding example with the default values is:
 
 ## subscription
 
-```json
-subscription()
-```
+`subscription()`
 
 Returns details about the subscription for the current deployment.
 
@@ -945,9 +931,7 @@ The following [example template](https://github.com/Azure/azure-docs-json-sample
 
 ## subscriptionResourceId
 
-```json
-subscriptionResourceId([subscriptionId], resourceType, resourceName1, [resourceName2], ...)
-```
+`subscriptionResourceId([subscriptionId], resourceType, resourceName1, [resourceName2], ...)`
 
 Returns the unique identifier for a resource deployed at the subscription level.
 
@@ -1029,9 +1013,7 @@ The following template assigns a built-in role. You can deploy it to either a re
 
 ## tenantResourceId
 
-```json
-tenantResourceId(resourceType, resourceName1, [resourceName2], ...)
-```
+`tenantResourceId(resourceType, resourceName1, [resourceName2], ...)`
 
 Returns the unique identifier for a resource deployed at the tenant level.
 

articles/azure-resource-manager/templates/template-functions.md

@@ -13,7 +13,6 @@ To create your own functions, see [User-defined functions](template-syntax.md#fu
 Most functions work the same when deployed to a resource group, subscription, management group, or tenant. A few functions can't be used in all scopes. They're noted in the lists below.
 
 <a id="array" aria-hidden="true" />
-<a id="coalesce" aria-hidden="true" />
 <a id="concatarray" aria-hidden="true" />
 <a id="contains" aria-hidden="true" />
 <a id="createarray" aria-hidden="true" />
@@ -49,6 +48,7 @@ Resource Manager provides several functions for working with arrays.
 * [take](template-functions-array.md#take)
 * [union](template-functions-array.md#union)
 
+<a id="coalesce" aria-hidden="true" />
 <a id="equals" aria-hidden="true" />
 <a id="less" aria-hidden="true" />
 <a id="lessorequals" aria-hidden="true" />
@@ -59,6 +59,7 @@ Resource Manager provides several functions for working with arrays.
 
 Resource Manager provides several functions for making comparisons in your templates.
 
+* [coalesce](template-functions-comparison.md#coalesce)
 * [equals](template-functions-comparison.md#equals)
 * [less](template-functions-comparison.md#less)
 * [lessOrEquals](template-functions-comparison.md#lessorequals)