Linking to Sawtooth Software's Web Survey from another Survey Program
Top  Previous  Next

Some users may find the need to link to Sawtooth Software's web survey software from another HTML form or Web-based survey. One of the most critical aspects is that you pass through an identifier that can be saved as the user name or password with the Sawtooth Software data set. That way, respondents from the two separate data sets can be matched during data processing.

Note: Linking multiple SSI Web surveys that result in more CiW questions than your license conveys is a violation of your license agreement.



URL Hyperlink to Pass Respondents Directly in SSI Web Survey


If you want to automatically pass respondents from another Web survey page to an SSI Web survey and automatically "pass through" the user name and/or password, you should link respondents directly to the SSI Web Perl script located in the cgi-bin directory. The following text included in an email message starts a survey with a studyname "tep1" located in the "gonzo" study root directory, with a valid username of "michael" and a password of "A6Z99":

http://www.sawtoothsoftware.com/gonzo/cgi-bin/ciwweb.pl?studyname=tep1&myusername=michael&mypassword=A6Z99


In this next example, only a username is used:

http://www.sawtoothsoftware.com/gonzo/cgi-bin/ciwweb.pl?studyname=tep1&myusername=michael


You can also pass additional variables into the data set, as long as those are defined as Pass-in Fields in the Questionnaire Access and Passwords dialog:

http://www.sawtoothsoftware.com/gonzo/cgi-bin/ciwweb.pl?studyname=tep1&mypassword=A6Z99&Q1=1&Q2=5


In this example tep1 is the study name, and there is just one password named mypassword, with A6Z99 as a valid value for mypassword. Q1 and Q2 are additional variables to be passed into the data set, and these variables were previously defined in the Pass-in Fields tab of the Questionnaire Access and Passwords dialog.

When respondents start the survey by clicking the hyperlink, if the passwords are valid (and the quota is not complete), the respondent is sent to the page following the Start page (page 1). If the respondent is restarting an interview, the page where he/she left off is displayed.

Warning: If you are "passing in" a variable to an ACA/Web, CVA/Web, or CBC/Web study that you plan to use as a case identifier for later merging the conjoint data with other survey variables, you should only use numeric values. SSI Web will not permit the creation of conjoint data files for summarizing or computing utilities that use non-numeric case identifiers.



Form Submit Button


You can create a "submit button" that sends respondents to the address of a Sawtooth Software survey and "passes through" a variable to be saved as the user name and/or password. Note that your survey program must be able to customize the HTML text on the fly with respect to the values of the variables passed through.

Here's some sample HTML:

<HTML>
<BODY>
Click the button below to continue survey.
<FORM METHOD="GET" ACTION = "http://www.website.com/survey/cgi-bin/ciwweb.pl">
<INPUT TYPE="HIDDEN" NAME="myusername" value="michael">
<INPUT TYPE="HIDDEN" NAME="mypassword" value="A6Z99">
<INPUT TYPE="HIDDEN" NAME="studyname" value="tep1">
<INPUT TYPE="SUBMIT" VALUE="Continue">
</FORM>
</BODY>
</HTML>



Linking from SSI Web to Another System

You can link from SSI Web to another system by specifying the Terminate/Link question type. You can dynamically insert respondent identifiers (such as user name and password) or even responses to questions within the SSI Web survey within the HTML of that hyperlink.

For more information about dynamically inserting user name, password, or answers to previous questions within the hyperlink, please see the section on Displaying Responses to Previous Questions
.