Questionmark's Open Assessment Platform

SharePoint

This How to! details how to use Web Parts to embed assessments in SharePoint pages and is split into the following sections:

  • How to link Perception and SharePoint
  • Adding the Page Viewer Web Part in SharePoint
  • Displaying an assessment in the Web Part
  • How do I set assessment and participant details?

Reasons for embedding an assessment in SharePoint are numerous. For example:

  • If you use SharePoint as a Content Management System, you may want to assess the knowledge of the people who use it
  • You have people in your organization who use SharePoint as part of their learning activities and you want to assess what they already know or what they learnt from training
  • Embedding an assessment. For example, a Quiz in pages helps focus the learning that the user is undertaking

Before you embed an assessment in a page it is recommended that you make some changes to the template used. The Page Viewer Web Part used to display an assessment in a page works in a similar method to an iFrame. So the changes required to the template are the same as would be required for an iFrame.

How to link Perception and SharePoint

Embedding assessments are effective for open assessments and provides the opportunity to include an assessment directly in a SharePoint page rather than link to an assessment.

Embedding an assessment is beneficial for organizations that use wiki or blog pages to inform and train learners. It can help provide an improved user experience, including:

  • Embedding the activities and assessment together in a simple to use delivery
  • Personalizing the process of learning and assessing to ensure the relevance to the learner
  • Focusing their attention
  • Providing an aspect of repetition of the learning material

Adding the Page Viewer Web Part in SharePoint

To add a Web Part to a page you will need appropriate privileges to edit that page and have access to the default Web Parts available in the SharePoint Web Part library.

A Web Part can be added to any page in SharePoint including, shared or personalized pages:

  • A shared page is the same for all users
  • A personalized page only shows a Web Part assigned to a particular user/type of user. For example, various Page Viewer Web Parts could be added to a page. However, the only one that displays is the one associated with the viewer who is viewing the page. This can be useful for delivering a truly personalized experience for assessments and the learning process in whole.

The method of adding the Page Viewer Web Part is similar for each type of page. However, wiki and blog pages are only available in SharePoint 2007. The Web Part does not become part of the content, but instead becomes another section of the screen, independent to the rest. It is possible to place the Web Part above or below any other Web Parts, or even to the Left or Right.

To edit a shared view of a SharePoint page and add a Web Part:

  1. Navigate to the page where you want to add the assessment.
  2. Site Actions drop-down list.
  3. Click Edit Page.
  4. Select the area of the screen where you would like to add the Web Part. This is the area of the page where the assessment will display.
  5. Click Add a Web Part in the location you would like to add the Web Part.
  6. In the Add Web Parts window place a check in the Page Viewer Web Part and click Add.

The Page Viewer Web Part will now be available on the page.

The Page Viewer Web Part must be installed and you must have permission to use it before it will be available in the list of available Web Parts. The Web Part must also be enabled for all parts of your SharePoint site if you intend to use it in wiki pages on Blogs or in general SharePoint pages.

To add a Web Part to the personalized view of a page rather than the shared view:

  1. Navigate to the page.
  2. Select Personalize this page from the Welcome drop-down list.
  3. Select the area of the screen where you would like to add the Web Part. This is the area of the page where the assessment will display.
  4. Click Add a Web Part in the location you would like to add the Web Part.
  5. In the Add Web Parts window place a check in the Page Viewer Web Part and click Add.

Refer to the following section for instructions about how to embed an assessment in this Web Part.

Displaying an assessment in the Web Part

If the Web Part is available on your SharePoint page it is possible to embed an assessment in the Web Part. To embed an assessment:

  1. Click the Edit drop-down list in the Page Viewer Web Part and select Modify My Web Part. This will open the settings panel for the Web Part.
  2. Ensure that the option button Web Page is selected.
  3. In the Link text-box enter the URL for the assessment you want to add. See below for details about the URL to provide.
  4. Select Appearance and set the Title of the Web Part if you intend to show this.
  5. Set your preferences for Height and Width of the Page Viewer Web Part. Caution should be taken when determining values as certain settings will affect how the template is displayed and depend largely on your screen resolution.
  6. From the Chrome Type select how you would like the Web Part displayed; with a border, a border and title, a title only, or nothing.
  7. Click OK to finish configuring the Web Part.
  8. Click Exit Edit Mode to see how the page will look to others.

How do I set participant and assessment details?

It is possible to define in the URL used in the Web Part how Questionmark will function. For example you can:

  1. Call perception.php and make a participant login to start an assessment scheduled to them.
  2. Call a specific assessment but require participants to log in.
  3. Call a specific assessment for a specific participant.
  4. Call an open assessment where a participant needs to enter a name before selecting the assessment of their choice.
  5. Call a specific open assessment but require participant to enter their name/group.
  6. Call a specific open assessment using predetermined participant name/group.
  7. Call a specific open assessment using the participants Windows user name.

All these methods of taking an assessment can be defined for the Web Part by modifying the URL used to in the Link textbox to call Perception. For example:

  • http://<Perception server>/perception5/open.php?SESSION=7834957634859275&NAME=user1&GROUP=wiki
  • http://<Perception server>/perception5/perception.php?SESSION=4532957634859439&NAME=part1&PASSWORD=pwd

...where <Perception server> is the address of your Perception installation.

The following table describes URL parameters that are available:

Parameter Description Used with?
SESSIONS The 16 digit ID for the assessment  perception.php and open.php 
NAME The name of the participant you want to pass to the repository if using open.php or the ID of the participant if using perception.php perception.php and open.php 
GROUP The group of the participant you want to pass to the repository  open.php 
PASSWORD The password associated with the participant  perception.php

Where each of the parameters is of the format:

PARAMETER=parametervalue

To pass more than one parameter in the URL you can use the ampersand (&) to append additional parameters, see example below:

http://perceptionserver/perception5/perception.php?SESSION=4532957634859439&NAME=part1&PASSWORD=pwd

When linking to an assessment, you must ensure that SharePoint can access the Perception server. For example, you must ensure it is not installed behind different firewalls or is not connectable directly from the internet.