REST API for Clinical One Platform

~~[Deprecated]: Add form in a study version~~

post

/ec-designer-svc/rest/v6.0/studies/{studyId}/versions/{version}/forms

Deprecated: Use latest version instead. Adds a form in a study version.

Request

Path Parameters

studyId(required): string(uuid)

Study ID. Example: F054C951EB74443C93716CA714AB686E
version(required): string

Study version. Example: "1.0.0.1"

Supported Media Types

Root Schema : FormDto v7.0

Type: object

Title: FormDto v7.0

Form Info

Show Source

id: string (uuid)

Form Unique GUID
items: array items
refname(required): string

Minimum Length: 1

Maximum Length: 64

Form refname

Example: FORM_01
title(required): string

Minimum Length: 1

Maximum Length: 64

Form title

Example: Demography

{
    "title":"FormDto v7.0",
    "required":[
        "refname",
        "title"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Form Unique GUID",
            "format":"uuid"
        },
        "title":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form title",
            "example":"Demography"
        },
        "refname":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form refname",
            "example":"FORM_01"
        },
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemDtoV7"
            }
        }
    },
    "description":"Form Info"
}

Nested Schema : items

Type: array

Show Source

Array of: object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/FormItemDtoV7"
    }
}

Nested Schema : FormItemDto v7.0

Type: object

Title: FormItemDto v7.0

Discriminator: questionType

{
    "title":"FormItemDto v7.0",
    "required":[
        "questionLabel",
        "questionType",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Form Item Unique GUID",
            "format":"uuid"
        },
        "formId":{
            "type":"string",
            "description":"Form Unique GUID",
            "format":"uuid"
        },
        "formTitle":{
            "type":"string",
            "description":"Form title",
            "example":"Demography"
        },
        "questionLabel":{
            "maxLength":"4000",
            "minLength":"1",
            "type":"string",
            "description":"Form question label",
            "example":"Age"
        },
        "questionHint":{
            "maxLength":"4000",
            "minLength":"0",
            "type":"string",
            "description":"Form question hint",
            "example":"What is your age?"
        },
        "randomizationTag":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item should be used for randomization stratification or not.",
            "example":true
        },
        "isStrataFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization stratum or not.",
            "example":false
        },
        "isCohortFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization cohort or not.",
            "example":false
        },
        "refname":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form item reference name.",
            "example":"NUMBER_01"
        },
        "required":{
            "type":"boolean",
            "description":"Whether this form item is requiered or not.",
            "example":true
        },
        "ruleSet":{
            "type":"string",
            "description":"A JSON-formatted set of rules to do validation of the answers.",
            "example":"{'logicalOperator':'NONE','rules':[],'numberIndex':1}"
        },
        "sdvRequired":{
            "type":"boolean",
            "description":"Source-Documented Verification: Whether proof of the answer required?",
            "example":false
        },
        "sequence":{
            "type":"integer",
            "description":"Item position in the form.",
            "format":"int32",
            "example":"1"
        },
        "smartItemId":{
            "type":"string",
            "description":"Smart item Unique GUID",
            "format":"uuid"
        },
        "formula":{
            "type":"string",
            "description":"Smart item formula.",
            "example":"[{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]"
        },
        "smartObject":{
            "type":"string",
            "description":"Smart object.",
            "example":"AGE"
        },
        "advancedProps":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemAdvancedPropDtoV7"
            }
        },
        "questionType":{
            "type":"string"
        }
    },
    "description":"Form Item Information",
    "discriminator":{
        "propertyName":"questionType",
        "mapping":{
            "datetime":"#/components/schemas/FormDatetimeItemDtoV7",
            "numeric":"#/components/schemas/FormNumberItemDtoV7",
            "measurement":"#/components/schemas/FormNumberItemDtoV7",
            "text":"#/components/schemas/FormTextItemDtoV7",
            "choice":"#/components/schemas/FormChoiceItemDtoV7"
        }
    },
    "oneOf":[
        {
            "$ref":"#/components/schemas/FormNumberItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormChoiceItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormTextItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormDatetimeItemDtoV7"
        }
    ]
}

Form Item Information

Show Source

advancedProps: array advancedProps
formId: string (uuid)

Form Unique GUID
formTitle: string

Form title

Example: Demography
formula: string

Smart item formula.

