Create an open query
post
/ec-query-svc/rest/v9.0/studies/{studyId}/{mode}/queries/open
Creates a new query with the status Open.
Request
Path Parameters
-
mode(required): string
Study mode.
-
studyId(required): string
Study ID.
Supported Media Types
- application/json
Root Schema : QueryDTO Version 9
Type:
object
Title:
QueryDTO Version 9
Information for creating/editing query
Show Source
-
dataElementId: string
(uuid)
Data element Unique GUID
-
discrepancyId: integer
Discrepancy Id
-
eventId: string
(uuid)
Event Unique GUID
-
eventInstanceNumber: number
Sequence number (0, 1, 2, ...) of repeating eventExample:
0
-
formId: string
(uuid)
Form Unique GUID
-
formInstanceNumber: number
Sequence number (0, 1, 2, ...) of repeating formExample:
0
-
id: string
(uuid)
Query Unique GUID
-
itemId: string
(uuid)
Item Unique GUID
-
objectVersionNumber: number
Sequence number (0, 1, 2, ...) of object Version NumberExample:
0
-
propertyName: string
-
propertyType: string
-
queryComment(required): string
Minimum Length:
1
Maximum Length:2048
Query commentsExample:Comment
-
repeatFormNumber: integer
Repeat Form Number
-
siteId: string
(uuid)
Site Unique GUID
-
studyRoles: array
studyRoles
List of study roles ids
-
studyVersionStart: string
(date-time)
Data element Version Start
-
subjectId: string
(uuid)
Subject Unique GUID
-
userDisplayName: string
First and last name of query creator or user who modified queryExample:
John Doe
Nested Schema : studyRoles
Type:
array
List of study roles ids
Show Source
-
Array of:
string(uuid)
List of study roles ids
Example:
[
"6AF54DB79B764662B685D68C52AB0B84",
"6AF54DB79B764662B685D68C52AB0B84"
]
Response
Supported Media Types
- application/json
200 Response
Successful operation.
Root Schema : QueryDTO Version 9
Type:
object
Title:
QueryDTO Version 9
Information for returned from updating/inserting query
Show Source
-
dataElementId: string
(uuid)
Data element Unique GUID
-
discrepancyId: integer
Discrepancy Id
-
eventId: string
(uuid)
Event Unique GUID
-
eventInstanceNumber: number
Sequence number (0, 1, 2, ...) of repeating eventExample:
0
-
formId: string
(uuid)
Form Unique GUID
-
formInstanceNumber: number
Sequence number (0, 1, 2, ...) of repeating formExample:
0
-
id: string
(uuid)
Query Unique GUID
-
isQueryCreator: boolean
-
itemId: string
(uuid)
Item Unique GUID
-
objectVersionNumber: number
Sequence number (0, 1, 2, ...) of object Version NumberExample:
0
-
propertyName: string
-
propertyType: string
-
queryComment(required): string
Minimum Length:
1
Maximum Length:2048
Query commentsExample:Comment
-
repeatFormNumber: integer
Repeat Form Number
-
ruleId: string
(uuid)
-
siteId: string
(uuid)
Site Unique GUID
-
state: string
Query stateExample:
Opened
-
studyRoles: array
studyRoles
-
studyVersionStart: string
(date-time)
Data element Version Start
-
subjectId: string
(uuid)
Subject Unique GUID
400 Response
Data is invalid.
Root Schema : Response DTO
Type:
object
Response from Query APIs
Show Source
-
errorData: object
Error details DTO
Read Only:
true
Error details from Query APIs -
result: object
result
Read Only:
true
Result Object -
status: string
Read Only:
true
Allowed Values:[ "success, failed" ]
Status -
version: string
Read Only:
true
Response version
Nested Schema : Error details DTO
Type:
object
Read Only:
true
Error details from Query APIs
Show Source
-
details: object
details
Read Only:
true
Error Details -
errorCode: string
Read Only:
true
Error Code -
errorMessage: string
Read Only:
true
Error Message
Nested Schema : result
Type:
object
Read Only:
true
Result Object
Nested Schema : details
Type:
object
Read Only:
true
Error Details