Add new GQLSTATUS codes 22NAA and 22NAB (#349)

Lojjs · renetapopova · web-flow · commit 1bde8026e780 · 2025-07-09T10:22:46.000+01:00
Introduced in neo-technology/neo4j#31849 --------- Co-authored-by: Reneta Popova <reneta.popova@neo4j.com>
diff --git a/modules/ROOT/content-nav.adoc b/modules/ROOT/content-nav.adoc
@@ -141,6 +141,8 @@
 **** xref:errors/gql-errors/22NA7.adoc[]
 **** xref:errors/gql-errors/22NA8.adoc[]
 **** xref:errors/gql-errors/22NA9.adoc[]
+**** xref:errors/gql-errors/22NAA.adoc[]
+**** xref:errors/gql-errors/22NAB.adoc[]
 **** xref:errors/gql-errors/22NB0.adoc[]
 **** xref:errors/gql-errors/22NB1.adoc[]
 **** xref:errors/gql-errors/22NB2.adoc[]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NA0.adoc b/modules/ROOT/pages/errors/gql-errors/22NA0.adoc
@@ -1,7 +1,7 @@
 = 22NA0
 
 == Status description
-error: data exception - invalid property based access control rule. Failed to administer property rule.
+error: data exception - invalid property-based access control rule. Failed to administer property rule.
 
 ifndef::backend-pdf[]
 [discrete.glossary]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NA1.adoc b/modules/ROOT/pages/errors/gql-errors/22NA1.adoc
@@ -2,7 +2,7 @@
 
 
 == Status description
-error: data exception - invalid property based access control rule involving non-commutative expressions. The property `{ <<propKey>> }` must appear on the left hand side of the `{ <<operation>> }` operator.
+error: data exception - invalid property-based access control rule involving non-commutative expressions. The property `{ <<propKey>> }` must appear on the left hand side of the `{ <<operation>> }` operator.
 
 
 ifndef::backend-pdf[]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NA2.adoc b/modules/ROOT/pages/errors/gql-errors/22NA2.adoc
@@ -2,7 +2,7 @@
 
 
 == Status description
-error: data exception - invalid property based access control rule involving multiple properties. The expression: `{ <<expr>> }` is not supported. Property rules can only contain one property.
+error: data exception - invalid property-based access control rule involving multiple properties. The expression: `{ <<expr>> }` is not supported. Property rules can only contain one property.
 
 
 ifndef::backend-pdf[]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NA3.adoc b/modules/ROOT/pages/errors/gql-errors/22NA3.adoc
@@ -2,7 +2,7 @@
 
 == Status description
 
-error: data exception - invalid property based access control rule involving NaN. 'NaN' is not supported for property-based access control.
+error: data exception - invalid property-based access control rule involving NaN. 'NaN' is not supported for property-based access control.
 
 
 
diff --git a/modules/ROOT/pages/errors/gql-errors/22NA4.adoc b/modules/ROOT/pages/errors/gql-errors/22NA4.adoc
@@ -1,7 +1,7 @@
 = 22NA4
 
 == Status description
-error: data exception - invalid property based access control rule involving comparison with `NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`.
+error: data exception - invalid property-based access control rule involving comparison with `NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`.
 
 ifndef::backend-pdf[]
 [discrete.glossary]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NA5.adoc b/modules/ROOT/pages/errors/gql-errors/22NA5.adoc
@@ -1,7 +1,7 @@
 = 22NA5
 
 == Status description
-error: data exception - invalid property based access control rule involving `IS NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `IS NULL` instead.
+error: data exception - invalid property-based access control rule involving `IS NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `IS NULL` instead.
 
 ifndef::backend-pdf[]
 [discrete.glossary]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NA6.adoc b/modules/ROOT/pages/errors/gql-errors/22NA6.adoc
@@ -1,7 +1,7 @@
 = 22NA6
 
 == Status description
-error: data exception - invalid property based access control rule involving `IS NOT NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `IS NOT NULL` instead.
+error: data exception - invalid property-based access control rule involving `IS NOT NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `IS NOT NULL` instead.
 
 ifndef::backend-pdf[]
 [discrete.glossary]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NA7.adoc b/modules/ROOT/pages/errors/gql-errors/22NA7.adoc
@@ -2,7 +2,7 @@
 
 
 == Status description
-error: data exception - invalid property based access control rule involving nontrivial predicates. The expression: `{ <<expr>> }` is not supported. Only single, literal-based predicate expressions are allowed for property-based access control.
+error: data exception - invalid property-based access control rule involving nontrivial predicates. The expression: `{ <<expr>> }` is not supported. Only single, literal-based predicate expressions are allowed for property-based access control.
 
 
 
diff --git a/modules/ROOT/pages/errors/gql-errors/22NAA.adoc b/modules/ROOT/pages/errors/gql-errors/22NAA.adoc
@@ -0,0 +1,28 @@
+= 22NAA
+
+== Status description
+error: data exception - invalid list for property-based access control rule. The expression `{ <<expr>> }` is not supported. Lists containing `{ <<exprType>> }` values are not supported for property-based access control.
+
+== Example scenario
+
+For example, try to add a property-based access control rule including a list with a `NULL` type:
+
+[source,cypher]
+----
+GRANT TRAVERSE ON GRAPH * FOR (n) WHERE n.prop1 IN ["string value", NULL] TO role
+----
+
+You will receive an error with GQLSTATUS xref:errors/gql-errors/22NA0.adoc[22NA0]  and a cause with GQLSTATUS 22NAA and the following status description:
+
+
+[source]
+----
+error: data exception - invalid list for property-based access control rule. The expression 'n.prop1 IN ["string value", NULL]' is not supported. Lists containing NULL values are not supported for property-based access control.
+----
+
+ifndef::backend-pdf[]
+[discrete.glossary]
+== Glossary
+
+include::partial$glossary.adoc[]
+endif::[]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NAB.adoc b/modules/ROOT/pages/errors/gql-errors/22NAB.adoc
@@ -0,0 +1,28 @@
+= 22NAB
+
+== Status description
+error: data exception - mixed type list for property-based access control rule. The expression `{ <<expr>> }` is not supported. All elements in a list must be literals of the same type for property-based access control.
+
+== Example scenario
+
+For example, try to add a property-based access control rule that contains a list of mixed types:
+
+[source,cypher]
+----
+GRANT TRAVERSE ON GRAPH * FOR (n) WHERE n.prop1 IN ["string value", 5] TO role
+----
+
+You will receive an error with GQLSTATUS xref:errors/gql-errors/22NA0.adoc[22NA0] and a cause with GQLSTATUS 22NAB and the following status description:
+
+
+[source]
+----
+error: data exception - mixed type list for property-based access control rule. The expression 'n.prop1 IN ["string value", 5]' is not supported. All elements in a list must be literals of the same type for property-based access control.
+----
+
+ifndef::backend-pdf[]
+[discrete.glossary]
+== Glossary
+
+include::partial$glossary.adoc[]
+endif::[]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NB0.adoc b/modules/ROOT/pages/errors/gql-errors/22NB0.adoc
@@ -1,7 +1,7 @@
 = 22NB0
 
 == Status description
-error: data exception - invalid property based access control rule involving `WHERE` and `IS NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `WHERE` syntax in combination with `IS NULL` instead.
+error: data exception - invalid property-based access control rule involving `WHERE` and `IS NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `WHERE` syntax in combination with `IS NULL` instead.
 
 ifndef::backend-pdf[]
 [discrete.glossary]
diff --git a/modules/ROOT/pages/errors/gql-errors/index.adoc b/modules/ROOT/pages/errors/gql-errors/index.adoc
@@ -533,35 +533,35 @@ Status description:: error: data exception - wrong token during deserialization.
 
 === xref:errors/gql-errors/22NA0.adoc[22NA0]
 
-Status description:: error: data exception - invalid property based access control rule. Failed to administer property rule.
+Status description:: error: data exception - invalid property-based access control rule. Failed to administer property rule.
 
 === xref:errors/gql-errors/22NA1.adoc[22NA1]
 
-Status description:: error: data exception - invalid property based access control rule involving non-commutative expressions. The property `{ <<propKey>> }` must appear on the left hand side of the `{ <<operation>> }` operator.
+Status description:: error: data exception - invalid property-based access control rule involving non-commutative expressions. The property `{ <<propKey>> }` must appear on the left hand side of the `{ <<operation>> }` operator.
 
 === xref:errors/gql-errors/22NA2.adoc[22NA2]
 
-Status description:: error: data exception - invalid property based access control rule involving multiple properties. The expression: `{ <<expr>> }` is not supported. Property rules can only contain one property.
+Status description:: error: data exception - invalid property-based access control rule involving multiple properties. The expression: `{ <<expr>> }` is not supported. Property rules can only contain one property.
 
 === xref:errors/gql-errors/22NA3.adoc[22NA3]
 
-Status description:: error: data exception - invalid property based access control rule involving NaN. 'NaN' is not supported for property-based access control.
+Status description:: error: data exception - invalid property-based access control rule involving NaN. 'NaN' is not supported for property-based access control.
 
 === xref:errors/gql-errors/22NA4.adoc[22NA4]
 
-Status description:: error: data exception - invalid property based access control rule involving comparison with `NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`.
+Status description:: error: data exception - invalid property-based access control rule involving comparison with `NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`.
 
 === xref:errors/gql-errors/22NA5.adoc[22NA5]
 
-Status description:: error: data exception - invalid property based access control rule involving `IS NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `IS NULL` instead.
+Status description:: error: data exception - invalid property-based access control rule involving `IS NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `IS NULL` instead.
 
 === xref:errors/gql-errors/22NA6.adoc[22NA6]
 
-Status description:: error: data exception - invalid property based access control rule involving `IS NOT NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `IS NOT NULL` instead.
+Status description:: error: data exception - invalid property-based access control rule involving `IS NOT NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `IS NOT NULL` instead.
 
 === xref:errors/gql-errors/22NA7.adoc[22NA7]
 
-Status description:: error: data exception - invalid property based access control rule involving nontrivial predicates. The expression: `{ <<expr>> }` is not supported. Only single, literal-based predicate expressions are allowed for property-based access control.
+Status description:: error: data exception - invalid property-based access control rule involving nontrivial predicates. The expression: `{ <<expr>> }` is not supported. Only single, literal-based predicate expressions are allowed for property-based access control.
 
 === xref:errors/gql-errors/22NA8.adoc[22NA8]
 
@@ -571,9 +571,17 @@ Status description:: error: data exception - parsing JSON failure. Underlying er
 
 Status description:: error: data exception - unexpected map entry. Invalid input. Unexpected key `{ <<mapKey>> }`, expected keys are `{ <<mapKeyList>> }`.
 
+=== xref:errors/gql-errors/22NAA.adoc[22NAA]
+
+Status description:: error: data exception - invalid list for property-based access control rule. The expression `{ <<expr>> }` is not supported. Lists containing `{ <<exprType>> }` values are not supported for property-based access control.
+
+=== xref:errors/gql-errors/22NAB.adoc[22NAB]
+
+Status description:: error: data exception - mixed type list for property-based access control rule. The expression `{ <<expr>> }` is not supported. All elements in a list must be literals of the same type for property-based access control.
+
 === xref:errors/gql-errors/22NB0.adoc[22NB0]
 
-Status description:: error: data exception - invalid property based access control rule involving `WHERE` and `IS NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `WHERE` syntax in combination with `IS NULL` instead.
+Status description:: error: data exception - invalid property-based access control rule involving `WHERE` and `IS NULL`. The property value access rule pattern `{ <<pred>> }` always evaluates to `NULL`. Use `WHERE` syntax in combination with `IS NULL` instead.
 
 === xref:errors/gql-errors/22NB1.adoc[22NB1]
 

Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@`
`2`	`2`
`3`	`3`	`== Status description`
`4`	`4`
`5`		`-error: data exception - invalid property based access control rule involving NaN. 'NaN' is not supported for property-based access control.`
	`5`	`+error: data exception - invalid property-based access control rule involving NaN. 'NaN' is not supported for property-based access control.`
`6`	`6`
`7`	`7`
`8`	`8`
Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@`
`2`	`2`
`3`	`3`
`4`	`4`	`== Status description`
`5`		-error: data exception - invalid property based access control rule involving nontrivial predicates. The expression: `{ <<expr>> }` is not supported. Only single, literal-based predicate expressions are allowed for property-based access control.
	`5`	+error: data exception - invalid property-based access control rule involving nontrivial predicates. The expression: `{ <<expr>> }` is not supported. Only single, literal-based predicate expressions are allowed for property-based access control.
`6`	`6`
`7`	`7`
`8`	`8`