Example: [{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]
id: string (uuid)

Form Item Unique GUID
isCohortFactor: boolean

Flag that indicates whether this form item is used as a factor for randomization cohort or not.

Example: false
isStrataFactor: boolean

Flag that indicates whether this form item is used as a factor for randomization stratum or not.

Example: false
questionHint: string

Minimum Length: 0

Maximum Length: 4000

Form question hint

Example: What is your age?
questionLabel(required): string

Minimum Length: 1

Maximum Length: 4000

Form question label

Example: Age
questionType(required): string
randomizationTag: boolean

Flag that indicates whether this form item should be used for randomization stratification or not.

Example: true
refname(required): string

Minimum Length: 1

Maximum Length: 64

Form item reference name.

Example: NUMBER_01
required(required): boolean

Whether this form item is requiered or not.

Example: true
ruleSet: string

A JSON-formatted set of rules to do validation of the answers.

Example: {'logicalOperator':'NONE','rules':[],'numberIndex':1}
sdvRequired(required): boolean

Source-Documented Verification: Whether proof of the answer required?

Example: false
sequence: integer (int32)

Item position in the form.

Example: 1
smartItemId: string (uuid)

Smart item Unique GUID
smartObject: string

Smart object.

Example: AGE

{
    "title":"FormItemDto v7.0",
    "required":[
        "questionLabel",
        "questionType",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Form Item Unique GUID",
            "format":"uuid"
        },
        "formId":{
            "type":"string",
            "description":"Form Unique GUID",
            "format":"uuid"
        },
        "formTitle":{
            "type":"string",
            "description":"Form title",
            "example":"Demography"
        },
        "questionLabel":{
            "maxLength":"4000",
            "minLength":"1",
            "type":"string",
            "description":"Form question label",
            "example":"Age"
        },
        "questionHint":{
            "maxLength":"4000",
            "minLength":"0",
            "type":"string",
            "description":"Form question hint",
            "example":"What is your age?"
        },
        "randomizationTag":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item should be used for randomization stratification or not.",
            "example":true
        },
        "isStrataFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization stratum or not.",
            "example":false
        },
        "isCohortFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization cohort or not.",
            "example":false
        },
        "refname":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form item reference name.",
            "example":"NUMBER_01"
        },
        "required":{
            "type":"boolean",
            "description":"Whether this form item is requiered or not.",
            "example":true
        },
        "ruleSet":{
            "type":"string",
            "description":"A JSON-formatted set of rules to do validation of the answers.",
            "example":"{'logicalOperator':'NONE','rules':[],'numberIndex':1}"
        },
        "sdvRequired":{
            "type":"boolean",
            "description":"Source-Documented Verification: Whether proof of the answer required?",
            "example":false
        },
        "sequence":{
            "type":"integer",
            "description":"Item position in the form.",
            "format":"int32",
            "example":"1"
        },
        "smartItemId":{
            "type":"string",
            "description":"Smart item Unique GUID",
            "format":"uuid"
        },
        "formula":{
            "type":"string",
            "description":"Smart item formula.",
            "example":"[{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]"
        },
        "smartObject":{
            "type":"string",
            "description":"Smart object.",
            "example":"AGE"
        },
        "advancedProps":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemAdvancedPropDtoV7"
            }
        },
        "questionType":{
            "type":"string"
        }
    },
    "description":"Form Item Information",
    "discriminator":{
        "propertyName":"questionType",
        "mapping":{
            "datetime":"#/components/schemas/FormDatetimeItemDtoV7",
            "numeric":"#/components/schemas/FormNumberItemDtoV7",
            "measurement":"#/components/schemas/FormNumberItemDtoV7",
            "text":"#/components/schemas/FormTextItemDtoV7",
            "choice":"#/components/schemas/FormChoiceItemDtoV7"
        }
    },
    "oneOf":[
        {
            "$ref":"#/components/schemas/FormNumberItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormChoiceItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormTextItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormDatetimeItemDtoV7"
        }
    ]
}

Match One Schema

Show Source

object FormNumberItemDto v7.0

Title: FormNumberItemDto v7.0

Form Number Item Details Information
object FormChoiceItemDto v7.0

Title: FormChoiceItemDto v7.0

Form Choice Item Details Information
object FormTextItemDto v7.0

Title: FormTextItemDto v7.0

Form text Item Details Information
object FormDatetimeItemDto v7.0

Title: FormDatetimeItemDto v7.0

Form DateTime Item Details Information

{
    "title":"FormItemDto v7.0",
    "required":[
        "questionLabel",
        "questionType",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Form Item Unique GUID",
            "format":"uuid"
        },
        "formId":{
            "type":"string",
            "description":"Form Unique GUID",
            "format":"uuid"
        },
        "formTitle":{
            "type":"string",
            "description":"Form title",
            "example":"Demography"
        },
        "questionLabel":{
            "maxLength":"4000",
            "minLength":"1",
            "type":"string",
            "description":"Form question label",
            "example":"Age"
        },
        "questionHint":{
            "maxLength":"4000",
            "minLength":"0",
            "type":"string",
            "description":"Form question hint",
            "example":"What is your age?"
        },
        "randomizationTag":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item should be used for randomization stratification or not.",
            "example":true
        },
        "isStrataFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization stratum or not.",
            "example":false
        },
        "isCohortFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization cohort or not.",
            "example":false
        },
        "refname":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form item reference name.",
            "example":"NUMBER_01"
        },
        "required":{
            "type":"boolean",
            "description":"Whether this form item is requiered or not.",
            "example":true
        },
        "ruleSet":{
            "type":"string",
            "description":"A JSON-formatted set of rules to do validation of the answers.",
            "example":"{'logicalOperator':'NONE','rules':[],'numberIndex':1}"
        },
        "sdvRequired":{
            "type":"boolean",
            "description":"Source-Documented Verification: Whether proof of the answer required?",
            "example":false
        },
        "sequence":{
            "type":"integer",
            "description":"Item position in the form.",
            "format":"int32",
            "example":"1"
        },
        "smartItemId":{
            "type":"string",
            "description":"Smart item Unique GUID",
            "format":"uuid"
        },
        "formula":{
            "type":"string",
            "description":"Smart item formula.",
            "example":"[{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]"
        },
        "smartObject":{
            "type":"string",
            "description":"Smart object.",
            "example":"AGE"
        },
        "advancedProps":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemAdvancedPropDtoV7"
            }
        },
        "questionType":{
            "type":"string"
        }
    },
    "description":"Form Item Information",
    "discriminator":{
        "propertyName":"questionType",
        "mapping":{
            "datetime":"#/components/schemas/FormDatetimeItemDtoV7",
            "numeric":"#/components/schemas/FormNumberItemDtoV7",
            "measurement":"#/components/schemas/FormNumberItemDtoV7",
            "text":"#/components/schemas/FormTextItemDtoV7",
            "choice":"#/components/schemas/FormChoiceItemDtoV7"
        }
    },
    "oneOf":[
        {
            "$ref":"#/components/schemas/FormNumberItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormChoiceItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormTextItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormDatetimeItemDtoV7"
        }
    ]
}

