Merge pull request #194247 from mumian/0406-items

move items() to the Bicep object function file

Author: tamarakhader

articles/azure-resource-manager/bicep/bicep-functions-array.md

@@ -4,7 +4,7 @@ description: Describes the functions to use in a Bicep file for working with arr
 author: mumian
 ms.topic: conceptual
 ms.author: jgao
-ms.date: 12/08/2021
+ms.date: 04/06/2022
 
 ---
 # Array functions for Bicep
@@ -328,120 +328,6 @@ The output from the preceding example is:
 | commonUp | array | [1, 2, 3] |
 | commonDown | array | [3, 2, 1] |
 
-## items
-
-`items(object)`
-
-Converts a dictionary object to an array.
-
-Namespace: [sys](bicep-functions.md#namespaces-for-functions).
-
-### Parameters
-
-| Parameter | Required | Type | Description |
-|:--- |:--- |:--- |:--- |
-| object |Yes |object |The dictionary object to convert to an array. |
-
-### Return value
-
-An array of objects for the converted dictionary. Each object in the array has a `key` property that contains the key value for the dictionary. Each object also has a `value` property that contains the properties for the object.
-
-### Example
-
-The following example converts a dictionary object to an array. For each object in the array, it creates a new object with modified values.
-
-```bicep
-var entities = {
-  item002: {
-    enabled: false
-    displayName: 'Example item 2'
-    number: 200
-  }
-  item001: {
-    enabled: true
-    displayName: 'Example item 1'
-    number: 300
-  }
-}
-
-var modifiedListOfEntities = [for entity in items(entities): {
-  key: entity.key
-  fullName: entity.value.displayName
-  itemEnabled: entity.value.enabled
-}]
-
-output modifiedResult array = modifiedListOfEntities
-```
-
-The preceding example returns:
-
-```json
-"modifiedResult": {
-  "type": "Array",
-  "value": [
-    {
-      "fullName": "Example item 1",
-      "itemEnabled": true,
-      "key": "item001"
-    },
-    {
-      "fullName": "Example item 2",
-      "itemEnabled": false,
-      "key": "item002"
-    }
-  ]
-}
-```
-
-The following example shows the array that is returned from the items function.
-
-```bicep
-var entities = {
-  item002: {
-    enabled: false
-    displayName: 'Example item 2'
-    number: 200
-  }
-  item001: {
-    enabled: true
-    displayName: 'Example item 1'
-    number: 300
-  }
-}
-
-var entitiesArray = items(entities)
-
-output itemsResult array = entitiesArray
-```
-
-The example returns:
-
-```json
-"itemsResult": {
-  "type": "Array",
-  "value": [
-    {
-      "key": "item001",
-      "value": {
-        "displayName": "Example item 1",
-        "enabled": true,
-        "number": 300
-      }
-    },
-    {
-      "key": "item002",
-      "value": {
-        "displayName": "Example item 2",
-        "enabled": false,
-        "number": 200
-      }
-    }
-  ]
-}
-```
-
-The items() function sorts the objects in the alphabetical order. For example, **item001** appears before **item002** in the outputs of the two preceding samples.
-
 ## last
 
 `last(arg1)`

articles/azure-resource-manager/bicep/bicep-functions-object.md

@@ -4,7 +4,7 @@ description: Describes the functions to use in a Bicep file for working with obj
 author: mumian
 ms.author: jgao
 ms.topic: conceptual
-ms.date: 09/30/2021
+ms.date: 04/06/2022
 ---
 
 # Object functions for Bicep
@@ -162,6 +162,120 @@ The output from the preceding example with the default values is:
 | objectOutput | Object | {"one": "a", "three": "c"} |
 | arrayOutput | Array | ["two", "three"] |
 
+## items
+
+`items(object)`
+
+Converts a dictionary object to an array.
+
+Namespace: [sys](bicep-functions.md#namespaces-for-functions).
+
+### Parameters
+
+| Parameter | Required | Type | Description |
+|:--- |:--- |:--- |:--- |
+| object |Yes |object |The dictionary object to convert to an array. |
+
+### Return value
+
+An array of objects for the converted dictionary. Each object in the array has a `key` property that contains the key value for the dictionary. Each object also has a `value` property that contains the properties for the object.
+
+### Example
+
+The following example converts a dictionary object to an array. For each object in the array, it creates a new object with modified values.
+
+```bicep
+var entities = {
+  item002: {
+    enabled: false
+    displayName: 'Example item 2'
+    number: 200
+  }
+  item001: {
+    enabled: true
+    displayName: 'Example item 1'
+    number: 300
+  }
+}
+
+var modifiedListOfEntities = [for entity in items(entities): {
+  key: entity.key
+  fullName: entity.value.displayName
+  itemEnabled: entity.value.enabled
+}]
+
+output modifiedResult array = modifiedListOfEntities
+```
+
+The preceding example returns:
+
+```json
+"modifiedResult": {
+  "type": "Array",
+  "value": [
+    {
+      "fullName": "Example item 1",
+      "itemEnabled": true,
+      "key": "item001"
+    },
+    {
+      "fullName": "Example item 2",
+      "itemEnabled": false,
+      "key": "item002"
+    }
+  ]
+}
+```
+
+The following example shows the array that is returned from the items function.
+
+```bicep
+var entities = {
+  item002: {
+    enabled: false
+    displayName: 'Example item 2'
+    number: 200
+  }
+  item001: {
+    enabled: true
+    displayName: 'Example item 1'
+    number: 300
+  }
+}
+
+var entitiesArray = items(entities)
+
+output itemsResult array = entitiesArray
+```
+
+The example returns:
+
+```json
+"itemsResult": {
+  "type": "Array",
+  "value": [
+    {
+      "key": "item001",
+      "value": {
+        "displayName": "Example item 1",
+        "enabled": true,
+        "number": 300
+      }
+    },
+    {
+      "key": "item002",
+      "value": {
+        "displayName": "Example item 2",
+        "enabled": false,
+        "number": 200
+      }
+    }
+  ]
+}
+```
+
+The items() function sorts the objects in the alphabetical order. For example, **item001** appears before **item002** in the outputs of the two preceding samples.
+
 <a id="json"></a>
 
 ## json

articles/azure-resource-manager/bicep/bicep-functions.md

@@ -2,7 +2,7 @@
 title: Bicep functions
 description: Describes the functions to use in a Bicep file to retrieve values, work with strings and numerics, and retrieve deployment information.
 ms.topic: conceptual
-ms.date: 10/15/2021
+ms.date: 04/06/2022
 ---
 
 # Bicep functions
@@ -19,7 +19,7 @@ All Bicep functions are contained within two namespaces - `az` and `sys`. Typica
 // Parameter contains the same name as a function
 param range int
 
-// Must use sys namespace to call the function. 
+// Must use sys namespace to call the function.
 // The second use of range refers to the parameter.
 output result array = sys.range(1, range)
 ```
@@ -40,7 +40,6 @@ The following functions are available for working with arrays. All of these func
 * [empty](./bicep-functions-array.md#empty)
 * [first](./bicep-functions-array.md#first)
 * [intersection](./bicep-functions-array.md#intersection)
-* [items](./bicep-functions-array.md#items)
 * [last](./bicep-functions-array.md#last)
 * [length](./bicep-functions-array.md#length)
 * [min](./bicep-functions-array.md#min)
@@ -92,6 +91,7 @@ The following functions are available for working with objects. All of these fun
 * [contains](./bicep-functions-object.md#contains)
 * [empty](./bicep-functions-object.md#empty)
 * [intersection](./bicep-functions-object.md#intersection)
+* [items](./bicep-functions-object.md#items)
 * [json](./bicep-functions-object.md#json)
 * [length](./bicep-functions-object.md#length)
 * [union](./bicep-functions-object.md#union)

articles/azure-resource-manager/bicep/loops.md

@@ -33,7 +33,7 @@ Loops can be declared by:
   }]
   ```
 
-- Using **items in a dictionary object**. This option works when your scenario is: "I want to create an instance for each item in an object." The [items function](bicep-functions-array.md#items) converts the object to an array. Within the loop, you can use properties from the object to create values. For more information, see [Dictionary object](#dictionary-object).
+- Using **items in a dictionary object**. This option works when your scenario is: "I want to create an instance for each item in an object." The [items function](bicep-functions-object.md#items) converts the object to an array. Within the loop, you can use properties from the object to create values. For more information, see [Dictionary object](#dictionary-object).
 
   ```bicep
   [for <item> in items(<object>): {
@@ -208,7 +208,7 @@ output deployedNSGs array = [for (name, i) in orgNames: {
 
 ## Dictionary object
 
-To iterate over elements in a dictionary object, use the [items function](bicep-functions-array.md#items), which converts the object to an array. Use the `value` property to get properties on the objects.
+To iterate over elements in a dictionary object, use the [items function](bicep-functions-object.md#items), which converts the object to an array. Use the `value` property to get properties on the objects.
 
 ```bicep
 param nsgValues object = {

articles/azure-resource-manager/bicep/quickstart-loops.md

@@ -124,7 +124,7 @@ After deploying the preceding sample, you create two storage accounts that are s
 
 ## Use dictionary object
 
-To iterate over elements in a dictionary object, use the [items function](./bicep-functions-array.md#items), which converts the object to an array. Use the `value` property to get properties on the objects.
+To iterate over elements in a dictionary object, use the [items function](./bicep-functions-object.md#items), which converts the object to an array. Use the `value` property to get properties on the objects.
 
 :::code language="bicep" source="~/azure-docs-bicep-samples/samples/loops-quickstart/loopObject.bicep" highlight="3-12,14,15,18":::