CheckWare partner API reference guide

Datatypes

OverviewDatatypesWebservice operationsChangelog

Datatypes

Available datatypes

NameTypeDocumentation
administratorGroupcomplex
administratorGroupIDsimpleThe administrator 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 conatins two collections: assessment instances belonging to assessment instance plan and grouping by plans and second: asseaament 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 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.

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.
assessmentInstanceReportDetailedcomplex
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 respondet 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 used to defined attribute Meta. This list could be
use only in 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
consentcomplexConstant datatype
consentCollectioncomplex
consentIDsimpleThe consent identifier. Identifying one unique consent.
consentInstancecomplex
consentInstanceCollectioncomplex
consentInstanceIDsimpleThe consent instance identifier. Identifying one unique consent instance.
consentInstanceListFiltercomplexObject with properties to filter list consent instances
consentInstanceOptioncomplexSet of roles
consentInstanceOptionAnswercomplexSet of roles
consentInstanceOptionAnswerCollectioncomplex
consentInstanceOptionAnswerIDsimpleThe consent instance option answer identifier. Identifying one unique consent instance option answer.
consentInstanceOptionCollectioncomplex
consentInstanceOptionIDsimpleThe consent instance option identifier. Identifying one unique consent instance option.
consentInstanceToSubmitcomplexConstant instance data needed to submit particular consent instance
consentOptioncomplexConstant datatype
consentOptionCollectioncomplex
consentOptionVersionIDsimpleThe consent option version identifier. Identifying one unique consent option version.
consentVersioncomplexConstant datatype
consentVersionIDsimpleThe consent version identifier. Identifying one unique consent version.
contextIDsimpleThe context identifier. Identifying one unique context.
dataExportInstancecomplexInstance of data export template, object contains body od data export file and
other meta data described exported data file.
dataExportInstanceMetadatacomplexObject contains metadata of an 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 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.
exportSystemEventLogDatacomplexModel of export system event log data. Contains parameters and filters to return
list of system event log data.
exportTreatmentInstanceDatacomplex
Contains parameters and filters to export treatments.
exportUserDatacomplexContains parameters and filters to export informations about clinicians.
exportUserGroupDatacomplexContains parameters and filters to export user groups and user's informations .
instanceIDsimpleThe instance identifier. Identifying one unique template.
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 a respondent (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 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.
respondentGroupcomplex
respondentGroupCollectioncomplexContains a set of respondent groups.
respondentGroupIDsimpleThe respondent group identifier.
respondentGroupUserGroupConnectioncomplexConnection between user group and respondent group
respondentGroupUserGroupMappingcomplexRespondent group - user group mapping
respondentGroupUserGroupMappingCollectioncomplexCollection of respondentGroupUserGroupMapping objects
respondentGroupUserGroupMappingFiltercomplexFilter respondent group - user 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. Respondant may have more than one treatments.
If respondent woludn't have any treatment it will be impossible to assign him eny assessments, plans etc.
All elements like assessments, assessment plans etc. are assign 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 set by clinicians or users assigned to treatment
reports.
treatmentInstanceRoleIDsimpleThe unique identifier for a single treatment instance's role.
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
treatmentTypeHasRoleSetcomplex
treatmentTypeIDsimpleThe treatment type identifier. Identifying one unique treatment type.
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.
userCollectioncomplexCollection of user
userGroupcomplexClinician group object
userGroupCollectionscomplexCollection of clinician group objects
userGroupIDsimpleThe user (clinician) group identifier. Identifying one unique clinician group.
userGroupIDCollectioncomplexCollection of user group indentifiers
userIDsimpleThe user identifier. Identifies one unique
userIDCollectioncomplexCollection of clinician ids
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.