18th. October, 2007

This file contains further information regarding:

1. Requirments
2. Installation
3. New features in The Surveyor 8.5
4. Creating your web pages
5. Conversion/Upgrading      *** IMPORTANT ***
6. Known issues
7. Version History
8. Documentation
9. Support Contacts

Information about our licencing of this product can be found at our web site http://Videlicet.com/


------------------------------------------------------------------------------------------------


1. REQUIREMENTS

Macintosh:

Requirements for The Surveyor developer CPU: Mac OS X.3.9 or higher. For best performance, we recommend at least a 1GHz G5 or Intel processor. A monitor with 1024 by 768 pixels or more is desirable. The Surveyor runtime application runs under Mac OS X, but the data files can be also used with FileMaker version 8.5. The runtime application requires that Surveyor.USR be present in the same folder as the application and/or your questionnaire data file (depending on your chosen configuration for development and deployment). 

Requirements for web server deployment: WebSTAR/Apache and Lasso. Please see the http://WebSTAR.com/ site for information about the WebSTAR server and the http://LassoSoft.com/ for details about Lasso and the latter's supported databases. Apache details will be with your server documentation or your Apache download (usually from http://Apache.org/). Lasso 7.1.3 is required as a minimum (Lasso 8.0.2 or greater is preferred), and the latter requires OS X, Windows 2000 or XP, or RedHat Linux. Questionnaire web files created by The Surveyor on Mac OS X will run unmodified under Windows and Linux web server platforms supported by your version of Lasso, and vice versa. 

A database engine for data collection is required. This may be any engine supported by Lasso, but automatic support is provided by Lasso for its built-in SQL database (LassoMySQL (Lasso 7.1.3) or LassoSQLite (Lasso 8.0.2 and above)) and an installation of MySQL external to the Lasso location. Other SQL databases are supported by Lasso through JDBC or ODBC. Limited support for FileMaker data collection databases by JDBC is also available, but not formally supported. 


Windows:

Requirements for The Surveyor developer CPU: Windows 98 or better (Windows XP required for Lasso 7 service and above). For best performance, we recommend at least a 2GHz processor. A monitor with 1024 by 768 pixels or more is desirable. 

Requirements for web server deployment: Please see the Microsoft¨ web site for information about IIS and LassoSoft for details about Lasso and the latter's supported databases. You can also use Apache or Apache 2, as supported by your version of Lasso. 

A database engine for data collection is required. This may be any engine supported by Lasso, but automatic support is provided by Lasso for its built-in SQL database (LassoMySQL (Lasso 7.1.3) or LassoSQLite (Lasso 8.0.2 and above)) and an installation of MySQL external to the Lasso location. Other SQL databases are supported by Lasso through JDBC or ODBC. Limited support for FileMaker data collection databases by JDBC is also available, but not formally supported. 



If you don't have a web server, please note that since version 5.0, The Surveyor can NO LONGER run directly from FileMaker Pro, since the new version 7 of FileMaker Pro makes this too complex, too expensive, and less flexible for our users. We took this strategic direction, since there is no longer much call for stand-alone FileMaker data collection. Limited support for FileMaker 7 and 8 is provided through the FileMaker JDBC interface and Lasso's JDBC connector, but is not formally supported. 


------------------------------------------------------------------------------------------------


2. INSTALLATION

1) If you intend to use MySQL instead of Lasso's built-in SQL database, ensure that you have installed MySQL on your server (or on another machine to which your web server computer has rapid access). See http://MySQL.com/Downloads/ to download. Use the latest Generally Available release for your computer, and pick a mirror site from which to do the download and follow the installation instructions. It's a simple process, usually just a double-click; 

2) Ensure that you have installed Lasso on your web server computer. See http://LassoSoft.com/Downloads/index.lasso to obtain a download and installation instructions. Choose the Developer version if you simply want to test The Surveyor. Note that, as of Lasso version 8.5, Lasso will run in developer mode if it does not have a valid serial number. This is a major improvement for trying out Lasso and The Surveyor, since it allows you to test your Lasso installation and to test The Surveyor without the hassle of getting a temporary licence serial number. Once the download to your computer is complete, double-click the installer for default installation on your computer. This should finish by calling up a browser page that asks you for a Lasso _server_ administrator name and password that you'll remember. You'll also have to set up a user and password for your default web site (as opposed to the Lasso administrator name/password). For do this, click to the Sites > Sites > Preferences tab, and enter a _site_ adminstrator name and password. This should be different from the Lasso _server_ name and password. For full, illustrated, step-by-step installation instructions, please see the Lasso documentation; 

3) Double click on The Surveyor archive you downloaded to expand it to a folder (The Surveyor or The_Surveyor_nnn_Beta, where nnn is Mac or Win) which contains this Read Me file, the Installation Manual pdf file for The Surveyor (includes instructions for installing Lasso), the User Manual pdf file for The Surveyor, and the folder (Surveyor_x.x.x) that contains all the files/folders for The Surveyor itself. Please note that full installation and use instructions for The Surveyor can be found in the manuals. 

You should ensure that the Surveyor x.x.x folder and all of its contents have read AND write capability, before you use The Surveyor. Please check this NOW, because some archive expanders set all of the contents of expanded archives to Read Only. It will only frustrate and confuse you, if these files/folders do not have write permissions. 

Do NOT delete folders inside the enclosed "Surveyor x.x.x" folder unless you move them with The Surveyor files/application to the same destination folder. This is because The Surveyor expects these folders to be present in the folder in which it resides when it performs its exports (i.e. The Surveyor attempts to create files in folders RELATIVE to the folder in which it finds itself). Ideally, keep everything in the folder created by the archive and then move that single folder to where you want it on your hard drive. You CAN rename this folder to whatever you want, however; 

The main Surveyor folder contains the Surveyor application (Surveyor on Mac computers, Surveyor.exe on Windows computers), a Surveyor.USR and Questionnaire.USR file, along with Index.html, Index.lasso, Error.html, and Error.lasso, along with folders named Exports, Images, Imports, Includes, Pages, SPSS Scripts, and Summaries. These four files and the contents of the folders contain the export from The Surveyor for the Sample questionnaire on our web site, i.e. the content that would be served by your web server once you've changed the domain name references to your domain, and images needed to serve your Sample questionnaire (domain and path settings, notwithstanding). The main Surveyor folder also contains exports of the two Word¨ files that The Surveyor can export (Survey Summary.RTF and Questionnaire.RTF), along with an support files and folders for the application: an Extensions folder (Mac and Windows), and .dll files on Windows computers; 

4) To run The Surveyor, double click on Questionnaire.USR; drag it onto the Surveyor application you just downloaded; or drag it onto your own copy of FileMaker 8.x; or open FileMaker 8.x and then double-click the Questionnaire.USR file;

5) The first thing you should do after opening The Surveyor is to specify YOUR domain and file locations in the Set Up > Server pane of The Surveyor. In this pane, the domain should be of the form Videlicet.com (or a quad-IP in the form of xxx.xxx.xxx.xxx). The lower-level paths should be with respect to the domain and they must start with a slash character: /, per the Sample questionnaire settings in the copy of The Surveyor's Questionnaire.USR file that you downloaded; 

6) If you intend to send files by e-mail from the administration area of your questionnaire, make sure that, before you perform the file export from The Surveyor, you've entered appropriate e-mail account information in the Set Up > E-Mail pane of The Surveyor. You'll need to modify the six fields at the top of this pane. Note that this e-mail account must have relay capability (defined in your SMTP e-mail server). If your e-mail server requires SMTP authentication, include the account password in this pane. If authentication is not required, just leave the password field empty. If you want to send the questionnaire administrator an e-mail each time a respondent finishes a questionnaire, make sure that the Administrator BCC has an e-mail address. If you want to send e-mail copies of information resulting form importing files using the questionnaire web interface or summaries of bulk e-mail you've sent from the questionnaire web interface, make sure that the Administrator e-mail address is filled out; 

7) This completes your set up of The Surveyor itself for the Sample questionnaire contained in the download. To create and run your version of the Sample questionnaire on your web/Lasso server, follow the instructions in the next section. 


