From 8e2786a656f4b16868efe562f26acbd13cde1fa7 Mon Sep 17 00:00:00 2001
From: David Glick <david@glicksoftware.com>
Date: Thu, 21 Sep 2023 13:44:51 -0700
Subject: [PATCH] Support getting /@querystring vocabs in context (#1704)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Support getting /@querystring vocabs in context

* changelog

* Add test, update docs

* Update docs/source/endpoints/querystring.md

Co-authored-by: Steve Piercy <web@stevepiercy.com>

---------

Co-authored-by: Víctor Fernández de Alba <sneridagh@gmail.com>
Co-authored-by: Steve Piercy <web@stevepiercy.com>
Co-authored-by: Timo Stollenwerk <tisto@users.noreply.github.com>
---
 docs/source/endpoints/querystring.md          |   30 +-
 news/1704.feature                             |    1 +
 .../services/querystring/configure.zcml       |    9 +
 src/plone/restapi/services/querystring/get.py |    2 +-
 .../querystring_get_contextual.req            |    3 +
 .../querystring_get_contextual.resp           | 1735 +++++++++++++++++
 src/plone/restapi/tests/test_documentation.py |    5 +
 7 files changed, 1767 insertions(+), 18 deletions(-)
 create mode 100644 news/1704.feature
 create mode 100644 src/plone/restapi/tests/http-examples/querystring_get_contextual.req
 create mode 100644 src/plone/restapi/tests/http-examples/querystring_get_contextual.resp

diff --git a/docs/source/endpoints/querystring.md b/docs/source/endpoints/querystring.md
index 03c6e6ef38..b376fa0625 100644
--- a/docs/source/endpoints/querystring.md
+++ b/docs/source/endpoints/querystring.md
@@ -1,40 +1,36 @@
 ---
 myst:
   html_meta:
-    "description": "The @querystring endpoint returns the querystring configuration of plone.app.querystring."
-    "property=og:description": "The @querystring endpoint returns the querystring configuration of plone.app.querystring."
+    "description": "The @querystring endpoint returns metadata about available query operations."
+    "property=og:description": "The @querystring endpoint returns metadata about available query operations."
     "property=og:title": "Querystring"
     "keywords": "Plone, plone.restapi, REST, API, Querystring"
 ---
 
 # Querystring
 
-The `@querystring` endpoint returns the `querystring` configuration of `plone.app.querystring`.
+The `@querystring` endpoint returns metadata about the query operations that can be performed using the [`@querystringsearch`](querystringsearch) endpoint.
 
-Instead of simply exposing the `querystring` related `field` and `operation` entries from the registry, it serializes them in the same way that `p.a.querystring` does in its `@@querybuilderjsonconfig` view.
+The results include all of the indexes that can be queried, along with metadata about each index.
+The top-level `indexes` property includes all indexes, and the top-level `sortable_indexes` property includes only the indexes that can be used to sort.
 
-This form is structured in a more convenient way for frontends to process:
+Each index result includes a list of the query operations that can be performed on that index.
+The `operations` property contains the list of operations as dotted names.
+The `operators` property contains additional metadata about each operation.
 
-- *Vocabularies* will be resolved.
-  Their values will be inlined in the `values` property.
-- *Operations* will be inlined as well.
-  The `operations` property will contain the list of operations as dotted names.
-  The `operators` property will contain the full definition of each of those operations supported by that field.
-- Indexes that are flagged as *sortable* are listed in a dedicated top-level property `sortable_indexes`.
+If an index uses a vocabulary, the vocabulary values are included in the `values` property.
+The vocabulary is resolved in the same context where the `/@querystring` endpoint is called (requires `plone.app.querystring >= 2.1.0`).
 
-Available options for the querystring in a Plone site can be queried by interacting with the `/@querystring` endpoint on the portal root:
+## Get `querystring` configuration
 
-
-## Querystring Config
-
-To retrieve all `querystring` options in the portal, call the `/@querystring` endpoint with a `GET` request:
+To get the metadata about all query operations available in the portal, call the `/@querystring` endpoint with a `GET` request:
 
 ```{eval-rst}
 ..  http:example:: curl httpie python-requests
     :request: ../../../src/plone/restapi/tests/http-examples/querystring_get.req
 ```
 
-The server will respond with all `querystring` options in the portal:
+The server will respond with the metadata:
 
 ```{literalinclude} ../../../src/plone/restapi/tests/http-examples/querystring_get.resp
 :language: http
diff --git a/news/1704.feature b/news/1704.feature
new file mode 100644
index 0000000000..e6f9ca41cd
--- /dev/null
+++ b/news/1704.feature
@@ -0,0 +1 @@
+Add support for getting the `/@querystring` endpoint in a specific context. @davisagli
diff --git a/src/plone/restapi/services/querystring/configure.zcml b/src/plone/restapi/services/querystring/configure.zcml
index 0cc223e650..f7e6f38343 100644
--- a/src/plone/restapi/services/querystring/configure.zcml
+++ b/src/plone/restapi/services/querystring/configure.zcml
@@ -12,6 +12,15 @@
       permission="zope2.View"
       name="@querystring"
       />
+
+  <plone:service
+      method="GET"
+      factory=".get.QuerystringGet"
+      for="Products.CMFCore.interfaces.IContentish"
+      permission="zope2.View"
+      name="@querystring"
+      />
+
   <cache:ruleset
       for=".get.QuerystringGet"
       ruleset="plone.content.dynamic"
diff --git a/src/plone/restapi/services/querystring/get.py b/src/plone/restapi/services/querystring/get.py
index b0387e5a83..359bf8625c 100644
--- a/src/plone/restapi/services/querystring/get.py
+++ b/src/plone/restapi/services/querystring/get.py
@@ -15,7 +15,7 @@ class QuerystringGet(Service):
     def reply(self):
         registry = getUtility(IRegistry)
         reader = getMultiAdapter((registry, self.request), IQuerystringRegistryReader)
-
+        reader.vocab_context = self.context
         result = reader()
         result["@id"] = "%s/@querystring" % self.context.absolute_url()
         return result
diff --git a/src/plone/restapi/tests/http-examples/querystring_get_contextual.req b/src/plone/restapi/tests/http-examples/querystring_get_contextual.req
new file mode 100644
index 0000000000..39a9f41b64
--- /dev/null
+++ b/src/plone/restapi/tests/http-examples/querystring_get_contextual.req
@@ -0,0 +1,3 @@
+GET /plone/front-page/@querystring HTTP/1.1
+Accept: application/json
+Authorization: Basic YWRtaW46c2VjcmV0
diff --git a/src/plone/restapi/tests/http-examples/querystring_get_contextual.resp b/src/plone/restapi/tests/http-examples/querystring_get_contextual.resp
new file mode 100644
index 0000000000..07d805325b
--- /dev/null
+++ b/src/plone/restapi/tests/http-examples/querystring_get_contextual.resp
@@ -0,0 +1,1735 @@
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+    "@id": "http://localhost:55001/plone/front-page/@querystring",
+    "indexes": {
+        "Creator": {
+            "description": "The person that created an item",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.string.currentUser",
+                "plone.app.querystring.operation.selection.any",
+                "plone.app.querystring.operation.selection.none"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.selection.any": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Matches any of",
+                    "widget": "MultipleSelectionWidget"
+                },
+                "plone.app.querystring.operation.selection.none": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Matches none of",
+                    "widget": "MultipleSelectionWidget"
+                },
+                "plone.app.querystring.operation.string.currentUser": {
+                    "description": "The user viewing the querystring results",
+                    "operation": "plone.app.querystring.queryparser._currentUser",
+                    "title": "Current logged in user",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Creator",
+            "values": {},
+            "vocabulary": "plone.app.vocabularies.Users"
+        },
+        "Description": {
+            "description": "An item's description",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Text",
+            "operations": [
+                "plone.app.querystring.operation.string.contains"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.string.contains": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Contains",
+                    "widget": "StringWidget"
+                }
+            },
+            "sortable": false,
+            "title": "Description",
+            "values": {},
+            "vocabulary": null
+        },
+        "SearchableText": {
+            "description": "Text search of an item's contents",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Text",
+            "operations": [
+                "plone.app.querystring.operation.string.contains"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.string.contains": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Contains",
+                    "widget": "StringWidget"
+                }
+            },
+            "sortable": false,
+            "title": "Searchable text",
+            "values": {},
+            "vocabulary": null
+        },
+        "Subject": {
+            "description": "Tags are used for organization of content",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Text",
+            "operations": [
+                "plone.app.querystring.operation.selection.any",
+                "plone.app.querystring.operation.selection.all",
+                "plone.app.querystring.operation.selection.none"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.selection.all": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._all",
+                    "title": "Matches all of",
+                    "widget": "MultipleSelectionWidget"
+                },
+                "plone.app.querystring.operation.selection.any": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Matches any of",
+                    "widget": "MultipleSelectionWidget"
+                },
+                "plone.app.querystring.operation.selection.none": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Matches none of",
+                    "widget": "MultipleSelectionWidget"
+                }
+            },
+            "sortable": false,
+            "title": "Tag",
+            "values": {},
+            "vocabulary": "plone.app.vocabularies.Keywords"
+        },
+        "Title": {
+            "description": "Text search of an item's title",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Text",
+            "operations": [
+                "plone.app.querystring.operation.string.contains"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.string.contains": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Contains",
+                    "widget": "StringWidget"
+                }
+            },
+            "sortable": false,
+            "title": "Title",
+            "values": {},
+            "vocabulary": null
+        },
+        "created": {
+            "description": "The date an item was created",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Creation date",
+            "values": {},
+            "vocabulary": null
+        },
+        "effective": {
+            "description": "The time and date an item was first published",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Effective date",
+            "values": {},
+            "vocabulary": null
+        },
+        "effectiveRange": {
+            "description": "Querying this is undefined",
+            "enabled": false,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [],
+            "operators": {},
+            "sortable": false,
+            "title": "Effective range",
+            "values": {},
+            "vocabulary": null
+        },
+        "end": {
+            "description": "The end date and time of an event",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Event end date",
+            "values": {},
+            "vocabulary": null
+        },
+        "expires": {
+            "description": "The time and date an item was expired",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Expiration date",
+            "values": {},
+            "vocabulary": null
+        },
+        "getId": {
+            "description": "The short name of an item (used in the url)",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.string.is",
+                "plone.app.querystring.operation.string.isNot"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.string.is": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._equal",
+                    "title": "Is",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.string.isNot": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Is not",
+                    "widget": "StringWidget"
+                }
+            },
+            "sortable": true,
+            "title": "Short name (id)",
+            "values": {},
+            "vocabulary": null
+        },
+        "getObjPositionInParent": {
+            "description": "The order of an item in its parent folder",
+            "enabled": false,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.int.is",
+                "plone.app.querystring.operation.int.lessThan",
+                "plone.app.querystring.operation.int.largerThan"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.int.is": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._intEqual",
+                    "title": "Equals",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.int.largerThan": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._intLargerThan",
+                    "title": "Larger than",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.int.lessThan": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._intLessThan",
+                    "title": "Less than",
+                    "widget": "StringWidget"
+                }
+            },
+            "sortable": true,
+            "title": "Order in folder",
+            "values": {},
+            "vocabulary": null
+        },
+        "getRawRelatedItems": {
+            "description": "Find items related to the selected items",
+            "enabled": false,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.reference.is"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.reference.is": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._referenceIs",
+                    "title": "Equals",
+                    "widget": "ReferenceWidget"
+                }
+            },
+            "sortable": false,
+            "title": "Related To",
+            "values": {},
+            "vocabulary": null
+        },
+        "isDefaultPage": {
+            "description": "Find items that are the default view for their containing folder.",
+            "enabled": false,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.boolean.isTrue",
+                "plone.app.querystring.operation.boolean.isFalse"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.boolean.isFalse": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._isFalse",
+                    "title": "No",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.boolean.isTrue": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._isTrue",
+                    "title": "Yes",
+                    "widget": null
+                }
+            },
+            "sortable": false,
+            "title": "Default Page",
+            "values": {},
+            "vocabulary": null
+        },
+        "isFolderish": {
+            "description": "Find items that can contain other objects",
+            "enabled": false,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.boolean.isTrue",
+                "plone.app.querystring.operation.boolean.isFalse"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.boolean.isFalse": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._isFalse",
+                    "title": "No",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.boolean.isTrue": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._isTrue",
+                    "title": "Yes",
+                    "widget": null
+                }
+            },
+            "sortable": false,
+            "title": "Folder-like",
+            "values": {},
+            "vocabulary": null
+        },
+        "modified": {
+            "description": "The time and date an item was last modified",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Modification date",
+            "values": {},
+            "vocabulary": null
+        },
+        "path": {
+            "description": "The location of an item ",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.string.absolutePath",
+                "plone.app.querystring.operation.string.path",
+                "plone.app.querystring.operation.string.relativePath"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.string.absolutePath": {
+                    "description": "Location in the site structure",
+                    "operation": "plone.app.querystring.queryparser._absolutePath",
+                    "title": "Absolute path",
+                    "widget": "ReferenceWidget"
+                },
+                "plone.app.querystring.operation.string.path": {
+                    "description": "Location in the navigation structure",
+                    "operation": "plone.app.querystring.queryparser._navigationPath",
+                    "title": "Navigation path",
+                    "widget": "ReferenceWidget"
+                },
+                "plone.app.querystring.operation.string.relativePath": {
+                    "description": "Use '../' to navigate to parent objects.",
+                    "operation": "plone.app.querystring.queryparser._relativePath",
+                    "title": "Relative path",
+                    "widget": "RelativePathWidget"
+                }
+            },
+            "sortable": false,
+            "title": "Location",
+            "values": {},
+            "vocabulary": null
+        },
+        "portal_type": {
+            "description": "An item's type (e.g. Event)",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.selection.any",
+                "plone.app.querystring.operation.selection.none"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.selection.any": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Matches any of",
+                    "widget": "MultipleSelectionWidget"
+                },
+                "plone.app.querystring.operation.selection.none": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Matches none of",
+                    "widget": "MultipleSelectionWidget"
+                }
+            },
+            "sortable": false,
+            "title": "Type",
+            "values": {
+                "ATTestDocument": {
+                    "title": "Test Document"
+                },
+                "ATTestFolder": {
+                    "title": "Test Folder"
+                },
+                "Collection": {
+                    "title": "Collection"
+                },
+                "DXTestDocument": {
+                    "title": "DX Test Document"
+                },
+                "Discussion Item": {
+                    "title": "Comment"
+                },
+                "Document": {
+                    "title": "Page"
+                },
+                "Event": {
+                    "title": "Event"
+                },
+                "File": {
+                    "title": "File"
+                },
+                "Folder": {
+                    "title": "Folder"
+                },
+                "Image": {
+                    "title": "Image"
+                },
+                "Link": {
+                    "title": "Link"
+                },
+                "News Item": {
+                    "title": "News Item"
+                }
+            },
+            "vocabulary": "plone.app.vocabularies.ReallyUserFriendlyTypes"
+        },
+        "review_state": {
+            "description": "An item's workflow state (e.g.published)",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.selection.any",
+                "plone.app.querystring.operation.selection.none"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.selection.any": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Matches any of",
+                    "widget": "MultipleSelectionWidget"
+                },
+                "plone.app.querystring.operation.selection.none": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Matches none of",
+                    "widget": "MultipleSelectionWidget"
+                }
+            },
+            "sortable": true,
+            "title": "Review state",
+            "values": {
+                "external": {
+                    "title": "Externally visible [external]"
+                },
+                "internal": {
+                    "title": "Internal draft [internal]"
+                },
+                "internally_published": {
+                    "title": "Internally published [internally_published]"
+                },
+                "pending": {
+                    "title": "Pending [pending]"
+                },
+                "private": {
+                    "title": "Private [private]"
+                },
+                "published": {
+                    "title": "Published with accent \u00e9 [published]"
+                },
+                "rejected": {
+                    "title": "Rejected [rejected]"
+                },
+                "spam": {
+                    "title": "Spam [spam]"
+                },
+                "visible": {
+                    "title": "Public draft [visible]"
+                }
+            },
+            "vocabulary": "plone.app.vocabularies.WorkflowStates"
+        },
+        "show_inactive": {
+            "description": "Select which roles have the permission to view inactive objects",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.string.showInactive"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.string.showInactive": {
+                    "description": "The user roles which are allowed to see inactive content",
+                    "operation": "plone.app.querystring.queryparser._showInactive",
+                    "title": "Show Inactive",
+                    "widget": "MultipleSelectionWidget"
+                }
+            },
+            "sortable": false,
+            "title": "Show Inactive",
+            "values": {
+                "Anonymous": {
+                    "title": "Anonymous"
+                },
+                "Authenticated": {
+                    "title": "Authenticated"
+                },
+                "Contributor": {
+                    "title": "Contributor"
+                },
+                "Editor": {
+                    "title": "Editor"
+                },
+                "Manager": {
+                    "title": "Manager"
+                },
+                "Member": {
+                    "title": "Member"
+                },
+                "Owner": {
+                    "title": "Owner"
+                },
+                "Reader": {
+                    "title": "Reader"
+                },
+                "Reviewer": {
+                    "title": "Reviewer"
+                },
+                "Site Administrator": {
+                    "title": "Site Administrator"
+                }
+            },
+            "vocabulary": "plone.app.vocabularies.Roles"
+        },
+        "sortable_title": {
+            "description": "The item's title, transformed for sorting",
+            "enabled": false,
+            "fetch_vocabulary": true,
+            "group": "Text",
+            "operations": [
+                "plone.app.querystring.operation.string.contains",
+                "plone.app.querystring.operation.string.is",
+                "plone.app.querystring.operation.string.isNot"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.string.contains": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Contains",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.string.is": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._equal",
+                    "title": "Is",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.string.isNot": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Is not",
+                    "widget": "StringWidget"
+                }
+            },
+            "sortable": true,
+            "title": "Sortable Title",
+            "values": {},
+            "vocabulary": null
+        },
+        "start": {
+            "description": "The start date and time of an event",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Event start date",
+            "values": {},
+            "vocabulary": null
+        }
+    },
+    "sortable_indexes": {
+        "Creator": {
+            "description": "The person that created an item",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.string.currentUser",
+                "plone.app.querystring.operation.selection.any",
+                "plone.app.querystring.operation.selection.none"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.selection.any": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Matches any of",
+                    "widget": "MultipleSelectionWidget"
+                },
+                "plone.app.querystring.operation.selection.none": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Matches none of",
+                    "widget": "MultipleSelectionWidget"
+                },
+                "plone.app.querystring.operation.string.currentUser": {
+                    "description": "The user viewing the querystring results",
+                    "operation": "plone.app.querystring.queryparser._currentUser",
+                    "title": "Current logged in user",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Creator",
+            "values": {},
+            "vocabulary": "plone.app.vocabularies.Users"
+        },
+        "created": {
+            "description": "The date an item was created",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Creation date",
+            "values": {},
+            "vocabulary": null
+        },
+        "effective": {
+            "description": "The time and date an item was first published",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Effective date",
+            "values": {},
+            "vocabulary": null
+        },
+        "end": {
+            "description": "The end date and time of an event",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Event end date",
+            "values": {},
+            "vocabulary": null
+        },
+        "expires": {
+            "description": "The time and date an item was expired",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Expiration date",
+            "values": {},
+            "vocabulary": null
+        },
+        "getId": {
+            "description": "The short name of an item (used in the url)",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.string.is",
+                "plone.app.querystring.operation.string.isNot"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.string.is": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._equal",
+                    "title": "Is",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.string.isNot": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Is not",
+                    "widget": "StringWidget"
+                }
+            },
+            "sortable": true,
+            "title": "Short name (id)",
+            "values": {},
+            "vocabulary": null
+        },
+        "getObjPositionInParent": {
+            "description": "The order of an item in its parent folder",
+            "enabled": false,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.int.is",
+                "plone.app.querystring.operation.int.lessThan",
+                "plone.app.querystring.operation.int.largerThan"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.int.is": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._intEqual",
+                    "title": "Equals",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.int.largerThan": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._intLargerThan",
+                    "title": "Larger than",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.int.lessThan": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._intLessThan",
+                    "title": "Less than",
+                    "widget": "StringWidget"
+                }
+            },
+            "sortable": true,
+            "title": "Order in folder",
+            "values": {},
+            "vocabulary": null
+        },
+        "modified": {
+            "description": "The time and date an item was last modified",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Modification date",
+            "values": {},
+            "vocabulary": null
+        },
+        "review_state": {
+            "description": "An item's workflow state (e.g.published)",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Metadata",
+            "operations": [
+                "plone.app.querystring.operation.selection.any",
+                "plone.app.querystring.operation.selection.none"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.selection.any": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Matches any of",
+                    "widget": "MultipleSelectionWidget"
+                },
+                "plone.app.querystring.operation.selection.none": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Matches none of",
+                    "widget": "MultipleSelectionWidget"
+                }
+            },
+            "sortable": true,
+            "title": "Review state",
+            "values": {
+                "external": {
+                    "title": "Externally visible [external]"
+                },
+                "internal": {
+                    "title": "Internal draft [internal]"
+                },
+                "internally_published": {
+                    "title": "Internally published [internally_published]"
+                },
+                "pending": {
+                    "title": "Pending [pending]"
+                },
+                "private": {
+                    "title": "Private [private]"
+                },
+                "published": {
+                    "title": "Published with accent \u00e9 [published]"
+                },
+                "rejected": {
+                    "title": "Rejected [rejected]"
+                },
+                "spam": {
+                    "title": "Spam [spam]"
+                },
+                "visible": {
+                    "title": "Public draft [visible]"
+                }
+            },
+            "vocabulary": "plone.app.vocabularies.WorkflowStates"
+        },
+        "sortable_title": {
+            "description": "The item's title, transformed for sorting",
+            "enabled": false,
+            "fetch_vocabulary": true,
+            "group": "Text",
+            "operations": [
+                "plone.app.querystring.operation.string.contains",
+                "plone.app.querystring.operation.string.is",
+                "plone.app.querystring.operation.string.isNot"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.string.contains": {
+                    "description": null,
+                    "operation": "plone.app.querystring.queryparser._contains",
+                    "title": "Contains",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.string.is": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._equal",
+                    "title": "Is",
+                    "widget": "StringWidget"
+                },
+                "plone.app.querystring.operation.string.isNot": {
+                    "description": "Tip: you can use * to autocomplete.",
+                    "operation": "plone.app.querystring.queryparser._excludes",
+                    "title": "Is not",
+                    "widget": "StringWidget"
+                }
+            },
+            "sortable": true,
+            "title": "Sortable Title",
+            "values": {},
+            "vocabulary": null
+        },
+        "start": {
+            "description": "The start date and time of an event",
+            "enabled": true,
+            "fetch_vocabulary": true,
+            "group": "Dates",
+            "operations": [
+                "plone.app.querystring.operation.date.lessThan",
+                "plone.app.querystring.operation.date.largerThan",
+                "plone.app.querystring.operation.date.between",
+                "plone.app.querystring.operation.date.lessThanRelativeDate",
+                "plone.app.querystring.operation.date.largerThanRelativeDate",
+                "plone.app.querystring.operation.date.today",
+                "plone.app.querystring.operation.date.beforeToday",
+                "plone.app.querystring.operation.date.afterToday",
+                "plone.app.querystring.operation.date.beforeRelativeDate",
+                "plone.app.querystring.operation.date.afterRelativeDate"
+            ],
+            "operators": {
+                "plone.app.querystring.operation.date.afterRelativeDate": {
+                    "description": "After N days in the future",
+                    "operation": "plone.app.querystring.queryparser._afterRelativeDate",
+                    "title": "After relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.afterToday": {
+                    "description": "After the current day",
+                    "operation": "plone.app.querystring.queryparser._afterToday",
+                    "title": "After today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.beforeRelativeDate": {
+                    "description": "Before N days in the past",
+                    "operation": "plone.app.querystring.queryparser._beforeRelativeDate",
+                    "title": "Before relative Date",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.beforeToday": {
+                    "description": "Before the current day",
+                    "operation": "plone.app.querystring.queryparser._beforeToday",
+                    "title": "Before today",
+                    "widget": null
+                },
+                "plone.app.querystring.operation.date.between": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._between",
+                    "title": "Between dates",
+                    "widget": "DateRangeWidget"
+                },
+                "plone.app.querystring.operation.date.largerThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._largerThan",
+                    "title": "After date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.largerThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._moreThanRelativeDate",
+                    "title": "Within last",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThan": {
+                    "description": "Please use YYYY/MM/DD.",
+                    "operation": "plone.app.querystring.queryparser._lessThan",
+                    "title": "Before date",
+                    "widget": "DateWidget"
+                },
+                "plone.app.querystring.operation.date.lessThanRelativeDate": {
+                    "description": "Please enter the number in days.",
+                    "operation": "plone.app.querystring.queryparser._lessThanRelativeDate",
+                    "title": "Within next",
+                    "widget": "RelativeDateWidget"
+                },
+                "plone.app.querystring.operation.date.today": {
+                    "description": "The current day",
+                    "operation": "plone.app.querystring.queryparser._today",
+                    "title": "Today",
+                    "widget": null
+                }
+            },
+            "sortable": true,
+            "title": "Event start date",
+            "values": {},
+            "vocabulary": null
+        }
+    }
+}
diff --git a/src/plone/restapi/tests/test_documentation.py b/src/plone/restapi/tests/test_documentation.py
index 1634fc3806..e10c2e97cf 100644
--- a/src/plone/restapi/tests/test_documentation.py
+++ b/src/plone/restapi/tests/test_documentation.py
@@ -1719,6 +1719,11 @@ def test_querystring_get(self):
         response = self.api_session.get(url)
         save_request_and_response_for_docs("querystring_get", response)
 
+    def test_querystring_get_contextual(self):
+        url = f"{self.document.absolute_url()}/@querystring"
+        response = self.api_session.get(url)
+        save_request_and_response_for_docs("querystring_get_contextual", response)
+
     def test_querystringsearch_post(self):
         url = "/@querystring-search"