Add form in a study version

post

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

Adds a form in a study version.

Request

Path Parameters
Supported Media Types
Request Body - */* ()
Root Schema : FormDto v15.0
Type: object
Title: FormDto v15.0
Form Info
Show Source
Nested Schema : assignedVisits
Type: array
branch cycle information describing the visits on which the forms are displayed
Show Source
Nested Schema : items
Type: array
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
Nested Schema : linkFrom
Type: array
linked from forms
Show Source
Nested Schema : showFrom
Type: array
show dynamic parent from forms of same visit
Show Source
Nested Schema : FormCopySourceDto v15.0
Type: object
Title: FormCopySourceDto v15.0
Form Copy Source Information
Show Source
Nested Schema : From Item Advanced Property With Parent v15.0
Type: object
Title: From Item Advanced Property With Parent v15.0
Form Item Advanced Property with Parent Info
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : From Item Advanced Property Rule v15.0
Type: object
Title: From Item Advanced Property Rule v15.0
Form Item Advanced Property Rule
Show Source
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.VALUE
    Example: Yes
  • name
    Example: RolloverQuestionAnswer
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.CODELISTITEM_ID
    Example: B1B8327AFAA6412287106192AB5984EF
Nested Schema : FormItemDto v15.0
Type: object
Title: FormItemDto v15.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : dataClassificationIds
Type: array
Show Source
Nested Schema : FormNumberItemDto v15.0
Type: object
Title: FormNumberItemDto v15.0
Form Number Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormNumberItemDto v15.0-allOf[1]
Nested Schema : FormChoiceItemDto v15.0
Type: object
Title: FormChoiceItemDto v15.0
Form Choice Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormChoiceItemDto v15.0-allOf[1]
Nested Schema : FormTextItemDto v15.0
Type: object
Title: FormTextItemDto v15.0
Form text Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormTextItemDto v15.0-allOf[1]
Nested Schema : FormDatetimeItemDto v15.0
Type: object
Title: FormDatetimeItemDto v15.0
Form DateTime Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormDatetimeItemDto v15.0-allOf[1]
Nested Schema : FormQuestionGroupItemDto v15.0
Type: object
Title: FormQuestionGroupItemDto v15.0
Form Question Group Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
Nested Schema : FormTableItemDto v15.0
Type: object
Title: FormTableItemDto v15.0
Form table Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormTableItemDto v15.0-allOf[1]
Nested Schema : FormLabelItemDto
Type: object
Match All
Show Source
  • FormItemDto v16.0
    Title: FormItemDto v16.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov16", "numeric":"#/components/schemas/FormNumberItemDtov16", "measurement":"#/components/schemas/FormNumberItemDtov16", "text":"#/components/schemas/FormTextItemDtov16", "choice":"#/components/schemas/FormChoiceItemDtov16", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov16", "table":"#/components/schemas/FormTableItemDtov16", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormLabelItemDto-allOf[1]
Nested Schema : From Item Advanced Property v15.0
Type: object
Title: From Item Advanced Property v15.0
Form Item Advanced Property
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : FormNumberItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : FormChoiceItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : options
Type: array
Show Source
Nested Schema : FormOptionDto v15.0
Type: object
Title: FormOptionDto v15.0
Form choice item option details
Show Source
  • Codelist code for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Codelist description for a one specific choice.
    Example: 1
  • Codelist value for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox label for a one specific choice.
    Example: Female
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox value for a one specific choice.
    Example: 1
Nested Schema : FormTextItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : FormDatetimeItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : FormTableItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : FormItemDto v16.0
Type: object
Title: FormItemDto v16.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : FormLabelItemDto-allOf[1]
Type: object
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : options
Type: array
Show Source
Nested Schema : From Item Advanced Property With Parent v16.0
Type: object
Title: From Item Advanced Property With Parent v16.0
Form Item Advanced Property with Parent Info
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : From Item Advanced Property Rule v16.0
Type: object
Title: From Item Advanced Property Rule v16.0
Form Item Advanced Property Rule
Show Source
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.VALUE
    Example: Yes
  • name
    Example: RolloverQuestionAnswer
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.CODELISTITEM_ID
    Example: B1B8327AFAA6412287106192AB5984EF
Nested Schema : FormOptionDto v16.0
Type: object
Title: FormOptionDto v16.0
Form choice item option details
Show Source
  • Codelist code for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Codelist description for a one specific choice.
    Example: 1
  • Codelist value for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox label for a one specific choice.
    Example: Female
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox value for a one specific choice.
    Example: 1
Nested Schema : FormLinkFromDto v15.0
Type: object
Title: FormLinkFromDto v15.0
Linked From Form Details
Show Source
Nested Schema : items
Type: array
Form items
Show Source
Nested Schema : parentAssignedVisits
Type: array
Parent Assigned Visits
Show Source
Back to Top

Response

Supported Media Types

200 Response

Successful operation.
Body ()
Root Schema : FormDto v15.0
Type: object
Title: FormDto v15.0
Form Info
Show Source
Nested Schema : assignedVisits
Type: array
branch cycle information describing the visits on which the forms are displayed
Show Source
Nested Schema : items
Type: array
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
Nested Schema : linkFrom
Type: array
linked from forms
Show Source
Nested Schema : showFrom
Type: array
show dynamic parent from forms of same visit
Show Source
Nested Schema : FormCopySourceDto v15.0
Type: object
Title: FormCopySourceDto v15.0
Form Copy Source Information
Show Source
Nested Schema : From Item Advanced Property With Parent v15.0
Type: object
Title: From Item Advanced Property With Parent v15.0
Form Item Advanced Property with Parent Info
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : From Item Advanced Property Rule v15.0
Type: object
Title: From Item Advanced Property Rule v15.0
Form Item Advanced Property Rule
Show Source
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.VALUE
    Example: Yes
  • name
    Example: RolloverQuestionAnswer
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.CODELISTITEM_ID
    Example: B1B8327AFAA6412287106192AB5984EF
Nested Schema : FormItemDto v15.0
Type: object
Title: FormItemDto v15.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : dataClassificationIds
Type: array
Show Source
Nested Schema : FormNumberItemDto v15.0
Type: object
Title: FormNumberItemDto v15.0
Form Number Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormNumberItemDto v15.0-allOf[1]
Nested Schema : FormChoiceItemDto v15.0
Type: object
Title: FormChoiceItemDto v15.0
Form Choice Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormChoiceItemDto v15.0-allOf[1]
Nested Schema : FormTextItemDto v15.0
Type: object
Title: FormTextItemDto v15.0
Form text Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormTextItemDto v15.0-allOf[1]
Nested Schema : FormDatetimeItemDto v15.0
Type: object
Title: FormDatetimeItemDto v15.0
Form DateTime Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormDatetimeItemDto v15.0-allOf[1]
Nested Schema : FormQuestionGroupItemDto v15.0
Type: object
Title: FormQuestionGroupItemDto v15.0
Form Question Group Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
Nested Schema : FormTableItemDto v15.0
Type: object
Title: FormTableItemDto v15.0
Form table Item Details Information
Match All
Show Source
  • FormItemDto v15.0
    Title: FormItemDto v15.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov15", "numeric":"#/components/schemas/FormNumberItemDtov15", "measurement":"#/components/schemas/FormNumberItemDtov15", "text":"#/components/schemas/FormTextItemDtov15", "choice":"#/components/schemas/FormChoiceItemDtov15", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov15", "table":"#/components/schemas/FormTableItemDtov15", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormTableItemDto v15.0-allOf[1]
Nested Schema : FormLabelItemDto
Type: object
Match All
Show Source
  • FormItemDto v16.0
    Title: FormItemDto v16.0
    Discriminator: { "propertyName":"questionType", "mapping":{ "datetime":"#/components/schemas/FormDatetimeItemDtov16", "numeric":"#/components/schemas/FormNumberItemDtov16", "measurement":"#/components/schemas/FormNumberItemDtov16", "text":"#/components/schemas/FormTextItemDtov16", "choice":"#/components/schemas/FormChoiceItemDtov16", "questionGroup":"#/components/schemas/FormQuestionGroupItemDtov16", "table":"#/components/schemas/FormTableItemDtov16", "label":"#/components/schemas/FormLabelItemDto" } }
    Form Item Information
  • FormLabelItemDto-allOf[1]
Nested Schema : From Item Advanced Property v15.0
Type: object
Title: From Item Advanced Property v15.0
Form Item Advanced Property
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : FormNumberItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : FormChoiceItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : options
Type: array
Show Source
Nested Schema : FormOptionDto v15.0
Type: object
Title: FormOptionDto v15.0
Form choice item option details
Show Source
  • Codelist code for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Codelist description for a one specific choice.
    Example: 1
  • Codelist value for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox label for a one specific choice.
    Example: Female
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox value for a one specific choice.
    Example: 1
Nested Schema : FormTextItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : FormDatetimeItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : FormTableItemDto v15.0-allOf[1]
Type: object
Show Source
Nested Schema : FormItemDto v16.0
Type: object
Title: FormItemDto v16.0
Discriminator: questionType

Discriminator Values

Form Item Information
Show Source
Match One Schema
Show Source
Nested Schema : FormLabelItemDto-allOf[1]
Type: object
Show Source
Nested Schema : advancedProps
Type: array
Show Source
Nested Schema : options
Type: array
Show Source
Nested Schema : From Item Advanced Property With Parent v16.0
Type: object
Title: From Item Advanced Property With Parent v16.0
Form Item Advanced Property with Parent Info
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : From Item Advanced Property Rule v16.0
Type: object
Title: From Item Advanced Property Rule v16.0
Form Item Advanced Property Rule
Show Source
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.VALUE
    Example: Yes
  • name
    Example: RolloverQuestionAnswer
  • For RolloverQuestion property it is an ECDV_CODELISTITEM.CODELISTITEM_ID
    Example: B1B8327AFAA6412287106192AB5984EF
Nested Schema : FormOptionDto v16.0
Type: object
Title: FormOptionDto v16.0
Form choice item option details
Show Source
  • Codelist code for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Codelist description for a one specific choice.
    Example: 1
  • Codelist value for a one specific choice.
    Example: 1
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox label for a one specific choice.
    Example: Female
  • Minimum Length: 1
    Maximum Length: 4000
    Form choice selectbox value for a one specific choice.
    Example: 1
Nested Schema : FormLinkFromDto v15.0
Type: object
Title: FormLinkFromDto v15.0
Linked From Form Details
Show Source
Nested Schema : items
Type: array
Form items
Show Source
Nested Schema : parentAssignedVisits
Type: array
Parent Assigned Visits
Show Source

500 Response

Error
Body ()
Root Schema : ErrorResponseData
Type: object
Show Source
Nested Schema : details
Type: object
Back to Top