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