------------------------------------------------------------------------------------------------


3. CREATING YOUR WEB PAGES

1) As noted in the previous section, you need to decide upon a path to your questionnaire folder and, if applicable, the questionnaire_s_ folder above it (see Figure 2 on page 3 of the User Manual for more details). These should be entered in the Set Up > Server pane in The Surveyor. Note the difference between the Questionnaires level and the Questionnaire level. This distinction permits many questionnaires to be hosted and kept easily separate from each other;

2) Your Includes, Pages, Imports, Exports, and Summaries folders on your server should have Unix/Windows ownership and privileges such that BOTH the Lasso user and the web server software user have read and write access permissions to these folders (you should get an appropriate error message in your browser if the folder cannot be read/written). If you get a "File Not Found" error in a blank page when you surf to your questionnaire, it is likely that the folder/file privileges have not been set properly. If there is Read permission but not Write permission, you may find that your browser stalls when you first try to open pages of your questionnaire, i.e. no page is returned and your browser still appears to be trying to connect to your server. In this case, stop your browser and make sure that Lasso has BOTH Read AND Write access to ALL of the these folders and the files they contain). Note that WebSTAR and Lasso both seem to default to the 'staff' user on Mac OS X, and that Lasso seems to put itself in the 'admin' group for most Apache installations on Mac OS X. You may want to put both the Lasso and web server users into, say, the Admin group and give that group read and write privileges to all files and folders associated with serving your questionnaire; 

Please note the LassoSoft and WebSTAR are aware of a minor Unix privileges problem in this area. Please see their discussion list archives for more information about this issue (http://www.LassoSoft.com/Support/FAQs/index.lasso?7613);

3) Once you've made the domain name changes to the sample Questionnaire.USR in your downloaded copy of The Surveyor Questionnaire.USR file, export the files needed by your web server by going to the Export pane and clicking the All Web Pages button (depending on the speed of your processor, this may take a few minutes. For comparison, an iMac G5 2.1GHz takes approximately 5 minutes and 30 seconds to export all the pages for the Sample questionnaire). Do not force quit The Surveyor (or FileMaker) during this export. As an aside, this is a good place for us to remind you to make backups in a timely manner;

4) PLEASE NOTE: as of version 8.5, The Surveyor has changed the field names it uses in the data collection database. This means that, if you intend to use this version of The Surveyor with an existing questionnaire, you should re‘xport ALL files from The Surveyor and overwrite the ones currently on your server, AS WELL AS recreating your data collection database. If you are already collecting data using files created with an older version of The Surveyor, DO NOT overwrite those files with files created by The Surveyor 8.5 and above. Please also note that the first time each web page is called up by a browser, the server has to do some file editing for you, so it may take a little longer to view the page the first time it is called. This is normal. Subsquent calls to the page will be fast; 

5) Now, from your main Surveyor folder, copy the

Pages
Includes
Images
Imports
Exports
Summaries

folders and the

Index.html
Index.lasso
Error.html
Error.lasso

files to the appropriate place on your web server for your chosen questionnaire's path within its domain, and it's ready to run.  :-) 

If your questionnaire is lower in the heirarchy than your domain, you should place the contents of the "Surveys Pages (one level up)" folder into the folder that contains your questionnaire folder and modify the name of this folder and the code in the files the files it contains, to suit your own needs (these files are provided only as examples of structure. They are not intended to 'run,' since we cannot predict the domain paths/names you will choose, or how you'd like these upper level pages to look). This folder is needed so that the "Questionnaires" level variables are available to all questionnaires on your site. Otherwise, you will get an error telling your that the ..../Includes/Name.lasso file cannot be found. This error should not occur if your Questionnaires-level path is empty in the Set Up > Server pane of The Surveyor. Again, you should modify these files to your own needs (or replace them with your own that contain the surveys-level lasso variables), before use of pages at this level in a production survey site; 

6) Again, remember to ensure that the Exports, Imports, and Summaries folders and their contents have both Read and Write permissions for both your web server process(s) and the Lasso process(es). File/folder permissions are, by far, the most frequent source of problems getting questionnaires up and running. Correct permissions for these folders allow the questionnaire administrator to upload lists of respondents, export collected data, and export summary files of an individual's responses to your questionnaire. See 2. INSTALLATION, above, for more on this; 

7) In your browser, go to the questionnaire home page. As of version 8.1 of The Surveyor and for questionnaires for which the SQL database and tables have yet to be created, you will be presented with a browser security prompt for the Lasso SITE administrator's login information. This ID and password allows the database and tables to be created. This prompt will also occur each time you put a freshly exported copy of Name.lasso into the Includes folder of your questionnaire. 

After providing the Lasso ID and password, you will be shown the questionnaire home page (note that this will be after a delay, which depends on the speed of your server, as Lasso edits the web page files to clean up extraneous characters before sending the page to the browser (these characters are an artifact of the FileMaker run time application during the export process from the Questionnaire.USR file). This delay occurs only once, i.e. the first time a given file is called by your questionnaire server). Now, click the Admin button (or surf directly to http://YourDomain.com/PathToYourQuestionnaireHomePage/Pages/AdminSecurity.lasso) and then the Create DBs button (if one or both of these is not visible, then surf to http://YourDomain.com/PathToYourQuestionnaireHomePage/Pages/AdminMySQL.lasso, where YourDomain.com is the domain you entered into The Surveyor before you performed your export of the web files for your Sample questionnaire). Type in a useful questionnaire administrator name and password (i.e. one for this _questionnaire_ only), your Lasso SITE administrator's username and password (the same as you used in the Lasso security prompt, NOT the Lasso _server_ name/pw). You can also enter the name of your respondents import file, if you have one already in the Imports folder. Then, click the Create button; 

8) You're done! After a minute or so (again, depending on speed of your server computer), your browser will show you the results of the questionnaire database, tables, and user privilege creation on a single, detailed page. If there are any errors, they should be displayed prominently on this page. You can now click to the questionnaire home page button (the default text for this button is Survey) and start creating/answering questionnaires as if you were a respondent. You can also log into the Administration area using the Admin name and password you entered when you created the questionnaire database and tables. 

At this point, and before creating a response record or logging into the questionnarie adminstration area, we recommend quitting your browser to clear cookies and the security ID and password from the browser's authentication. Please note that, if you click the Log Off button at the bottom of the web page, only the cookies will be cleared, not the browser authentication. To clear the latter, you must quit/restart your browser (note that the cookies expiry time defaults to a few minutes for the questionnaire administrator and responents, but you can change these any time on the Set Up > Server pane of The Surveyor and then re‘xport the Name.lasso file).

You can use the sample data we supply in the Imports folder as a model for your questionnaire, but you might want to change the e-mail addresses in these files before you import them for your own testing. 

You can use the Tab File Import Format give you a complete list of fields for when you import questions into The Surveyor itself. Note that, as we add fields for use in The Surveyor, these will be appended to the current list in this file, to ensure that previously-created question import files will continue to work with newer versions of The Surveyor. 


------------------------------------------------------------------------------------------------


4. NEW FEATURES IN THE SURVEYOR 8.5FC5, 18th. October, 2007

The Surveyor 8.5FC5 is the final FC release of The Surveyor. No further feature creep will occur until the documentation has caught up with the application and all the language translations have been completed. 

This version is feature complete, except the language functions, which will be fully in place in the final release. 

New Features:

1) Questionnaires are now Section 508 and W3C WCAG compliant (with minor exceptions). Please see our Voluntary Product Accessibility Template (VPAT) at http://Videlicet.com/Home/Creation/Pages/VPATTheSurveyor.lasso for more details; 

2) Can start and stop a questionnaire from the web interface; 

3) Automatic timeout of pages, to add more security to partially completed response pages; 

4) Can now select whether to insert 'of n pages' in the page title bar and page header; 

5) Updates to css style sheets; 

6) Added question vertical alignment; 

7) Separated the Administrator e-mail address from the administrator BCC address and made them capable of being different for each language; 

8) Added visible warnings for problems with question records; and 

9) Miscellaneous minor functional additions/improvements. 

Added provision for a file.

