Reserved Form mode names
Use form modes to specify what data can be read or written to documents using the form name in their form item. While you are free to pick any name (lower case, no special characters), there are names with a special purpose, namely:
default
The default
mode is, as the name implies, the default when creating or reading documents and in the absence of an explicitly specified mode=
parameter
dql
When data is queried by DQL, forms need a dql
mode to return values. The mode specified what data gets returned. If a form doesn't have a dql
mode, no data will be returned for that form in a DQL query.
odata
The odata
mode lets you define the data that comes through OData endpoints. The API support the OData standard Open Data Protocol(oData). If a form doesn't have an odata
mode, then an OData won't return any data for that form.
raw
Needed for /api/v1/raw
endpoint. The endpoint /api/v1/raw
will only return data when the mode raw
exists for the form requested and the user has the permission, expressed in the @formula of the raw mode definition. Typically you want to restrict raw access to admin and support users.
Note
raw
mode returns all fields without translation or adjustment.