Options dialog box: Testing tab

Use the Testing tab of the Options dialog box to select a file that contains the default participant records when the Participant.xsu file is not found in the project directory.

The path for the appropriate default participant record file. This file will be used if there is no Participant.xsu file in the project directory. The default file path is:

[INSTALL_FOLDER]\IBM\SPSS\DataCollection\<version>\Author\Interview\Participant.xsu

The file that will be used for displaying the quota results in Microsoft Excel. The default file and file location is:

C:\ProgramData\IBM\SPSS\DataCollection\7\Author\Interview\DebugQuotaReport.mrs

Identifies the location of the quota data records file that is used for quota tracking. The default file location is:

C:\Users\<username>\AppData\Roaming\IBM\SPSS\DataCollection\7\Author\DebugQuotas

If your interview will use Sample Management when activated in UNICOM Intelligence Interviewer - Server, and the routing section of your interview script (.mdd) file accesses sample data, you can test your interview script before activating it.

Sample Management data is stored in a Sample User XML (.xsu) file, which contains a single sample record with one or more fields. The records and fields are defined using XML syntax. Each field has a name, a type and a value. You cannot have more than one sample record in a .xsu file, and each project's .xsu file must be in the <ProjectMDD>_files subdirectory.

The following sample record is from a file called Participant.xsu; its defauilt location is:

[INSTALL_FOLDER]\IBM\SPSS\DataCollection\7\Professional\ Interview

<SampleRecord ID="ID1">
  <SampleFields>
    <SampleField>
      <name>ID</name>
      <type>8</type>
      <value>ID1</value>
    </SampleField>
    <SampleField>
      <name>UserName</name>
      <type>8</type>
      <value>Name1</value>
    </SampleField>
    <SampleField>
      <name>Password</name>
      <type>8</type>
      <value>Password1</value>
    </SampleField>
  </SampleFields>
</SampleRecord>

When you create your own sample fields, you must give each field a type. A list of the valid values for the <type> element is shown in the following table. Make sure that the types in your Sample User XML file match the equivalent SQL field types for the sample table (sometimes known as the participants table) that your interview will use after activation.

Value of <type>	Equivalent SQL field type
2	Smallint
3	Int
7	Datetime
8	Char, Text, Ntext, or Nvarchar
11	Bit

For an example of the code you need to write to access the data in the sample record, see:

[INSTALL_FOLDER]\IBM\SPSS\DataCollection\7\DDL\Scripts\Interview\Sample Management - Scripts\Basic\Basic.mdd

which is intended to be used with Participant.xsu. The relevant parts of the script are shown below. When the script is run, the browser should display the message "Welcome to the Drinks Survey Name1", as Name1 is the value of the UserName field in Participant.xsu.

Metadata(en-US, Question, label)
  ...
  Welcome "Welcome to the Drinks survey {UserName}." info;
  ...
End Metadata

Routing(Web)
  ' Get the UserName from the sample record
  Welcome.Label.Inserts["UserName"].Text =   IOM.SampleRecord.Item["UserName"]
  Welcome.Show()
  ...
End Routing