Summary
Creates a Json Form
Description
Creates a new JSON form document with a unique name.
Route
POST /json-forms/forms
Roles
admin
other
readonly
apiread
Parameters
DetailsExampleSchema
Name |
Type |
Required |
Description |
name |
string |
yes |
Unique name of the JSON form |
description |
string |
yes |
Short description of the JSON form |
struct |
object |
yes |
Array structure of the form |
schema |
object |
yes |
JSON schema of the form |
uiSchema |
object |
yes |
UI schema of the form |
Copied to Clipboard
{
"name": "Device Form",
"description": "This form describes the connection information for a device.",
"struct": {
"nodeId": "kdWO-g4oS3GkzrbqDqCZUw",
"type": "array",
"items": [
{
"nodeId": "kdWO-g4oS3GkzrbqDqCZUw",
"type": "string",
"title": "Device Name",
"description": "A unique name of the target device.",
"placeholder": "Enter the device's name",
"required": false
},
{
"nodeId": "kdWO-g4oS3GkzrbqDqCZUw",
"type": "number",
"title": "Retry attempts",
"description": "The number of connection retries before timing out.",
"placeholder": "Enter connection retry attempt count",
"required": true
},
{
"nodeId": "kdWO-g4oS3GkzrbqDqCZUw",
"type": "string",
"title": "Device Name",
"description": "A unique name of the target device.",
"placeholder": "Enter the device's name",
"required": true
},
{
"nodeId": "kdWO-g4oS3GkzrbqDqCZUw",
"type": "string",
"title": "Device Name",
"description": "A unique name of the target device.",
"placeholder": "Enter the device's name",
"required": true
},
{
"nodeId": "kdWO-g4oS3GkzrbqDqCZUw",
"type": "boolean",
"title": "Allow timeout",
"description": "Is a timeout allowed to pass this step?"
}
]
},
"schema": {
"title": "schema"
},
"uiSchema": {
"title": "uiSchema"
}
}
Copied to Clipboard
{
"type": "object",
"properties": {
"name": {
"title": "name",
"type": "string",
"examples": [
"Device Form"
]
},
"description": {
"title": "description",
"type": "string",
"examples": [
"This form describes the connection information for a device."
]
},
"struct": {
"title": "struct",
"$ref": "formStruct"
},
"schema": {
"title": "schema",
"$ref": "formSchema#/definitions/container"
},
"uiSchema": {
"title": "uiSchema",
"$ref": "formUISchema#/definitions/container"
}
},
"required": [
"name",
"description",
"struct",
"schema",
"uiSchema"
],
"additionalProperties": false
}
Return
DetailsExampleSchema
Name |
Type |
Description |
document |
object |
document that was created from the request |
Copied to Clipboard
{
"title": "document"
}