To integrate Questionmark Perception with the SAP Enterprise Learning environment, you can use the SAP Connector. With the SAP Connector, Perception assessments can be scheduled and taken from SAP Learning Solution. Then, once the Perception assessment has been completed, the results can be returned to SAP Learning Solution.
If you are using Perception version 4.3 you must obtain a license before using the SAP Connector. The SAP Connector will be made available to you for download once you have purchase the relevant licenses. If you are using Perception version 4.4 the SAP Connector components are installed as part of Service Pack 1. But to use the SAP Connector you will need to buy the appropriate license.
This article is divided into:
SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG Germany and in several other countries all over the world. All other names, product names, and trade names are trademarks or registered trademarks of their respective holders.
How does the SAP Connector work?
The integration between Perception and SAP Learning Solution that the SAP Connector provides is outlined in the following diagram.
Each stage in this process is described in more detail in the table below.
| Stage |
Description |
| 1 |
A Perception assessment is created using Questionmark authoring software |
| 2 |
The Course Administrator in SAP Learning Solution creates a course which links to the Perception assessment by specifying the assessment ID. The setup can be qualification framework integrated, and standard workflow and reporting can be used. It can also be combined with instructor-led or self-paced training. Electronic signatures can be applied, and if a price is provided, internal cost allocation or billing to external systems is configurable
For more information on using SAP Learning Solution, please refer to the online Help that accompanies the product |
| 3 |
The learner accesses the learning portal of SAP Learning Solution. Along with all other course offerings the learner will find the Perception assessment in the course catalog
Like other course offerings in SAP Learning Solution, the Perception assessment can be:
- Found in the catalog and by the search function (visibility and accessibility can be restricted if needed)
- Part of the personalized learning proposal for a learner: either prescribed as mandatory for a learner based on his/her organizational data (e.g. can be set as mandatory for entire departments, based on already available organizational data), or pushed to the learner because of missing qualification for his job or soon expiring licence
- Combined in blended course packages (programs or curriculum) e.g. as final test or pre-test to an instructor-led course or self-paced web-based training (WBT)
|
| 4 |
The learner books the course in the SAP Learning Solution
Standard approval workflow can be automatically routed to Manager, if desired. The learner can then launch the course after the successful approval. |
| 5 |
The learner takes the Perception assessment.
After booking, the Perception assessment is available in My Training Activities and can be launched from within the Learning Portal of SAP Learning Solution. Clicking the Start now link will open the Perception assessment |
| 6 |
The assessment is delivered with Perception |
| 7 |
The learner completes the assessment |
| 8 |
Assessment results are passed back to SAP Learning Solution. Once this has been completed, the following can be carried out (ifconfigured):
- A qualification or licence automatically transferred to a learner's profile upon successful completion of an assessment
- Electronic signature applied and stored
- Standard processes for internal cost allocation and billing
- Standard reporting in SAP Learning Solution
|
| 9 |
Full assessment results are stored in the Perception repository.
Perception administrators with reporting permissions can use the sophisticated reporting features of Perception Enterprise Reporter to comprehensively analyse all results data |
Click the link below to watch a short Captivate movie on how the SAP Connector integration works from an end users perspective.
System requirements
The SAP Connector requires the following software and versions.
| Software |
Version |
| Perception Server |
4.3 and above |
| SAP Learning Solution |
3.0 or above with the following SAP Notes implemented:
Or the respective Support Package levels:
- Release (ECC) Package name
- 500 SAPKGPHC39
- 600 SAPKGPHD22
- 602 SAPK-60201INEAHR
|
The SAP Connector is a chargeable addition to Perception Server. Please contact your nearest Questionmark Sales office for more details.
 |
