Merge pull request #226880 from baanders/2-9-acro

ADT: Acrolinx

Author: prmerger-automator[bot]

articles/digital-twins/reference-query-functions.md

@@ -45,16 +45,16 @@ The following query returns the name of all digital twins who have an array prop
 ### Limitations
 
 The ARRAY_CONTAINS() function has the following limitations:
-* Array indexing is not supported. 
+* Array indexing isn't supported. 
     - For example, `array-name[index] = 'foo_bar'`
-* Subqueries within the ARRAY_CONTAINS() property are not supported. 
+* Subqueries within the ARRAY_CONTAINS() property aren't supported. 
     - For example, `SELECT T.name FROM DIGITALTWINS T WHERE ARRAY_CONTAINS (SELECT S.floor_number FROM DIGITALTWINS S, 4)`
-* ARRAY_CONTAINS() is not supported on properties of relationships. 
-    - For example, say `Floor.Contains` is a relationship from Floor to Room and it has a `lift` property with a value of `["operating", "under maintenance", "under construction"]`. Queries like this are not supported: `SELECT Room FROM DIGITALTWINS Floor JOIN Room RELATED Floor.Contains WHERE 	Floor.$dtId = 'Floor-35' AND ARRAY_CONTAINS(Floor.Contains.lift, "operating")`.
-* ARRAY_CONTAINS() does not search inside nested arrays. 
-    - For example, say a twin has a `tags` property with a value of `[1, [2,3], 3, 4]`. A search for `2` using the query `SELECT * FROM DIGITALTWINS WHERE ARRAY_CONTAINS(tags, 2)` will return `False`. A search for a value in the top level array, like `1` using the query `SELECT * FROM DIGITALTWINS WHERE ARRAY_CONTAINS(tags, 1)`, will return `True`.
-* ARRAY_CONTAINS() is not supported if the array contains objects.
-    - For example, say a twin has a `tags` property with a value of `[Room1, Room2]` where `Room1` and `Room2` are objects. Queries like this are not supported: `SELECT * FROM DIGITALTWINS WHERE ARRAY_CONTAINS(tags, Room2)`.
+* ARRAY_CONTAINS() isn't supported on properties of relationships. 
+    - For example, say `Floor.Contains` is a relationship from Floor to Room and it has a `lift` property with a value of `["operating", "under maintenance", "under construction"]`. Queries like this aren't supported: `SELECT Room FROM DIGITALTWINS Floor JOIN Room RELATED Floor.Contains WHERE 	Floor.$dtId = 'Floor-35' AND ARRAY_CONTAINS(Floor.Contains.lift, "operating")`.
+* ARRAY_CONTAINS() doesn't search inside nested arrays. 
+    - For example, say a twin has a `tags` property with a value of `[1, [2,3], 3, 4]`. A search for `2` using the query `SELECT * FROM DIGITALTWINS WHERE ARRAY_CONTAINS(tags, 2)` returns `False`. A search for a value in the top level array, like `1` using the query `SELECT * FROM DIGITALTWINS WHERE ARRAY_CONTAINS(tags, 1)`, returns `True`.
+* ARRAY_CONTAINS() isn't supported if the array contains objects.
+    - For example, say a twin has a `tags` property with a value of `[Room1, Room2]` where `Room1` and `Room2` are objects. Queries like this aren't supported: `SELECT * FROM DIGITALTWINS WHERE ARRAY_CONTAINS(tags, Room2)`.
 
 ## CONTAINS
 
@@ -104,17 +104,17 @@ The following query returns all digital twins whose IDs end in `-small`. The str
 
 ## IS_BOOL
 
-A type checking function for determining whether an property has a Boolean value.
+A type checking function for determining whether a property has a Boolean value.
 
-This function is often combined with other predicates if the program processing the query results requires a boolean value, and you want to filter out cases where the property is not a boolean.
+This function is often combined with other predicates if the program processing the query results requires a boolean value, and you want to filter out cases where the property isn't a boolean.
 
 ### Syntax
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsBoolSyntax":::
 
 ### Arguments
 
-`<property>`, an property to check whether it is a Boolean.
+`<property>`, a property to check whether it's a Boolean.
 
 ### Returns
 
