Schedule an event
Usage
Schedules a single study subject event (visit) in an OpenClinica Study.
NOTE: the scheduleEvent WSDL states that more than one event can be scheduled at a time, however the application will only schedule one event per request. See 13008 for further information.
SOAP XML Request and Response Template
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:v1="http://openclinica.org/ws/event/v1"
xmlns:bean="http://openclinica.org/ws/beans">
${insert header}
<soapenv:Body>
<v1:scheduleRequest>
<v1:event>
<bean:studySubjectRef>
<bean:label>?</bean:label>
</bean:studySubjectRef>
<bean:studyRef>
<bean:identifier>?</bean:identifier>
<!--Optional:-->
<bean:siteRef>
<bean:identifier>?</bean:identifier>
</bean:siteRef>
</bean:studyRef>
<bean:eventDefinitionOID>?</bean:eventDefinitionOID>
<bean:location>?</bean:location>
<bean:startDate>?</bean:startDate>
<!--Optional:-->
<bean:startTime>?</bean:startTime>
<!--Optional:-->
<bean:endDate>?</bean:endDate>
<!--Optional:-->
<bean:endTime>?</bean:endTime>
</v1:event>
</v1:scheduleRequest>
</soapenv:Body>
</soapenv:Envelope>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<scheduleResponse>
<result>success</result>
<eventDefinitionOID>SE_TEST</eventDefinitionOID>
<studySubjectOID>SS_PERSON</studySubjectOID>
<studyEventOrdinal>1</studyEventOrdinal>
</scheduleResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Parameters
Request Parameters
Element | UI | Domain | DB | Validations | Datatypes | Examples | Required |
---|---|---|---|---|---|---|---|
studySubjectRef:label | Study Subject ID | StudySubjectBean:label | study_subject:label | – should be a valid study subject ID | String | <label>SSID001</label> | Y |
eventDefinitionOID | OID (Manage All Event Definitions Screen) | StudyEventDefinitionBean:oid | study_event_definition: oc_oid | – should be a valid event definition OID | String | <eventDefinitionOID>OC_OID</eventDefinitionOID> | Y |
location | Location (Schedule Study Event Screen) | StudyEventBean:location | study_event:location | n/a | String | <location>Waltham</location> | Y |
startDate | Start Date/Time (Schedule Study Event Screen) | StudyEventBean:dateStarted | study_event:date_start | – should be a valid date in the ISO 8601 format | Date | <startDate>2008-12-12</startDate> | Y |
startTime | Start Date/Time (Schedule Study Event Screen) | StudyEventBean:dateStarted | study_event:date_start | – should be a valid time in the ISO 8601 format | Date | <startTime>12:00</startTime> | N |
endDate | End Date/Time (Schedule Study Event Screen) | StudyEventBean:dateEnded | study_event:date_end | – should be a valid date in the ISO 8601 format | Date | <endDate>2008-12-12</endDate> | N |
endTime | End Date/Time (Schedule Study Event Screen) | StudyEventBean:dateEnded | study_event:date_end | – should be a valid time in the ISO 8601 format | Date | <endTime>15:00</endTime> | N |
studyRef:identifier | Unique Protocol ID | StudyBean:identifier | study:unique_identifier | – should be a valid study identifier | String | <identifier>StudyA</identifier> | Y |
siteRef:identifier | Unique Protocol ID | StudyBean:identifier | study:unique_identifier | – should be a valid site identifier | String | <identifier>SiteA</identifier> | N |
Response Parameters
Parameter | UI | Domain | DB | Result on success | Result on fail |
---|---|---|---|---|---|
eventDefinitionOID | OID (Manage All Event Definitions Screen) | StudyEventDefinitionBean:oid | study_event_definition: oc_oid | <eventDefinitionOID>SE_TEST</eventDefinitionOID> | n/a |
studySubjectOID | OID (Subject Matrix) | StudySubjectBean:oid | study_subject:oc_oid | <studySubjectOID>SS_OID</studySubjectOID> | n/a |
studyEventOrdinal | Event (Occurrence Number) – (View Subject Screen | StudyEventBean:ordinal | study_event:sample_ordinal | <studyEventOrdinal>1</studyEventOrdinal> | n/a |
result | n/a | n/a | n/a | <result>Success</result> | <result>Fail</result> |
warning | n/a | n/a | n/a | n/a | |
error | n/a | n/a | n/a | n/a | <error>An error message indicating reason of failure</error> |