Nested Schema : advancedProps

Type: array

Show Source

Array of: object From Item Advanced Property v7.0

Title: From Item Advanced Property v7.0

Form Item Advanced Property

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/FormItemAdvancedPropDtoV7"
    }
}

Nested Schema : FormNumberItemDto v7.0

Type: object

Title: FormNumberItemDto v7.0

Form Number Item Details Information

Match All

Show Source

object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information
object FormNumberItemDto v7.0-allOf[1]

{
    "title":"FormNumberItemDto v7.0",
    "required":[
        "precision",
        "questionLabel",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "description":"Form Number Item Details Information",
    "allOf":[
        {
            "$ref":"#/components/schemas/FormItemDtoV7"
        },
        {
            "type":"object",
            "properties":{
                "precision":{
                    "minimum":"0",
                    "type":"integer",
                    "description":"Number value precision",
                    "format":"int32",
                    "example":"1"
                },
                "units":{
                    "type":"string",
                    "description":"Units of measure",
                    "example":"kg"
                }
            }
        }
    ]
}

Nested Schema : FormChoiceItemDto v7.0

Type: object

Title: FormChoiceItemDto v7.0

Form Choice Item Details Information

Match All

Show Source

object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information
object FormChoiceItemDto v7.0-allOf[1]

{
    "title":"FormChoiceItemDto v7.0",
    "required":[
        "display",
        "options",
        "questionLabel",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "description":"Form Choice Item Details Information",
    "allOf":[
        {
            "$ref":"#/components/schemas/FormItemDtoV7"
        },
        {
            "type":"object",
            "properties":{
                "display":{
                    "pattern":"selectbox",
                    "type":"string",
                    "description":"Form choice item display in UI - Selectbox.",
                    "example":"selectbox"
                },
                "options":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/FormOptionDtoV7"
                    }
                }
            }
        }
    ]
}

Nested Schema : FormTextItemDto v7.0

Type: object

Title: FormTextItemDto v7.0

Form text Item Details Information

Match All

Show Source

object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information
object FormTextItemDto v7.0-allOf[1]

{
    "title":"FormTextItemDto v7.0",
    "required":[
        "maxlength",
        "multiline",
        "questionLabel",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "description":"Form text Item Details Information",
    "allOf":[
        {
            "$ref":"#/components/schemas/FormItemDtoV7"
        },
        {
            "type":"object",
            "properties":{
                "maxlength":{
                    "maximum":"4000",
                    "minimum":"0",
                    "type":"integer",
                    "description":"Form text item max length",
                    "format":"int32",
                    "example":"4000"
                },
                "multiline":{
                    "type":"boolean",
                    "description":"Is form text item multiline",
                    "example":false
                }
            }
        }
    ]
}

Nested Schema : FormDatetimeItemDto v7.0

Type: object

Title: FormDatetimeItemDto v7.0

Form DateTime Item Details Information

Match All

Show Source

object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information
object FormDatetimeItemDto v7.0-allOf[1]

{
    "title":"FormDatetimeItemDto v7.0",
    "required":[
        "format",
        "questionLabel",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "description":"Form DateTime Item Details Information",
    "allOf":[
        {
            "$ref":"#/components/schemas/FormItemDtoV7"
        },
        {
            "type":"object",
            "properties":{
                "format":{
                    "pattern":"yyyy|MMM-yyyy|dd-MMM-yyyy|dd-MMM-yyyy HH:mm",
                    "type":"string",
                    "description":"Date time format",
                    "example":"DD-MON-YYYY"
                },
                "allowPartialDate":{
                    "maximum":"1",
                    "minimum":"0",
                    "type":"integer",
                    "description":"Allow partial date",
                    "format":"int32",
                    "example":"1"
                },
                "partialDate":{
                    "pattern":"yyyy|MMM-yyyy",
                    "type":"string",
                    "description":"Partial date format",
                    "example":"Jan-1993"
                }
            }
        }
    ]
}

Nested Schema : From Item Advanced Property v7.0

Type: object

Title: From Item Advanced Property v7.0

Form Item Advanced Property

Show Source

id: string (uuid)

Advanced property id
label: string

Advanced property label in UI, i.e. studyName

Example: Study BT-31
name: string

Advanced property name, mapped to the ECD_EXTENDED_PROPERTIES.PROPERTY_NAME column

Example: RolloverQuestion
parentObjectId: string (uuid)
parentObjectLabel: string
parentObjectLevel: string
rules: array rules
type: string

Advanced property type, mapped to the ECD_EXTENDED_PROPERTIES.RESPONSE_MAP_JSON column 'valueType' field

Example: Dropdown
value: string

Advanced property value of studyId

Example: B1B8327AFAA6412287106192AB5984EF

{
    "title":"From Item Advanced Property v7.0",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Advanced property id",
            "format":"uuid"
        },
        "type":{
            "type":"string",
            "description":"Advanced property type, mapped to the ECD_EXTENDED_PROPERTIES.RESPONSE_MAP_JSON column 'valueType' field",
            "example":"Dropdown"
        },
        "name":{
            "type":"string",
            "description":"Advanced property name, mapped to the ECD_EXTENDED_PROPERTIES.PROPERTY_NAME column",
            "example":"RolloverQuestion"
        },
        "value":{
            "type":"string",
            "description":"Advanced property value of studyId",
            "example":"B1B8327AFAA6412287106192AB5984EF"
        },
        "label":{
            "type":"string",
            "description":"Advanced property label in UI, i.e. studyName",
            "example":"Study BT-31"
        },
        "rules":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemAdvancedPropRuleDtoV7"
            }
        },
        "parentObjectId":{
            "type":"string",
            "format":"uuid"
        },
        "parentObjectLevel":{
            "type":"string"
        },
        "parentObjectLabel":{
            "type":"string"
        }
    },
    "description":"Form Item Advanced Property"
}

