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. 

GetAssessmentListByGroup

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

This method processes a Group_ID and returns a list giving the full details of all the assessments that have been assigned to the group if that Group_ID exists and has any assessments assigned to it. If not, an empty list is returned. If the group 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?

Group_ID

The Group_ID of the group whose assigned assessment details are required

String

N

Response

Output name   Description Data type

Assessment

(zero or more repetitions)

 

 

 

 

Assessment_ID

The Assessment_ID for this definition

String

 

Revision

The assessment's current revision

Integer

 

Session_Name

The assessment name or title

String

 

Author

The name of the user who created the assessment definition

String

 

Save_Answers

This indicates whether the answers are saved in the answer tables

Boolean

 

Save Answer_Data

This indicates whether the data is saved 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 Folder_ID of the assessment folder where the assessment is stored

Integer

 

Lang *

The language of the assessment

String

 

Description

This is a short comment for the assessment definition

String

 

Monitored

0 - Assessment not monitored 1 - Assessment monitored

Boolean

 

Editor

The last user who modified the new assessment definition

String

 

Version

The version of Assessment Manager last used to modify the new assessment

String

 

Permit_External_Call

This is placed in the database field S_Header.Permit_External_Call

Boolean

 

Created_Date

The date on which the new assessment definition was created

Date

 

Modified_Date

The last date on which the new assessment definition was modified

Date

* Only available in Perception 5.1 and higher

Troubleshooting

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

Appendix - Error codes