Security
The SAP Connector is intended to operate in an environment where Perception Server and SAP Learning Solution are located on the same network, and that the connection between SAP Learning Solution Web Service and QMWISe will reside behind the same firewall. If this is the case, then the SAP Connector will not require any explicit security configuration.
If further security is required, you should configure IIS to specify that QMWISe can only be called by SAP Learning Solution web services. You should also ensure that QMWISe is only accessible to safe applications. For more information on configuring security with QMWISe, please refer to the Security chapter of the QMWISe Reference Guide.
|
Installing the SAP Connector
The SAP Connector is compatible with Perception version 4.3 and above. This section contains information on installing the SAP Connector on:
Installing on Perception version 4.3
The SAP Connector will be made available to you for download once you have purchase the relevant licenses.
Once you have obtained the SAP Connector zip file, you can install it as follows:
-
Check that your system meets the System Requirements listed above and that your Perception license enables you to use the SAP Connector
- Download the SAP Connector zip file from to the \bin folder of your Perception Server installation. In a default installation, this is:
C:\program files\questionmark\perception4\server\qmwise\bin
- Ensure that Perception Server is not running and extract the SAP Connector zip file.
Confirm that you want to overwrite existing files if prompted.
- Specify your security settings
You will need to configure IIS to specify that QMWISe can only be called by SAP Learning Solution web services. Once you have done this, you will need to turn QMWISe security off. To turn QMWISe security off, edit a setting in the perceptionv4.ini configuration file. In a default installation, this file is located in the following folder:
C:\program files\questionmark\perception4\server\
Locate the SecurityRequire setting and set this to 0 as follows:
SecurityRequire=0
Save your changes and close the file
- On your Perception Server, reset IIS
Installing the SAP Connector on Perception version 4.4
To install the SAP Connector on Perception version 4.4 you will need to:
- Download and install Service Pack 1 for Perception version 4.4. For further information about how to obtain and install Service Pack 1, please refer to the Knowledge Base article:
How do I install Service Pack 1 for Perception 4.4?
- Specify your security settings
You will need to configure IIS to specify that QMWISe can only be called by SAP Learning Solution web services. Once you have done this, you will need to turn QMWISe security off. To turn QMWISe security off, edit a setting in the perceptionv4.ini configuration file. In a default installation, this file is located in the following folder:
C:\program files\questionmark\perception4\server\
Locate the SecurityRequire setting and set this to 0 as follows:
SecurityRequire=0
Save your changes and close the file
- On your Perception Server, reset IIS
Verifying the installation
The name of the QMWISe service used by the SAP Connector is qmwise.asmx. This file details the QMWISe methods that are installed. To confirm that the SAP Connector has been correctly installed, view this file in a browser and confirm that the new web service methods used by QMWISe are included. To do so:
- Enter the URL of qmwise.asmx in the address bar of your browser
This file is located in the \qmwise folder of your Perception Server installation. In a default installation, this is:
C:\Program Files\Questionmark\Perception4\server\qmwise
By default, the Perception Server install program gives the \qmwise directory the webshare name qmwise4. Therefore, if you have installed Perception Server in the default location and have created the default webshare names, the URL to enter will be:
http://<server_name>/qmwise4/qmwise.asmx
Where <server_name> is the name of your server. The text of the file is displayed
- Confirm that the new QMWISe methods are included in the text of the file
The new methods are:
- CreateAndScheduleParticipant
- DeleteScheduleList
- GetAccessScheduleNotify
If the new methods are included, the SAP Connector has been correctly installed.
What information does Perception send to SAP?
The assessment information sent to SAP Learning Solution from Perception is listed in the following table.
| Data |
Description |
Assessment_ID |
The unique ID of the assessment that has been taken |
Participant |
The name of the participant who has taken the assessment |
Max_Score |
The maximum score of all questions answered |
Total_Score |
The participant's actual score for all questions answered |
Time_Taken |
The time taken, in seconds, between the start and end of the assessment (zero if the assessment is still active) |
Score_Band_Title |
The title of assessment outcome at end of the assessment |
Percentage_Score |
The percentage score achieved by the participant for the assessment |
When_Started |
Date when the result was first written to the database |
| When_Finished |
The date when the assessment finished, or when last updated if still going |
Finding more information
For further information on the installation, configuration and use of QMWISe, please refer to the QMWISe Reference Guide.
For more information on the SAP Connector, please contact Questionmark Technical Services.
|
knowledge base 