Bug Fixes:

1) All other reported/observed bugs have been fixed.


------------------------------------------------------------------------------------------------


5. CONVERSION/UPGRADING

***  IMPORTANT INFORMATION ABOUT UPGRADING FROM PREVIOUS VERSIONS  ***

The Surveyor is a major upgrade from previous versions. Security upgrades have required that you cannot export questionnaires from 8.5 and have them work with previously existing Surveyor data collection databases. Please use The Surveyor 8.5 and up for only questionnaries for which you have yet to collect any data. There IS a simple, manual way to use old databases with new files, so please contact us if you need to continue using existing Surveyor collection databases with 8.5 web files. 

If you have been using The Surveyor 8.x to 8.5FC4l, you will need to do a two-stage import to upgrade your questionnaire to version 8.5FC4m and above. To do this, you should use the 'Convert from prior to 8.5FC4m.USR' file for the first stage, and then import the date into the latest version from that interim file. If you have problems or questions about this, please contact us. 


------------------------------------------------------------------------------------------------


6. KNOWN ISSUES

1. There is a minor issue of Unix file permissions that is known by LassoSoft and Kerio. It affects all questionnaire folders on the web server. It is simple to fix in the cammand line console. Please see http://www.LassoSoft.com/Support/FAQs/index.lasso?7613 for more details; 

Please report any problems with this release directly to Bugs@Videlicet.com. 


------------------------------------------------------------------------------------------------


7. VERSION HISTORY

For current version information, please see section 4), above.

---------------------------------------------------

Version 8.5FC4, -> 2nd. October, 2007

The Surveyor 8.5FC4 was a series of small updates with both bug fixes and feature updates for particular customers. 

New Features:

1) Modifications for Survey creation page text, to make it customisable; 

2) Modifications for Survey creation reply page text, to make it customisable; 

3) Added landing page for after questionnaire completion; and 

4) Other miscellaneous minor improvements for customers.

Bug Fixes:

1) All other reported/observed bugs have been fixed.

---------------------------------------------------

Version 8.5FC3, 4th. January, 2007

The Surveyor 8.5FC3 is a final candidate of a new version of The Surveyor. 

New Features:

1) Miscellaneous minor improvements.

Bug Fixes:

1) All other reported/observed bugs have been fixed.

---------------------------------------------------

Version 8.5FC2, 9th. December, 2006

The Surveyor 8.5FC2 is a final candidate of a new version of The Surveyor. 

New Features:

1) Results pages. One as summary of all results for which you've specified results should be made available, and one that allows the user to choose to see the results for one question at a time; 

2) Results generation speed is much improved; 

3) More speed improvements to questionnaire web pages; 

4) Rearranged footer buttons to reduce cumulative width when Results button is displayed; 

5) Easier handling of log-ins to The Surveyor; 

6) Fonts can now be specified in ems; 

7) Language choice web buttons can now have their background colour specified; 

8) Background colours can now be left blank, to allow for 'transparent' question/response and other text backgrounds on questionnaire web pages; 

9) Miscellaneous minor improvements.

Bug Fixes:

1) Problems due to SQLite syntax in Lasso have been fixed; 

2) Corrected problem with format of confirmation e-mails; 

3) All other reported/observed bugs have been fixed.


---------------------------------------------------

Version 8.5FC1, 23rd. November, 2006

The Surveyor 8.5FC1 is a final candidate of a new version of The Surveyor. 

New Features:

1) There is now a Rank question type, so that you can force your respondents to specify from 1 to n the rank of the following n questions (use the Rank Header in the same way as you'd use the Subquestion Header, by specifying the number of following questions to be included in the ranking); 

2) 'Hooks and handles' for up to five languages are supported for both question/response text, and alerts (full function not available in 8.5FC1).

Bug Fixes:

1) Fixed reported minor bugs.


---------------------------------------------------

Version 8.5§1, 14th. September, 2006

The Surveyor 8.5§1 is a new version of The Surveyor. 

New Features:

1) .mov and .mpeg movies can be placed as 'moving' pictures, using the Picture response type. The movie will be embedded where a picture would have been placed (note that movie file names must have .mov or .mpeg type); 

2) Checkbox, Menu, Picture, Radio, Select, and Select-Multiple question types can now have their response order randomised; 

3) Questions can now be presented in a randomised order in groups that you specify on any page (use the Random Header in the same way as you'd use the Subquestion Header, by specifying the number of following questions to be randomised as a group. We have found it best to not have question numbering on when using this function); 

4) Button names and labels can now be specified by the questionnaire developer in text form, rather than recreating a new image. A benefit of this new feature is that only one large and one small image need be created for buttons, since the web page overlays the text over this image; 

5) 'Hooks and handles' for up to five languages are supported for both question/response text, and alerts (full function not available in 8.5§1); 

6) New, more secure scheme for database access for users of Lasso 8.x and up; 

7) Speed improvements. 


---------------------------------------------------

Version 8.1.8, 1st. September, 2006

The Surveyor 8.1.8 is a maintenance update to The Surveyor 8.1.7 to prepare for The Surveyor 8.5. 

Note: Due to corrections for the Integer and Number field types, if you used the Integer or Number fields types for published questionnaires, you should not use re‘xported files from this version to rewrite files for those questionnaires. Also, due to security changes, if you wish to use this version of The Surveyor with published questionnaires, we _STRONGLY_ recommend that update ALL files from this version, rather than updating individual files. 

New Features:

1) Added code to export data to tabbed files for import into version 8.5.

Bug Fixes:

1) Minor corrections.


---------------------------------------------------

Version 8.1.7, 11th. June, 2006

The Surveyor 8.1.7 is a maintenance update to The Surveyor 8.1.6. 

Note: Due to corrections for the Integer and Number field types, if you used the Integer or Number fields types for published questionnaires, you should not use re‘xported files from this version to rewrite files for those questionnaires. Also, due to security changes, if you wish to use this version of The Surveyor with published questionnaires, we _STRONGLY_ recommend that update ALL files from this version, rather than updating individual files. 

Bug Fixes:

1) Corrected a problem of incorrect export of number of respondent pages in Name.lasso file.


---------------------------------------------------

Version 8.1.6, 10th. June, 2006

The Surveyor 8.1.6 is a maintenance update to The Surveyor 8.1.5. 

Note: Due to corrections for the Integer and Number field types, if you used the Integer or Number fields types for published questionnaires, you should not use re‘xported files from this version to rewrite files for those questionnaires. Also, due to security changes, if you wish to use this version of The Surveyor with published questionnaires, we _STRONGLY_ recommend that export all files from this version, rather than updating individual files. 

New Features:

1) Added fields to help refer to database fields or JavaScript objects in JavaScript jumps.

Bug Fixes:

1) Corrected a problem of an uncleared checkbox field variable in the Survey.lasso page.


---------------------------------------------------

Version 8.1.5, 11th. May, 2006

The Surveyor 8.1.5 is a maintenance update to The Surveyor 8.1.4. 

Note: Due to corrections for the Integer and Number field types, if you used the Integer or Number fields types for published questionnaires, you should not use re‘xported files from this version to rewrite files for those questionnaires. Also, due to security changes, if you wish to use this version of The Surveyor with published questionnaires, we _STRONGLY_ recommend that export all files from this version, rather than updating individual files. 

New Features:

1) Added dialogue asking if set up should be imported as well as data when questions are imported from another Surveyor database.

Bug Fixes:

1) Worked around issue where MySQL 4.1.18 on Mac platform would rename tables without a request from The Surveyor; 

2) Fixed issue where, under some circumstances, multiple uses of the Back button on some browsers would cause an earlier page to be displayed; 

3) Fixed typo that was introduced in the Name.lasso file in version 8.1.4. Under some circumstances, the questionnaire would repeatedly ask for authentication, when no authentication should have been required.


---------------------------------------------------

Version 8.1.4, 5th. May, 2006

The Surveyor 8.1.4 is a maintenance update to The Surveyor 8.1.3. 