Nested Schema : rules

Type: array

Show Source

Array of: object From Item Advanced Property Rule v7.0

Title: From Item Advanced Property Rule v7.0

Form Item Advanced Property Rule

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/FormItemAdvancedPropRuleDtoV7"
    }
}

Nested Schema : From Item Advanced Property Rule v7.0

Type: object

Title: From Item Advanced Property Rule v7.0

Form Item Advanced Property Rule

Show Source

label: string

For RolloverQuestion property it is an ECD_CODELISTITEM.OBJECT_DESCRIPTION

Example: Yes
name: string

name

Example: Answer for Rollover
value: string

For RolloverQuestion property it is an ECD_CODELISTITEM.CODELISTITEM_ID

Example: B1B8327AFAA6412287106192AB5984EF

{
    "title":"From Item Advanced Property Rule v7.0",
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"name",
            "example":"Answer for Rollover"
        },
        "value":{
            "type":"string",
            "description":"For RolloverQuestion property it is an ECD_CODELISTITEM.CODELISTITEM_ID",
            "example":"B1B8327AFAA6412287106192AB5984EF"
        },
        "label":{
            "type":"string",
            "description":"For RolloverQuestion property it is an ECD_CODELISTITEM.OBJECT_DESCRIPTION",
            "example":"Yes"
        }
    },
    "description":"Form Item Advanced Property Rule"
}

Nested Schema : FormNumberItemDto v7.0-allOf[1]

Type: object

Show Source

precision: integer (int32)

Minimum Value: 0

Number value precision

Example: 1
units: string

Units of measure

Example: kg

{
    "type":"object",
    "properties":{
        "precision":{
            "minimum":"0",
            "type":"integer",
            "description":"Number value precision",
            "format":"int32",
            "example":"1"
        },
        "units":{
            "type":"string",
            "description":"Units of measure",
            "example":"kg"
        }
    }
}

Nested Schema : FormChoiceItemDto v7.0-allOf[1]

Type: object

Show Source

display: string

Pattern: selectbox

Form choice item display in UI - Selectbox.

Example: selectbox
options: array options

{
    "type":"object",
    "properties":{
        "display":{
            "pattern":"selectbox",
            "type":"string",
            "description":"Form choice item display in UI - Selectbox.",
            "example":"selectbox"
        },
        "options":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormOptionDtoV7"
            }
        }
    }
}

Nested Schema : options

Type: array

Show Source

Array of: object FormOptionDto v7.0

Title: FormOptionDto v7.0

Form choice item option details

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/FormOptionDtoV7"
    }
}

Nested Schema : FormOptionDto v7.0

Type: object

Title: FormOptionDto v7.0

Form choice item option details

Show Source

label: string

Minimum Length: 1

Maximum Length: 4000

Form choice selectbox label for a one specific choice.

Example: Female
value: string

Minimum Length: 1

Maximum Length: 4000

Pattern: [a-zA-Z0-9]+

Form choice selectbox value for a one specific choice.

Example: 1

{
    "title":"FormOptionDto v7.0",
    "type":"object",
    "properties":{
        "label":{
            "maxLength":"4000",
            "minLength":"1",
            "type":"string",
            "description":"Form choice selectbox label for a one specific choice.",
            "example":"Female"
        },
        "value":{
            "maxLength":"4000",
            "minLength":"1",
            "pattern":"[a-zA-Z0-9]+",
            "type":"string",
            "description":"Form choice selectbox value for a one specific choice.",
            "example":"1"
        }
    },
    "description":"Form choice item option details"
}

Nested Schema : FormTextItemDto v7.0-allOf[1]

Type: object

Show Source

maxlength: integer (int32)

Minimum Value: 0

Maximum Value: 4000

Form text item max length

Example: 4000
multiline: boolean

Is form text item multiline

Example: false

{
    "type":"object",
    "properties":{
        "maxlength":{
            "maximum":"4000",
            "minimum":"0",
            "type":"integer",
            "description":"Form text item max length",
            "format":"int32",
            "example":"4000"
        },
        "multiline":{
            "type":"boolean",
            "description":"Is form text item multiline",
            "example":false
        }
    }
}

Nested Schema : FormDatetimeItemDto v7.0-allOf[1]

Type: object

Show Source

allowPartialDate: integer (int32)

Minimum Value: 0

Maximum Value: 1

Allow partial date

Example: 1
format: string

Pattern: yyyy|MMM-yyyy|dd-MMM-yyyy|dd-MMM-yyyy HH:mm

Date time format

Example: DD-MON-YYYY
partialDate: string

Pattern: yyyy|MMM-yyyy

Partial date format

Example: Jan-1993

{
    "type":"object",
    "properties":{
        "format":{
            "pattern":"yyyy|MMM-yyyy|dd-MMM-yyyy|dd-MMM-yyyy HH:mm",
            "type":"string",
            "description":"Date time format",
            "example":"DD-MON-YYYY"
        },
        "allowPartialDate":{
            "maximum":"1",
            "minimum":"0",
            "type":"integer",
            "description":"Allow partial date",
            "format":"int32",
            "example":"1"
        },
        "partialDate":{
            "pattern":"yyyy|MMM-yyyy",
            "type":"string",
            "description":"Partial date format",
            "example":"Jan-1993"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

Successful operation.

Root Schema : FormDto v7.0

Type: object

Title: FormDto v7.0

Form Info

Show Source

id: string (uuid)

Form Unique GUID
items: array items
refname(required): string

Minimum Length: 1

Maximum Length: 64

Form refname

Example: FORM_01
title(required): string

Minimum Length: 1

Maximum Length: 64

Form title

Example: Demography

{
    "title":"FormDto v7.0",
    "required":[
        "refname",
        "title"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Form Unique GUID",
            "format":"uuid"
        },
        "title":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form title",
            "example":"Demography"
        },
        "refname":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form refname",
            "example":"FORM_01"
        },
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemDtoV7"
            }
        }
    },
    "description":"Form Info"
}

