Merge pull request #2986 from abinav2307/miscellaneous-third-pass-validation

Miscellaneous third pass validation

Author: JamesJBarnett

articles/cosmos-db/mongodb/vcore/operators/miscellaneous/$getfield.md

@@ -1,13 +1,13 @@
 ---
   title: $getField
-  titleSuffix: Overview of the $getField operation in Azure Cosmos DB for MongoDB (vCore)
+  titleSuffix: Overview of the $getField operator in Azure Cosmos DB for MongoDB (vCore)
   description: The $getField operator allows retrieving the value of a specified field from a document.
   author: suvishodcitus
   ms.author: suvishod
   ms.service: azure-cosmos-db
   ms.subservice: mongodb-vcore
   ms.topic: reference
-  ms.date: 02/12/2025
+  ms.date: 09/04/2025
 ---
 
 # $getField
@@ -16,8 +16,6 @@ The `$getField` operator is used to retrieve the value of a specified field from
 
 ## Syntax
 
-The syntax for the `$getField` operator is as follows:
-
 ```javascript
 {
   $getField: {
@@ -48,50 +46,111 @@ Consider this sample document from the stores collection.
 
 ```json
 {
-  "_id": "2cf3f885-9962-4b67-a172-aa9039e9ae2f",
-  "name": "First Up Consultants | Bed and Bath Center - South Amir",
-  "location": {
-    "lat": 60.7954,
-    "lon": -142.0012
-  },
-  "staff": {
-    "totalStaff": {
-      "fullTime": 18,
-      "partTime": 17
-    }
-  },
-  "sales": {
-    "totalSales": 37701,
-    "salesByCategory": [
-      {
-        "categoryName": "Mattress Toppers",
-        "totalSales": 37701
-      }
-    ]
-  },
-  "promotionEvents": [
-    {
-      "eventName": "Price Drop Palooza",
-      "promotionalDates": {
-        "startDate": {
-          "Year": 2024,
-          "Month": 9,
-          "Day": 21
-        },
-        "endDate": {
-          "Year": 2024,
-          "Month": 9,
-          "Day": 30
+    "_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
+    "name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
+    "location": {
+        "lat": -89.2384,
+        "lon": -46.4012
+    },
+    "staff": {
+        "totalStaff": {
+            "fullTime": 8,
+            "partTime": 20
         }
-      },
-      "discounts": [
+    },
+    "sales": {
+        "totalSales": 75670,
+        "salesByCategory": [
+            {
+                "categoryName": "Wine Accessories",
+                "totalSales": 34440
+            },
+            {
+                "categoryName": "Bitters",
+                "totalSales": 39496
+            },
+            {
+                "categoryName": "Rum",
+                "totalSales": 1734
+            }
+        ]
+    },
+    "promotionEvents": [
         {
-          "categoryName": "Bath Accessories",
-          "discountPercentage": 18
+            "eventName": "Unbeatable Bargain Bash",
+            "promotionalDates": {
+                "startDate": {
+                    "Year": 2024,
+                    "Month": 6,
+                    "Day": 23
+                },
+                "endDate": {
+                    "Year": 2024,
+                    "Month": 7,
+                    "Day": 2
+                }
+            },
+            "discounts": [
+                {
+                    "categoryName": "Whiskey",
+                    "discountPercentage": 7
+                },
+                {
+                    "categoryName": "Bitters",
+                    "discountPercentage": 15
+                },
+                {
+                    "categoryName": "Brandy",
+                    "discountPercentage": 8
+                },
+                {
+                    "categoryName": "Sports Drinks",
+                    "discountPercentage": 22
+                },
+                {
+                    "categoryName": "Vodka",
+                    "discountPercentage": 19
+                }
+            ]
+        },
+        {
+            "eventName": "Steal of a Deal Days",
+            "promotionalDates": {
+                "startDate": {
+                    "Year": 2024,
+                    "Month": 9,
+                    "Day": 21
+                },
+                "endDate": {
+                    "Year": 2024,
+                    "Month": 9,
+                    "Day": 29
+                }
+            },
+            "discounts": [
+                {
+                    "categoryName": "Organic Wine",
+                    "discountPercentage": 19
+                },
+                {
+                    "categoryName": "White Wine",
+                    "discountPercentage": 20
+                },
+                {
+                    "categoryName": "Sparkling Wine",
+                    "discountPercentage": 19
+                },
+                {
+                    "categoryName": "Whiskey",
+                    "discountPercentage": 17
+                },
+                {
+                    "categoryName": "Vodka",
+                    "discountPercentage": 23
+                }
+            ]
         }
-      ]
-    }
-  ]
+    ]
 }
 ```
 
@@ -116,14 +175,16 @@ db.stores.aggregate([
 ])
 ```
 
-This command produces the following output:
+This query returns the following result.
 
 ```json
-{
-  "_id": "2cf3f885-9962-4b67-a172-aa9039e9ae2f",
-  "name": "First Up Consultants | Bed and Bath Center - South Amir",
-  "totalSalesValue": 37701
-}
+[
+  {
+    "_id": "2cf3f885-9962-4b67-a172-aa9039e9ae2f",
+    "name": "First Up Consultants | Bed and Bath Center - South Amir",
+    "totalSalesValue": 37701
+  }
+]
 ```
 
 ### Example 2: Shorthand syntax
@@ -142,17 +203,19 @@ db.stores.aggregate([
 ])
 ```
 
-This command produces the following output:
+This query returns the following result.
 
 ```json
-{
-  "_id": "2cf3f885-9962-4b67-a172-aa9039e9ae2f",
-  "storeName": "First Up Consultants | Bed and Bath Center - South Amir",
-  "storeLocation": {
-    "lat": 60.7954,
-    "lon": -142.0012
+[
+  {
+    "_id": "2cf3f885-9962-4b67-a172-aa9039e9ae2f",
+    "storeName": "First Up Consultants | Bed and Bath Center - South Amir",
+    "storeLocation": {
+      "lat": 60.7954,
+      "lon": -142.0012
+    }
   }
-}
+]
 ```
 
 ## Related content