Note: Due to corrections for the Integer and Number field types, if you used the Integer or Number fields types for published questionnaires, you should not use re‘xported files from this version to rewrite files for those questionnaires. Also, due to security changes, if you wish to use this version of The Surveyor with published questionnaires, we _STRONGLY_ recommend that export all files from this version, rather than updating individual files. 

Bug Fixes:

1) A further unusual combination of database name and/or database alias in Lasso admin and/or case of those names has come to light. The Name.lasso and AdminMySQLReplyScript.lasso files have been updated to allow for this possibility. The problem MAY be manifest for existing questionnaire databases or for other existing databases where the name/alias combination has been changed manually in Lasso admin or the case of the name and/or alias has been changed manually in Lasso admin. This update works around these Lasso admin name/alias combinations.


---------------------------------------------------

Version 8.1.3, 27th. April, 2006

The Surveyor 8.1.3 is a functional update to The Surveyor 8.1.2. 

Note: Due to corrections for the Integer and Number field types, if you used the Integer or Number fields types for published questionnaires, you should not use re‘xported files from this version to rewrite files for those questionnaires. Also, due to security changes, if you wish to use this version of The Surveyor with published questionnaires, we _STRONGLY_ recommend that export all files from this version, rather than updating individual files. 

New Features:

1) Seed values are now checked for appropriateness at time of exports from The Surveyor and warning provided if there's a problem;

2) Mismatch of Lasso connector and MySQL host database name now checked and warning provided, if necessary; 

3) If questionnaire database is present, but questionnaire tables have been deleted, warning now provided for each that is not available; 

4) Better handling of Lasso administrator username and password to provide more useful warning if there is a problem; 

5) Improvements to questionnaire-level ('host') Error.lasso file; 

6) .lasso file type no longer required when entering file names. The Surveyor adds the .lasso extension for the questionnaire administrator; 

7) Can now export ALL response fields (including the calculated fields) to a single file for use in SPSS. This applies to both parent and child responses. Separate .sps file is provided for this export type. Child .sps files now divided per child table to make it easier to use child table data in SPSS; 

8) Added clarification text to the questionnaire administration export page and others; 

9) List of import files now available to logged-in questionnaire administrator in the Lasso database creation web page;

10) Extra features now available for Checkbox and Select-Multiple JavaScript tests. Developer can now check for checked/selected, number checked/selected, total value of checks/selections, and do alphanumeric searches of a concatenation of the checks/selections. Code for these, and examples is now provided for these 'extra' JavaScript fields; 

11) 'Extra' JavaScript jumping code that includes [NoProcess] or [/NoProcess] will now be included 'as-is,' to allow both JavaScript code and Lasso code in your extra code; 

12) Eased some of the file privilege checking to make installation easier and more similar for all of the Lasso-supported operating systems; 

13) The Surveyor now handles the differing settings in MySQL with respect to case of database names (some versions of MySQL install with forced lowercase for the database and/or table names. Other versions do not, which can cause problems with Lasso exact match searches used by The Surveyor). 


Bug Fixes:

1) Export of collected data of field type Number and Integer has been corrected, as have exports for fields in SumTotal collections; 

2) Security problem in the WriteQuestionnaire.txt and EMailSurvey.txt has been fixed. If you use these files and want to put in the security update, you MUST re‘xport these files and the Name.lasso, EMSent.lasso, and WriteQuestionnaireReply.lasso files for your questionnaire to work, because the problems files have been renamed to WriteBody.lasso and EMailBody.lasso, respectively; 

3) For consistency with 2) above, EMailSent.html has been renamed EMailSendPage.lasso. Hence, if you use this file, you should re‘xport EMailSentPage.lasso and EMailSend.lasso for your existing questionnaires. The renaming of this file was not due to security issues. All files from the Surveyor are now .lasso files, except where needed otherwise; 

4) Dropping of databases and/or tables without removing the Lasso administration settings has been worked around; 

5) Worked around identified file permissions issues; 

6) Worked around character conflicts between Lasso and JavaScript in presenting question text with Lasso code in it. Please note that the characters [ and ] are now considered reserved in question text. This is because Lasso will attempt to execute anything between [ and ], allowing you to put Lasso code into any question. The ' character is handled by The Surveyor, so it CAN be used in your question text; 

7) Corrected error in the circumstance that a value list is calculated from numbers AND one of the resulting values in the list is zero. (This 'zero' error was present _only_ for choices lists calculated from start and end points, not for value lists using the typed-in choices lists where one of the choices had a zero value.) This would cause Lasso to use the zero value as the default when presenting the web page field; 

8) Corrected a minor problem when checking Lasso version and flushing the internal database tables; 

9) Miscellaneous small conflicts between Lasso, JavaScript, and html special characters have been cleaned up.  


---------------------------------------------------

Version 8.1.2, 7th. April, 2006

The Surveyor 8.1.2 was a special release for a particular client. 


---------------------------------------------------

Version 8.1.1, 28th. March, 2006

The Surveyor 8.1.1 is a functional update to The Surveyor 8.1.0. 

New Features:

1) Setting for the default alignment for text in the ancillary pages;

2) Page number on/off selection now available; 

3) Better handling of questionnaire setting deletions in Lasso Administration; 

4) Any combination of User ID, password, e-mail mow possible for respondent file import, including empty values. The import code will generate random values whenever these data are missing; 

5) If imported User ID is a valid e-mail and no e-mail address is provided, the User ID is also used for the EMail field; 

6) Several minor improvements to the web administration pages, including ability to include Lasso code in subject and body of e-mails sent to respondents; 

7) Log in information in sent e-mails can now have both encrypted linnk, as well as ID/pw combination, if desired by the questionnaire administrator. 


Bug Fixes:

1) Moving all pages _including_page_1_ upwards no longer causes a an infinite loop; 

2) Last character of some results labels no longer missing; 

3) Count of e-mails sent at import of respondents corrected; 

4) Corrected error in export of collected data to file (error was introduced in version 8.0.5); 

5) Corrected error affecting certain dates when selecting respondents for an e-mail notice; 

6) Removed limit of 50 e-mails sent from the e-mail notice in questionnaire web administration; 

7) Corrected minor problem in the Index.html file cleanup; 

8) Corrected cookie timeout error.

---------------------------------------------------

Version 8.1, 10th. February, 2006

The Surveyor 8.1 is a functional update to The Surveyor 8.0.14. 

New Features:

1) Prefix and suffix are now available for response section; 

2) Two new field types are now available: Number and Integer; 

3) When exporting files that take more than about a second to export, The Surveyor now confirms completion of the export with a beep and confirmation dialogue; 

4) All control records are now identified with the Type field. Upon import to this version, data from text files and other Surveyor files are updated to this new format. References to 'Portal' type are now identified by 'Related,' as part of the change to more consistent naming of fields, records, items, and related records in this new version. 

5) Removed the need to remove soft return characters from the web questionnaire files. Note that permissions for the Questionnaire web folders and their contents must be set to Read, Write, and Execute for the Lasso user. On Mac OS X with WebSTAR, this means that the 'staff' group must be able to read and write to the folder and is sub-folders; 

6) Import from text file now imports all fields for a question record; 

7) Numerous other improvements 'under the hood.' 

Bug Fixes:

1) Minor updates and cosmetic changes.

2) Other minor fixes.

---------------------------------------------------

Version 8.0.14, 22nd. November, 2005

The Surveyor 8.0.14 is a maintenance update to The Surveyor 8.0.13. 

New Features:

1) Coded around a bug in MicroSoft Internet Explorer, which treats the case of cookie domains differently when saving and retrieving cookies. 

Bug Fixes:

1) Fixed minor problem with the exporting of Questionnaire.RTF file.

---------------------------------------------------

Version 8.0.13, 31st. October, 2005

New Features:

1) Added "encrypted link" selection for direct login from e-mail body; 
2) Added Word output file for paper-based questionnaires; 
3) Many additions to the export of SPSS files, including the ability to prepend header text to SPSS variable label(s); 
4) Ability to specify whether a given field should be excluded from the export to the numerical, textual, or both forms from the data collection database; 
5) Skip pattern Javascript Override now included, as is, in the Word summary file; 
6) Added count of Checkboxes checked for each Checkbox question. Similar counter added for Select_Multiple fields. These can be used for skip pattern overrides; 
7) Subquestion header bar can now be turned off by specifying zero height, as well as by spcifying a blank colour; 
8) Improvements to import functions; and 
9) Minor interface improvements. 

