CheckWare partner API reference guide

Datatypes

OverviewDatatypesWebservice operationsChangelog

assessmentInstance

An assessment instance represents an assessment issued to a respondent. The
instance keeps track of scheduling and status of that particular assessment.

Grouping method: sequence
Multiplicity: 1 .. 1

ElementMultiplicityTypeRestrictionDescription
assessmentInstanceID1 .. 1assessmentInstanceID 


The unique identifier for this assessment
instance.

assessmentID1 .. 1assessmentID 


The identifier for the assessment.

respondentID1 .. 1respondentID 


The identifier for the respondent.

treatmentInstanceID0 .. 1treatmentInstanceID 


The identifier for the treatment.

treatmentInstanceRoleID0 .. 1treatmentInstanceRoleID 


If you want to add assessment to role, use this parameter to get role of this type.

assessmentName0 .. 1string 


The name of the assessment.

This is not required when adding data - the
assessment ID will be used. When retreiving data
this will always be present to ease use of
result.

lastModified1 .. 1dateTime 

The date and time for when this assessment instance was last modified.

issueDate1 .. 1dateTime 


The date and time when the assessmentInstance
was created (issued to respondent).

startDate1 .. 1date 


The assessment is available in the respondent
GUI from the start date and forwards.

By controlling the start date you can create a
series of assessment instances that will appear
at the given time in the respondent GUI.

ExpireDate1 .. 1date 


The assessment instance expire date is the date
where alerts will be displayed if the assessment
instance is not completed.

isCompleted1 .. 1boolean 


If an assessment instance is completed
(delivered by respondent) the assessment
instance is no longer visible for the respondent
and reports can be generated on the data.

completedDate0 .. 1dateTime 


If the assessment is completed the completedDate
will be populated with the timestamp
representing the time it was completed by the
respondent.

startDateTime0 .. 1dateTime 


The assessment is available in the respondent
GUI from the start date and forwards.

By controlling the start date you can create a
series of assessment instances that will appear
at the given time in the respondent GUI.

By this field you can controll not only date but time as well. It overwrite startDate
field.

Format must be concurring with ISO 8601 standard, i.e.:
2015-03-15T12:50:43
2015-03-15T12:50:43+00:00
2015-03-15T14:50:43+02:00

expireDateTime0 .. 1dateTime 


The assessment instance expire date is the date
where alerts will be displayed if the assessment
instance is not completed.

By this field you can controll not only date but time as well. It overwrite expireDate
field.
Format must be concurring with ISO 8601 standard, i.e.:
2015-03-15T12:50:43
2015-03-15T12:50:43+00:00
2015-03-15T14:50:43+02:00

contextID0 .. 1contextID 


Identifier of context.

ownerID0 .. 1ownerID 


Id of clinician who is owner of assessment instance.

code0 .. 1code 

External resource Code

mappingData0 .. 1mappingData 


Integration mapping data