up Inquisit Language Reference

file attribute

The file attribute specifies where Inquisit should record the data.

Member of

<data> <dataStream> <eyeTracker> <eyeTrackerSrResearch> <eyeTrackerTobii> <summaryData> <survey>

Syntax

/ file = path

Parameters

Name Type Description
path file A string indicating a valid local path, network share, or url to send the data.

Remarks

The file command specifies where Inquisit should record the data. The data file may be written to the local drive, a network share, or a web URL.

If a web URL is specified, the data is posted to the specified web address via HTTP POST. The web server can then extract the data from the POST request and save it. If you specify an http address, data is sent to the web server in plain text using the standard http protocol. If you specify an https address, the data is encrypted using Secure Sockets Layer (SSL) before being sent over the wire, which provides protection from packet sniffers. Since data can be posted and later retrieved from the data web service at millisecond.com (this is the default behavior for Inquisit Web), it should rarely be necessary to set up your own web server to handle web data collection.

If the data location requires login credentials, the user name and password can be specified using the userid and password commands.

For Inquisit Web, data is by default posted back to the millisecond.com web server via Secure Sockets Layer (SLL). For Lab, the data is saved to a *.iqdat file in the directory as the script.

See Gathering Data Over the Web for more information on saving data gathered on remote client machines to a network server.

If the file attribute is not specified and /separatefiles = false, the default file names are as follows:

Data element: [script file name]_raw_.iqdat

Summarydata elements: [script file_name]_summary_.iqdat

If the file attribute is not specified and /separatefiles = true, the default file names are as follows:

Data element: [script file name]_raw_[subjectId]_[year]_[month]_[day]_[hour]_[minute]_[second]_[millisecond].iqdat

Summarydata elements: [script file_name]_summary_[subjectId]_[year]_[month]_[day]_[hour]_[minute]_[second]_[millisecond].iqdat

Examples

The following appends the data to a local file:

<data>
/ file = "C:\myscript\mydata.iqdat"
</data>

The following saves the data to a network file share:

<data>
/ file = "\\server\fileshare\data\"
</data>

The following posts the data to a web server:

<data>
/ file = "http://www.foo.com/datafiles/"
</data>

Copyright Millisecond Software, LLC. All rights reserved.