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

ElementUIDomainDBValidationsDatatypesExamplesRequired
studySubjectRef:labelStudy Subject IDStudySubjectBean:labelstudy_subject:label

– should be a valid study subject ID

String<label>SSID001</label>Y
eventDefinitionOIDOID (Manage All Event Definitions Screen)StudyEventDefinitionBean:oidstudy_event_definition: oc_oid– should be a valid event definition OIDString<eventDefinitionOID>OC_OID</eventDefinitionOID>Y
locationLocation (Schedule Study Event Screen)StudyEventBean:locationstudy_event:locationn/aString<location>Waltham</location>Y
startDateStart Date/Time (Schedule Study Event Screen)StudyEventBean:dateStartedstudy_event:date_start– should be a valid date in the ISO 8601 formatDate<startDate>2008-12-12</startDate>Y
startTimeStart Date/Time (Schedule Study Event Screen)StudyEventBean:dateStartedstudy_event:date_start– should be a valid time in the ISO 8601 formatDate<startTime>12:00</startTime>N
endDateEnd Date/Time (Schedule Study Event Screen)StudyEventBean:dateEndedstudy_event:date_end– should be a valid date in the ISO 8601 formatDate<endDate>2008-12-12</endDate>N
endTimeEnd Date/Time (Schedule Study Event Screen)StudyEventBean:dateEndedstudy_event:date_end– should be a valid time in the ISO 8601 formatDate<endTime>15:00</endTime>N
studyRef:identifierUnique Protocol IDStudyBean:identifierstudy:unique_identifier

– should be a valid study identifier

String<identifier>StudyA</identifier>Y
siteRef:identifierUnique Protocol IDStudyBean:identifierstudy:unique_identifier

– should be a valid site identifier

String<identifier>SiteA</identifier>N

 

Response Parameters

 
ParameterUIDomainDBResult on successResult on fail
eventDefinitionOIDOID (Manage All Event Definitions Screen)StudyEventDefinitionBean:oidstudy_event_definition: oc_oid<eventDefinitionOID>SE_TEST</eventDefinitionOID>n/a
studySubjectOIDOID (Subject Matrix)StudySubjectBean:oidstudy_subject:oc_oid<studySubjectOID>SS_OID</studySubjectOID>n/a
studyEventOrdinalEvent (Occurrence Number) – (View Subject ScreenStudyEventBean:ordinalstudy_event:sample_ordinal<studyEventOrdinal>1</studyEventOrdinal>n/a
resultn/an/an/a<result>Success</result><result>Fail</result>
warningn/an/an/a n/a
errorn/an/an/an/a<error>An error message indicating reason of failure</error>