Bug Fixes:

1) Fixed minor question numbering problem for questions with the same number as the previous one; 
2) Minor corrections to SPSS file exports; 
3) Minor corrections to export from data collection database; 
4) Fixes to Check box and Select-Multiple field types; 
5) Better handling of cookie timeouts; 
6) Better handling of conversion of numerical choices list back to normal choices list type; 
7) Inadvertent setting of Subquestion Headers to 'required' no longer causes JavaScript failure on page; 
8) Corrected issue when respondent e-mail address field is defined by developer but there is no Surveyor record with that field name; 
9) Added work around for JavaScript anomalies in Safari and Opera; 
10) Updated deprecated Lasso tag to current version; and 
11) Miscellaneous other minor corrections/improvements. 

---------------------------------------------------

Version 8.0.12, 15th. September, 2005

Bug Fixes:

1) Fixed a security issue; 
2) Coded around a bug in Microsoft Internet Explorer's implementation of JavaScript; 
3) Fixed minor problem in export of quantitative data; 
4) Updated SPSS file exports to correspond with changes to the way SPSS 11 scripting works (SPSS changed the way in which SPSS parses scripts); 
5) Minor formatting corrections.

---------------------------------------------------

Version 8.0.11, 1st. August, 2005

New Features:

1) Improved speed of exporting web pages.

Bug Fixes:

1) Found and corrected elusive, minor bug in export of limit testing and page jumping; and 
2) Corrected minor bug in Survey.lasso file URL redirect.

---------------------------------------------------

Version 8.0.10, 11th. July, 2005

New Features:

1) Added ability to specify only one end of a range test, rather than both ends the range; and 
2) Improvements to cookie timeouts.

Bug Fixes:

1) Correction to security which overzealously deleted all cookies at time of respondent/admin log off; 
2) Correction to next page when adding child records; and 
3) Added missing respondent group file exists permission.

---------------------------------------------------

Version 8.0.9, 4th. July, 2005

The Surveyor 8.0.9 is a functional update to The Surveyor 8.0.8. 

New Features:

1) Better handling of sessions; 
2) Better security; 
3) Better progress maintenance when using child records; 
4) Better error reporting; and 
5) Added counts to number results pop-up window. 

Bug Fixes:

1) Corrections to pop-up results windows; and
2) Minor correction to admin security.

---------------------------------------------------

Version 8.0.8, 30th. June, 2005

The Surveyor 8.0.8 is a maintenance update to The Surveyor 8.0.7. 

New Features:

1) Questionnaire administrator can embed Lasso code in the e-mail notice subject and body text. 

Bug Fixes:

1) Minor fixes to Index.html file for secure questionnaires; 
2) Fixed export problem when there are no 'numerical' choices lists.

---------------------------------------------------

Version 8.0.7, 23rd. June, 2005

The Surveyor 8.0.7 is a maintenance update to The Surveyor 8.0.6. 

New Features: 

1) Implemented first phase of new security model. User and Admin cookies now set to expire to help protect data in browsers that have not been quit. Questionnaire developer can set expiration time for both users, separately. 

Bug Fixes:

1) JavaScript tests now produce no JavaScript if the commparison field name does not exist, rather than producing JavaScript that does not operate properly; and 
2) Corrected problem (introduced in 8.0.6) when second omit condition is specified for particular web question.

---------------------------------------------------

Version 8.0.6, 18th. June, 2005

The Surveyor 8.0.6 is a maintenance update to The Surveyor 8.0.5. 

New Features: 

1) Copyright label in all files, to protect your questionnaire; 
2) Minor improvements to rtf file information; 
3) Better notification when export of a group of files is performed; and 
4) All web field types may now be compared to other fields on the same web page (previously radio button, checkbox, and select types could not be used after a field that might have been omitted from the page.

Bug Fixes:

1) Corrected problem when using The Surveyor as a demo that caused the export of web page sto be hobbled. Our apologies to people who tried The Surveyor and were frustrated by this. 

---------------------------------------------------

Version 8.0.5, 9th. June, 2005

The Surveyor 8.0.5 is a maintenance update to The Surveyor 8.0.4. 

Bug Fixes:

1) Fixed privilege problem introduced in 8.0.3 when creating databases for the questionnaire. 

---------------------------------------------------

Version 8.0.4, 3rd. June, 2005

The Surveyor 8.0.4 is a maintenance update to The Surveyor 8.0.3. 

Bug Fixes:

1) Fixed problem introduced in 8.0.3 that caused an infinite loop (only when exporting ExportDataxxx.lasso files for questionnaires with child records); 
2) Corrected minor logic error in Error.lasso file; 
3) Made the Admin questionnaire creation more flexible and corrected problem when no questionnaire number is supplied; 
4) Improved the 'one level up' folder files. 

---------------------------------------------------

Version 8.0.3, 28th. May, 2005

The Surveyor 8.0.3 is a maintenance update to The Surveyor 8.0.2. 

New Features:

1) Developer can now opt for unauthenticated sending of e-mail by leaving the password field empty in the Set Up > E-Mail pane; 
2) Improved management of upper-level folder/file permissions; and 
3) Group file export from The Surveyor now notes completion (applies to All Pages, All Web Pages, Helper Fields, and SPSS Files exports). 

Bug Fixes:

1) Fixed problem when there are no numerical fields and no child records to export from the MySQL database. 

---------------------------------------------------

Version 8.0.2, 23rd. May, 2005

The Surveyor 8.0.2 is a maintenance update to The Surveyor 8.0.1. 

Bug Fixes:

1) Fixed minor problem exporting files for single-page questionnaire. 

---------------------------------------------------

Version 8.0.1, 21st. May, 2005

The Surveyor 8.0.1 is a maintenance update to The Surveyor 8.0. 

Bug Fixes:

1) Fixed problem with references to Name.lasso file for questionnaires that are more than three folders deep; 
2) Fixed problem where apostrophes in questionnaire names would cause a Lasso error;
3) Fixed database creation problem introduced in version 8.0, where users of Lasso 7 would see a tag error when creating their questionnaire database. 

---------------------------------------------------

Version 8.0, 17th.. May, 2005

The Surveyor 8.0 is a functional update to The Surveyor 7.1.3. 

Please note: 

1. If you intend to use this code with an existing questionnaire (i.e. one already being served to the web) and you want to change any web pages, you should at least once perform a complete export of the pages and replace all the existing pages. Thereafter, you can export individual pages again. Please remember to back up your existing files before overwriting them. 

New Features: 

1) The Surveyor is now compatible with Lasso. 8.x; 
2) The "Start New" button is no longer shown on the "Logged Off" page; 
3) The questionnaire number can now be provided as a reminder to the respondent at the time of log off; 
4) Doubled number of possible sub-question numbers to 52; 
5) Progress meter can now be based upon the number of question numbers, question subnumbers, or data fields shown to the respondent. Depending on how many subnumbers you have in your questionnaire and their distribution, each selection before export will show a slightly different apparent progress through the questionnaire. 
 
Bug Fixes:

1) Fixed minor bug introduced in 7.1.3 where exporting all pages would export all questions to every page. This did not affect export of single or a group of pages specifically entered in the Export pane; 
2) Miscellaneous minor clean ups. 

---------------------------------------------------

Version 7.1.3, 10th. May, 2005

The Surveyor 7.1.3 is a maintenance update to The Surveyor 7.1.2. 

New Features: 

1) Added feature to turn respondent Help, About, and Contact pages as pop-up windows, instead of subsequent pages in the same browser window; 
2) Header alignment can now be set to left/right/centre; 
3) Added ability on a per-question basis to add extra JavaScript tests to the point-and-click tests the Surveyor creates, allowing for very complex checks to be added by the developer; 
4) JavaScript tests can be inserted into the jump page record, to override The Surveyor's tests where very complex testing and changes to destination page are required; 
5) Better representation of html formatting in RTF file export; 
5) Provided option to remove Back button from Home page. 
 