Nested Schema : items

Type: array

Show Source

Array of: object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/FormItemDtoV7"
    }
}

Nested Schema : FormItemDto v7.0

Type: object

Title: FormItemDto v7.0

Discriminator: questionType

Discriminator Values

datetime
numeric
measurement
text
choice

{
    "title":"FormItemDto v7.0",
    "required":[
        "questionLabel",
        "questionType",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Form Item Unique GUID",
            "format":"uuid"
        },
        "formId":{
            "type":"string",
            "description":"Form Unique GUID",
            "format":"uuid"
        },
        "formTitle":{
            "type":"string",
            "description":"Form title",
            "example":"Demography"
        },
        "questionLabel":{
            "maxLength":"4000",
            "minLength":"1",
            "type":"string",
            "description":"Form question label",
            "example":"Age"
        },
        "questionHint":{
            "maxLength":"4000",
            "minLength":"0",
            "type":"string",
            "description":"Form question hint",
            "example":"What is your age?"
        },
        "randomizationTag":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item should be used for randomization stratification or not.",
            "example":true
        },
        "isStrataFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization stratum or not.",
            "example":false
        },
        "isCohortFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization cohort or not.",
            "example":false
        },
        "refname":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form item reference name.",
            "example":"NUMBER_01"
        },
        "required":{
            "type":"boolean",
            "description":"Whether this form item is requiered or not.",
            "example":true
        },
        "ruleSet":{
            "type":"string",
            "description":"A JSON-formatted set of rules to do validation of the answers.",
            "example":"{'logicalOperator':'NONE','rules':[],'numberIndex':1}"
        },
        "sdvRequired":{
            "type":"boolean",
            "description":"Source-Documented Verification: Whether proof of the answer required?",
            "example":false
        },
        "sequence":{
            "type":"integer",
            "description":"Item position in the form.",
            "format":"int32",
            "example":"1"
        },
        "smartItemId":{
            "type":"string",
            "description":"Smart item Unique GUID",
            "format":"uuid"
        },
        "formula":{
            "type":"string",
            "description":"Smart item formula.",
            "example":"[{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]"
        },
        "smartObject":{
            "type":"string",
            "description":"Smart object.",
            "example":"AGE"
        },
        "advancedProps":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemAdvancedPropDtoV7"
            }
        },
        "questionType":{
            "type":"string"
        }
    },
    "description":"Form Item Information",
    "discriminator":{
        "propertyName":"questionType",
        "mapping":{
            "datetime":"#/components/schemas/FormDatetimeItemDtoV7",
            "numeric":"#/components/schemas/FormNumberItemDtoV7",
            "measurement":"#/components/schemas/FormNumberItemDtoV7",
            "text":"#/components/schemas/FormTextItemDtoV7",
            "choice":"#/components/schemas/FormChoiceItemDtoV7"
        }
    },
    "oneOf":[
        {
            "$ref":"#/components/schemas/FormNumberItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormChoiceItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormTextItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormDatetimeItemDtoV7"
        }
    ]
}

Form Item Information

Show Source

advancedProps: array advancedProps
formId: string (uuid)

Form Unique GUID
formTitle: string

Form title

Example: Demography
formula: string

Smart item formula.

Example: [{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]
id: string (uuid)

Form Item Unique GUID
isCohortFactor: boolean

Flag that indicates whether this form item is used as a factor for randomization cohort or not.

Example: false
isStrataFactor: boolean

Flag that indicates whether this form item is used as a factor for randomization stratum or not.

Example: false
questionHint: string

Minimum Length: 0

Maximum Length: 4000

Form question hint

Example: What is your age?
questionLabel(required): string

Minimum Length: 1

Maximum Length: 4000

Form question label

Example: Age
questionType(required): string
randomizationTag: boolean

Flag that indicates whether this form item should be used for randomization stratification or not.

Example: true
refname(required): string

Minimum Length: 1

Maximum Length: 64

Form item reference name.

Example: NUMBER_01
required(required): boolean

Whether this form item is requiered or not.

Example: true
ruleSet: string

A JSON-formatted set of rules to do validation of the answers.

Example: {'logicalOperator':'NONE','rules':[],'numberIndex':1}
sdvRequired(required): boolean

Source-Documented Verification: Whether proof of the answer required?

Example: false
sequence: integer (int32)

Item position in the form.

Example: 1
smartItemId: string (uuid)

Smart item Unique GUID
smartObject: string

Smart object.

Example: AGE

{
    "title":"FormItemDto v7.0",
    "required":[
        "questionLabel",
        "questionType",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Form Item Unique GUID",
            "format":"uuid"
        },
        "formId":{
            "type":"string",
            "description":"Form Unique GUID",
            "format":"uuid"
        },
        "formTitle":{
            "type":"string",
            "description":"Form title",
            "example":"Demography"
        },
        "questionLabel":{
            "maxLength":"4000",
            "minLength":"1",
            "type":"string",
            "description":"Form question label",
            "example":"Age"
        },
        "questionHint":{
            "maxLength":"4000",
            "minLength":"0",
            "type":"string",
            "description":"Form question hint",
            "example":"What is your age?"
        },
        "randomizationTag":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item should be used for randomization stratification or not.",
            "example":true
        },
        "isStrataFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization stratum or not.",
            "example":false
        },
        "isCohortFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization cohort or not.",
            "example":false
        },
        "refname":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form item reference name.",
            "example":"NUMBER_01"
        },
        "required":{
            "type":"boolean",
            "description":"Whether this form item is requiered or not.",
            "example":true
        },
        "ruleSet":{
            "type":"string",
            "description":"A JSON-formatted set of rules to do validation of the answers.",
            "example":"{'logicalOperator':'NONE','rules':[],'numberIndex':1}"
        },
        "sdvRequired":{
            "type":"boolean",
            "description":"Source-Documented Verification: Whether proof of the answer required?",
            "example":false
        },
        "sequence":{
            "type":"integer",
            "description":"Item position in the form.",
            "format":"int32",
            "example":"1"
        },
        "smartItemId":{
            "type":"string",
            "description":"Smart item Unique GUID",
            "format":"uuid"
        },
        "formula":{
            "type":"string",
            "description":"Smart item formula.",
            "example":"[{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]"
        },
        "smartObject":{
            "type":"string",
            "description":"Smart object.",
            "example":"AGE"
        },
        "advancedProps":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemAdvancedPropDtoV7"
            }
        },
        "questionType":{
            "type":"string"
        }
    },
    "description":"Form Item Information",
    "discriminator":{
        "propertyName":"questionType",
        "mapping":{
            "datetime":"#/components/schemas/FormDatetimeItemDtoV7",
            "numeric":"#/components/schemas/FormNumberItemDtoV7",
            "measurement":"#/components/schemas/FormNumberItemDtoV7",
            "text":"#/components/schemas/FormTextItemDtoV7",
            "choice":"#/components/schemas/FormChoiceItemDtoV7"
        }
    },
    "oneOf":[
        {
            "$ref":"#/components/schemas/FormNumberItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormChoiceItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormTextItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormDatetimeItemDtoV7"
        }
    ]
}

