Questionmark's Open Assessment Platform

How do I create a URL that directly links to a Perception assessment?

It is possible to define a URL that links directly to a Perception assessment. How Perception will behave in terms of assessment and participant details can be determined in the URL. For example, you can:

  • Call perception.php/dll and make a participant login to start an assessment scheduled to them.
  • Call a specific assessment but require participants to log in.
  • Call a specific assessment for a specific participant.
  • Call an open assessment where a participant needs to enter a name before selecting the assessment of their choice.
  • Call a specific open assessment but require participant to enter their name/group.
  • Call a specific open assessment using predetermined participant name/group.
  • Call a specific open assessment using the participants Windows username.

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

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

The following table describes the URL parameters that are available:

Parameter Description Used with? (Perception 5) Used with? (Perception 4)
SESSION The 16 digit ID for the assessment  perception.dll and open.dll perception.php and open.php 
NAME The name of the participant you want to pass to the repository if using open assessments or the ID of the participant if using secure assessments  perception.dll and open.dll perception.php and open.php 
GROUP The group of the participant you want to pass to the repository  open.dll open.php
PASSWORD The password associated with the participant  perception.dll 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. For example:

  • Perception 5:
    • http://<Perception server>/perception5/perception.php?SESSION=4532957634859439&NAME=part1&PASSWORD=pwd
  • Perception 4:
    • http://<Perception server>/q4/perception.dll?SESSION=4532957634859439&NAME=part1&PASSWORD=pwd

Creating a URL as a direct link to assessments can be useful if you want to:

  • Include a link to an assessment in an Office document
  • Insert an iFrame into a webpage (LINK NEEDED!)
  • Embed an assessment in SharePoint using a web part