Bug Fixes:

1. Fixed looping problem when moving all pages up from page 1; 
2. Fixed settings problem when importing questions from tab-delimited file; 
3. Fixed number of pages calculated when importing questions from tab-delimited file; 
4. Minor clean up to copyright presentation on web page; 
5. Ensured that Admin page selection menu is available, even if the administrator accidentally loaded the non-existent Survey.lasso page from the URL line of the browser; 
6. Minor fixes to jumping page calculations for skipping patterns; 
7. Correction to JavaScript warning mesaage for grouped questions; 
8. Added missing left parenthesis for JavaScript tests for some conditionals; 
9. Correction to record omission is test value is blank; 
10. Fixed minor bug that made progress meter report less progress than actual; 
11. Fixed problem when skipping an order of magnitude of pages.

---------------------------------------------------

Version 7.1.2, 14th. April, 2005

The Surveyor 7.1.2 is a maintenance update to The Surveyor 7.1.1. 

Please note: 

1. This version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7.1.3, but it has not yet been tested with Lasso 8; 
2. If you intend to use this code with an existing questionnaire (i.e. one already being served to the web) and you want to change any web pages, you should at least once perform a complete export of the pages and replace all the existing pages. Thereafter, you can export individual pages again. Please remember to back up your exisiting files before overwriting them. 

New Features: 

None, this is a maintenance update. 
 
Bug Fixes:

1. Fixed problem in the Admin list of respondents web page, which, in some cases, reported "Problem with answer. Please contact administrator;" 

---------------------------------------------------

Version 7.1.1, 12th. April, 2005

The Surveyor 7.1.1 is a functional update to The Surveyor 7.1. 

Please note: 

1. This version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7.1.3, but it has not yet been tested with Lasso 8; 
2. If you intend to use this code with an existing questionnaire (i.e. one already being served to the web) and you want to change any web pages, you should at least once perform a complete export of the pages and replace all the existing pages. Thereafter, you can export individual pages again. Please remember to back up your exisiting files before overwriting them. 

New Features: 

1. ExportDataReply.lasso will not time out on systems with Lasso 7.0 and greater. 
 
Bug Fixes:

1. Fixed problem on questionnaire web pages with one or more questions set to certain field types set to Force Include No. 

---------------------------------------------------

Version 7.1, 22nd. March, 2005

The Surveyor 7.1 is a functional update to The Surveyor 7.0.6. 

Please note: 

1. This version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7.1.3, but it has not yet been tested with Lasso 8; 
2. If you intend to use this code with an existing questionnaire (i.e. one already being served to the web) and you want to change any web pages, you should at least once perform a complete export of the pages and replace all the existing pages. Thereafter, you can export individual pages again. Please remember to back up your exisiting files before overwriting them. 

New Features: 

1. Exact_Search, Exact_Update, and Exact_Delete functionality of Lasso is now available to Lasso 7.1.3 (and up); 
2. Added extra options to SPSS Value script files; 
3. Added Web question numbers to Word RTF file export; 
4. Added option to export Display fields in exported analysis data files (saves having to recreate the calculation in your analysis software); 
5. Added ability to set characters separating multiple fields in single question/response in the e-mailed report and the written file; 
6. Added ability to override individual questions from being excluded from written report, if value is "None" or empty; 
7. Changed the Display field so that it no longer requires a Lasso variable (The Surveyor now does this for you); 
8. Added page jumping pull-down menu to more Admin web pages, i.e. after E-Mail, Write, and Export, to improve convenience for questionnaire administrator; and 
9. Exports now remove extraneous line feeds in both numeric and text exports, to aide import into other software. 
 
Bug Fixes:

1. Corrected Exact_Search for Security database; 
2. Fixed problem where two successive Field records with identical Field Names AND identical Export Field Names caused an export of the Field Name to SPSS data file instead of export of Export Field Name (usually only affects identical question presentation where one version of the question is shown to one group and another to the rest); 
3. Renamed this file to ReadMe.text to make it easier to bulk search through files including .txt files, without accidentally changing the contents of this file; 
4. Fixed bug in "Omit field on web" for display fields; 
5. Fixed bug in "Omit field on web" for empty comparison values and values that do not correspond to list of values for the comparison field; 
6. Corrected export of several pages between pages 40 and 100 to export Related page, which were not being exported in earlier versions; 
7. Corrected a problem in the Name.lasso page where a cookie was not being set at the correct place, which may have caused problems gaining access to the database creation page(s); 
8. Corrected cosmetic problem with question numbering; 
9. Corrected problem with unescaped apostrophes when updating page information; 
10. Corrected issue where, when there were unused records, reference was made to them as though they were to be included in the exports of the web pages; 
11. Cosmetic change to Thank You web page for questionnaire administrator; and 
12. Minor problem in search for exportable records fixed. 

---------------------------------------------------

Version 7.0.6, 8th. February, 2005

The Surveyor 7.0.6 is a maintenance update to The Surveyor 7.0.5. 

Please note that this version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7 up to 7.1.2, but it has not yet been tested with Lasso 8. 