@@ -126,7 +126,7 @@ The following query selects the digital twins that have a boolean `HasTemperatur
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsBoolExample":::
 
-The following query builds on the above example to select the digital twins that have a boolean `HasTemperature` property, and the value of that property is not `false`.
+The following query builds on the above example to select the digital twins that have a boolean `HasTemperature` property, and the value of that property isn't `false`.
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsBoolNotFalseExample":::
 
@@ -140,7 +140,7 @@ A type checking function to determine whether a property is defined.
 
 ### Arguments
 
-`<property>`, a property to determine whether it is defined.
+`<property>`, a property to determine whether it's defined.
 
 ### Returns
 
@@ -154,15 +154,15 @@ The following query returns all digital twins who have a defined `Location` prop
 
 ## IS_NULL
 
-A type checking function for determining whether an property's value is `null`.
+A type checking function for determining whether a property's value is `null`.
 
 ### Syntax
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsNullSyntax":::
 
 ### Arguments
 
-`<property>`, a property to check whether it is null.
+`<property>`, a property to check whether it's null.
 
 ### Returns
 
@@ -178,47 +178,47 @@ The following query returns twins who do not have a null value for Temperature.
 
 A type checking function for determining whether a property has a number value.
 
-This function is often combined with other predicates if the program processing the query results requires a number value, and you want to filter out cases where the property is not a number.
+This function is often combined with other predicates if the program processing the query results requires a number value, and you want to filter out cases where the property isn't a number.
 
 ### Syntax
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsNumberSyntax":::
 
 ### Arguments
 
-`<property>`, a property to check whether it is a number.
+`<property>`, a property to check whether it's a number.
 
 ### Returns
 
 A Boolean value indicating if the type of the specified property is a number.
 
 ### Example
 
-The following query selects the digital twins that have a numeric `Capacity` property and its value is not equal to 0.
+The following query selects the digital twins that have a numeric `Capacity` property and its value isn't equal to 0.
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsNumberExample":::
 
 ## IS_OBJECT
 
 A type checking function for determining whether a property's value is of a JSON object type.
 
-This function is often combined with other predicates if the program processing the query results requires a JSON object, and you want to filter out cases where the value is not a JSON object.
+This function is often combined with other predicates if the program processing the query results requires a JSON object, and you want to filter out cases where the value isn't a JSON object.
 
 ### Syntax
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsObjectSyntax":::
 
 ### Arguments
 
-`<property>`, a property to check whether it is of an object type.
+`<property>`, a property to check whether it's of an object type.
 
 ### Returns
 
 A Boolean value indicating if the type of the specified property is a JSON object.
 
 ### Example
 
-The following query selects all of the digital twins where this is an object called `MapObject`, and it does not have a child property `TemperatureReading`.
+The following query selects all of the digital twins where this is an object called `MapObject`, and it doesn't have a child property `TemperatureReading`.
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsObjectExample":::
 
@@ -236,8 +236,8 @@ Required:
 * `<model-ID>`: The model ID to check for.
 
 Optional:
-* `<twin-collection>`: Specify a twin collection to search when there is more than one (like when a `JOIN` is used).
-* `exact`: Require an exact match. If this parameter is not set, the result set will include twins with models that inherit from the specified model.
+* `<twin-collection>`: Specify a twin collection to search when there's more than one (like when a `JOIN` is used).
+* `exact`: Require an exact match. If this parameter isn't set, the result set includes twins with models that inherit from the specified model.
 
 ### Returns
 
@@ -253,15 +253,15 @@ The following query returns twins from the DT collection that are exactly of the
 
 A type checking function for determining whether a property's value is of a primitive type (string, Boolean, numeric, or `null`).
 
-This function is often combined with other predicates if the program processing the query results requires a primitive-typed value, and you want to filter out cases where the property is not primitive.
+This function is often combined with other predicates if the program processing the query results requires a primitive-typed value, and you want to filter out cases where the property isn't primitive.
 
 ### Syntax
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsPrimitiveSyntax":::
 
 ### Arguments
 
-`<property>`, a property to check whether it is of a primitive type.
+`<property>`, a property to check whether it's of a primitive type.
 
 ### Returns
 
@@ -277,23 +277,23 @@ The following query returns the `area` property of the Factory with the ID of 'A
 
 A type checking function for determining whether a property has a string value. 
 
-This function is often combined with other predicates if the program processing the query results requires a string value, and you want to filter out cases where the property is not a string.
+This function is often combined with other predicates if the program processing the query results requires a string value, and you want to filter out cases where the property isn't a string.
 
 ### Syntax
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsStringSyntax":::
 
 ### Arguments
 
-`<property>`, a property to check whether it is a string.
+`<property>`, a property to check whether it's a string.
 
 ### Returns
 
 A Boolean value indicating if the type of the specified expression is a string.
 
 ### Example
 
-The following query selects the digital twins that have a string property `Status` property and its value is not equal to `Completed`.
+The following query selects the digital twins that have a string property `Status` property and its value isn't equal to `Completed`.
 
 :::code language="sql" source="~/digital-twins-docs-samples/queries/reference.sql" ID="IsStringExample":::