IMPORTANT: Questionmark recommendeds using the Delivery Odata API (click here for documentation) for new integrations, not the QMWISe API. Although we currently continue to issue maintenance updates to this API to support customers with current QMWISe-based integrations, we are no longer adding new methods/functionality to QMWISe. 

GetAssessment

Applies to the following products: 
Questionmark OnDemand
Questionmark Perception
Questionmark OnPremise
Applies to the following Perception versions: 
Perception 5.7

This method processes an Assessment_ID and returns a list giving the full details of the assessment if the assessment exists in the repository. If the assessment does not exist in the repository a SOAP fault message will be returned.

Available in:
  • Version 4.1 +
  • Version 5.1 +

Parameters

Input name Description Data type Optional field?

Assessment_ID

The Assessment_ID of the assessment you want to get the details of

String

N

Response

Output name Description Data type

Assessment_ID

The Assessment_ID of the assessment

String

Revisions

The revision number of the assessment

Integer

Session_Name

The assessment's name or title

String

Author

The name of the assessment's creator

String

Save_Answers

This indicates whether to save the answers in the answer tables

Boolean

Save_Answer_Data

This indicates whether to save the data to all answer tables, or only to the results and assessment tables

Boolean

Open_Session

This indicates whether the assessment can be presented with open.dll or open.php

Boolean

Session_Password

The assessment's password (blank if no password is set)

String

Session_Timed

This indicates whether the assessment has a time limit (if so, the value is contained in the field Time_Limit below)

Boolean

Time_Limit

The number of minutes for which the assessment is available (used if Session_Timed above is set)

Integer

Template_Name

The default template file for the assessment (each assessment block can be set to use its own template file)

String

When_Feedback

0 - No feedback at all 1 - Feedback shown after each block 3 - Feedback shown at the end of the assessment

Integer

End_Feedback

If When_Feedback above is zero:

0 - All questions get feedback 1 - Only wrong or unanswered questions get feedback 2 - Only wrong questions get feedback 3 - All answered questions get feedback

Integer

Exclude_Unscored

If When_Feedback above is not zero, this indicates whether questions with a maximum score of zero should show feedback

Boolean

Folder_ID

The ID of the Assessment Folder the assessment is stored in

Integer

Lang *

The language of the assessment

String

Description

This is a short comment for the assessment

String

Monitored

0 - Assessment not monitored 1 - Assessment monitored

Boolean

Editor

The last user who modified the assessment

String

Version

The version of Enterprise Manager last used to modify the assessment

String

Permit_External_Call

Allow the assessment to be called externally via PIP or LMS

Boolean

Created_Date

The date on which the assessment was created

Date/Time

Modified_Date

The last date on which the assessment was modified

Date/Time

* Available in Perception 5.1 and higher only

Troubleshooting

Please refer to the following page for any error codes that are displayed when using this method.

Appendix - Error codes