Create study design visits for multiple versions
post
/ec-designer-svc/rest/v9.0/studies/{studyId}/design
Creates list of visits for multiple versions in a study's design.
Request
Path Parameters
-
studyId(required): string(uuid)
Study ID. Example: F054C951EB74443C93716CA714AB686E
Query Parameters
-
isLiteAPI: boolean
If true, generate light version of the API.Default Value:
true
Supported Media Types
- */*
Response
Supported Media Types
- application/json
200 Response
Successful operation.
Root Schema : schema
Type:
Show Source
array-
Array of:
object VisitBranchDesignDtoV9
Visit Design branches
Nested Schema : VisitBranchDesignDtoV9
Type:
objectVisit Design branches
Show Source
-
branchVisits: array
branchVisits
branches
-
scheduledVisits: array
scheduledVisits
scheduledVisits
-
unscheduledVisits: array
unscheduledVisits
unscheduledVisits
Nested Schema : scheduledVisits
Type:
arrayscheduledVisits
Show Source
-
Array of:
object VisitDesignDto v9.0
Title:
VisitDesignDto v9.0Visit Design Information
Nested Schema : unscheduledVisits
Type:
arrayunscheduledVisits
Show Source
-
Array of:
object VisitDesignDto v9.0
Title:
VisitDesignDto v9.0Visit Design Information
Nested Schema : items
Type:
arraybranches
Show Source
-
Array of:
object BranchDesignDTOV9
Branch Design properties
Nested Schema : BranchDesignDTOV9
Type:
objectBranch Design properties
Show Source
-
branch: object
VisitBranchDto v2.0
Title:
VisitBranchDto v2.0Visit Branch details. -
visits: array
visits
The visits in this branch
Nested Schema : VisitBranchDto v2.0
Type:
objectTitle:
VisitBranchDto v2.0Visit Branch details.
Show Source
-
arms: array
arms
Arm Details DTO
-
branchIndex: integer
(int32)
index information of the branch in the tierExample:
10 -
branchTier: integer
(int32)
tier information of the branchExample:
10 -
cycleCount: number
number of times a branch can cycleExample:
10 -
forms: array
forms
Form Details DTO
-
formVisits: array
formVisits
Visit Details DTO
-
id: string
(uuid)
Visit Branch GUID
-
isCycle(required): boolean
determines if the branch is cyclic or acyclicExample:
true -
isRestartCycle: boolean
determines if the branch is cycles needs a restart of the cycle countExample:
true -
shortName(required): string
Minimum Length:
1Maximum Length:32Visit Branch shortNameExample:Br2 -
startCycle: integer
(int32)
Start Cycle Number
-
title(required): string
Minimum Length:
1Maximum Length:64Visit Branch titleExample:Branch 2
Nested Schema : visits
Type:
arrayThe visits in this branch
Show Source
-
Array of:
object VisitDesignDto v9.0
Title:
VisitDesignDto v9.0Visit Design Information
Nested Schema : arms
Type:
arrayArm Details DTO
Show Source
-
Array of:
object From Item Advanced Property v11.0
Title:
From Item Advanced Property v11.0Form Item Advanced Property
Nested Schema : forms
Type:
arrayForm Details DTO
Show Source
-
Array of:
object From Item Advanced Property v11.0
Title:
From Item Advanced Property v11.0Form Item Advanced Property
Nested Schema : formVisits
Type:
arrayVisit Details DTO
Show Source
-
Array of:
object From Item Advanced Property v11.0
Title:
From Item Advanced Property v11.0Form Item Advanced Property
Nested Schema : From Item Advanced Property v11.0
Type:
objectTitle:
From Item Advanced Property v11.0Form 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:
1Maximum Length:255Advanced property nameExample:RolloverQuestionStudyId -
rules: array
rules
-
value(required): string
Minimum Length:
1Maximum Length:2048Advanced property value. For example, rollover study UUIDExample:B1B8327AFAA6412287106192AB5984EF
Nested Schema : rules
Type:
Show Source
array-
Array of:
object From Item Advanced Property Rule v11.0
Title:
From Item Advanced Property Rule v11.0Form Item Advanced Property Rule
Nested Schema : From Item Advanced Property Rule v11.0
Type:
objectTitle:
From Item Advanced Property Rule v11.0Form 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 : VisitDesignDto v9.0
Type:
objectTitle:
VisitDesignDto v9.0Visit Design Information
Show Source
-
branchId: string
(uuid)
The id of the branch
-
dispensings: object
VisitDesignDispensingDto v9.0
Title:
VisitDesignDispensingDto v9.0Visit Design dispensing properties -
endVisitId: string
(uuid)
Visit design End Visit Id
-
eventType: string
Visit Design event typeExample:
ScreeningVisit -
forms: object
VisitDesignAssignedFormsDto v9.0
Title:
VisitDesignAssignedFormsDto v9.0Visit Design assigned forms properties -
id: string
(uuid)
Visit Design unique GUID
-
randomization: object
VisitDesignRandomizationDto v9.0
Title:
VisitDesignRandomizationDto v9.0Visit Design randomization properties -
scheduling: object
VisitDesignSchedulingDto v9.0
Title:
VisitDesignSchedulingDto v9.0Visit Design scheduling properties -
shortName: string
Visit Design short nameExample:
Week1 -
startVisitId: string
(uuid)
Visit Design Start Visit Id
-
state: object
VisitDesignStateDto v9.0
Title:
VisitDesignStateDto v9.0Visit Design state properties -
title: string
Visit design titleExample:
Week1
Nested Schema : VisitDesignDispensingDto v9.0
Type:
objectTitle:
VisitDesignDispensingDto v9.0Visit Design dispensing properties
Show Source
-
deviceCount: integer
(int32)
Visit Design device countExample:
1 -
id: integer
(int32)
Visit Design titration countExample:
1
Nested Schema : VisitDesignAssignedFormsDto v9.0
Type:
objectTitle:
VisitDesignAssignedFormsDto v9.0Visit Design assigned forms properties
Show Source
-
id: integer
(int32)
Visit Design assigned forms countExample:
1
Nested Schema : VisitDesignRandomizationDto v9.0
Type:
objectTitle:
VisitDesignRandomizationDto v9.0Visit Design randomization properties
Show Source
-
algorithmType: string
Visit Design allow randomization algorithm typeExample:
1 -
id: string
(uuid)
Visit Design randomization unique GUID
-
treatmentArms: string
Visit Design allow randomization treatment arms to be remappedExample:
1 -
type: string
Visit Design randomization typeExample:
1 -
visits: array
visits
Visit Design randomization visit GUID's
Nested Schema : VisitDesignSchedulingDto v9.0
Type:
objectTitle:
VisitDesignSchedulingDto v9.0Visit Design scheduling properties
Show Source
-
afterDelayWindow: object
Delay
Visit Design cheduing before delay
-
beforeDelayWindow: object
Delay
Visit Design cheduing before delay
-
branchId: string
(uuid)
bbranch GUID
-
delay: object
Delay
Visit Design cheduing before delay
-
fromVisitId: string
(uuid)
Visit Design from visit GUID
-
outOfWindowAlert: string
(string)
Outside Visit Window AlertExample:
OFF
Nested Schema : VisitDesignStateDto v9.0
Type:
objectTitle:
VisitDesignStateDto v9.0Visit Design state properties
Show Source
-
dynamic: boolean
Visit Design dynamic stateExample:
false -
lastRequired: boolean
Visit Design lastRequired stateExample:
false -
repeating: boolean
Visit Design repeating stateExample:
false -
required: boolean
Visit Design required stateExample:
true -
timeLine: integer
(int32)
show in timeline. allows the designer to set when a visit can be shown to a user.Example:
1
Nested Schema : visits
Type:
arrayVisit Design randomization visit GUID's
Show Source
-
Array of:
string(uuid)
Visit Design randomization visit GUID's
Example:
55C8628FB6594912B3214E294A5D4E9FNested Schema : Delay
Type:
objectVisit Design cheduing before delay
Show Source
-
days: integer
(int32)
Minimum Value:
0Maximum Value:365 -
hours: integer
(int32)
Minimum Value:
0Maximum Value:24
204 Response
Successful operation.
Root Schema : schema
Type:
Show Source
array-
Array of:
object VisitBranchDesignDtoV9
Visit Design branches
Nested Schema : VisitBranchDesignDtoV9
Type:
objectVisit Design branches
Show Source
-
branchVisits: array
branchVisits
branches
-
scheduledVisits: array
scheduledVisits
scheduledVisits
-
unscheduledVisits: array
unscheduledVisits
unscheduledVisits
Nested Schema : scheduledVisits
Type:
arrayscheduledVisits
Show Source
-
Array of:
object VisitDesignDto v9.0
Title:
VisitDesignDto v9.0Visit Design Information
Nested Schema : unscheduledVisits
Type:
arrayunscheduledVisits
Show Source
-
Array of:
object VisitDesignDto v9.0
Title:
VisitDesignDto v9.0Visit Design Information
Nested Schema : items
Type:
arraybranches
Show Source
-
Array of:
object BranchDesignDTOV9
Branch Design properties
Nested Schema : BranchDesignDTOV9
Type:
objectBranch Design properties
Show Source
-
branch: object
VisitBranchDto v2.0
Title:
VisitBranchDto v2.0Visit Branch details. -
visits: array
visits
The visits in this branch
Nested Schema : VisitBranchDto v2.0
Type:
objectTitle:
VisitBranchDto v2.0Visit Branch details.
Show Source
-
arms: array
arms
Arm Details DTO
-
branchIndex: integer
(int32)
index information of the branch in the tierExample:
10 -
branchTier: integer
(int32)
tier information of the branchExample:
10 -
cycleCount: number
number of times a branch can cycleExample:
10 -
forms: array
forms
Form Details DTO
-
formVisits: array
formVisits
Visit Details DTO
-
id: string
(uuid)
Visit Branch GUID
-
isCycle(required): boolean
determines if the branch is cyclic or acyclicExample:
true -
isRestartCycle: boolean
determines if the branch is cycles needs a restart of the cycle countExample:
true -
shortName(required): string
Minimum Length:
1Maximum Length:32Visit Branch shortNameExample:Br2 -
startCycle: integer
(int32)
Start Cycle Number
-
title(required): string
Minimum Length:
1Maximum Length:64Visit Branch titleExample:Branch 2
Nested Schema : visits
Type:
arrayThe visits in this branch
Show Source
-
Array of:
object VisitDesignDto v9.0
Title:
VisitDesignDto v9.0Visit Design Information
Nested Schema : arms
Type:
arrayArm Details DTO
Show Source
-
Array of:
object From Item Advanced Property v11.0
Title:
From Item Advanced Property v11.0Form Item Advanced Property
Nested Schema : forms
Type:
arrayForm Details DTO
Show Source
-
Array of:
object From Item Advanced Property v11.0
Title:
From Item Advanced Property v11.0Form Item Advanced Property
Nested Schema : formVisits
Type:
arrayVisit Details DTO
Show Source
-
Array of:
object From Item Advanced Property v11.0
Title:
From Item Advanced Property v11.0Form Item Advanced Property
Nested Schema : From Item Advanced Property v11.0
Type:
objectTitle:
From Item Advanced Property v11.0Form 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:
1Maximum Length:255Advanced property nameExample:RolloverQuestionStudyId -
rules: array
rules
-
value(required): string
Minimum Length:
1Maximum Length:2048Advanced property value. For example, rollover study UUIDExample:B1B8327AFAA6412287106192AB5984EF
Nested Schema : rules
Type:
Show Source
array-
Array of:
object From Item Advanced Property Rule v11.0
Title:
From Item Advanced Property Rule v11.0Form Item Advanced Property Rule
Nested Schema : From Item Advanced Property Rule v11.0
Type:
objectTitle:
From Item Advanced Property Rule v11.0Form 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 : VisitDesignDto v9.0
Type:
objectTitle:
VisitDesignDto v9.0Visit Design Information
Show Source
-
branchId: string
(uuid)
The id of the branch
-
dispensings: object
VisitDesignDispensingDto v9.0
Title:
VisitDesignDispensingDto v9.0Visit Design dispensing properties -
endVisitId: string
(uuid)
Visit design End Visit Id
-
eventType: string
Visit Design event typeExample:
ScreeningVisit -
forms: object
VisitDesignAssignedFormsDto v9.0
Title:
VisitDesignAssignedFormsDto v9.0Visit Design assigned forms properties -
id: string
(uuid)
Visit Design unique GUID
-
randomization: object
VisitDesignRandomizationDto v9.0
Title:
VisitDesignRandomizationDto v9.0Visit Design randomization properties -
scheduling: object
VisitDesignSchedulingDto v9.0
Title:
VisitDesignSchedulingDto v9.0Visit Design scheduling properties -
shortName: string
Visit Design short nameExample:
Week1 -
startVisitId: string
(uuid)
Visit Design Start Visit Id
-
state: object
VisitDesignStateDto v9.0
Title:
VisitDesignStateDto v9.0Visit Design state properties -
title: string
Visit design titleExample:
Week1
Nested Schema : VisitDesignDispensingDto v9.0
Type:
objectTitle:
VisitDesignDispensingDto v9.0Visit Design dispensing properties
Show Source
-
deviceCount: integer
(int32)
Visit Design device countExample:
1 -
id: integer
(int32)
Visit Design titration countExample:
1
Nested Schema : VisitDesignAssignedFormsDto v9.0
Type:
objectTitle:
VisitDesignAssignedFormsDto v9.0Visit Design assigned forms properties
Show Source
-
id: integer
(int32)
Visit Design assigned forms countExample:
1
Nested Schema : VisitDesignRandomizationDto v9.0
Type:
objectTitle:
VisitDesignRandomizationDto v9.0Visit Design randomization properties
Show Source
-
algorithmType: string
Visit Design allow randomization algorithm typeExample:
1 -
id: string
(uuid)
Visit Design randomization unique GUID
-
treatmentArms: string
Visit Design allow randomization treatment arms to be remappedExample:
1 -
type: string
Visit Design randomization typeExample:
1 -
visits: array
visits
Visit Design randomization visit GUID's
Nested Schema : VisitDesignSchedulingDto v9.0
Type:
objectTitle:
VisitDesignSchedulingDto v9.0Visit Design scheduling properties
Show Source
-
afterDelayWindow: object
Delay
Visit Design cheduing before delay
-
beforeDelayWindow: object
Delay
Visit Design cheduing before delay
-
branchId: string
(uuid)
bbranch GUID
-
delay: object
Delay
Visit Design cheduing before delay
-
fromVisitId: string
(uuid)
Visit Design from visit GUID
-
outOfWindowAlert: string
(string)
Outside Visit Window AlertExample:
OFF
Nested Schema : VisitDesignStateDto v9.0
Type:
objectTitle:
VisitDesignStateDto v9.0Visit Design state properties
Show Source
-
dynamic: boolean
Visit Design dynamic stateExample:
false -
lastRequired: boolean
Visit Design lastRequired stateExample:
false -
repeating: boolean
Visit Design repeating stateExample:
false -
required: boolean
Visit Design required stateExample:
true -
timeLine: integer
(int32)
show in timeline. allows the designer to set when a visit can be shown to a user.Example:
1
Nested Schema : visits
Type:
arrayVisit Design randomization visit GUID's
Show Source
-
Array of:
string(uuid)
Visit Design randomization visit GUID's
Example:
55C8628FB6594912B3214E294A5D4E9FNested Schema : Delay
Type:
objectVisit Design cheduing before delay
Show Source
-
days: integer
(int32)
Minimum Value:
0Maximum Value:365 -
hours: integer
(int32)
Minimum Value:
0Maximum Value:24
500 Response
Error
Nested Schema : details
Type:
object