-----------------------------------------------
Readme Notes (Microsoft Outlook Web Access - Survey Answer Form)
-----------------------------------------------

License Agreement

By using this sample/tool software, you agree to be bound by the terms described in the AFLICENS.HTM file in the support\collab directory of this CD-ROM. 

Support Policy

This EULA does not entitle you to support from Microsoft for the SOFTWARE PRODUCT. Microsoft does not guarantee the performance of the Microsoft Exchange Application Farm samples/tools, response times for answering questions, or bug fixes to the samples/tools. However, you may report bugs by sending Internet e-mail to AppFarm@microsoft.com. This e-mail address is only for Microsoft Exchange Application Farm related issues. Microsoft in its sole discretion may provide possible solutions to you for any bugs you report. The most current versions of all samples/tools are always found directly on the web site available via http://www.microsoft.com/technet/AppFarm; so do check the site and download the most up to date version if you find you are intrigued by what's provided in this sampler.

Requirements:

NT 4.0 with SP3
IIS 3.0 with (SP3) ASP installed, or higher.
Outlook Web Access option, available via from Exchange Server 5.5 Custom setup, installed on your web server.


Setup:

1)  Install Exchange Server.

2)  Create a directory called \Microsoft\Answer under the WebData\USA\Forms\IPM directory and copy all of the application's files into it.

Functionality:

This application is used to take surveys that were created with the VB16bit version of the Microsoft Survey application, which shipped with Exchange Server 4.0, 4.5 and 5.0.

If you want to create a survey or manage survey responses, install the Microsoft Survey application, which shipped with prior versions of Exchange Server.  This Survey composition form will also be made available from http://www.microsoft.com/technet/AppFarm

With Exchange Server 5.5 all Outlook clients (16bit, 32bit and Mac) provide the ability to launch web forms, in the case that neither a vb, EFD, nor Outlook version exist as a registered form handler.  This requires that the Outlook client be properly configured, on a per client basis.  This setting is available via the Tools.Options...Manage Forms tab, via the 'Web Services' button.  To enable you should enable the checkbox labeled "Use Outlook Web Access to open messages not understood by Outlook client" and then enter http://<YourServerNameGoesHere>/exchange/forms/openitem.asp for 'Web Services Location.'  Note:  you'll want to replace the <YourServerNameGoesHere> portion of the provided URL with your OWA server's machine name.

Known Issues:

1)  If you close the survey before choosing Send Results, your work will be lost.  The VB version does the same.

Note:  The minimum screen resolution for this application is 800x600.

Survey Blobs
------------
The Survey Sample Application uses two blobs to store data, the question and answer blobs.  The question blob includes information defining each question, and the answer blob contains survey response data.

Question Blob
-------------
The question blob is a comma/carriage return delimited string stored in a binary format.  The string includes a line or row for each survey question.  Each line consists of the following columns, delimited by commas. 

1) Column 1 contains the question text.

2) Column 2 contains the question type.
    
    Valid question types are:
	0 - Choice
	1 - True/False
	2 - Essay
	3 - Gradient
	4 - Ranking
	5 - Placeholder

3) Column 3 contains the question title.

4) Column 4 contains the section Title.

5) Columns 5-9 contain text values that are dependent on the question type.  These values are described below for each question type.

6) Columns 10-12 contain integer values that are dependent on the question type.  These values are described below for each question type.

7) Column 13 contains the required boolean.  Boolean indicating whether a response is required.


Choice Questions
----------------
When creating a "Choice" question, the survey author may establish 3-5 options.  In addition, the author must determine whether the options are exclusive.

Columns 5-9 contain the text for each option.

Column 11 indicates whether multiple options may be selected:
	0 - Allow 1 selection (option buttons)
	1 - Allow multiple selections (checkboxes)

Column 12 indicates the number of options for the question:
	1 - 3 options
	2 - 4 options
	3 - 5 options

True/False Questions
--------------------
For a "True/False" question, the survey author may write the text for up to 3 options (i.e. true, false, & N/A) and may establish "branching" for each option.  Under "branching," the next survey question depends on the option selected.

Columns 5-7 contain text for each option.

Column 8 indicates whether to display the third option.
	0 - Hide the third option
	1 - Show the third option

Columns 10-12 correspond with options specified in columns 5-7 and indicate how to handle branching for each question.
	0, 1 - Branch to the next question
	2    - Branch to the second question after the current one (skip the next question)
	3    - Branch to the third question after the current one (skip the next 2 questions)
	Etc.

Essay Questions
---------------
Essay questions may be single or multiple lines.

Column 11 indicates whether the essay is single or multiple lines.
	-1 - Single line
	 0 - Multiple lines

Gradient Questions
------------------
To define a "Gradient" question, the survey author writes 3 text values describing the mid-point and end points of the gradient range, defines the numeric values of the range, and indicates whether ticks are to be displayed.

Columns 5-7 contain text describing the mid-point and end points.

Column 8 indicates the type of range.
	0 - 1 to range size
	1 - 0 to range size - 1
	2 - -(range size)/2 to (range size)/2

Column 11 is the range size.

Column 12 indicates whether to show the numeric range.
	0 - Hide numeric range
	1 - Show numeric range

Ranking Questions
-----------------
When "Ranking" questions are created, 3-5 items are listed for ranking.

Columns 5-9 contain text for up to 5 items.

Column 12 indicates the number of items.
	0 - 3 items
	1 - 4 items
	2 - 5 items

Place Holders
-------------
"Place holders" indicate the end of the survey, contain instructions for display in the course of the survey, or indicate branching.

Column 10 indicates the place holder type.
	0 - Survey end
	1 - Instructions
	2 - Branch to question

Column 11 defines branching.
	0, 1 - Branch to the next question
	2    - Branch to the second question after this one
	Etc. 


Answer Blob
-----------
Like the question blob, the answer blob is a comma/carriage return delimited string stored in a binary format.  The string includes a line or row for each survey question.  Each line consists of 7 columns delimited by commas.  Column 7 contains the index or row number of the associated question in the question blob.  The use of the columns 1-6 depends on the question type as described below.

Choice Answer
-------------
Under "choice" questions, options selected may or may not be exclusive.

Column 1 contains an integer in the range 1-5 that indicates the selected option if only one option may be selected.

Columns 1-5 indicate whether an option was selected when more than one option may be selected.
	0 - Option not selected
	1 - Option selected

True/False Answer
-----------------
"True/false" questions actually provide for up to three options (i.e. true, false, & N/A).

Column 1 contains an integer in the range 1-3 indicating the selected option.

Essay Answer
------------
Column 6 contains the essay text.

Gradient Answer
---------------
Column 1 contains an integer in the gradient range.

Ranking Answer
--------------
Columns 1-5 contain an integer corresponding to an option being ranked.  For example, if column 1
contains 3, then the third option is ranked first.

Place Holder Answer
-------------------
No data stored is stored in the answer blob.
