Collecting demographic data

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

Authors can utilize PIP to pass demographic information from a calling program to Questionmark, and have this information stored in special fields within the answer database.

There are ten special fields in the repository called Special_1 to Special_10 and each field can hold up to 50 characters of text. These fields can be displayed in Reporting and can be used to filter the contents of reports.

PIP includes ten input parameters that correspond to the ten special fields in the answer database. These are S1 to S10 and each of these input parameters can also hold up to 50 characters of text.

This section contains instructions on how to pass demographic information to Questionmark using PIP and use it in reports. To do so you will need to:

  1. Create an HTML page that will collect the demographic information and run an assessment
  2. Create a PIP file that is called from the HTML page above
  3. Use the HTML page to collect the demographic information and take the assessment
  4. Create a report that displays the demographic information

Each of these steps is described below.

Please note that in the example used below, the fields specified in the PIP file correspond to the fields created in the HTML file, for instance the PIP file contains:

S1=Organization

...and the HTML file contains:

<input type=text name="Organization" size=20 maxlength=50>

You can change the names of these fields, as long as the HTML file and the PIP file contain the same name.

Only 3 special fields are used to store demographic information in the example, but you can store up to a maximum of 10.

Creating an HTML page

To create an HTML page that will collect the demographic information:

  1. Using an HTML or ASCII editor, such as Notepad, enter the following HTML code.

<html>

<head>

<title>Demographic PIP example</title>

</head>

 

<body bgcolor="#eeeeff">

<br>

 

<!-- Start of demographic collection form -->

<form method=GET action="http://www.questionmark.com/perception5/session.php">

 

<input type=hidden name="call" value="demographics.pip">

Your name:<br>

<input type=text name="Name" size=20 maxlength=50>

<p> Organization name:<br>

<input type=text name="Organization" size=20 maxlength=50>

<p> Organization type:<br>

<select name="Industry">

<option></option>

<option>Educational</option>

<option>Corporate</option>

<option>Non-profit Org</option>

</select>

<p> Can we contact you with more details?<br>

<input type=radio name="Contact" value="Yes" checked>Yes<br>

<input type=radio name="Contact" value="No">No<p>

<input type=submit value="Submit details and start survey">

</form>

<!-- end of demographic collection form -->

</body>

</html>

Note: Change http://www.questionmark.com/perception5/session.php to match the URL to your own Questionmark area.

  1. Save the HTML document as demographics.html.
  2. Create a global resource folder called demographics in the repository (in OnDemand and OnPremise, create the folder in Authoring > Resources > Global Resources).
  3. Add the file demographics.html to the demographics.

Creating a PIP file

Once you have created the demographics.html file, you will need to create the PIP file that is called from the HTML page. To do so:

  1. Create a new document in your HTML or ASCII editor, and enter the following information.

; demographics.pip

 

[INPUT]

SESSION="4117626686784785"

S1=Organization

S2=Industry

S3=Contact

Note: Change the value of SESSION="4117626686784785" to an assessment ID that exists in the repository.

By placing the assessment ID in the PIP file you make your PIP use more secure. Using this approach the PIP file can be used with the specified assessment only.

  1. Save this document as demographics.pip in C:\Program Files\Questionmark\Perception5\server\pip (Perception) or Authoring > Resources > pip (OnDemand and OnPremise).

Using the HTML page

To collect the demographic information and take the assessment:

  1. In your browser, enter the URL below of the form:

http://<domain name>/<resources share name>/demographics/demographics.html

...where <domain name> is the domain name for your Questionmark area, and <resources share name> is the webshare name of the resources directory in the repository.

  1. Complete the demographic information, and click the Submit details and start survey button.

  1. Complete the assessment that now starts.

Creating a report

To create a report that displays the demographic information:

  1. Log in to Questionmark.
  2. Go to Report Manager and create a new Coaching Report.
  3. Select Special fields 1, 2 and 3 and assign these fields some useful labels in the Alternative label column.
  4. Configure the rest of the report according to the other information that you wish to be included.
  5. Once you have named this report, click Save and View to run the report.
  6. When the Coaching Report main page appears, select the report definition you just created and the assessment you called from the HTML file.
  7. Click Search.
  8. Click the name of the participant whose results you wish to view.
  9. You should now see the demographic information shown in the report.