Advanced: Page Templates
Use the Page Templates settings to define custom templates in place of some or all of the default templates.
Use Custom Interview Templates
Select this option if you want to use your own templates for any of the listed events.
Custom templates
Name
The default template name: see
Default templates.
Type
Indicates whether the custom template information is generated from a template file, or a URL:
▪None: Use the default template.
▪Template: Use a custom template file: specify the template name in the Filename/URL cell.
▪URL: Use a custom template URL: specify the template URL in the associated Filename/URL cell.
Filename/URL
The custom template filename or URL. Custom template files must be in either the project’s source directory, in:
[INSTALL_FOLDER]IBM\SPSS\DataCollection\7\Interviewer Server\FMRoot\Master
or a shared location on your web server. In all cases, you specify the filename (not a path name). When the project is activated, templates that are in the project’s source directory are copied to the project’s directory in:
[INSTALL_FOLDER]IBM\SPSS\DataCollection\7\Interviewer Server\FMRoot\Master
When interviews take place, the interviewing program looks for the templates first in the project-specific directory and then in the main project directory.
If a Type = URL, you can specify a redirection by using the {querystring} parameter. For example, if an invitation has already been sent containing the URL, http://my-old-host.com/mrIWeb/mrIWeb.dll?I.Project=MYPROJECT&Id=XYZ, you can redirect the request to a new cluster at http://my-new-host.com: to do this, set the project as inactive on my-old-host, and then set a custom template for “project inactive” as a URL redirect to http://my-new-host.com/mrIWeb/mrIWeb.dll?{querystring}. When the HTTP GET for http://my-old-host.com/mrIWeb/mrIWeb.dll?I.Project=MYPROJECT&Id=XYZ occurs at my-old-host, a redirect page is created that redirects to http://my-new-host.com/mrIWeb/mrIWeb.dll?I.Project=MYPROJECT&Id=XYZ; that is, the query string from the original request is also used on the redirect request, which allows the query string to be passed across to the new server.
The {querystring} parameter is useful when migrating projects to new clusters, and also in other situations: for example, a redirect to a web application on authentication failure that uses the sample fields that were in the request to control the page that is displayed.
Default templates
You can specify all pages except Authenticate and Authenticate Retry as templates or URLs. For these two pages, use only templates, as URLs can result in an interview having two connection IDs.
Interview stopped
The page to display when the participant stops an interview or the interview is stopped by a statement in the interview script. There is no default template but UNICOM Intelligence Interviewer - Server Admin displays 'End of interview. Thank you for your participation.'
Interview completed
The page to display at the end of the interview; that is, when the participant has answered all relevant questions in the questionnaire.
There is no default page, but UNICOM Intelligence Interviewer - Server Admin displays 'End of interview. Thank you for your participation'.
If the interview ends with a display statement, this text is displayed as the last page of the interview instead.
Interview rejected
The page to display when a participant fails authentication and no retry prompt is required, for example, when the participant fails quota control.
The default is a template named rejected.htm that displays “Thank you for your interest in participating in this survey.”
Authenticate
The page to display when an inbound project uses Sample Management, and you need to verify that the person taking the interview is a member of the participant group.
The default is a template named authenticate.htm that displays “Please enter your authentication information”.
Authenticate failed
The page to display when authentication fails.
The default is a template named authfailed.htm that displays the message “Your authentication information is incorrect”.
Authenticate retry
The page to display when authentication of a prospective participant against the participant database fails, and you want the participant to reenter the authentication details.
The default page is a template named authretry.htm that displays “The authentication information you have entered is incorrect. Please try again”.
Project inactive
The page to display when the participant attempts to start an interview for an inactive project.
The default is a template named projinactive.htm that displays “Please come back later”.
Quota full
The page to display when the participant belongs in a quota cell whose target has already been met.
There is no default page.
See also