CheckWare assessment API reference guide

Datatypes

OverviewDatatypesWebservice operationsChangelog

Datatypes

Available datatypes

NameTypeDocumentation
assessmentcomplexAn assessment is equivalent to a questionnaire or interview.

By issuing an assesment to a respondent you will spawn an assessmentInstance.
assessmentCollectioncomplexAn assessment collection is a collection of assessments.
assessmentIDsimpleThe assessment identifier. Identifying one unique assessment.
assessmentInstancecomplexAn assessment instance represents an assessment issued to a respondent. The instance keeps track of scheduling and status of that particular assessment.
assessmentInstanceAnswercomplexAssessment instance answer is
assessmentInstanceAnswersCollectioncomplexCollection of answers for assessment instance.
assessmentInstanceCalculationcomplexCode and value of calculation defined for assessment
assessmentInstanceCalculationsCollectioncomplexCollection of assessment instance calculations.
assessmentInstanceCollectioncomplexAssessment instance collection contains a set of assessment instances.
assessmentInstanceDatacomplexObject grouping assessment instance object (optional), collection of answers, collection of calculations and flags raised for assessment instance.
assessmentInstanceFlagcomplexCode and value of flag defined for assessment. Value true means that flag is raised.
assessmentInstanceFlagsCollectioncomplexCollection of assessment instance flags.
assessmentInstanceIDsimpleThe assessment identifier. Identifying one unique assessment for one unique respondent.
assessmentInstanceQuerycomplexThe assessment instance query defines the selection criterias for retreving assessment instances from the system.

You may use the elements in combination. All of the criterias that are defined in the query must be met before the assessment instance is part of the resulting assessment instance collection.
assessmentInstanceReportcomplexAn assessment report is a file generated by the assessment system for a given assessment.
One assessment may contain multiple reports. One report may in some cases contain information from more than one assessment but is always initiated from one assessment instance point of view.

Important note: This structure only contains the information about the report, not the actual report data.
assessmentInstanceReportCollectioncomplexAn assessment report collection is a collection of references to assessment reports.
assessmentInstanceReportFilecomplexThe assessment instance report file contains the actual data for the report (attachment).

assessmentInstanceReportFileKITHcomplexThe assessment instance report file contains the actual data for the report in KITH message format (attachment).

assessmentInstanceReportIDsimpleThe assessment instance report identifier.
assessmentPlancomplexTemplate with defined group of assessments or other components to assign to respondent by application
assessmentPlanCollectioncomplexCollection of assessment plans
assessmentPlanIDsimpleId of template of assessment plan
assessmentPlanInstancecomplexInstance of assessment plan represents group of assessments or other components
assessmentPlanInstanceIDsimpleId of instance of assessment plan
assessmentReportIDsimpleThe assessment report indentifier.
attributeMetaParameterCollectioncomplexList of options which could used to defined attribute Meta. This list could be use only in type of attribute meta is dropdown.
attributeMetaTypessimplePossible types of custom attributes meta.
dateRangeTypesimpleList of possible option to use as filter in export assessment instances operation. Option "past" means that only assessments which have start date in the past, "future" that only assessments with start date in the future will be exported and "all" (default value) means that information fro all assessments will be exported.
exportAssessmentInstanceDatacomplexModel of export assessment instances. Contains parameters and filters to return list of assessment instances with answers, calculations, flags and other information about instances.
exportAssessmentInstanceStatusDatacomplexModel of export assessment instances statuses. Contains parameters and filters to return list of assessment instances.
exportAssessmentPlanDatacomplexModel of export assessment plans with related informations.
exportDatasimpleData in csv format.
exportDataObjectcomplexData in csv format.
exportLoginSessionDatacomplexContains parameters and filters to export informations about respondent and users sessions.
exportRespondentDatacomplexContains parameters and filters to export informations about respondent.
exportRespondentGroupDatacomplexContains parameters and filters to export informations about respondent groups and respondent's informations.
exportUserDatacomplexContains parameters and filters to export informations about clinicians.
exportUserGroupDatacomplexContains parameters and filters to export user groups and user's informations .
ownerIDsimpleId of clinician who is owner of assessement instance
respondentcomplexThe respondent is the structure representing a respondent (the individual that responds to an assessment).
respondentAttributecomplexModel of respondent attribute. Attribute is additional information about respondent. Attribute could be taken only from list of respondent attribute meta. Attribute is mandatory if value of respondentAttributeMetaRequired is true.
respondentAttributeCollectioncomplexCollection of custom attributes defined for respondent
respondentAttributeMetacomplexModel of respondent's attribute to stored additional information about respondent
respondentAttributeMetaCollectioncomplexCollection of custom attributes which could be added to respondent.
respondentAttributeMetaIDsimpleId of respondent attribute meta field.
respondentChangecomplexThe respondentChange structure is used to change respondentID for an existing respondent.
respondentCollectioncomplexA respondentCollection is a collection of zero to many respondents.
respondentGroupcomplexThe respondent group represents the id and name of a valid respondent group.
respondentGroupCollectioncomplexContains a set of respondent groups.
respondentGroupIDsimpleThe respondent group identifier.
respondentIDsimpleThe respondent identifier. Identifying one unique respondent.
usercomplexA user represent a clinician in medical terms. The user is the one evaluating the reports and issuing assessment instances for a given respondent.
userAttributecomplexModel of user attribute. Attribute is additional information about user. Attribute could be taken only from list of user attribute meta. Attribute is mandatory if value of userAttributeMetaRequired is true.
userAttributeCollectioncomplexCollection of custom attributes defined for user
userAttributeMetacomplexModel of custom attribute to stored additional information about respondent.
userAttributeMetaCollectioncomplexCollection of custom attributes which could be added to respondent.
userAttributeMetaIDsimpleId of clinician attribute meta field.
userIDsimpleThe user identifier. Identifies one unique
userRolecomplexA user role represents the id and name of a specific user role.
userRoleCollectioncomplexUser role collection contains a set of user roles.
userRoleIDsimpleThe user role identifier.
voidsimpleThe void type is just an indicator that you should not expect any useful response. It is there to be able to send a fault if something goes wrong.