Match One Schema

Show Source

object FormNumberItemDto v7.0

Title: FormNumberItemDto v7.0

Form Number Item Details Information
object FormChoiceItemDto v7.0

Title: FormChoiceItemDto v7.0

Form Choice Item Details Information
object FormTextItemDto v7.0

Title: FormTextItemDto v7.0

Form text Item Details Information
object FormDatetimeItemDto v7.0

Title: FormDatetimeItemDto v7.0

Form DateTime Item Details Information

{
    "title":"FormItemDto v7.0",
    "required":[
        "questionLabel",
        "questionType",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Form Item Unique GUID",
            "format":"uuid"
        },
        "formId":{
            "type":"string",
            "description":"Form Unique GUID",
            "format":"uuid"
        },
        "formTitle":{
            "type":"string",
            "description":"Form title",
            "example":"Demography"
        },
        "questionLabel":{
            "maxLength":"4000",
            "minLength":"1",
            "type":"string",
            "description":"Form question label",
            "example":"Age"
        },
        "questionHint":{
            "maxLength":"4000",
            "minLength":"0",
            "type":"string",
            "description":"Form question hint",
            "example":"What is your age?"
        },
        "randomizationTag":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item should be used for randomization stratification or not.",
            "example":true
        },
        "isStrataFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization stratum or not.",
            "example":false
        },
        "isCohortFactor":{
            "type":"boolean",
            "description":"Flag that indicates whether this form item is used as a factor for randomization cohort or not.",
            "example":false
        },
        "refname":{
            "maxLength":"64",
            "minLength":"1",
            "type":"string",
            "description":"Form item reference name.",
            "example":"NUMBER_01"
        },
        "required":{
            "type":"boolean",
            "description":"Whether this form item is requiered or not.",
            "example":true
        },
        "ruleSet":{
            "type":"string",
            "description":"A JSON-formatted set of rules to do validation of the answers.",
            "example":"{'logicalOperator':'NONE','rules':[],'numberIndex':1}"
        },
        "sdvRequired":{
            "type":"boolean",
            "description":"Source-Documented Verification: Whether proof of the answer required?",
            "example":false
        },
        "sequence":{
            "type":"integer",
            "description":"Item position in the form.",
            "format":"int32",
            "example":"1"
        },
        "smartItemId":{
            "type":"string",
            "description":"Smart item Unique GUID",
            "format":"uuid"
        },
        "formula":{
            "type":"string",
            "description":"Smart item formula.",
            "example":"[{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]"
        },
        "smartObject":{
            "type":"string",
            "description":"Smart object.",
            "example":"AGE"
        },
        "advancedProps":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemAdvancedPropDtoV7"
            }
        },
        "questionType":{
            "type":"string"
        }
    },
    "description":"Form Item Information",
    "discriminator":{
        "propertyName":"questionType",
        "mapping":{
            "datetime":"#/components/schemas/FormDatetimeItemDtoV7",
            "numeric":"#/components/schemas/FormNumberItemDtoV7",
            "measurement":"#/components/schemas/FormNumberItemDtoV7",
            "text":"#/components/schemas/FormTextItemDtoV7",
            "choice":"#/components/schemas/FormChoiceItemDtoV7"
        }
    },
    "oneOf":[
        {
            "$ref":"#/components/schemas/FormNumberItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormChoiceItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormTextItemDtoV7"
        },
        {
            "$ref":"#/components/schemas/FormDatetimeItemDtoV7"
        }
    ]
}

Nested Schema : advancedProps

Type: array

Show Source

Array of: object From Item Advanced Property v7.0

Title: From Item Advanced Property v7.0

Form Item Advanced Property

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/FormItemAdvancedPropDtoV7"
    }
}

Nested Schema : FormNumberItemDto v7.0

Type: object