Lasso 7.1.2 has a bug in its Exact_Search, Exact_Update, and Exact_Delete settings (that, fortunately, make your data more secure, but unfortunately break The Surveyor's security tests). We've coded around the bug, but it does mean that, in theory at least, one level of security (the Exact functions in Lasso itself) is not available to Lasso 7 users. It's not likely to be a huge problem, but one of which we feel you should be aware. 

Bug Fixes:

1. Fixed date problem in http header which caused some Gecko-based browsers to display questionnaire pages incorrectly; 
2. Fixed minor css formatting problem affecting display of radio buttons in Gecko-based browsers; and 
3. Fixed problem with some Gecko-based browsers not displaying the results pop-up windows. 

---------------------------------------------------

Version 7.0.5, 7th. February, 2005

The Surveyor 7.0.5 is a maintenance update to The Surveyor 7.0.4. 

Please note that this version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7, but it has not yet been tested with Lasso 8. 

Lasso 7.1.2 has a bug in its Exact_Search, Exact_Update, and Exact_Delete settings (that, fortunately, make your data more secure, but unfortunately break The Surveyor's security tests). We've coded around the bug, but it does mean that, in theory at least, one level of security (the Exact functions in Lasso itself) is not available to Lasso 7 users. It's not likely to be a huge problem, but one of which we feel you should be aware. 

Bug Fixes:

1. Fixed minor problem with left/right question/response background colours.

---------------------------------------------------

Version 7.0.4, 2nd. February, 2005: 

The Surveyor 7.0.4 is a maintenance update to The Surveyor 7.0.3. 

Please note that this version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7, but it has not yet been tested with Lasso 8. 

Lasso 7.1.2 has a bug in its Exact_Search, Exact_Update, and Exact_Delete settings (that, fortunately, make your data more secure, but unfortunately break The Surveyor's security tests). We've coded around the bug, but it does mean that, in theory at least, one level of security (the Exact functions in Lasso itself) is not available to Lasso 7 users. It's not likely to be a huge problem, but one of which we feel you should be aware. 

New Features: 

1. Added another 15% export speed boost; and 
2. Added Lasso functionality to subject line for e-mail of textual summaries. 
 
Bug Fixes:

1. Fixed minor formatting problem when same field was used twice in a multi-field per response format, once for condition A and once for not condition A.

---------------------------------------------------

Version 7.0.3, 31st. January, 2005: 

The Surveyor 7.0.3 is a maintenance update to The Surveyor 7.0.2. 

Please note that this version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7, but it has not yet been tested with Lasso 8. 

Lasso 7.1.2 has a bug in its Exact_Search, Exact_Update, and Exact_Delete settings (that, fortunately, make your data more secure, but unfortunately break The Surveyor's security tests). We've coded around the bug, but it does mean that, in theory at least, one level of security (the Exact functions in Lasso itself) is not available to Lasso 7 users. It's not likely to be a huge problem, but one of which we feel you should be aware. 

New Features: 

1. Added capability to file write of summary text of a single questionnaire's worth of responses (equivalent to the existing e-mailing of the summary), so that The Surveyor can now be used on a stand-alone computer (i.e. e-mail is no longer required to send textual summary of respondent answers to the questionnaire administrator);
2. Added field for default text for questionnaire creation web page body;
3. Added option to set alignment of Save/Delete buttons for review of related records in the Admin section; 
4. Reorganised Set Up and Export panes to accommodate new functions; and 
5. Updated documentation to reflect additions and changes; 
6. Speed improvements to export of questionnaire pages. 
 
Bug Fixes:

1. Fixed import of foot mark characters into ValueLists database, which caused record creation error when databases created throught the JDBC connector (not the MySQL connectors). Affected Lasso 7 installations only; 
2. Fixed problem when upper part of Admin search finds no records. Affected Lasso 7 installations only; 
3. E-mail of questionnaire summaries from Lasso 7 (only) fixed; 
4. Fixed questionnaire database creation problem where Lasso installation had a connexion from BOTH external MySQL AND JDBC hosts, simultaneously, and creation used either external MySQL or JDBC host; 
5. Fixed problem when Lasso code is included in question text; 
6. Improvements to Import functions; 
7. Fixed minor formatting problem for Matrix Text Likert tables when Choice list changed; 
8. Worked around issue where Lasso 7.1.2 would allow creation of 0 value in data MySQL data fields when nothing was entered at the browser. Now sets the values of both text and numerical fields to NULL, more accurately reflect user input; 
9. Rebuilt update routines to work around Lasso 7.1.2 problem saving blank data as zeroes; 
10. Reworked Pop Up Results to provide accurate data for optional extra selections
11. Worked around new error message phrasing in Lasso 7.x vs. Lasso 6.x.

---------------------------------------------------

Version 7.0.2: 

The Surveyor 7.0.2 is a maintenance update to The Surveyor 7.0.2. 

Please note that this version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7, but it has not yet been tested with Lasso 8. 

Lasso 7.1.2 has a bug in its Exact_Search, Exact_Update, and Exact_Delete settings (that, fortunately, make your data more secure, but unfortunately break The Surveyor's security tests). We've coded around the bug, but it does mean that, in theory at least, one level of security (the Exact functions in Lasso itself) is not available to Lasso 7 users. It's not likely to be a huge problem, but one of which we feel you should be aware. 

New Features: 

1. Added default text for questionnaire creation web page body text field.
 
Bug Fixes:

1. Fixed import of foot mark characters into ValueLists database, which caused record creation error when databases created throught the JDBC connector (not the MySQL connectors). Affected Lasso 7 installations only; 
2. Fixed problem when upper part of Admin search finds no records. Affected Lasso 7 installations only.

---------------------------------------------------

Version 7.0.1: 

The Surveyor 7.0.1 is a maintenance update to The Surveyor 7.0. 

Please note that this version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7, but it has not yet been tested with Lasso 8. 

Lasso 7.1.2 has a bug in its Exact_Search, Exact_Update, and Exact_Delete settings (that, fortunately, make your data more secure, but unfortunately break The Surveyor's security tests). We've coded around the bug, but it does mean that, in theory at least, one level of security (the Exact functions in Lasso itself) is not available to Lasso 7 users. It's not likely to be a huge problem, but one of which we feel you should be aware. 

New Features: 

1. Minor improvement to MySQL database creation; 
2. Added some extra selections to the default MySQL name menu.
 
Bug Fixes:

1. Minor problems with extra field selection for Admin Lists corrected; 
2. Fixed page load problem for web pages of related records; 
3. Fixed minor problem with import of default MySQL database name; and 
4. Minor correction to the List pane.

---------------------------------------------------

Version 7.0: 

The Surveyor 7.0 is a functional update to The Surveyor 5.2.1. Given the new support for Lasso version 7, we've taken this opportunity to make The Surveyor's main version number co•ncident with Lasso's. 

Please note that this version is for Lasso access to LassoMySQL AND external MySQL databases. It has been tested with Lasso 6 strict syntax and Lasso 7, but it has not yet been tested with Lasso 8. 

Lasso 7.1.2 still has a bug in its Exact_Search, Exact_Update, and Exact_Delete settings (that, fortunately, make your data more secure, but unfortunately break The Surveyor's security tests). We've coded around the bug, but it does mean that, in theory at least, one level of security (the Exact functions in Lasso itself) is not available to Lasso 7 users. It's not likely to be a huge problem, but one of which we feel you should be aware. 

New Features: 

1. Lasso 7 now supported; 
2. External MySQL now supported; 
3. Better error reporting during database/table creation; 
4. New developer's manual for The Surveyor;
5. Added ability to specify number of columns for Picture fields.
 
Bug Fixes:

1. Problems in Matrix formatting corrected where, under some circumstances changing question/response orientation could omit the choice/value legend; 
2. Creation date for questionnaire records now set for user-created questionnaires; 
3. Export of completed records now works properly for split questionnaires (i.e. with respondent and administrator sections)
4. Corrected small error in the e-mail body of textual questionnaire reports.

---------------------------------------------------

Version 5.2.1: 

The Surveyor 5.2.1 is a maintenance update to The Surveyor 5.1.1. Please note that this version is for Lasso 6.0 access to LassoMySQL databases. It has been tested with Lasso 6 strict syntax, but it has not been tested with Lasso 7. A updated version of The Surveyor for Lasso 7.1 will be made available as a free update to users of The Surveyor version 5.x and above once Lasso 7.1 is available.

New Features: 

1. Additions and corrections to E-Mail functionality; 
2. Addition of Lasso connector and Host fields in preparation for Lasso version 8; 
3. Updates to Import function; 
4. Minor rearrangements of panes in The Surveyor databases; 
5. Addition of button set up pane for html title code for web buttons; 
6. Addition of Set Up > Password pane; 
7. Finally, a draft of an up-to-date users' manual for The Surveyor (final version expected in early January, 2005, or before); and 
8. Worked around all but one known bug in Lasso 7.1.2 (this last bug cannot be worked around). 
 
Bug Fixes:

1. Problems in Matrix formatting corrected.

---------------------------------------------------

Version 5.1.1: 

The Surveyor 5.1.1 is a maintenance update to The Surveyor 5.1. Please note that this version is for Lasso 6.0 access to LassoMySQL databases. It has been tested with Lasso 6 strict syntax, but it has not been tested with Lasso 7. A updated version of The Surveyor for Lasso 7.1 will be made available as a free update to users of The Surveyor version 5.0 and above once Lasso 7.1 is available.

New Features: 

1. Admin user can now select to e-mail notices to all respondents that have not previously been e-mailed

Bug Fixes:

1. Minor tidy ups.

---------------------------------------------------

Version 5.1: 

New Features: 

1. None

Bug Fixes:

1. Minor tidy ups, particularly in the secure version and to cope with browser idiosyncracies.

---------------------------------------------------

Version 5.0: 

New Features: 

The Surveyor 5.0 is a functional update to The Surveyor 4.7. Please note that this version is for Lasso 6.0 access to LassoMySQL databases. It has been tested with Lasso 6 strict syntax, but it has not been tested with Lasso 7: 

1. Single click to create MySQL data collection database, including automated creation of the MySQL database, tables, users, and groups; 

2. Complete rework of security scheme, including encryption; 

3. Added importation of pre-defined respondents, their passwords, and e-mail addresses; 

4. Automatic determination of OS that created import file and whether it is tab or comma delimited;

5. Admin user specifies the name of import file name;

6. Added e-mail of announcement messages to existing/imported respondents (can include user ID and password); 

7. Added export of respondent data to file;

8. Admin user determines the name of the export file;

9. Choice of tab or comma delimiter for export file;

10. Choice of whether to overwrite a file with the same name as the export file name;

11. Can e-mail the exported file to any number of recipients; 

12. Admin user can delete any questionnaire from a respondent and/or any 'child' responses associated with it; 

13. Added log-off function to delete cookies from browser page;

14. A new form of a value matrix has been provided to separate the values from additions such as N/A and 'Other;'

15. Value matrices can now have the value immediately next to the radio button; 

16. Subquestion numbering has been added, so that you can have question 1a, 1b, etc.. This sub numbering is in upper or lower case alpha, or upper and lower case roman numerals; 

17. Separation bar can be added to blocks of subquestions; 

18. Question numbers can now have their own text style, and subquestion numbers can have their own, also; 

19. Several additions to the style functionality have been made, as well as corrections to minor errors. As a result, the look and feel of resultant 
pages has been significantly improved; 

20. Developer can now select whether the Lasso/MySQL and the Admin buttons appear on 
pages, thereby keeping admin functions invisible to respondents. 


Bug Fixes:

1. Minor tidy ups and formatting changes. 

---------------------------------------------------

Version 4.7: 

New Features: 

1. None

Bug Fixes:

1. Fixed minor problem with value lists export for value lists database ('Other' etc. were missing from database); 

2. Fixed redirect problem for some browsers with index page cookie/location checking; 

3. Minor tidy ups;

---------------------------------------------------

Version 4.6: 

New Features: 

1. Admin footer added to FileMaker export.

Bug Fixes:

1. Minor tidy ups.

---------------------------------------------------

Version 4.5: 

New Features: 

1. Processing structure changed from 'Classic' method to Inline method for Lasso 3 and Lasso 6 export of web pages.

Bug Fixes:

1. Minor tidy ups.

---------------------------------------------------

Version 4.4: 

New Features: 

1. Pop up frequency results windows available to respondent, administrator, or both (according to researcher's preference); 

2. Automatic 'gatekeeper' function to prevent non-JavaScript enabled browsers from taking questionnaire (Javascript is required for data validation. More than 95% browsers currently on web (August, 2003) support JavaScript); and 

3. Added sum total question format (several fields on page must sum to total).

Bug Fixes:

1. Minor tidy ups.

---------------------------------------------------

Version 4.3: 

New Features: 

1. Format of e-mail report tailorable;

2. E-mail response to respondent, researcher, or both; 

3. Individual questions can be omitted from the e-mail report; and 

4. Researcher can provide default responses for any and all questions.

Bug Fixes:

1. Fixed problem with certain combinations of skip patterns. 

---------------------------------------------------

Version 4.2: 

New Features: 

1. Added e-mail question format (validated for proper format); 

2. Added display question format (no data entry); 

3. Administrator able to search using several fields and sort by other fields, if desired; and 

4. Researcher can specify which fields are listed in result of administrator search for response records.

Bug Fixes:

1. Fixed problem that some html code would show up in pop-up help. 

2. Minor tidy ups. 

---------------------------------------------------

Version 4.1: 

New Features: 

1. Export all web 
pages with one click of mouse;

2. Export individual web 
site pages with one click of mouse (very useful after you've made a small change);

3. Automatic parent/child records for each respondent/questionnaire. For example a respondent may have an unknown number of children, be taking a unknown number of medications, etc. and you need data on each. The Surveyor is the only web 
software to provide this function built-in; 

4. Automatic sequential question numbering;

5. Automatic note when question requires an answer (may be turned on or off, according to preference);

6. Administration portal to manage responses;

7. Create two parts for questionnaire: one for respondent, one for researcher/administrator;

8. Administration portal presents question in an identical manner to questionnaire, with identical input validation;

9. Administrator can jump to any questionnaire and to any page of that survey; and 

10. FileMaker-only support added (surveys can now be hosted with CDML).

Bug Fixes:

1. Minor tidy ups. 

---------------------------------------------------

Version 4.0:

New Features:

1. FileMaker-only support added (surveys can now be hosted with CDML); and 

2. Researcher can provide pop-up help for any and all questions. 


Bug Fixes:

1. Minor tidy ups. 

---------------------------------------------------

Version 3.3:

New Features:

1. E-mail of responses may now be sent automatically to the respondent, upon a request from the respondent; 

2. Added comparison of fields on 
page (now, each field on a 
page may be tested against any of the other field on that page); 

3. Added 
progress bar at the top of 
pages beyond page one (with switch to turn this off, if desired); 

4. Added switch to present required fields as such to 
respondents; 

5. Added switch to present question numbers to 
respondents; 

6. Significant improvements to 
set up in The Surveyor application; 

7. Can now use special characters (such as accented French letters) in question text; and

8. Limit testing now provokes Required Field testing. 


Bug Fixes:

1. Corrections to JavaScript message for range test; 

2. Slider field no longer automatically assumes that it requires a response; and 

3. Minor tidy ups. 

---------------------------------------------------

Version 3.2:

New Features:

1. Added completely new user-friendly interface; and 

2. Added notes/comments field for each 
question. 


Bug Fixes:

1. Minor tidy ups. 

---------------------------------------------------

Version 3.1.4:

New Features:

1. Added click sliders for continous interval data, such as temperature, etc..  


Bug Fixes:

1. Minor tidy ups. 

---------------------------------------------------

Version 3.1.3:

New Features:

1. Minor improvement to the SurveyFound.lasso file, so that page jumping/skipping is better presented as a respondant returns to complete the questionnaire;  

2. Automatic, serial question numbering implemented for all 
questions; 

3. Speed improvements for layout display (number of 
pages calculated faster). 


Bug Fixes:

1. Problems with response limit checking: Limits would not test, and SPSS value numbers were tested as alpha. Fixed. 

2. Minor problem with question numbering during page finds and exports is fixed. 

---------------------------------------------------

Version 3.1.2:

New Features:

There are no new features in this maintenance release. 


Bug Fixes:

1. Minor text size problems in the Name.lasso file fixed.  

2. Minor text size problems in The Surveyor export files and the .lasso non-
pages fixed. 

---------------------------------------------------

Version 3.1.1:

New Features:

There are no new features in this maintenance release. 


Bug Fixes:

1. Empty database fields would appear in the presentation of menues, radio buttons, matrices, pictures and checkboxes as a selected item if, and only if, the selected item's SPSS value was 0. Lasso improperly equates '' to '0' in its comparison operators. A work around was implemented. 

---------------------------------------------------

Version 3.1:

New Features:

1. If a page is reloaded, all previously entered information is now returned to the web page from the database to pull-down menues, radio buttons, matrix buttons, picture buttons, and checkboxes. 


Bug Fixes:

1. Corrected minor problems with the matrix and picture functions. 

---------------------------------------------------

Version 3.0:

New Features: 

1. Multiple language capability. Data may now be entered in up to five languages (English, French, German, Spanish, and an 'Other' language;

2. Picture questions so that a radio button selection from up to fifty pictures may now be made;

3. Two forms of question matrix presentation. One form presents the text version of the scale values, the other presents a list of what each column represents in numerical format and then titles each solumn with the appropriate number. The latter format is useful when the text for the columns would be unreasonably long to present as column headers;

4. Testing one field on a given web page, based on the values of another on that page. For example: if 'Education' contains 'Other' make sure that 'EducationOther' is not blank;

5. Secure surveys are now possible, using new default variables in the Name.lasso file;

6. Checkboxes can now be tested for both 'required' and per 4) for 'contains' operations; 

7. Many other minor ameliorations to the layouts and functioning.


Fixes:

No specific bug fixes in this release. 


------------------------------------------------------------------------------------------------


8. DOCUMENTATION

The Surveyor 8.x comes with both an Installation Manual pdf file and a User Manaul pdf file. Documentation for version 7.0.4 is applicable to versions up to version 7.0.6. Documentation for version 7.1 is applicable to versions 7.1 to 7.1.3. 

Please refer all questions and comments about the documentation to Docs@Videlicet.com. Thanks. 


------------------------------------------------------------------------------------------------


9. SUPPORT CONTACTS

Please submit bug reports to:  Bugs@Videlicet.com

For support, please use one of the following:

Videlicet
P. O. Box 19591-519
55, Bloor Street West
Toronto
Ontario  M4W 3T9
Canada

Telephone: (416) 962 1040
Facsimile: (416) 962 1044
(The country code for Canada is 1.)

E-mail:    Support@Videlicet.com
URL:       http://Videlicet.com


© 2002-2007, Trevor H. Jacques. The Surveyor Read Me file, revised 18th. October, 2007.