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. 

Configuration settings

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

QMWISe is very flexible in its operation and be easily re-configured by using the Server Setting page in Enterprise Manager.

Perception 4.1+

The QMWISe configuration settings are explained below for Perception 4.

When you have made or changed configuration settings, you must do one of the following so that the new settings can take effect on your QMWISe server:

  • Restart the web server on which QMWISe runs
  • Run an external program to call the web service method SetConfiguration
  • Use a web service testing application like soapUI for updating the configuration settings
Setting Purpose Example settings
AssessmentURL The URL for the Perception assessment delivery point. http://localhost/q4/session.dll
ListURL The URL for the Perception entry point used to run login and select assessments. For example: http://localhost/q4/perception.dll
AdminURL The URL for logging in to Enterprise Manager. For example: http://localhost/em4/exlogin.asp
ReportURL The URL for running reports with Enterprise Reporter. For example: http://localhost/em4/reporting/coaching/view.asp
DisconnectedFileURL If you are using Questionmark to Go, the URL of the directory used to store assessments delivered by Questionmark to Go. Set this to the full URL of the /togo virtual directory on your Perception installation. http://localhost/togo4
DisconnectedFileExtension

The file extension of the files which contain assessments delivered by Questionmark to Go.

It should not normally be changed.

Apacks
DisconnectedFileFolder

The directory in which the files which contain assessments delivered by Questionmark to Go are stored.

This setting is only required if you are using the web service methods for disconnected schedules. For example:

 
ResourceFolder

The folder that contains the resources used in assessments delivered by Questionmark to Go.

This setting is only required if you are using the web service methods for disconnected schedules. For example:

 
JavaFolder

The folder that contains the Java files used in assessments delivered by Questionmark to Go.

This setting is only required if you are using the web service methods for disconnected schedules. For example:

 
MultimediaFolder

The folder that contains the multimedia files used in assessments delivered by Questionmark to Go.

This setting is only required if you are using the web service methods for disconnected schedules. For example:

 
SecurityRequire

Set this to 1 (true) if SOAP headers are to be used for authentication in the QMWISe request and response messages. See the section about in-built security). If TrustRequire is also set to 1 (true), then the SecurityRequire setting is ignored and assumed to be false.

If no authorization is required, set this to 0 (false).

Also see the chapter about security settings.

0
TrustRequire

Set this to 1 (true) if trusted security (meaning that only Questionmark applications such as Questionmark to Go can process the messages) is required by the QMWISe request.

Otherwise set this to 0 (false).

See the section about security settings and also the section about trusted security.

0
TrustedKey

This is a key of exactly eight alphanumeric characters used for trusted security.

You should change this from the default value so that only your users can use Questionmark applications with the QMWISe installation.

See the section about security settings and also the section about trusted security.

12345678
SoapLogLevel

This indicates the logging level for the SOAP log:

0 - No logging

1 - Log only fault messages

2 - Log all requests and responses

2
TraceLogLevel

This indicates the logging level for the SOAP log:

0 - No logging

1 - Errors only

2 - Summary of all activity

3 - Detailed trace of all activity

3

Perception 5.1+

The QMWISe configuration settings are explained below for Perception 5+.

Setting Description Default value
Disconnected file extension Specifies the file extension for Questionmark to Go assessments APacks
Item Limit In Attachment Determines the number of separate messages to be included in an email attachment 100
Participant Email template Specifies the location of the participant email template used for the QMWISe method SendEmailsScheduledEvent C:\Program Files\Questionmark\ Perception5\QMWISe\ Template\ EmailTemplate.xml
Proctor Email template Specifies the location of the proctor email template used for the QMWISe method SendEmailsScheduledEvent C:\Program Files\Questionmark\ Perception5\QMWISe\ Template\ EmailTemplateProctor.xml
Security require Use this setting to enable QMWISe to use SOAP headers to authenticate requests True
Soap log level Use this setting to enable Soap logging for QMWISe False
Trace log level Use this setting to enable trace logging for QMWISe False
Trusted Key Specifies a key of exactly eight alphanumeric characters used for trusted security with external applications and QMIWSe 12345678
Trust require Use this setting to enable trusted security (meaning that only Questionmark applications such as Questionmark to Go can process the messages) is required by the QMWISe request True