Title: FormNumberItemDto v7.0

Form Number Item Details Information

Match All

Show Source

object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information
object FormNumberItemDto v7.0-allOf[1]

{
    "title":"FormNumberItemDto v7.0",
    "required":[
        "precision",
        "questionLabel",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "description":"Form Number Item Details Information",
    "allOf":[
        {
            "$ref":"#/components/schemas/FormItemDtoV7"
        },
        {
            "type":"object",
            "properties":{
                "precision":{
                    "minimum":"0",
                    "type":"integer",
                    "description":"Number value precision",
                    "format":"int32",
                    "example":"1"
                },
                "units":{
                    "type":"string",
                    "description":"Units of measure",
                    "example":"kg"
                }
            }
        }
    ]
}

Nested Schema : FormChoiceItemDto v7.0

Type: object

Title: FormChoiceItemDto v7.0

Form Choice Item Details Information

Match All

Show Source

object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information
object FormChoiceItemDto v7.0-allOf[1]

{
    "title":"FormChoiceItemDto v7.0",
    "required":[
        "display",
        "options",
        "questionLabel",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "description":"Form Choice Item Details Information",
    "allOf":[
        {
            "$ref":"#/components/schemas/FormItemDtoV7"
        },
        {
            "type":"object",
            "properties":{
                "display":{
                    "pattern":"selectbox",
                    "type":"string",
                    "description":"Form choice item display in UI - Selectbox.",
                    "example":"selectbox"
                },
                "options":{
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/FormOptionDtoV7"
                    }
                }
            }
        }
    ]
}

Nested Schema : FormTextItemDto v7.0

Type: object

Title: FormTextItemDto v7.0

Form text Item Details Information

Match All

Show Source

object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information
object FormTextItemDto v7.0-allOf[1]

{
    "title":"FormTextItemDto v7.0",
    "required":[
        "maxlength",
        "multiline",
        "questionLabel",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "description":"Form text Item Details Information",
    "allOf":[
        {
            "$ref":"#/components/schemas/FormItemDtoV7"
        },
        {
            "type":"object",
            "properties":{
                "maxlength":{
                    "maximum":"4000",
                    "minimum":"0",
                    "type":"integer",
                    "description":"Form text item max length",
                    "format":"int32",
                    "example":"4000"
                },
                "multiline":{
                    "type":"boolean",
                    "description":"Is form text item multiline",
                    "example":false
                }
            }
        }
    ]
}

Nested Schema : FormDatetimeItemDto v7.0

Type: object

Title: FormDatetimeItemDto v7.0

Form DateTime Item Details Information

Match All

Show Source

object FormItemDto v7.0

Title: FormItemDto v7.0

Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV7", "numeric":"#/components/schemas/FormNumberItemDtoV7", "measurement":"#/components/schemas/FormNumberItemDtoV7", "text":"#/components/schemas/FormTextItemDtoV7", "choice":"#/components/schemas/FormChoiceItemDtoV7" } }

Form Item Information
object FormDatetimeItemDto v7.0-allOf[1]

{
    "title":"FormDatetimeItemDto v7.0",
    "required":[
        "format",
        "questionLabel",
        "refname",
        "required",
        "sdvRequired"
    ],
    "type":"object",
    "description":"Form DateTime Item Details Information",
    "allOf":[
        {
            "$ref":"#/components/schemas/FormItemDtoV7"
        },
        {
            "type":"object",
            "properties":{
                "format":{
                    "pattern":"yyyy|MMM-yyyy|dd-MMM-yyyy|dd-MMM-yyyy HH:mm",
                    "type":"string",
                    "description":"Date time format",
                    "example":"DD-MON-YYYY"
                },
                "allowPartialDate":{
                    "maximum":"1",
                    "minimum":"0",
                    "type":"integer",
                    "description":"Allow partial date",
                    "format":"int32",
                    "example":"1"
                },
                "partialDate":{
                    "pattern":"yyyy|MMM-yyyy",
                    "type":"string",
                    "description":"Partial date format",
                    "example":"Jan-1993"
                }
            }
        }
    ]
}

Nested Schema : From Item Advanced Property v7.0

Type: object

Title: From Item Advanced Property v7.0

Form Item Advanced Property

Show Source

id: string (uuid)

Advanced property id
label: string

Advanced property label in UI, i.e. studyName

Example: Study BT-31
name: string

Advanced property name, mapped to the ECD_EXTENDED_PROPERTIES.PROPERTY_NAME column

Example: RolloverQuestion
parentObjectId: string (uuid)
parentObjectLabel: string
parentObjectLevel: string
rules: array rules
type: string

Advanced property type, mapped to the ECD_EXTENDED_PROPERTIES.RESPONSE_MAP_JSON column 'valueType' field

Example: Dropdown
value: string

Advanced property value of studyId

Example: B1B8327AFAA6412287106192AB5984EF

{
    "title":"From Item Advanced Property v7.0",
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Advanced property id",
            "format":"uuid"
        },
        "type":{
            "type":"string",
            "description":"Advanced property type, mapped to the ECD_EXTENDED_PROPERTIES.RESPONSE_MAP_JSON column 'valueType' field",
            "example":"Dropdown"
        },
        "name":{
            "type":"string",
            "description":"Advanced property name, mapped to the ECD_EXTENDED_PROPERTIES.PROPERTY_NAME column",
            "example":"RolloverQuestion"
        },
        "value":{
            "type":"string",
            "description":"Advanced property value of studyId",
            "example":"B1B8327AFAA6412287106192AB5984EF"
        },
        "label":{
            "type":"string",
            "description":"Advanced property label in UI, i.e. studyName",
            "example":"Study BT-31"
        },
        "rules":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormItemAdvancedPropRuleDtoV7"
            }
        },
        "parentObjectId":{
            "type":"string",
            "format":"uuid"
        },
        "parentObjectLevel":{
            "type":"string"
        },
        "parentObjectLabel":{
            "type":"string"
        }
    },
    "description":"Form Item Advanced Property"
}

