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