[Deprecated]: Get list of forms in a study
get
/ec-designer-svc/rest/v7.0/studies/{studyId}/versions/{version}/visits/{visitid}/forms
Deprecated: Use latest version instead. Retrieves all forms in a study for a specific study version.
Request
Path Parameters
-
studyId(required): string(uuid)
Study ID. Example: F054C951EB74443C93716CA714AB686E
-
version(required): string
Study version. Example: "1.0.0.1"
-
visitid(required): string(uuid)
Visit GUID.
Query Parameters
-
response: string
Default Value:
summary
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation.
Root Schema : schema
Type:
Show Source
array
-
Array of:
object FormDto v8.0
Title:
FormDto v8.0
Form Info
Nested Schema : FormDto v8.0
Type:
object
Title:
FormDto v8.0
Form Info
Show Source
-
id: string
(uuid)
Form Unique GUID
-
items: array
items
-
refname(required): string
Minimum Length:
1
Maximum Length:64
Form refnameExample:FORM_01
-
repeat: boolean
Form repeating?Example:
false
-
title(required): string
Minimum Length:
1
Maximum Length:64
Form titleExample:Demography
Nested Schema : items
Type:
Show Source
array
-
Array of:
object FormItemDto v8.0
Title:
FormItemDto v8.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV8", "numeric":"#/components/schemas/FormNumberItemDtoV8", "measurement":"#/components/schemas/FormNumberItemDtoV8", "text":"#/components/schemas/FormTextItemDtoV8", "choice":"#/components/schemas/FormChoiceItemDtoV8", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtoV8" } }
Form Item Information
Nested Schema : FormItemDto v8.0
Type:
object
Title:
FormItemDto v8.0
Discriminator: questionType
Discriminator Values
Form Item Information
Show Source
-
advancedProps: array
advancedProps
-
formId: string
(uuid)
Form Unique GUID
-
formTitle: string
Form titleExample:
Demography
-
formula: string
Smart item formula.Example:
[{'ruleName':'AGE','ruleExpression':'AgeInYears(AGE_DOB_01, visitDate)'}]
-
groupSequence: integer
(int32)
Group sequence.
- hidden: boolean
-
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 hintExample:What is your age?
-
questionLabel(required): string
Minimum Length:
1
Maximum Length:4000
Form question labelExample:Age
-
questionType(required): string
-
randomizationTag: boolean
Flag that indicates whether this form item should be used for randomization stratification or not.Example:
true
-
readOnly: boolean
Is form item read only?Example:
false
-
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
Match One Schema
Show Source
-
object
FormNumberItemDto v8.0
Title:
FormNumberItemDto v8.0
Form Number Item Details Information -
object
FormChoiceItemDto v8.0
Title:
FormChoiceItemDto v8.0
Form Choice Item Details Information -
object
FormTextItemDto v8.0
Title:
FormTextItemDto v8.0
Form text Item Details Information -
object
FormDatetimeItemDto v8.0
Title:
FormDatetimeItemDto v8.0
Form DateTime Item Details Information -
object
FormQuestionGroupItemDto v8.0
Title:
FormQuestionGroupItemDto v8.0
Form Question Group Item Details Information
Nested Schema : advancedProps
Type:
Show Source
array
-
Array of:
object From Item Advanced Property v8.0
Title:
From Item Advanced Property v8.0
Form Item Advanced Property
Nested Schema : FormNumberItemDto v8.0
Type:
object
Title:
FormNumberItemDto v8.0
Form Number Item Details Information
Match All
Show Source
-
object
FormItemDto v8.0
Title:
FormItemDto v8.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV8", "numeric":"#/components/schemas/FormNumberItemDtoV8", "measurement":"#/components/schemas/FormNumberItemDtoV8", "text":"#/components/schemas/FormTextItemDtoV8", "choice":"#/components/schemas/FormChoiceItemDtoV8", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtoV8" } }
Form Item Information -
object
FormNumberItemDto v8.0-allOf[1]
Nested Schema : FormChoiceItemDto v8.0
Type:
object
Title:
FormChoiceItemDto v8.0
Form Choice Item Details Information
Match All
Show Source
-
object
FormItemDto v8.0
Title:
FormItemDto v8.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV8", "numeric":"#/components/schemas/FormNumberItemDtoV8", "measurement":"#/components/schemas/FormNumberItemDtoV8", "text":"#/components/schemas/FormTextItemDtoV8", "choice":"#/components/schemas/FormChoiceItemDtoV8", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtoV8" } }
Form Item Information -
object
FormChoiceItemDto v8.0-allOf[1]
Nested Schema : FormTextItemDto v8.0
Type:
object
Title:
FormTextItemDto v8.0
Form text Item Details Information
Match All
Show Source
-
object
FormItemDto v8.0
Title:
FormItemDto v8.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV8", "numeric":"#/components/schemas/FormNumberItemDtoV8", "measurement":"#/components/schemas/FormNumberItemDtoV8", "text":"#/components/schemas/FormTextItemDtoV8", "choice":"#/components/schemas/FormChoiceItemDtoV8", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtoV8" } }
Form Item Information -
object
FormTextItemDto v8.0-allOf[1]
Nested Schema : FormDatetimeItemDto v8.0
Type:
object
Title:
FormDatetimeItemDto v8.0
Form DateTime Item Details Information
Match All
Show Source
-
object
FormItemDto v8.0
Title:
FormItemDto v8.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV8", "numeric":"#/components/schemas/FormNumberItemDtoV8", "measurement":"#/components/schemas/FormNumberItemDtoV8", "text":"#/components/schemas/FormTextItemDtoV8", "choice":"#/components/schemas/FormChoiceItemDtoV8", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtoV8" } }
Form Item Information -
object
FormDatetimeItemDto v8.0-allOf[1]
Nested Schema : FormQuestionGroupItemDto v8.0
Type:
object
Title:
FormQuestionGroupItemDto v8.0
Form Question Group Item Details Information
Match All
Show Source
-
object
FormItemDto v8.0
Title:
FormItemDto v8.0
Discriminator:{ "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtoV8", "numeric":"#/components/schemas/FormNumberItemDtoV8", "measurement":"#/components/schemas/FormNumberItemDtoV8", "text":"#/components/schemas/FormTextItemDtoV8", "choice":"#/components/schemas/FormChoiceItemDtoV8", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtoV8" } }
Form Item Information
Nested Schema : From Item Advanced Property v8.0
Type:
object
Title:
From Item Advanced Property v8.0
Form Item Advanced Property
Show Source
-
id: string
(uuid)
Extended Property ID
-
label: string
Rollover study nameExample:
Rollover Study BT-31
-
name(required): string
Minimum Length:
1
Maximum Length:255
Advanced property nameExample:RolloverQuestionStudyId
-
rules: array
rules
-
value(required): string
Minimum Length:
1
Maximum Length:2048
Advanced property value. For example, rollover study UUIDExample:B1B8327AFAA6412287106192AB5984EF
Nested Schema : rules
Type:
Show Source
array
-
Array of:
object From Item Advanced Property Rule v8.0
Title:
From Item Advanced Property Rule v8.0
Form Item Advanced Property Rule
Nested Schema : From Item Advanced Property Rule v8.0
Type:
object
Title:
From Item Advanced Property Rule v8.0
Form Item Advanced Property Rule
Show Source
-
label: string
For RolloverQuestion property it is an ECDV_CODELISTITEM.VALUEExample:
Yes
-
name: string
nameExample:
RolloverQuestionAnswer
-
value: string
For RolloverQuestion property it is an ECDV_CODELISTITEM.CODELISTITEM_IDExample:
B1B8327AFAA6412287106192AB5984EF
Nested Schema : FormNumberItemDto v8.0-allOf[1]
Type:
Show Source
object
-
precision: integer
(int32)
Minimum Value:
0
Number value precisionExample:1
-
units: string
Units of measureExample:
kg
Nested Schema : FormChoiceItemDto v8.0-allOf[1]
Type:
Show Source
object
-
display: string
Pattern:
selectbox
Form choice item display in UI - Selectbox.Example:selectbox
-
options: array
options
Nested Schema : options
Type:
Show Source
array
-
Array of:
object FormOptionDto v8.0
Title:
FormOptionDto v8.0
Form choice item option details
Nested Schema : FormOptionDto v8.0
Type:
object
Title:
FormOptionDto v8.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
Nested Schema : FormTextItemDto v8.0-allOf[1]
Type:
Show Source
object
-
maxlength: integer
(int32)
Minimum Value:
0
Maximum Value:4000
Form text item max lengthExample:4000
-
multiline: boolean
Is form text item multilineExample:
false
Nested Schema : FormDatetimeItemDto v8.0-allOf[1]
Type:
Show Source
object
-
allowPartialDate: integer
(int32)
Minimum Value:
0
Maximum Value:1
Allow partial dateExample:1
-
format: string
Pattern:
yyyy|MMM-yyyy|dd-MMM-yyyy|dd-MMM-yyyy HH:mm
Date time formatExample:DD-MON-YYYY
-
partialDate: string
Pattern:
yyyy|MMM-yyyy
Partial date formatExample:Jan-1993
500 Response
Error
Nested Schema : details
Type:
object