Nested Schema : rules

Type: array

Show Source

Array of: object From Item Advanced Property Rule v7.0

Title: From Item Advanced Property Rule v7.0

Form Item Advanced Property Rule

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/FormItemAdvancedPropRuleDtoV7"
    }
}

Nested Schema : From Item Advanced Property Rule v7.0

Type: object

Title: From Item Advanced Property Rule v7.0

Form Item Advanced Property Rule

Show Source

label: string

For RolloverQuestion property it is an ECD_CODELISTITEM.OBJECT_DESCRIPTION

Example: Yes
name: string

name

Example: Answer for Rollover
value: string

For RolloverQuestion property it is an ECD_CODELISTITEM.CODELISTITEM_ID

Example: B1B8327AFAA6412287106192AB5984EF

{
    "title":"From Item Advanced Property Rule v7.0",
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"name",
            "example":"Answer for Rollover"
        },
        "value":{
            "type":"string",
            "description":"For RolloverQuestion property it is an ECD_CODELISTITEM.CODELISTITEM_ID",
            "example":"B1B8327AFAA6412287106192AB5984EF"
        },
        "label":{
            "type":"string",
            "description":"For RolloverQuestion property it is an ECD_CODELISTITEM.OBJECT_DESCRIPTION",
            "example":"Yes"
        }
    },
    "description":"Form Item Advanced Property Rule"
}

Nested Schema : FormNumberItemDto v7.0-allOf[1]

Type: object

Show Source

precision: integer (int32)

Minimum Value: 0

Number value precision

Example: 1
units: string

Units of measure

Example: kg

{
    "type":"object",
    "properties":{
        "precision":{
            "minimum":"0",
            "type":"integer",
            "description":"Number value precision",
            "format":"int32",
            "example":"1"
        },
        "units":{
            "type":"string",
            "description":"Units of measure",
            "example":"kg"
        }
    }
}

Nested Schema : FormChoiceItemDto v7.0-allOf[1]

Type: object

Show Source

display: string

Pattern: selectbox

Form choice item display in UI - Selectbox.

Example: selectbox
options: array options

{
    "type":"object",
    "properties":{
        "display":{
            "pattern":"selectbox",
            "type":"string",
            "description":"Form choice item display in UI - Selectbox.",
            "example":"selectbox"
        },
        "options":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/FormOptionDtoV7"
            }
        }
    }
}

Nested Schema : options

Type: array

Show Source

Array of: object FormOptionDto v7.0

Title: FormOptionDto v7.0

Form choice item option details

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/FormOptionDtoV7"
    }
}

Nested Schema : FormOptionDto v7.0

Type: object

Title: FormOptionDto v7.0

Form choice item option details

Show Source

label: string

Minimum Length: 1

Maximum Length: 4000

Form choice selectbox label for a one specific choice.

Example: Female
value: string

Minimum Length: 1

Maximum Length: 4000

Pattern: [a-zA-Z0-9]+

Form choice selectbox value for a one specific choice.

Example: 1

{
    "title":"FormOptionDto v7.0",
    "type":"object",
    "properties":{
        "label":{
            "maxLength":"4000",
            "minLength":"1",
            "type":"string",
            "description":"Form choice selectbox label for a one specific choice.",
            "example":"Female"
        },
        "value":{
            "maxLength":"4000",
            "minLength":"1",
            "pattern":"[a-zA-Z0-9]+",
            "type":"string",
            "description":"Form choice selectbox value for a one specific choice.",
            "example":"1"
        }
    },
    "description":"Form choice item option details"
}

Nested Schema : FormTextItemDto v7.0-allOf[1]

Type: object

Show Source

maxlength: integer (int32)

Minimum Value: 0

Maximum Value: 4000

Form text item max length

Example: 4000
multiline: boolean

Is form text item multiline

Example: false

{
    "type":"object",
    "properties":{
        "maxlength":{
            "maximum":"4000",
            "minimum":"0",
            "type":"integer",
            "description":"Form text item max length",
            "format":"int32",
            "example":"4000"
        },
        "multiline":{
            "type":"boolean",
            "description":"Is form text item multiline",
            "example":false
        }
    }
}

Nested Schema : FormDatetimeItemDto v7.0-allOf[1]

Type: object

Show Source

allowPartialDate: integer (int32)

Minimum Value: 0

Maximum Value: 1

Allow partial date

Example: 1
format: string

Pattern: yyyy|MMM-yyyy|dd-MMM-yyyy|dd-MMM-yyyy HH:mm

Date time format

Example: DD-MON-YYYY
partialDate: string

Pattern: yyyy|MMM-yyyy

Partial date format

Example: Jan-1993

{
    "type":"object",
    "properties":{
        "format":{
            "pattern":"yyyy|MMM-yyyy|dd-MMM-yyyy|dd-MMM-yyyy HH:mm",
            "type":"string",
            "description":"Date time format",
            "example":"DD-MON-YYYY"
        },
        "allowPartialDate":{
            "maximum":"1",
            "minimum":"0",
            "type":"integer",
            "description":"Allow partial date",
            "format":"int32",
            "example":"1"
        },
        "partialDate":{
            "pattern":"yyyy|MMM-yyyy",
            "type":"string",
            "description":"Partial date format",
            "example":"Jan-1993"
        }
    }
}

500 Response

Error

Root Schema : ErrorResponseData

Type: object

Show Source

details: object details
errorCode: string
errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : details

Type: object