CheckWare partner API reference guide

Datatypes

OverviewDatatypesWebservice operationsChangelog

Datatypes

Available datatypes

NameTypeDocumentation
administratorGroupcomplexThe clinician group
administratorGroupIDsimpleThe clinician group identifier.
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 the answer/value for a question.
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.
assessmentInstanceContextcomplexContext is logical space to group assessment instances.
assessmentInstanceContextCollectioncomplexCollection of assessment instance contexts.
assessmentInstanceDatacomplexObject grouping assessment instance object (optional), collection of answers,
collection of calculations and flags raised for assessment instance.
assessmentInstanceDetailedcomplexThis object contains two collections: assessment instances belonging to assessment instance plan and grouping by plans and second: assessment instances assigned directly to treatment.
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.
assessmentInstancePortalCodesimpleCode assigned to assessment instance grants access to Assessment Instance Portal
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.
assessmentInstanceQuestionValueTypecomplexType of answer
assessmentInstanceReportcomplexAn assessment report is a file generated by the 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.

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.
assessmentInstanceReportDetailedcomplexAn assessment report belongs to an assessment
assessmentInstanceReportDetailedCollectioncomplexAn 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
assessmentPlanFilterscomplexParameters to filter list of assessment plans
assessmentPlanIDsimpleId of template of assessment plan
assessmentPlanInstancecomplexInstance of assessment plan represents group of assessments or other components
assessmentPlanInstanceHasAssessmentInstancecomplexObject contains assessment plan instance and collection of assessment instances
added to respondent by assessment plan instance.
assessmentPlanInstanceHasAssessmentInstanceCollectioncomplex
assessmentPlanInstanceHasAssessmentInstanceFiltercomplexParameters to filter assessmentPlanInstanceHasAssessmentInstance objects.
assessmentPlanInstanceIDsimpleId of instance of assessment plan
assessmentReportIDsimpleThe assessment report indentifier.
attributeMetaParameterCollectioncomplexList of options which could be used to define attribute Meta. This list can only be used where type of attribute meta is dropdown.
attributeMetaTypessimplePossible types of custom attributes meta.
availableAssessmentsFiltercomplexParameters to filter available assessments.
availableAssessmentsScopesimple
Possible scopes of available assessments.
Scope 'all' means all available assessments will be returned (default behaviour).
Scope 'clinician-only' means only clinician available assessments will be returned.
Scope 'respondent-only' means only respondent available assessments will be returned.
codecomplexExternal resource Code
codesCollectioncomplexCollection of Codes
contextIDsimpleThe context identifier. Identifying one unique context.
dataExportInstancecomplexInstance of data export template, object contains body of data export file and
other meta data describing exported data file.
dataExportTemplatecomplexA data export template is used for creating custom data exports.
dataExportTemplateCollectioncomplexA collection of data export templates.
dataExportTemplateContextCollectioncomplexCollection of assessment instance context id to filter data results.
dateRangeTypesimpleList of possible options to use as filter in export assessment instances operation.
Option "past" includes only assessments with start date in the past.
Option "future" includes only assessments with start date in the future.
Option "all" (default value) exports information from all assessments.
exportAssessmentInstanceDatacomplexModel of export assessment instances. Contains parameters and filters to return
list of assessment instances with answers, calculations, flags and other information about
instances. The export contains the same parameters as the GUI equivalent.
exportAssessmentInstanceStatusDatacomplexModel of export assessment instances statuses. Contains parameters and filters to
return list of assessment instances.
exportAssessmentPlanDatacomplexModel of export assessment plans with related information.
exportDatasimpleData in csv format.
exportDataObjectcomplexData in .csv format.
exportLoginSessionDatacomplexContains parameters and filters to export information about respondent and clinician
sessions.
exportRespondentDatacomplexContains parameters and filters to export information about respondent.
exportRespondentGroupDatacomplexContains parameters and filters to export information about respondent groups
and respondent's informations.
exportTreatmentInstanceDatacomplex
Contains parameters and filters to export treatments.
exportUserDatacomplexContains parameters and filters to export information about clinicians.
exportUserGroupDatacomplexContains parameters and filters to export clinician groups and clinician's information.
instanceIDsimpleThe instance identifier. Identifying one unique instance.
languagecomplexLanguage defined in system
languageCollectioncomplexContains a set of languages
languageIDsimpleThe language identifier.
mappingDatacomplexIntegration mapping data
messagecomplexObject message represents comunication - messages sent beetwen respondent and
clinician(s)
messageCollectioncomplexCollection of messages
messageFiltercomplexSet of parameters to filter messages
messageIDsimpleIdentifier of message
ownerIDsimpleId of clinician who is owner of assessement instance
respondentcomplexThe respondent is the structure representing the individual that responds to an assessment.
Respondent ID is set in any situation, also when adding a new respondent. Social security number
of the respondent or other uniquely indentifying numbers/strings are normally used.
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 store 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
respondentGroupCollectioncomplexContains a set of respondent groups.
respondentGroupIDsimpleThe respondent group identifier.
respondentGroupUserGroupConnectioncomplexConnection between clinician group and respondent group
respondentGroupUserGroupMappingcomplexRespondent group - clinician group mapping
respondentGroupUserGroupMappingCollectioncomplexCollection of respondentGroupUserGroupMapping objects
respondentGroupUserGroupMappingFiltercomplexFilter respondent group - clinician group mapping
respondentIDsimpleThe respondent identifier. Identifying one unique respondent.
rolecomplexIf this is a respondent role, set true. If false this is not a respondent role.
roleCollectioncomplex
roleIDsimpleThe unique identifier for a specific role for a specific treatment type.
roleInRoleSetcomplex
roleInRoleSetCollectioncomplex
roleSetcomplexSet of roles
roleSetCollectioncomplex
roleSetHasRolecomplex
roleSetIDsimpleThe unique identifier for a specific role set.
roleTypessimplePossible types of role.
templateIDsimpleThe template identifier. Identifying one unique template.
treatmentFiltercomplexFilter to restrict treatments
treatmentInstancecomplexTreatment instance is a health unit created for respondent. Respondent may have more than one treatment.
If the respondent does not have any treatment it will be impossible to assign any assessments, plans etc.
All elements like assessments, assessment plans etc. are assigned to treatment instead of respondent directly.
treatmentInstanceAttributecomplex
treatmentInstanceAttributeCollectioncomplexCollection of treatment instance attributes
treatmentInstanceAttributeIDsimpleThe treatment instance attribute identifier. Identifying one unique treatment instance attribute assigned to treatment instance.
treatmentInstanceCollectioncomplexCollection of treatment instances
treatmentInstanceIDsimpleThe treatment identifier. Identifying one unique treatment assigned to respondent.
treatmentInstanceRolecomplex
treatmentInstanceRoleCollectioncomplexA treatment instance role collection is a collection of roles occupied by clinicians or respondents within the treatment instance.
treatmentInstanceRoleIDsimpleThe unique identifier for a single treatment instance's role.
treatmentInstanceStatussimplePossible types of treatment status.
treatmentTypecomplexType of treatments.
treatmentTypeAttributecomplexThis is template to define some custom attributes which could be used to define treatment instance.
treatmentTypeAttributeCollectioncomplexCollection of treatment type attributes
treatmentTypeAttributeIDsimpleThe treatment type attribute identifier. Identifying one unique treatment type attribute defined for treatment type.
treatmentTypeCollectioncomplexCollection of treatment types
treatmentTypeHasRoleSetcomplexThis treatment type has role sets
treatmentTypeIDsimpleThe treatment type identifier. Identifying one unique treatment type.
usercomplexA user represents a clinician in medical terms. The clinician is the one evaluating the
reports and issuing assessment instances for a given respondent.
userAttributecomplexModel of clinician attribute. Attribute is additional information about clinician.
Attribute could be taken only from list of clinician attribute meta. Attribute is mandatory if value
of userAttributeMetaRequired is true.
userAttributeCollectioncomplexCollection of custom attributes defined for clinician
userAttributeMetacomplexModel of custom attribute to store additional information about respondent.
userAttributeMetaCollectioncomplexCollection of custom attributes which could be added to respondent.
userAttributeMetaIDsimpleId of clinician attribute meta field.
userCollectioncomplexCollection of clinician
userGroupcomplexClinician group object
userGroupCollectionscomplexCollection of clinician group objects
userGroupIDsimpleThe clinician group identifier. Identifying one unique clinician group.
userGroupIDCollectioncomplexCollection of clinician group indentifiers
userIDsimpleThe clinician identifier. Identifies one unique clinician.
userIDCollectioncomplexCollection of clinician ids
userRolecomplexA clinician role represents the id and name of a specific clinician role.
userRoleCollectioncomplexClinician role collection contains a set of clinician roles.
userRoleIDsimpleThe clinician 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.