Home

Surveyor User Manual, version 8.0

1. SPSS Scripts Export Surveys Pages one level up Figure 1 The Surveyor folder oa M z Error lasso Example Import Files Please read the whole of this section before you use The Surveyor The information in this User Guide assumes that you know how to admin ister your web and file server computers and software including your text editor If you do not currently feel confident with these please take the time to get comfortable with them before you use The Surveyor Also please note that the graphic standard within The Surveyor itself is v8 0 THE SURVEYOR USER MANUAL such that all items in blue tabs buttons etc are clickable i e clicking the item will result in something happening for example moving to anoth et layout exporting files etc and all underlined items will sort the currently found question records by that item when it 1s clicked After you decompress the download you will see that The Surveyor comes in a folder that contains files similar to those in Figure 1 depend ing on whether you use a Macintosh or a Windows PC The Windows download includes extra files such as dll files You should place this folder anywhere convenient on your licenced development computer You can rename the main folder to anything you want Do not rename the folders inside it since these folder names are assumed by The Surveyor as it creates the files that you will copy to your web server once you ve
2. Figure 35 Page header text in use in the web Admin The text of the page header is used both as the page header information on the web pages and for the web Admin jump directly to page web Admin function as shown in Figure 35 Hence The Surveyor can provide context for your respondents and a navigation tool for the administration of your questionnaire This page header is also used as a page separator in the textual e mails of responses 37 THE SURVEYOR USER MANUAL 38 4 2 1 5 2 TEXT HEADER RECORDS Occasionally you ll want to insert informative header information in the body of your questionnaire web pages To do this simply choose TextHeader in the Field column and type the text you d like to present to your respondents in the Question Text field That s all there is to it The Surveyor will format your text into a header in the exported questionnaire web page You can include basic html code in the Question Text field for text headers so that you can add extra formatting to your text if required You can use the html pairs lt i gt lt u gt lt b gt lt h1 gt lt h2 gt and lt h3 gt to provide this extra formatting of your text headers Figures 33 and 34 illustrate these head ers they are the records with the white background The extra header for medications in Figure 32 is covered in the section on Related Records 4 2 1 5 3 QUESTION RECORDS Enter the name of your question field in the Field co
3. Low O O QUE Figure 50 Matrix Text field type left right orientation separated extra selections v8 0 v8 0 THE SURVEYOR USER MANUAL For Matrix presenations with true Likert scales we recommend using a minimum of seven responses in your scale The reason for this 1s apparent in Figure 48 If at the stage of data analysis you want to reduce the granularity of your data you want to group parts of your data together Say that we want to put the data into three groups trichotomise the data with a minimum of seven points on the data scale we can put them into two groups of two and one of three This is much more even a distribution than starting with five points and hav ing to have a grouping of one three one or two one two You should however always choose a scale that is appropriate to your question and try to ensure that the points on the scale give a good sense of even distribution and where applicable are properly symetrical Note that visually in the top bottom orientation the question gets in the way of the column headings so the header text is included for every question In the left right orientation this is not a problem and a single column header can be included for more than one sequential question The Surveyor will reset the question header each time the name of the Choices list changes unless you specify in the Detail pane that you want the same Matrix as the previous question This is very useful
4. 2 1 GETTING STARTED Before you begin ensure that the instructions in Installing The Surveyor have been completed and that the sample questionnaire is running and accepting data In essence for each web based questionnaire you want to create you ll be generating a web based copy of what would previously have been a paper based questionnaire You ll create new questionnaires and their associated data collection databases by duplicating the The Surveyor folder renaming it and then modifying the databases inside it something like the folders in Figure 18 There are several parts to the process of creating web ques tionnaires with The Surveyor Questionnairel Questionnaire2 Questionnaire3 Questionnaire4 Questionnaire5 Figure 18 Developing multiple questionnaires e specifying the questions and potential answers in The Surveyor databases Where you would like to restrict answers to a possible range test whether to show a question based upon an answer to an earlier question often referred to as skipping branching or conditionals make the response required etc you can do this in The Surveyor e creating the database that will be used to accept the data from your respondents browsers e creating the web pages for the questionnaire itself and e modifying the look and feel of the site using special template files and Adobe Photoshop image templates v8 0 v8 0 THE SURVEYOR USER MANUAL 2 2 THE SURVEYOR DATABASE
5. It should be run before the associated Frequencies sps file above 4 7 5 5 SPSSPARENTDATAFORMATSSCRIPT SPS The SPSS Formats Script button produces an SPSS sps file with the code required to define the field data types within SPSS Unless you ve specified otherwise for individual questions the default data type and values are used in this file Running this sps file in SPSS saves having to manually enter these data or manually create the script file itself All fields for the main questionnaire data collection database that are the result of a numeric response i e they use a Choice list will be exported in this file ready for execution by SPSS This script file should be run in SPSS before the associated Frequencies sps file is run in SPSS 4 7 5 6 SPSSPARENTFREQUENCIESSCRIPT SPS The SPSS Frequencies Script button produces an SPSS sps file that when run in SPSS will produce a quick summary of the data frequen cies This is useful when a quick check of the data quality is required Note that this file should only be run in SPSS after the associated SPSS Formats ValueLabels and VariableLabels sps files have been executed in SPSS 4 7 5 7 SPSSPARENTVALUELABELSSCRIPT SPS The permissible values fo a field called a variable in SPSS will be the same as the list of choices you ve made in The Surveyor for that que sitons To have SPSS be able to relate a numeral to a text label for reporting purposes the value labels need to be trans
6. One can create the questionnaire before using any of the System components but you might find it useful to use the Surveyor and its associated Sur veyor Field Choices databases during development of your questionnaire The design of the Surveyor database is such that it can help to clarify your thoughts about how to ask the questions of the respondents Even if your questionnaire is complete in a written form you will need to create a Survey ot database representation of it This will allow you to export the html code for the web pages rather than having to code the complex html Lasso and JavaScript code by hand The Surveyor database is programmed to create all of the code specifics for all of the questionnaire pages from a simple point and click interface v8 0 v8 0 THE SURVEYOR USER MANUAL Once the basic fields and pages have been defined in the Surveyor and Surveyor Field Choices databases you can change the look and feel of the ques tionnaure pages as they are presented to the respondents by changing the building block files exported by The Surveyor The questionnaire database for collection of respondent data is created using on of the web pages exported during the creation of the questionnaire web pages by The Surveyor This file can be exported on its own if required by going to the Export gt Pages pane of The Surveyor and clicking the appropriate button For each question in the questionnaire that requires an answer
7. 40 List pane mita Field Type pop up pHebDU us deca zie Ead RE eov Sur ede d 42 Sample questionnaire web field type examples os oss ren Vedi e arat rs e o d 43 NECK Ox HE PES buste dia edic e der A pen dd 44 Display U pe aras odiados idad 44 AU tyes ius ive tac dri dorem we Naka 45 FEI Melty a qct eek v yon tue NE A A caer tee ae ad 45 Matrix Text field type top bottom orientation se o vue ER ERRORES eave 46 Mati Text Held types let night OB ADIODI I LR ne e d ete d ose 46 Matrix Text field type Likert scale left right OHeDtation essem zy ue RE phe nea 46 Matrix Text field type top bottom orientation separated extra selections A6 Matrix Text field type left right orientation separated extra selections 46 Matrix Value field type top bottom orientation sierras 48 Matrix Value field type left right orientation tutti ed eu s 48 Matrix Value field type top bottom orientation numbered buttons 48 Matrix Value field type left right orientation numbered buttons 48 Menu field type mouse up and mouse down atada iia aos 49 Menu field type used to prevent numerical ettofs i ic se sshuetuetesteeressestast 49 Petaeted Pe sas es mon a EA e paa e Meee e eae 50 Radio puton Meld Ippe Les nn dud ite ind et ach aa Fea hee ite do E ages 50 ecce PI ET EE E E 51 Select Multiple re Dons Held a nee co wots nai 51 Sider a db A Sab ak OA ate Ea 52 Subquestion field typ
8. About Admin Back Contact Create MySQL DBs Admin Create EMail Text To Me Export Help Home Import Questionnaires Lasso List Log In Lagott Next Privacy Start Survey Surveys GoTo Selected Page EMail Export File to Me EMail Notite Next Group Review Sawe Delete Child Delete Child Confirm Delete Parent Delete Parent Confirm Upload Questionnaires Company inio Server Current T ext Find aut mare about us Administer survey Back to rhe previous page Contact us Create MyStL data Create new E mail responses ta me Export responses to file need help iHome page for Im p ort blank reste MAS dats List questionnaires Log In To Ivy questionnaire Lag off by deletirig my Lo to next page tour privacy statement Start my questionnaire iHome page for Gotothe surveys home ian to selected E mail exported data File to E mail this notice to Next group af Review all the child Save my entries Belete this child record Delete this Upload text file of ma Toolbar Available A Costa mis mp Ancillary Files Web Page Format English Archive Find out more about uz Administer survey Back to the previous page Contact us Create MySGl dats Create new E mail responses to me Export responses to file need help Home page for Import blank Create MySQL data List questionnaires Lag In To Ivy questi
9. Facs 416 962 1044 Figure 27 About This Application pane 4 1 2 NAVIGATING THE SURVEYOR DATABASE To help you in the Surveyor database all field labels and headings that are underlined or in a colour other than white provide a clickable func tion All underlined labels and headings will sort the found records by that field and where appropriate subsort by other fields All coloured items perform a context sensitive function when clicked 096 Use Aqd Pg Ord Field mi 1 PageHeaderTex mx 1 2 HeaderT ext mx 1 3 Firstiarne NAME fix 1 4 LastName NAME p_e Export Name Group 20090 Question Text lt h3 Menu Select and Test Fields Text TT Three of Ehe fields onthis pagearerequired Please enter vour first rame here Field 15 2 Please enter your family name here Field 45 Wi H Choice Menu Label Figure 28 Navigation tabs in the List pane Tabs you click to get to other pane will change their colour to reflect the pane currently presented For example in Figure 28 the uncoloured tab shows that we are in the List pane Clicking one of the round Page buttons will find all the records for questions and question headers on that page The round yellow H button at the top left of the fields database layouts will hide the database window on your computer without closing the Surveyor database You can always use the Windows menu at the top of your computer
10. Default MySQL DB Name mys qi LassoMySQL lasso_ internal MySQL usually mys qi Default is database name This pair is not seen by respondent bul chould be changed for each questionnaire Respondent UserName SampleResp Respondent Password SampleRespPassword Figure 97 Set Up gt Server pane F Database Information MySQL Database Name Videlicet no spaces Questionnaire Table Mame Sample no spaces Related Table Name no spaces Security Table Name no spaces Yalue Lists Table Name no spaces Default MySQL Character Length 123 Default MySQL Number Length 16 Default MySQL Number Precision Figure 98 Setting up MySQL data collection information v8 0 71 THE SURVEYOR USER MANUAL 12 If you d like to override the defaults for the MySQL data types at the time your database tables are created enter the overrides in the appro priate field at the bottom of this part of the Set Up gt Server pane For most questionnaires you should find that the defaults we have provided are up to the job 1 al 4 i F i T y he s Ti b e and fables Q Google PRES Respondents lasso MIB ed Figure 99 Sample MySQL data collection database creation web page 4 6 2 2 SERVER SET UP Assuming the server folder heirarchy exists as shown in Figure 101 The Surveyor needs to know the domain name of the web server on which you will be serving you
11. Index html Index lasso Pages Includes Images Import Export Figure 101 Questionnaire folder heirarchy z Server Information Domain ideli et corn Relative to domain folder Do not include http 11 Questionnaires Home Folder Path Samplest Questionnaire Home Folder Path Samples Sample Questionnaire Pages Folder Path Samples Sample Pages Questionnaire Images Folder Path Samples Sampletimages Questionnaire Includes Folder Path Samples Samplencludest Questionnaire Imports Folder Path Samples Sarmpletmpotsi Questionnaire Exports Folder Path Samples Sample Exports Queslionr Summaries Folder Path Samples Sample Summaries Figure 102 Setting up the questionnaire domain and file paths 4 6 2 3 LASSO SITE HOST CONNECTOR amp RESPONDENT IDS The Surveyor version 7 and higher can use embedded Lasso MySQL in Lasso 6 and 7 for database creation and data storage and it can use an external installation of MySQL From Lasso version 8 the MySQL database has to be external We have provided the means for you to specify the needed Site ID DataSource Connector ID and Default MySQL Database Name to create and connect to your external data base Since we cannot predict the IDs Name on your Lasso machine you should ask your Lasso MySQL administrator s for them and make sure that they are properly entered into these fields in the Set Up gt Server pane If you have lower than Lasso version 8 you should leave the Site ID i
12. Seed AlphaMumeri Fi GgHhBiJibKkLMr2SsTE TU u v va wx xS Y vez Aau Vvaw fill this box with Xx8vvzz amp dsSEaBbMm4MHuYnoPp3GgRr2SsTETU 3G qRr random alpha characters 25sTE1Uvavvxxavvzz aBb3ccDd8p3oGgqnr25sTETUuY VOW Moy zz AABbSFgHhBiJi5EkLkimdhHnoaPp3o qBRr25 STE ee TUU BERE LME deC Evvzz aBbSCeDdSEsFf TiagHhbi J bK amp aBbSc eFfGgt1Llu25smdMnoPp3Ggqgrz2 SsTTE Ju vk Lima gt oPp3igRbsccDbdkA aB bac eFinxaYvzaBbaFr riagHhbiJibEKkLHhbiJiS KkLTE Wy VkLhim nxavvzaBb3FtE rzihbiJiS e FF GgHh ghz Ah bi Je FRPSgHhbijSkkLMmtNnoCcDcDuydbsccOd EeP cDeFr agHhBiJibKkLHMmdHnoPpBmadHnsSEevavsex xev v pH Zz amp aBb3CccDdaEeFETGgHhbidiSkkLhimdahinoPp3G qRr2 STH US Met Tao P pirso Aris Kk LMmatn ose Seed Numeric 655213573358565548371565388328731256483812235 fill this box with 845545855853648533654837138156385638536432612 random numerals 348584554536483718371285523845544 71731256543 Timeout for Admin 5 minutes Respondent Timeout 10 minutes Figure 104 Setting up MySQL data collection information The next two fields in this part of the pane are random seeds for the encryption of cookies and other data used by the web pages of your questionnaire We recommend that you jumble them up a bit before exporting your web pages Make sure however that once you have decided to start collecting data that you do not change these fields or you may find that you can no longer get to some of your data One of the best ways to do this is t
13. THE SURVEYOR FROM Videlicet USER MANUAL 2004 2005 Trevor H Jacques Mac Macintosh and Mac OS X are trademarks of Apple Computer Inc registered in the U S and other countries Windows Windows NT Windows 2000 and Windows XP are trademarks of Microsoft Corporation registered in the U S and other countries WebSTAR is a trademark of 4D Inc registered in the U S and other countries Lasso and Lasso Professional are trademarks of OmniPilot Inc registered in the U S and other countries Photoshop is a trademark of Adobe Systems Inc registered in the U S and other countries BBEdit is a trademark of BareBones Software registered in the U S and other countries Any other trademarks in this publication that are registered in the U S and other countries are the property of their respective holders TABLE OF CONTENTS A Cr Sac ento vedo ser een mate D aE A du de 1 lb GOMpOne lista yea SE s u e uet eee ua od E eae ess oe 1 L2 System Req uirements 27355 MSN an Ded aces So eae er nn Sanaa 1 Lae o eles Ssh end edes a du iaces debeant datu neto ai dnd 1122 a ina aD E Ut aka ee d orb pite ead ie Dee tee 1 1 2 2 1 NACIO SAUS sane ocupa ate Sestri qo dO Rar UA AIR A hee 2 1 2 2 2 OUS 3 ete eC 2 1 2255 Dict ee ee TE er ee eee ee er ee eee er ee eee ee ee ere 2 Lo Mee SEE Ur O 2 Iur stalling Wie SES OL Re tried Giudice ance Reet oo 2 1 3 2 Confirming That Y
14. The final button in this pane allows you to import questions from text files produced by other applications or text word processors An exam ple of the format of the import file is provided in the download of The Surveyor There should be three tab separated fields in this file The first is the page number in numeral form the second is the order on the web page in numeral form and the third is the text of the question Please see the file named Text File For Question Import in the Imports folder of the download for an example of what the contents of the imported file s should look like 101 THE SURVEYOR USER MANUAL 102 Adi Questions From Tabbed Fil Record 1 of 14 records Found from total of 98 records There are 10 pages in your survey Figure 145 Set Up Import pane 4 7 EXPORT PANES This section of the manual will show you how all the piecs previously covered fit together to produce html JavaScript and Lasso code in files that produce the web pages seen by your respondents The export function and panes are divided in to five groups the main summary pane to export all the files and four subsidiary panes that let you export specific pages after you have made small changes to a questionnaire We ll cover each pane as a separate subsection of the manual 4 7 1 EXPORT EXPORT ALL PANE Figure 146 shows the Export All pane The top button will perform a complete export of all of the pages asso
15. gt gt Figure 193 Sample Admin list of found questionnaires web page 4 7 3 36 SURVEYREVIEWPAGESELECTION LASSO Sample Surveys The Videlicet Sample Survey Questionnaire Found Sc v http videlicet com Samples Sample Pages SurveyReviewFound lasso Q Google Found Questionnaire The questionnaire was found Questionnaire Number 77037C Page 1 Menu Select and Text Fields Text Boxes and Radio Buttons Page 2 Slider Fields Skip Patterns and Conditional Testing Page 3 Child Records and Context Sensitive Help for Each Question Page A EES FES Fields Page 6 ate Page Child Records cont Page 7 Sum of Several Fields Page 8 Display E Mail and Text Box Fields Page 9 Picture and Interval Scale Fields Page 10 Matrix Presentation both text and value headings Next gt Figure 194 Sample Admin questionnaire page selection pop up menu v8 0 THE SURVEYOR USER MANUAL Clicking a link button in the web page shown in the previous section or successfully finding a record by typing in its questionnaire number in the Admin web page results in the presentation of the web page in Figure 194 On this page there is onefield only a pop up menu that includes a link to each ot the web pages in the questionnaire The titles of the pages as determine by the PageHeader records in The Sur veyor database propduces the text that follows the page number If there is no PageHeader r
16. spacing vez 0 Question spacing es 2 Include Menu Label Yes Include HIA elc Ho Figure 134 Textual e mail formatting If a Page Header Text record has been defined for a page of your questionnaire it will be included in the e mail body as a lead in to the questions for that page If you d like to override that page header text you should enter the text you d like in the second field of this part of the pane You can specify forcing the page header text in the e mail body text to all upper case by using the next field Equally you can switch on and off whether page number page headers text headers and individual question numbers are included in the body of the e mail by using the next three pop up menues in this part of the pane v8 0 v8 0 THE SURVEYOR USER MANUAL If there are line feeds in the responses for text fields Field and Textbox field types The Surveyor will if requested set extra line feeds in the body to provide a clean break between paragraphs of the response You can select both whether to force the spacing and the number of lines to use for that spacing in the spacing line Just as for the line spacing you can turn the forced line spacing between questions on and off and specify the number of lines for that spacing Menu fields with Menu Labels can have that label included as a form of introducing the response after the question text This is often use ful for groups of responses such as
17. 1 B AgeYear AGE End e Menu Zeroto Y ears x 1 T Genderlow GENDER 4 Whatis your gender Radio Gender 1 a FormalEducation FRMLEDU Al 5 Whatisthe highest degree orlevel ofschool Menu Formal X1 8 EthnicGroup ETNICTY A 6 To which ethnic group s do you belong For Select 8 Ethnic 1 10 EthnieGroupOther ETHNICTYO C To other please specify Field 30 g x 1 11 Marital Status MAR STAT ei 8 From this list please pick the one closest to Radio Marital 12 MaritalStatusOther IMARSTATO C 4 other please specify Textbox 80 3 x 1 18 Havechildren CHILDREN C 10 Doyou haveanychildren This questionis Fadio Yes Mo 1 14 Residence State STATERES 11 Irapplicable in which statelprovincercounty do Menu Stake H Choices Menu Label Figure 68 List pane Choices column ADA O eni a mp Setu P Medication Effectiveness Medication Frequency i r2 HumberofMatherschilde MTHCHNHH OrdernniMothersChildren MTHCHORD MothersBovsBeforeMe MTHCHBOY Ta how many children did your BIOLOGICAL Menu RAG Age Index Offence Of vaurmathers BIOLOGICAL children which Menu RAG DSM PD Of vour mothers BIOLOGICAL children how Select Pe DM Schizophrenia HA Failure on Conditional Release RAD Use Rgd Pg Ord Field Export Name Group Question Text Type Mental State At Time of Alleged Offence 2 1 PageHeaderT ext o lt h3
18. 40 Creating Your Web Based Survey with The Surveyor 28 At Usine Me Surveyor Database usn ehe itm diam bae Eo D p ees Eb ne dob beds 29 dl as o hs atu ae bes ui Actu titt ee op dec ndi abe o vB a odis 29 Ad JNavieatine the Surveyor Databases sse was eed rate nb dea urs s 30 42 Specifying Questionnaires with The UV Old het ie d dir e ES eee 34 224 be List Pane He ne dera Moe odio t bine Gaara T MP Oe ses SEA 34 4 2 1 1 Delete Question Records es is usure ire ae 34 4 2 1 2 Requiica ll acuit E ls N sa T 34 4 2 1 3 PAC Nube is da dada ies 35 4 2 1 4 Order OO Pase sierras anb deberian oo E E Lanyon Cocos 35 4 2 1 5 FON AMIE aca stars da trees iue de stb ird ra ele ear od bou cantra eae dd ds 35 4 2 1 5 1 Papeseadet R Ord usse un eau sao tpi oit ares itd par eas 36 2 21 52 ext erder RECON aseo te oaa creo Rex etu dee tede e 38 4 2 1 5 3 Oueston Recorda e di be dd anc eR OH tuni 38 4 2 1 5 4 Jump To Page Records Skipping Branching 38 4 2 1 5 5 Related RECOLAS atan wade heo ass HE la ido 39 4 2 1 6 POL N E sia ad N ETE 40 TE ME SS 41 4 3 4 2 1 8 ICCA Etetea rae obo aAa eE ed a e a 41 4 2 1 9 OE Eelo E E E EE EE 41 AD Ne QUeSUOM LERE perean PO s bee qeu tpe Io d So a 41 A EE DE A AGE E E ANE cual EERE E a 42 AIET Cbheckbor tied Wy pest Diets CERE IIS hd shots A E 43 Aziz DEPO ein A E ex esa da tn elon EKEN 44 Dol EN ne mic a a dotati a re e er ls 45 Ale ied M
19. LastName Question Field 3 Gendertlow GENDER Question Field Droplets DROPLET Question Field 5 HaveChildren CHILDREN Extra Sort Field 1 FormalEducatian FRMLEDU Extra Sort Field 2 PeanutBulter PEANUTET Extra Sort Field 3 Strawberies STRAWBER Extra Sort Field 4 TotalWorkload TOTWORKEL Extra Sort Field 5 HumberdiMotheraC MTHGHNRA Results Listing Link Type Left Button Image List Field 1 First arne List Field 2 LastName List Field 3 GenderNow List Field 4 HaveChildren List Field 5 Mantal Status m i Ancilliary Files Server Oremde Question List 1 Override Question List 2 Ovemde Question List 3 Gender Oremde Question List 4 Droplets Overmde Question Lists Yes No Ovenmde Question Ovenide Question Ovemde Question Ovemide Question Ovemde Question bc hb ra or A Qushon Format Ewa enn First Mame Fleaze enter your first name here Last Mame Please enter your family name here Gender What is your gender 1 Male 2 Female 3 Droplets Picture Please select the picture you like 1 Droplet 1 2 Droplet Children Do you have any children This Wes 2 No Formal Education What is the highest degree or level of school you have Peanut Butter Do vou like peanut butter Strewberies Do you like strawberries Total Workload Please estimate the percent of your work time you spend on Number of Mother s Children To how many children did your B
20. Marital Stat usc her Textbox 30 3 TEXT HaweChildrer Radio INT Yes Mo Yes 2 Mo HTMLForExtraOptions Residence State m Menu 8 INT State Province Abeta 2 British Columbia 3 Figure 94 Limits pane A 5 JUMP PANE Jumping also known as branching is when based upon previously supplied responses the respondent is taken to a page other than the next page The conditions for the jump are entered in a special type of Record in The Surveoyr It is the JumpToPagelf field type To create a record with the Jump information find the records for the page on which you d like to put the conditional and then click the Jump tab at the top of the pane If no JumToPagelf record exists for that page you will be prompted to ensure that this is what you want to do If the record does exist you will be taken to the Jump pane As you can see from Figure 95 All you have to do is enter the conditions as part of a sentence that describes the logic so the condition in Figure 95 reads IF the field HaveChildren equals No then GO TO page 4 ELSE go to the next page Notice that if you enter nothing for the ELSE statement The Surveyor will assume that the respondent should go to the subsequent web page of your questionnaire Clicking the END check box tells The Surveyor that if the respondent s answers meet the conditions the respondent should be taken to the thank you page after this page You can specify up to three groups of two conditions for each
21. This database is used to both specify the questions in your questionnaire and generate the html Lasso and JavaScript code for the questionnaire s web pages It can also be used as a way to help get one s thoughts into order when creating the survey instrument itself and document those thoughts in a Microsoft Word format In effect The Surveyor achieves several purposes at one time It is a metabase 1 e a database that describes another database 000009 0 0 x ux on as fous 0000 Cf Use ves Web Number of pages inthe questionnaire 10 Field Information 01 08 2005 16 45 40 Trevor Number of questions inthe questionnaire 11 CommentsiNotes On page 1 this field is at position 5 andis question number 3 g Web Limits Check Choice text Field Name AgeDecade AgeDecade gt To 1 i Export Field Name AGE Required Yes AgeDecade To 7 7 Orderin Group Begin EMaillWrite Group Separator No C Empty Test If on this page field Same Question Number as Previous Yes Same Matrix as Previous Yes field Question Orientation Default Alignment Default Width Override Override Max Pictures Wide then the current field must be empty Question Text Please enter your age here This is an C Not Empty Test If on this page field example of many fields collected as part of field Response Type Menu Menu Label Tens Response Width characters Response Height rows then the current field must NOT be empty Display Field Lasso Code 4 Comparison Test
22. This sorting label is also present on the Detail pane You ll find that it s much easier to find duplicates in the Field names when sorting by this column A 2 1 5 4 JUMP TO PAGE RECORDS SKIPPING BRANCHING If you want to provide a skip pattern also known as branching in your questionnaire clicking the Jump tab will create a JumpToPagelf record at the bottom of the records for that page For the details of how to implement the conditions and destinations of the jump please see the Skipping Branching section and Figure 94 v8 0 v8 0 THE SURVEYOR USER MANUAL 4 2 1 5 5 E E A E Eo AR RO E 4E RO Ee ES RO RO OO ooo me cn cr Be to ra Use Rqd Pg Ord Fidi 1 aati ee IAS ary a ea ice a AA Pag eHead aT ext GHoaConcentrate GHOSlee p GHOUs ef ul GHoBecisions aHa Strain sHaDitfic ulties GHQEnjoy GHOProblerns GHOUnhappy GHC onfidence HeaderT ext GH ort hless GHOHappy JumpToPagelf RELATED RECORDS Epia Name Group GHGCONC GHOSLEP GHOULS FUL GHOGDECID GHOGSTRAN GHODIFCL GHOENJY GHGPROBS GHOLNHAP GHOCONF iaHGWWHTHL GHGHAPY E Question Text 2 h3 shdattid Likert Fields h 3 24 a nthe past hun weeks have vou Been able to h c d e Lost much sleep over vom Felt that ou are playing a useful part in thin gs Felt capable of making decisions about things Felt constantly understrain 25 Feltthat vo
23. as shown in Figure 121 The Default Alignment of the text is up to you It can be left or right justified or centred Generally yo ll want to use left justified but we ve seen occasions in the Left right quesiton response orientation that right justifying the question text can be appropriate The Default Orienta tion of the question and response is set here for the entire questionnaire Individual quesiton records can override this if you want to do so The next set of fields for the Questions lets you set up whether and how questionnaire numbers appear on your web pages The first field determines whether the number are shown the second specifies the number of pixels wide you want the column in which in which you want the question number will appear unless you want enormous question numbers or you have over 99 questions the default value of 25 pixels is likely to be fine The next three fields are for the font attributes Note that if you do not specify font attributes they will be inher v8 0 85 THE SURVEYOR USER MANUAL 86 ited from the question font attributes above The final field in the goup is a pop up menu of which character you d like to put after the numerals e g a period a parenthesis a comma or a hyphen The last group of fields provides for subquestion numbering when you use a Subquestion Header field type The fonts attributes work in the same manner as the question number attributes including inheritance but the i
24. corn Figure 132 Textual e mail subject introduction and exit text 92 v8 0 THE SURVEYOR USER MANUAL The three fields in Figure 132 allow you to determine the subject of the textual e mail sent to the respondent upon completion of a ques tionnaire Likewise you can specify how you d like to introduct the text of the e mail and end the message with a signature Note that you can put properly formed Lasso code into the introduction and signature fields as shown in the EMail Intro Text field in Figure 132 Please note that this Lasso code is not checked for syntax or any other errors by The Surveyor You must be sure that the code is in correct syn tax If you get an error page when sending your textual summaries by e mail one of the first things you should do is check your Lasso code in these three fields For more information about the correct form and use of Lasso syntax please see the Lasso documentation from OmniPilot com If the subject field is empty The Surveyor will use Your responses to the OuestionnareName questionnaire where Questionnaire Name is the text that you enter into the Questionnaire Name Prose field in the Set Up gt Web Page Format pane Alter natively you can include Lasso code in the e mail subject field Hence the code might look something like String Concatenate Questionnaire for field FirstName field LastName assuming that you have data fields called FirstName and L
25. one or more web based fields will be created The reason for there is not necessarily a one to one relationship between answers and database fields is that say the year could be presented as 2005 2006 2007 etc or as four independent numerals such as n m o p that are then concatenated by your analysis software If you d like each of your questionnaires that you put up on the web to have a different look and field one of the easiest ways to do it is to change the default backgrounds buttons headers and footers for your questionnaire pages Using the PhotoShop templates provided this can be done easily in a single place Finally exporting your sample data to SPSS is achieved by simply pressing button in the web Admin area At the time the data are exported they can be e mailed to one or more people Each of the above tasks is detailed in its own section below 4 1 USING THE SURVEYOR DATABASE The Surveyor database allows you to perform most of the tasks required to create your questionnaire and get it on to the web In general terms it is with The Surveyor database that you specify your questions and how you d like them to appear to the respondent s web browser The Surveyor creates all of the html Lasso and JavaSctipt code to operate your web based questionnaire The Surveyor is a FileMaker runtime application This means that if you have a copy of FileMaker you can run The Surveyor using FileMaker but FileMaker is not required
26. 18 document NextPage elements Token Page value 18 document NextPage elements Token ReturnToPage value 18 else if parseFloat RadioValue 1 1 document NextPage elements Token Page value 2 document NextPage elements Token ReturnToPage value 2 68 v8 0 v8 0 THE SURVEYOR USER MANUAL if NoProcess Math Add field OFFCPTV field OFFD3PSH field OFFD3PLG field OFFALL field OFFI3PTY field OFFJTVTR field OFFBOT NoProcess 1 alert You will now be taken to page 18 document NextPage elements Token Page value 18 document NextPage elements Token ReturnToPage value 18 else if NoProcess field RECMR1AR NoProcess 1 alert You will now be taken to page 18 document NextPage elements Token Page value 18 document NextPage elements Token ReturnToPage value 18 else alert You will now be taken to page 11 document NextPage elements Token Page value 11 document NextPage elements Token ReturnToPage value 11 4 6 SET UP PANES The Surveyor provides many settings to tailor questionnaires to your needs The default settings are the place to start as you change the look and feel of your own questionnaires As you can see from Figure 96 we ve divided up the settings into basic functional area The Company pane is for information that describes the author o
27. 2 RECORD IN USE CHECK BOX The record in use check box allows you to keep the record without including it in the web questionnaire and without deleting it In the Find pane there is a button to find all Omitted records so that you can restore the record at a later date 4 3 3 QUESTIONNAIRE PAGE SUMMARY At the top left of the Detail pane we ve included a quick summary of the questionnaire and where the current question is on its page Note that the position on the page is only with respect to other question header jump records on the page m Use Eves Web Humber of pages in the questionnaire io Humber of questions in the questionnaire 11 On page 1 this field is at position 5 andis question number 3 Figure 76 Questionnaire page summary 4 3 5 QUESTION NUMBER ON WEB PAGE This field in the bottom right of Figure 76 1s calculated by The Surveyor at the time of a full export of pages or when you click the blue col umn heading in the List pane You cannot directly change this number it is provided in the Detail and List panes for information purposes only 4 3 4 FIELD NAME EXPORT DATA COLLECTION FIELD NAME AND REQUIRED FIELDS Field Name AgeDecade Export Field Name AGE Required Yes Order in Group Begin EMali inte Group Separator Ho Figure 77 Field names required field and order in group The Field Name is the name that is currently used on the web page for the non numeric questions For numeric q
28. 23 3 1 1 3 1 1 Domain Web Site Home Button 23 ole lee Questionnaires Home Dutton 12 et p dtm ac o clans deis 29 3 1 1 3 1 3 Qucstonnadtes Help DUtOD acce acest ton diet bnt e oe couunedesseses 24 3 1 1 3 1 4 Questionnaires About Us Dutton a uo diner teintes 24 SERALI Questionnaires Contact Us Button ons ay es E NIRE RAN ia 24 liz Ouestonniaites java End Asso vi ole SE CAE vi ES 24 21155 Questionnalres avastati lass ui eade x te caw ER bel o ee etc 24 3 1 1 3 4 Questionnaires Mers 13850 Essen ioc E Seen da dado a dirai a ac PR 24 Mile Questontaltes Style ccs sis prodidit a Ac dedi Od ete ena ats 24 3 1 1 3 6 Ouestionnaires Namelasso io bei thee EA Ebr ated sands 25 ce Palas gi Questionnaires PageBackground lasso 2 54 4 head cip ener Pe p 25 3 1 1 3 8 Questionnaires PaschGOter lasso a vea ses deett eec imeem Pad ea 25 3 1 1 3 9 Questionnaires PageHeader lasso us a0 oed waa E Pedes eee 25 3 1 1 4 Questionnaites maccs Foldet dd e p od dod db T belli ta 25 DAS Ouestionnalre Folder one ass SR RSR ANR 26 3 1 1 5 1 Questionnaire Index 1590 ass edd ewes oen a iret date 26 211352 Questionnaire Index BB suuin ares es ss troi d oie sob 24 3 1 1 5 3 Questionnaire Pages Folder sidad eue 27 Som Questionnaire Images POITIERS LA en Lester 28 ILLOS Questionnaire I cludes PFoldet iui ise ichs qua Tu hice dn eth REP 28 2 2 Qonnusunus The DatabasecSebVeE und cs eniedis mo beet eat Ee ba diia 28
29. 30 eoo 9 O om ux unis sumo servo essor 0000000000000 Field Reqd Type w is H gt lt SPSS Prec SQL Type Lgth Prec Choices ListName Choices List Pairs PageHeaderT ext m HeaderT ext al Firstblarne El Field 15 CHAR 45 LastName E Field 15 CHAR 45 AgeDecade Ii Menu 1 7 INT ZerotoNine 0 0 1 12 223 24 45 56 6 7 7 AgeY ear E Meny INT Zero to Nine 0001122334 4 5 5g 8 7 7 GenderMow Cj Radio INT Gender Male 2 Female 3 Intersex 4 FormalEducation Ei Menu INT Formal Education Grades 1 12 NO DIPLOMA 2 EthnicGroup E Select 6 CHAR 220 Ethnic Abonginal Cree Micmac Metis EthnicGroupOther Field 30 CHAR 80 Marital Status Ej Radio INT Marital Status 1 Legallymanied 2 Living together Morita StatusOther Textbox 30 3 TEXT HaveChildren E Radio INT Yes No Yes 2 No HTMLForExtrsOptions Residence State rj Menu 0 8 INT State Province l Alberta 2 British Columbia 3 Record 3 of 14 records found from total of 99 records There are 10 pages in your survey Figure 31 Limits pane The Set Up tab takes to you a series of panes where you can define the look and feel of your questionnaire These functions are covered in a later section The Export pane is covered in the section Exporting Web Pages and Scripts Please refer to that section for more information about export ing your questionnaire web page files and script files for SPSS The next four buttons allow you to move all
30. 9 Please type in the password use only alphanumeric characters Le a z A Z and 0 9 Please type in the respondent s e mail address Do you want to send an e mail to the respondent with the information that his her questionnaire is ready Pick Here VE Please type in the subject for the e mail Your questionnaire for the Sample Survey is Ready E mail body text Append number password and survey web page location to the e mail Please pick here FE Back f Next P Figure 162 Sample web page for creation of individual questionnaire 117 THE SURVEYOR USER MANUAL 118 If the questionnaire administrator supplies an e mail address for the respondent an e mail announcement that the respondent s question naire is ready can be sent automatically by The Surveyor at the time the respondent record is created Select Yes or No to the first pop up menu to tell The Surveyor whether to send this e mail message When presenting this page to the questionnaire administrator The Surveyor suggests a default subject for the e mail message and presents the default creation message in the body text text box so that you don t have to hunt for the body text every time you create a new respon dent record in the data collection database Figure 162 shows nothing in this text box since the Sample questionnaire does not have anything in this field in the Set Up gt E Mail pane as shown in Figure 135 If y
31. Age ear AGE End Menu Zeroto Years 1 1 1 1 1 1 1 mx 1 1 1 1 1 1 1 GenderNow FormalEducation EthnicGroup EthnicGroupOther Marital Status Marital StatusOther HaweChildren ResidenceState 2 3 4 5 AgeDecade AGE Begin B 7 8 GENDERNW FRMLEDU ETNICTY ETNICTYO MARSTAT MARSTATO CHILDREN STATERES 0000000000090090 What is your gender Whatisthe highest degree orlevel of school To which ethnic group s do you belong For If other please specify From this list please pick the one closestto If other please specify Do you have any children This question is Radio Menu Select Field Radio Textbox Radio IKtapplicable in which state provincefcounty do Menu 30 30 Gender Formal Ethnic Marital YesNo State Record 3 of 14 records found from total of 99 records There are 10 pages in your survey Figure 5 List pane To change your password click the Set Up tab to the Set Up Company pane Figure 6 and then the Password button at the top right of the pane to get to the Set Up Password pane Figure 7 Click the Change Password button and enter the information requested by the dialogue and click OK Figure 8 This will bring up the change password dialogure for the Field Choices databases Enter the same information in this second dialogue as you entered in the first You can enter any combination of letters and numerals for your password Be sure to keep your pa
32. Field Choices database Limits Jump Set Up Export i lt rar Question Format E Mail Admin Buttons es amm Password zal E F m ES te Company Info Server Ancilliary Files Change Password Figure 144 Set Up gt Password pane 4 6 10 SET UP gt IMPORT PANE The Set Up gt Import pane allows you to import questions from another Surveyor database file into the current database You can simply add the records or replace all of the records in your current database The former function is very useful if you have developped specialised ques tions for your area of research and you want to include a batch of them into your current questionnaire Before you import from another Surveyor database make sure that you have opened that Surveyor database and found only the records you want to import Then close the source Surveyor database and open the destination Surveyor database to perform the import The Same applies to the records of the Field Choices database if you want to import records from it The import of set up information is a quick and easy way to add the look and feel of another of your questionnaires into the current database no record additions are performed i e only the global variable settings are altered in this process You can then use these imported settings are the starting point to modify the current questionnaire s look and feel and its name and web server information
33. Here Text Pick Here Figure 128 Default menu label You can also override the questionnaire wide default menu label by specifying questionnaire specific menu labels The results of setting the menu labels for two questions in a group is shown in Figure 129 Figure 129 Menu fields with question specific menu labels 4 6 6 SET UP gt E MAIL PANE The Surveyor sends e mail for several reasons 1 2 3 4 5 6 when the respondent s questionnaire is created or imported you can have an e mail sent that tells the respondent that his her questionnaire is ready for them to enter data when the questionnaire administrator sends a message to a single respondent or multiple respondents when the questionnaire administrator decides to send a summary of a respondent s answers to the survey administrator s default e mail address when a respondent completes a questionnaire and sends him herself a copy of his her responses copies of some of the above e mails are sent to the default administrator s e mail address and when an export of respondent data is performed the questionnaire administrator can send copies of the data files to the deafult address and additionally send more copies to other e mail addresses To accomplish these functions The Surveyor needs to know some e mail addresses contents and formats for the e mail body test and e mail server information and passwords which are entered in the E M
34. Privacy Statement Privacy Statement Because we want to demonstrate its commitment to our users privacy it has agreed to disclose its information practices on its web site What personally identifiable information we collect What personally identifiable information third parties collect through the Web site What organization collects the information How we use the information With whom we may share user information What choices are available to users regarding collection use and distribution of the information What types of security procedures are in place to protect the loss misuse or alteration of information under our control How users can correct any inaccuracies in the information If users have questions or concerns regarding this statement they should first contact us by e mail at the address on our contacts page If they do not receive acknowledgment of their inquiry or their inquiry is not satisfactorily addressed they should then contact us by telephone or postal mail By displaying this Privacy Policy we agree to notify users of Information Collection and Use We are the sole owner of the information collected on this domain We collect information from our users at several different points on our Web site Companies that request us to host their surveys are sole owner of the information collected by their hosted surveys and their portions of our web site Our hosting clients may collect information from our
35. SampleRelated already exists The SampleRelated table UserNumber field has been successfully updated The SampleRelated table UserPassword field has been successfully updated The table SampleSecurity already exists The default admin user already exists The default respondent user already exists The table SampleValueLists already exists ValueLists mrg is a Mac OS 9 file Found 617 value list records Deleted 617 value list records Added 617 value list records The group SurveySampleAdmin already exists The group SurveySampleRespondent already exists The user demo already exists The admin user to admin group link is already in place The user Resp already exists The admin user to respondent group link is already in place The respondent user to respondent group link is already in place The admin group was given include permission The admin group was given include URL permission The admin group was given include raw permission The admin group was given library permission Figure 159 Sample web page with results of database creation v8 0 THE SURVEYOR USER MANUAL Figure 159 shows the top of the reply page sent to the questionnaire after a request to create the data collection databases The page will tell you as shown in the figure whether a database table and or user already exists or was created The reason for this is that you may want to change data formats or add fields to your data collection databases after t
36. Secure field of this pane unless you intend that all access to this questionnaire should be with https and you have the appropriate SSL certificate installed on your web server Change Password Old Password CL New Password Confirm new password 0 Figure 8 Change password dialogue If you have lower than Lasso version 8 make sure the Site ID in the lower highlighted area in Figure 9 is 1 If you are using LassoMySQL for data collection the DataSource Connector ID should also be 1 In this case the Default MySQL Database Name should be lasso internal no quotation marks If you want to use an external installation of MySQL you should obtain the DataSource Connector ID and Default External MySQL Data base Name information from your Lasso administrator and enter them in the appropriate fields of The Surveyor in the lower highlighted area in Figure 9 Normally these would be 4 and mysql respectively see also Appendix A for some external MySQL database configuration exam ples These values and a few other useful ones are available in the pop up menues in the pane If your MySQL administrator has removed the mysql database or the test data base that are installed in the standard MySQL release you will have to choose Other for the Default External MySQL Database Name and enter the appropriate name manually Note that communication with the external installation of MySQL must be working before you
37. Zool ARMAS COLAS vaso qu ird mS AS E eric Lu d 121 Aono JENIUSUEVOV EXE vcr ates ee ee tee Non aed estas dro feel e NUDO A d 121 A he Bee p pt eee ek EORR tena 123 Ado JXporiData l5sOu oa ur Decet vs eri rer ene n ee leu 123 ARS LC xportataReply lass stes aces enone Gant See hows ewes eke oe Ee 125 AO IOIDIaSSO 6 20 005 nn ak det en eee es edu Ex aoe eee as 127 ox MENU CAU pr a ip wath oe ae es 127 dS a AA Stele doo a dedu adatto edet etui icu dede al 128 ADD SVO NASO ut A dac putetur ur ats 129 vi 4 7 4 quo SUVENI SLAO tance wean die eicit Eb ette a oM Oba wane ee ears 130 471 922 SULVEYNGMINSCCULL ASSO sada brand e ebria e enel a 130 119 23 DUNE CLEAN LA SO ouest ennemies ba eid Ar 151 Ad O24 sSurye CLCANOUREDIY ASSO as adonde qe AR Mad acad at E hc qt AP es den 152 Ao Survey ina lasso Lor IN page cresias earras nne Serb ORA tienne 12 3 26 Saye LOI ASS id n re RENE poet 133 ART uSutveyesultSPopUD 3880 is tala uh E A ae danse 134 Azor OUVE REVON TAS O Yates nta teer dia edes 136 Aleka SUIVEVREVIEWN ASS eee reU Ne ER MA ibd S ua ded 137 ACIDO Survey Review Deletelassoa ux eu ab e Cu bete S ber TENURE UR 137 AMIS S ryeyReviewDeleteDone lasso ata aaa 157 Aaa SUE Review DE Parent lasso naa a e a 138 415 35 utveyRevienDelParentDoOnelasso imp ponte he wees RB RING Ee 138 o Louve NevicwL OUNC ASSO ian cea eter ee eds at ee aed 139 5159 99 DOULVEVINCVIC WIASLIASSO Esti at ta ola dard 139 4 7 3 36 Survey
38. a web page like the one shown in Figure 172 It confirms the export and e mailing of the file s in great detail Export Data for Analysis The export folder exists Samples Sample Exports 20041210Backup lasso existed and has been emptied in preparation for the export 14 responses have been exported to the file Samples Sample Exports 20041210Backup lasso The export folder exists Samples 5Sample Exports 20041210BackupText lasso existed and has been emptied in preparation for the export 14 responses have been exported to the file Samples Sample Exports 20041210BackupText lasso E mail sent without error E Mailto Trevor Videlicet com Ed Back f Export E mail gt File Name File Size Last Modified 20041210Backup lasso 1453 12 20 2004 13 59 41 20041210BackupTextlasso 867 12 20 2004 13 59 f Home f Surveys SAMPLES f tasso 9 f Create Upload Import E Mail Admin f Export f Log Off Figure 172 Sample Admin export confirmation web page v8 0 125 THE SURVEYOR USER MANUAL The e mail will be titled with the name of the questionnaire and the file name s and with a simple body text as in the example shown in Figure 173 The export reply page also provides the questionnaire administrator the means to send the exported file s again but to anoth er recipient which produces a shorter reponse page also with the ability to resend the files by e mail as shown in Figure 1
39. amp Er Figure 51 Matrix Value field type top bottom orientation Please answer using the following scale Yes 1 No 2 N A 3 Decline 4 1 2 3 4 a Do you like butter 0 e Cj r b Do you like peanut butter C C fw 2 e Do you like jam Required O O O fe Figure 52 Matrix Value field type left right orientation e Do you like apples Required Please answer using the following scale Always 1 Mostly 2 Frequently 3 Uncertain neutral 4 Sometimes 5 Rarely 6 Never 7 1 32 fa 3 4 p ee 5 6 r7 ONJA Decline a Figure 53 Matrix Value field type top bottom orientation numbered buttons Please answer using the following scale Yes 1 No 2 a Do you like butter 1 fe 2 C N A Decline b Do you like peanut butter LE N A O Do you like jam Required 1 a O N A fe Decline Figure 54 Matrix Value field type left right orientation numbered buttons 48 v8 0 THE SURVEYOR USER MANUAL 4 2 1 11 7 MENU FIELD TYPE This format presents the respondent with a pop up menu from which to choose a single response When clicked all of the possible responses ate shown up to the maximum height of the respondent s browser The upper part of Figure 55 shows the compact form of the Menu field type when the respondent s mouse has not clicked it When clicked by the mouse the whole menu is shown as in the lower part of Figure 55 The exact look
40. an existing copy of that file and to specify an e mail address to which a copy of the new file should be sent To help the administrator determine an appropriate name for the file a list of files in the Summaries folder is provided on this page Once sent confirmation is provided and the option is given to send the file to another e mail address Note that only one e mail addressee may be used at a time Figure 200 shows the confirmation web page v8 0 v8 0 THE SURVEYOR USER MANUAL JamesBond lasso Please pick here Info Videlicet com Figure 198 Sample Write Summary Text File web page 4 7 3 13 WRITEQUESTIONNAIRE TXT WriteQuestionnaire txt is called when the questionnaire administrator has completed the fields in the WriteQuestionnaire lasso web page It generates the textual summary of the responses for the current questionnaire being perused by the administrator Figure 199 shows an exam ple of part of the contents of the file version of the summary file Essentially WriteQuestionnnaire txt ensures that the numerical values stored in the MySQL database are converted to their textual equivalents in the summary file In large questionnaires this WriteQuestion naire txt can be quite large For example in one questionnaire we have generated with The Surveyor the 1 000 questions in the questionnaire resulted in just over 1MB af Lasso code in the WriteQuestionnaire txt file Note the first line of the summar
41. and feel of the pop up menu will vary from browser to browser and operating system to oper ating system but its basic working and function is the same on all browsers The pop up menu does not include any formatting simply the text from the Choices list for the given question Accented characters typed into the Field Choices database of The Surveyor are properly encoded to appear accented in the web pop up menu Grades 1 12 NO DIPLOMA zT Y Grades 1 12 NO DIPLOMA High School Diploma GED Some college credit but less than 1 year lor more years college no degree Associate degree for example AA AS Bachelor s degree for example BA AB BS Master s degree far example MA MS MEng MEd MSW MBA Professional degree for example DDS DM LLB JD Doctorate degree for example MD PhD EdD Figure 55 Menu field type mouse up and mouse down Note in the lower part of Figure 55 that the uppermost choice is blank This uppermost line is the one that is shown on a page to which no responses have been given and no default values have been specified If you d like to provide your respondent with information about the contents of the pop up menu when the web page is first shown on the browser you can do so with the Menu Label field For more on menu labels please see the Menu Label section below Figure 56 Menu field type used to prevent numerical errors Note how using a group of
42. as where several fields are required to produce the answer to a single question such as the case for Social Security number The Order field can be the same for all of them but the order within the group of the nine fields required to produce the full Social Security Number has to be specified In cases of groups like this use the Group column to specify the order within the group 4 2 1 8 DETAIL LINK The small blue buttons in the middle of each line are links to the Detail pane for that particualr question header jump record A different detail page is provided for each type of special record 4 2 1 9 QUESTION NUMBER The question number is generated automatically by The Surveyor and is updated upon a full export You can force a renumbering by click ing the underlined column header Sub question numbers are also generated automatically at the time of renumbering You can display or not display the numbers on web pages by making your selection in the Set Up gt Question format pane of The Surveyor The font and colour of both the question number and sub question number can be set in the same pane 4 2 1 10 QUESTION TEXT This field is used to enter the questions that you want to ask you respondents You can use a tab delimited file to import the text from else where if you like please see the Import section Just about any character is acceptable in this field The Surveyor will rework special characters as required by say JavaScript whe
43. attempt to create your questionnaire database and tables If futher security is desired for the Lasso MySQL communication v8 0 7 THE SURVEYOR USER MANUAL your Lasso and MySQL administrator s should set the appropriate user names and passwords Please see the respective manual s if you don t know how to do this ou are usin asso and above e ite num er can DE whatever you wan u e aerau site 1s SO WE VC USE at as e aerau O use If y gL 8 and above the Sit b be what y t but the default site is 1 d that as the default t Mm Toolbar Available e Company Info Database information MySGL Database Name Questionnaire Table Name Related Table Name Security Table Name Yalue Lists Table Name Default MySQL Character Length Default MySQL Number Length Default MySQL Number Precision Guestionnaires Home Folder Path Questionnaire Home Folder Path Questionnaire Pages Folder Path Questionnaire Images Folder Path Questionnaire Includes Folder Path Questionnaire Imports Folder Path Peslionnaire Exports Folder Path Question mmanes Folder Path Lasso Site ID DataSourcelConnector ID Default MySQL DB Name Respondent UserName Respondent Password Xy X a Qa Server Information peta List Y Limits Y Jump set up Server Ancillary Files Web Page Format Question Format E Mail Sec urity Inf ormation gt Videlic et no spaces Use Password Sample no spaces Secure Do
44. basis upon which the percentage complete is calculated If you have not used sub question numbers and have no questions with multiple response fields this item should be left at being based upon question Number since in this case there are the same number of data ciollection fields as question numbers If you have more than the occasional question with multiple response fields but no questions with subquestions and they are evenly distributed throughout your quesitonnaire you should choose DataField so that the percentage complete reflects the num bet of responses made by the respondent This will make the bar more accurately represent the proportion of the data fields that have been addressed Likewise if most of your questions have a similar number of subquestion numbers you should choose SubNumber If your v8 0 THE SURVEYOR USER MANUAL questionnaire has an uneven distribution of multiple field response questions and or subnumbered questions your should experiment to find the best selection for this particular questionnaire Figure 110 Sample completion bar in a questionaire web page The last field in this part of the Web Page Format pane is where you can completely override the page banner header with your own html code We ve not yet found anyone who felt the need to use it but we decided to put it there for the sake of completeness 4 6 4 2 WEB PAGE TABLE SETTINGS Within the question web page width 1 e the p
45. client based data validation at the respondent s browser This validation is in addition to server side validation as the respondent s information reaches the server for entry in to the MySQL database Each time the respondent clicks the Next button at the bottom of the web page the JavaScript code is called to determine if the responses given meet the criteria specified with The Surveyor such as limit checks equivalence to previous fields etc B From this list please pick the one closest to your current situ Res O married Se together 2 or more years Common law O Widad mister common iin partner O Divorced O Separated from legal or common law partner O Single a und girl doy Bien JavaScript Sorry Given vour answer to question 8 From this list please pick the one closest to your current situation you must answer question 9 If other please specify Figure 178 Sample JavaScript pop up alert If the data do not validate a pop up message is shown to the respondent In the example shown in Figure 178 the respondent has neglect ed to click a required radio button Hence the respondent is told where the problem lies and what the problem is In this case in The Surveyor we specified that if the selection for question eight was Other then question nine should not be empty All of the validation JavaScript is created based upon the checking that you specify in the point and c
46. dot disais tons 60 Question text entry response field type width amp Height amp Lasso code 61 Choosine a SE OP holees udo deese Le ter diee dao ate ae 61 Excludite question trom textual equal sense ASA oe tiber AUS VT 62 SPECA Dopp Nel uto beri eit a ua p RR Saut ec dist EM ees 62 SPSo datatype lotat OP PRECISION eo dro idee de EE EROR EA UE PEE 62 Commenting your quests edd doceant e hee AA E 65 Data limit cS009 users EET e m p Pod fond tees eter TR Rd aes 63 RADET ASUN ses sine edhe metido ade einem 64 ghe ADE AAA rrET 64 COR DA OD ES IN tata td toa de deat 00 il abs dunt etae 64 Ottone ON Seba Go dud oae datei ur odo teca b di ter ee t duct 65 Extra AVA CUE CSS oo eth ae sued fet oa a te da Mt dance d ovale atn ae apice edd 65 Addo exta CHOICES to COCO Ps sin diane de Meca tesoro Che ttes SAP i 65 Specifying jump skip branching patterns 12er te RP EPIS ARP PPM PN EET 66 LAS PANG hog naa bam eri retten de prt o hase ace See duo wh ad 67 Powe 95r TUMPPARE us sheet en dona hare ias in d ard ne eeu Rat 68 Figure 96 Figure 97 Figure 98 Figure 99 Figure 100 Figure 101 Figure 102 Figure 103 Figure 104 Figure 105 Figure 106 Figure 107 Figure 108 Figure 109 Figure 110 Figure 111 Set Up Company pane s aeo kinpa dob baci Chao prar sa oie oiesopds debas 70 DEL UP Delve Pane ei crane mou cerner du 71 Setting up MySQL data col cuoninionmatons en va ach duci ase aD c
47. e th b Deine Iova ba dederunt 26 Sample questionnaire level home web page browser with JavaScript 26 Sample questionnaire home web page browser with no JavaScript 2 About his NDDIEADOD PIC la a tesi mb ras 30 INavieagoB Tabs EBD ASC aC prada tnt da na SUR eee 30 ind Pan C eae 31 Ibero C sudar apilados cabo aku dy bd da 32 AMES Dale oue spi rado ida wee fae ae weirs 33 List pane with column headings and fields cob o hau eh E Eee ES ao oe 34 sample quesuonnale WED DANG NE iii drain a dread wed que 36 Webindmia tor st pate Ol a portal maneire da dears Sec eere e ii 37 Pace header text muse mihe web Admi ans icem bu eu nie ec urs 37 Figure 36 Figure 37 Figure 38 Figure 39 Figure 40 Figure 41 Figure 42 Figure 43 Figure 44 Figure 45 Figure 46 Figure 47 Figure 48 Figure 49 Figure 50 Figure 51 Figure 52 Figure 53 Figure 54 Figure 55 Figure 56 Figure 57 Figure 58 Figure 59 Figure 60 Figure 61 Figure 62 Figure 63 Figure 64 Figure 65 Figure 66 Figure 67 Figure 68 Figure 69 Figure 70 Figure 71 Figure 72 Figure 73 List pane with Jump To Pase record uni dinar tout bro elisa Sia 39 List pane soe poral Pop Up uses dus Aube ba eden orbe ho ot oor dvd op d 39 ist pane with laspppae Oo POr uua ee une ee rane thiet EAE 40 Web Admin for Sample questionnaire detail to show portal subject
48. file that contain both html and Lasso code for inclusion as building blocks of html web pages in the Pages folder below and the Questionnaire Index lasso web page The files are the same as for the Questionnaire level see Surveys Includes Folder with some extra filesPlease see the Export section for more detail on the files in this folder 3 2 CONFIGURING THE DATABASE SERVER The web Admin section of your questionnaire provides a button if you want it visible that takes you to a page that allows you to create and con figure the MySQL databases for your questionnaire and the Lasso configurations at the same time If you choose not to make the Admin or the Lasso MySQL button s visible you can still get to them by noting their URLs and going directly there This hidden feature helps prevent surfers from getting to your Admin and MySQL sections More detail about these files is provided in the Set Up and Export sections 4 0 CREATING YOUR WEB BASED SURVEY WITH THE SURVEYOR There are some distinct steps to getting your survey on the web 1 creation of your questionnaire survey instrument and 2 export of the web files for your questionnaire 3 creation of the questionnaire database and security settings Minor ancillary tasks that can determine the look and feel of how the survey is presented to your respondents include web button generation and deter mination of the requirements for the web page headers and footers
49. height of the graphic line between the realted records The entries in Figure 124 would produce the divider bars in Figure 125 The image is from Safari Note that Safari and other Miozilla style 97 THE SURVEYOR USER MANUAL browsers include the cell padding as part of the height whereas Microft Explorer does not Hence in Explorer the height is the one pixel specified in The Surveyor We ve not yet found a way to make all the browsers display this bar in exactly the same manner 1 Related Records Related Record Hdr Bar Colour 0033FF Height 1 pixels Figure 124 Related record separators This page shows how multiple child records can be created for each questionnaire Add as many as you want They will all be reported in the report and can all be edited when the questionnaire is reviewed on line For each of your biological genetic children please enter the following information 21 Gender Required 23 Living with you Uncertain and Decline added to the list with a ne mouse click in The Surveyor Required This page shows how multiple child records can be created for each questionnaire Add as many as you want They will all be reported in the report and can all be edited when the questionnaire is reviewed on line For each of your biological genetic children please enter the following information 21 Gender Required 23 Living with you Uncertain and Decline added to t
50. of the files in the Imports folder v8 0 111 THE SURVEYOR USER MANUAL Once you ve decided upon the import file you need to tell The Surveyor whether you want to send an e mail to each imported respondent a message The Surveyor includes in the body area of the web page the default message you include in the Set Up gt E Mail pane of your questionnaire database It also includes a default subject for your e mail In Figure 157 you ll notice that we ve not included any default text for the Sample questionnaire Just as for the sending of individual e mail messages you can ask The Surveyor to append the questionnaire number and password to each e mail sent Your questionnaire for the Sample Survey is Ready Figure 157 Sample Admin import questionnaires web page When you ve clicked the Import button you will be presented the same page but at the top of the page there willl be confirmation of how many respondents were imported and e mailed Note that duplicate respondent records are neither imported nor sent an e mail message 112 v8 0 THE SURVEYOR USER MANUAL 4 7 3 5 ADMINMYSQL LASSO This page shown in Figure 158 is the one you use to create your data collection databases This is where you specify the questionnaire adminstrator name and password you d like to use for your questionnaires Admin area The first two field on this web page are to define the name and password Wie Pages AdminMySQL lasso b
51. page Note that this is not quite the same as finding all records for a page since you may have set some records to be not used in your questionnaire To find all records for a given page use the Find pane by clicking the magnifying glass button 4 2 SPECIFYING QUESTIONNAIRES WITH THE SURVEYOR 4 2 1 THE LIST PANE Each question you ask of the respondent requires proper specification in the Surveyor database Some of the things you will specify concern presentation on the web browser page others concern the saving of responses in the data collection database and export of data to SPSS mx mx Tox gx mx fx mx mx ax 1 1 1 1 1 1 1 1 1 0 CO cn cn Cal ra Use RadPg Ord Field 1 0 0009 0 9 pan PageHeaderT ext HeaderT ext Firsthlame LastName Ag eDecade Agey ear Gendertlow FormalE ducatian EthnicGroup A I DOr Se A EANET s Mae Li AS EE Er E Export Name Group Question Text 3 1 h3 Menu Select and Text Fields Text n Three of the fields onthis page are required MAME A 1 Please enter your first name here Field NAME a 2 Please enter your family name here Field AGE Begin ti 3 Please enter vourage here Thisisan example Menu AGE End a 4 Menu GENDERNYW n 4 Whatis vour gender Radio FFIMLEDU Al 5 Whatisthe highest degree orlevel ofschool Menu ETMICTY e B To which ethnic groupis do vnu belong For Select WO H Choices Zeroto Z
52. page will presetn a confirmation page to the adminsitrator By clicking Delete in this page confirmation is established and the main record and any associated related records are deleted The reply to the Delete button is shown in the next section Figure 190 Admin Sample main questionnaire deletion web page 4 7 3 33 SURVEYREVIEWDELPARENTDONE LASSO When a main questionnaire record the parent record is deleted The Surveyor replies with theweb page shown in Figure 191 Note that The Surveyor deletes not only the main record but alsoall the associated related records and provide confirmation of exactly which records were deleted In the case in Figure 191 there was only a main record Figure 191 Sample Admin main questionnaire deletion confirmation web page 138 v8 0 THE SURVEYOR USER MANUAL 4 7 3 34 SURVEYREVIEWFOUND LASSO When searching for a single questionnaire record using the Administer Questionnaire Data page The Surveyor will return the web page shown in Figure 192 if the record is found Note the questionnaire number in the figure highlighted in the figure for emphasis Figure 192 Sample Admin specific questionnaire found web page From this page the questionnaire administrator can choose any of the pages of the questionnaire and review the respondent s answers to the questions on that page Simply choosing the page number from the pop up menu and clicking Next is all it ta
53. pin gn EXER DEEP tege tem Chang a3 ord Record 15 of 15 records found from total of 99 records There are 10 pages in your survey Figure 7 Set Up gt Password pane v8 0 THE SURVEYOR USER MANUAL Please note that if you do not enter the same information in both password dialogues the behaviour of The Surveyor will not be predictable If you choose not to change your password you should click the Cancel button in both the change password dialogues Assuming you decided to change your password the instance of The Surveyor with which you are working has the new password you supplied 1 3 2 CONFIRMING THAT YOUR INSTALLATION IS WORKING Using the default survey data provided in The Surveyor s download will allow you to confirm that The Surveyor is working on your server s To do this you will need to do some simple configuations of your server and The Surveyor First decide on the URL in your domain that you want for your test questionnaire For the purposes of this manual we assume that it will be the http MyDomain com Questionnaires Sam ple noted in Figure 2 where MyDomain com should be replaced with your domain name On your web server create a folder structure similar to the one in Figure 2 You can use any name you want for the Questionnaires folder and the folders for each individual questionnaire See Figure 9 for where you should make your Domain and path changes in The Surveyor Do not enter a domain in the
54. s pages per Figure 26 e oe Sample Surveys The Videlicet Sample Survey Home RS APP ee ee a aoe lt ag V http videlicet com Samples Sample Index htmi Q Google i This survey requires JavaScript to function properly Either you do not have JavaScript enabled on your browser or the browser is not capable of executing JavaScript To fill out the questionnaire please enable JavaScriptin the browser you are using and then refresh this page or find a JavaScript enabled browser and return to this web address If you have any questions about our use of JavaScript for this questionnaire please contact us at Info at our domain Thanks HOME PAGE SURVEYS D Copyright Trevor H Jacques 2002 2009 The Surveyor HTML and JavaScript copyright Trevor IL Jacques 2001 2004 Figure 26 Sample questionnaire home web page browser with no JavaScript 3 1 1 5 3 QUESTIONNAIRE PAGES FOLDER If you have not already read Section 3 1 1 to this point you should do so before you continue this section and before you inspect the contents of the files in this folder This folder contains the bulk of the quetionnaire files themselves As in the case of the Questionnaires level the default version of this folder also contains a Help lasso AboutUs lasso and Contact lasso page that are exported by The Surveyor The body of these pages contains the text that you entered in Set Up gt Ancillary pane i e contact information fo
55. should have their questionnaire number and password appended at the bottom of the e mail Figure 154 is an example of a message sent to a single respondent Note that each e mail is sent individually so there is no way respondents can tell the e mail address es of other respondents The bottom three lines are the appended questionnaire information A copy of the body text and information about how many e mail messages were sent in this mailing is sent separately to the default ques tionnaire administrator e mail address It looks something like Figure 155 Note that only summary information is sent about the group of e mails sent 4 7 3 3 ADMINEMAILNOTICEREPLY LASSO When you send a batch or a single e mail from the Admin area of your questionnaire you receive a confirmation of the number of e mails sent to respondents and the e mail address of the recipient of the copy Figure 156 illustrates the form of confirmation web page Figure 156 Sample reply to Admin e mail web page 4 7 3 4 ADMINIMPORTQUESTIONNAIRES LASSO You can import lists of respondents into your data collection database The files should be placed in the Imports folder at your operating system level by FTP transfer or by using the Upload function the Admin area of your questionnaire s web pages Once the file is in the folder clicking the Import button will take you to the web page shown in Figure 157 The File name pop up menu will contain a complete list
56. the basic aspects of your questionnaire in a format that is easily incorporated into your word processor It s a great way to docu ment your work for future reference Figure 150 shows part of the contents of the Survey Summary RTF file for the Sample questionnaire Note how each question is numbered in the first column by page then order on page as well as with the question number This allows you to easily visualise on which web page and where on that page each questions is placed v8 0 v8 0 THE SURVEYOR USER MANUAL 1 1 Please enter your first name here 1 FirstName NAME Field web width 15 characters Required 1 2 Please enter your tamily name here 2 LastName NAME Field web width 15 characters Required 1 3 Please enter your age here INIS is an 3 example of many fields collected as part of a single answer Another example of this use is Social Security numbers The format prevents spurious data being entered ee AGE enu web label Tens Response must be greater than or equal to 1 and less than or equal to 7 1 4 Age Year AGE Menu web label Years Required LONDRAUNRS PANAMA IN MS nz ODADAIRLONO NO UE CN AO 1 5 What is your gender ale 4 GenderNow GENDERNW 2 Female Radio Required 3 Intersex ER A 5 Transgender 6 Uncertain 7 Decline 8 Other 1 6 What is the highest ree or level ot 1 Grades 1 12 NO DIPLOMA 5 school you have COMPLETED if the 2 High School Diploma G
57. the beginning of the Questionnaires pages which require JavaScript almost all pages It starts JavaScript statements that are assumed to have been written in the body of the calling file checks the browser version and provides a comment to indicate that JavaScript preloads should be inserted from this point in the calling file This file should not be included in the calling file if the Questionnaires level JavaEnd lasso is not also included 3 1 1 3 4 QUESTIONNAIRES METAS LASSO This file contains all the html META statements required for Questionnaires level lasso pages such as content description keywords and copyright statements You can modify this file as much as you want 3 1 1 3 5 QUESTIONNAIRES STYLE CSS The Name lasso file contains all the Lasso settings for Questionnaires level pages except web page font and paragraph styling which is handled by the web site Style css file This file is not in the MyDomain com folder but is assumed to be in the MyDomain com Includes folder If your web site does not have this file and or folder in your current domain to ensure consistent look and feel of the Ques tionnaires level you must ensure that the Questionnaires level cascading style sheet is present is to copy on of your Style css files to the MyDomain com Includes folder creating the folder if necessary v8 0 v8 0 THE SURVEYOR USER MANUAL 3 1 1 3 6 QUESTIONNAIRES NAME LASSO This file performs most of the tasks of making
58. the question header records for a page to the previous or next web page The outer two buttons also move all the records for subequent pages one page in the same direction Hence if one has just found the records for page two clicking the double up arrow will mve all records on web page two and up to page three and up If you had clicked the single up arrow all the records for page two would have been moved to page three The records for pages three and up are not affected byt using the single up arrow on page two The double up arrow action is the means to provide a space in the questionnaire to insert a new page Likewise the double down arrow closes up a gap in the pages of a questionnaire Moving from the records for one page to those for the previous ot next page is accomplished by the left and right arrow buttons to the right of hte tabs The single arrows move the view from the current page one page in the associated direction The double left and double right arrows v8 0 33 THE SURVEYOR USER MANUAL will show you the records for the first and last page in your questionnaire respectively Note that while these buttons look the same as the group at the left of the tab buttons those at the left move your focus from one record to the next whereas the ones to the right move your focus from web page to web page The numerical buttons at the top right of the panes of The Surveyor will automatically find all the records in use for a given
59. the questionnaire web pages Your SMTP e mail server should be put into the E Mail Host field Without all of the above information information your questionnaire cannot send any e mails If you d like the questionnaire administra tor to recieve copies of the textual versions of the responses sent to the respondents make sure that you enter the BCC address The last field in this part of the pane is for you to select whether textual e mails should be sent to only the respondent to only the ques tionnaire administrator or to both When you import a set of questionnaires from a text file The Surveyor sends the questionnaire administrator a single copy of the e mail not one for every questionnaire imported from the file 4 6 6 2 TEXTUAL E MAIL SUBJECT INTRODUCTION AND EXIT TEXT If you leave Ehe following three fields blank the e mail will use the default contents EMail Subject Text Sample Videlicet com questionnaire EMail Intro Text INTROCUCTION This is a report for if Field GEMDMNOwWw 1 Mr else if Field GEHDMOw 2 Ms JL IL Field FirstName Field LastHarne It is the result of vour having completed a sample questionnaire at http Vidselicet cam Samples 20035ample EMail Exit Text all the best Trevor Jacques Widelicet P Box 19591 55 Bloor Street West Toronto Ontario M4w 3T3 Phone 416 962 1040 Facsimile 416 962 1044 Email InfomVidelicet cam We ws Videlicet
60. the respondent can continue to the next page The SumTotal row is always in left right orientation 4 2 1 11 15 TEXTBOX FIELD TYPE Figure 65 Subquestion field type with left right orientation This page of the Videlicet Sample questionnaire shows examples of the Display Mennu EMail Menu and Textbox Surveyor field types respectively Note that the questions 41 and 42 have a left right question response format the other questions are in top bottom format Figure 66 Subquestion field type with top bottom orientation 53 THE SURVEYOR USER MANUAL 54 A text box is similar to the plain field but it is presented with several lines of text and scroll bars For this selection you must specify both width and height in the W and H columns Multiple paragraphs are permitted The Surveyor assumes that the number of charac ters in the reply will be no more than five times the width times the height of the text box This is to help minimise abuse of your questionnaire Unless you re expecting to have respondents provide essays we ve found this to be effective If you need more charac ters please contacct us with your details It will be a small change for us to make 4 2 1 12 FIELD WIDTH The Width field is used for Fields and Textboxes on the web page to specify an override of the default number of characters in the lines of the web fields It is also convenient for us to use this field to specify the s
61. these pages because experience has told us that these can change often before the final version of a questionnaire is ready v8 0 TT THE SURVEYOR USER MANUAL The Windows Pop Up selection allows you to have the Help About and Contact pages appear in the browser as separate pop up web pages rather than just links within the current window of the browser The remaining ancillary pages in this pane can be treated in the same manner except that they all have the option to be included or omitted from your questionnaire Simply pop up the Export Page file menu and choose the response you d like This will not only prevent The Survey ot exporting the web page file but also removes the associated button from the footer of the web page s Bring back the page into your questionnaire is as simple as changing your selection and re xporting the page and the FooterButtons lasso files m e Toolbar Available e peta Y ut Y Limits Background Colour FFFFFF Windows Pop Up ves d About Us Page Text Export AboutUs Page File es Formore about us pleaseMsit lt a rhrerz htt pt videlicet comi our maja home pagesia Export Contact Page File Help Page Text f Privacy Text Export Help Page File Yes Export Privacy Page File TEMPORARY PLACE HOLDER TEXT This is where voucan pul your help test andinstructions to vaurrespondents Record 4 of 88 records found from total of Q8 records There are 10 pages in
62. to which you d like a response If you have questions or comments about The Surveyor please send e mail to our Surveyor e mail address This page is where you d usually add an introductory description of your survey who should and should not complete it etc To administer this survey please use Demo without quotation marks for the user name and password Note that e mailing the report e mails it to the registered administrator so you will not get the report we will You can get a report by finishing a questionnaire as a respondent Note also that we have set up this sample survey to report only the first part of the survey i e all except the administration pages and that empty or negative responses have been excluded from the report T faj Back Start New F Login f Home Surveys Help About Us Contact U3 f Privacy Admin gt Figure 148 Sample Index lasso page the questionnaire home page 105 THE SURVEYOR USER MANUAL 106 4 7 2 EXPORT gt HELPER FILES PANE Record 1 of 99 records found from total of 99 records There are 10 pages in your Survey Figure 149 Export Helper Files pane Subsequent to moving to MySQL as the data collection database of choice the helper files have been reduced to only the export of your ques tionnaire in Word format See Figure 149 This in no way diminshes the importance of the Wrod export file It serves as a concise way to document all
63. up Help Pop Up Results Button Yes Context Sensitive Help Text then omit this field from the web survey page 1 Addio Choices partially Maybe Uncertain SPSS oO Yes Nd C Yes Na O Yes Na Data Type Formal Precision DNK NIA Decline Other 4 Jump To Page OYes amp Nq OYes amp amp Nd OYes 5Ng O Yes amp Ng Field name Operator Comparison Yalue Field name Operator Comparison value Jump to Page Number f IF GOTO OR End Field name Operator Comparison Yalue Field name Operator Comparison Yalue Jump to Page Number ELSE IP GOTO OR DEnd Field name Operator Comparison Yaiue Field name Operator Comparison Yalue Jump te Page Number ELSE IF GOTO OR End Jump to Page Number ELSE GOTO OR IEnd Figure 29 Find pane In terms of its appearance the Find pane is almost the same as the Detail pan It s function is to allow you to find records in your quesitonnaire database In this pane the menu pop ups also provide you with an Other choice where appropriate Clicking the magnifying glass button in the brings you to the Find pane where you just enter the search criteria and then use your Return key to execute the search Note that when you arrive at the search pane your cursor in put into the Page number field so getting to the fields for any given page is very simple Click but ton type page number hit the Return key The next four arrow buttons allow you to mo
64. very basic since it comes from the Sample quesitonnaire provided with the download Simply replace the text in the Set Up gt Ancillary Files pane to provide your respondents with the help information for your questionnaire 4 7 3 18 PRIVACY LASSO The Sample questionnaire has a very full provacy statement As Figure 176 illustrates it is very long but complete You may want to use this as a template for your own privacy statement or simply replace the text with your own You do this in the Set Up gt Ancillary Files pane of The Surveyor As your respondents submit completed pages of their questionnaires to the data collection data 1 e when they press the Next button at the bottom of each questionnaire web page the subsequent pageappears to be named the same i e Survey lasso It is this file that determines what to show the respondent as he she progresses through the questionnaire It includes the information for the questionnaire pages with in itself Hence while the URL will always be as shown at the top of Figure 177 the page information and number will vaty as the repondent progresses through the questionnaire This is but one of the mechainisms we use to make it troublesome for crackers to get to your ques tionnaire code 127 THE SURVEYOR USER MANUAL 128 4 7 3 19 If anyone tries to load Survey lasso directly i e without actually submnitting responses from a proper questionnaire web page the browser
65. web page When you include the information from grouped fields in the e mailed report or the written text file version you may want to specify whether and which characters separate the items in the group This allows you to have spearate fields on the web page but apparently a single response in the report For example for the age decade and age numeral in Figure 78 no separator is required so you d select Nothing from the pull down menu in Figure 77 We ve provided several common separators in the list such as full stop period comma colon etc but you can specify case specific ones yourself by using the Edit selection in the pull down menu Where there appear to be two instances of the separa tor the second has a space after it for example comma space v8 0 59 THE SURVEYOR USER MANUAL 60 4 3 7 SAME QUESTION NUMBER AS PREVIOUS Using the same quesiton number as the previous question is useful when say you want to show one version of a question to male respondents and another to female respondents You want the question number to be the same on the web page in both cases Clicking the check box acheives this Same Question Number as Previous Yes Same Matrix as Previous Yes Question Orientation Default Alignment Default Width Override Override Max Pictures Wide Figure 79 Same question number as previous 4 3 8 SAME MATRIX AS PREVIOUS If you have two different Choices lists that have th
66. wiederholen Sie alle Motieren meine E Mail Espa ol Informaci n s obre Administre as Denuevo ala pagina Informaci n de contacto Creel s bases de datos E mail las respuestas a Exporte lasrespuestas iMecesit a ayuda P gina principal de Cree las bases de datos Enumerelos Encuentre el Parado suprimiendo mis Ala pagina siguiente Pol jacute tica de Comience mi P gina principal de Ala p gina principal para Ada p gina seleccionada Por E mail envieme el E mail este aviso alos D emuestrea grupo Repase todas las Registre mis entradas Admin Buttons Other Language Password Figure 143 shows that text for up to five languages can be entered This is for future functionality but can be used for the moment as a useful Figure 143 Set Up gt Buttons text pane way to store your button text in several kanguages if that is useful to you v8 0 v8 0 THE SURVEYOR USER MANUAL 4 6 9 SET UP gt PASSWORD PANE This is a very simple pane to allow you to change the password for this instance of The Surveyor databases It s so simple that we ve only shown the top of the pane in Figure 144 Clicking the button will pop up two dialogues one for the main Surveyor database and one for the Field Choices database You should enter the same new password in both dialogues otherwise The Surveyor may have trouble relating your chosen Choices list names to the Choices lists in the
67. your questionnaire pages is constructed by Lasso each time a respondent requests the page It is built from the build ing blocks in the Includes folder in the following manner 1 html type declaration 2 inclusion of the Name lasso file to set the variables for this page s background colour image and the paths to the various files and fold ers used at the Questionnaires level 3 inclusion of the JavaStart lasso file to start the JavaScript code block in the web page 4 inclusion of the FooterButtonsJava lasso to insert the JavaScript that permits the buttons at the bottom of the page to change colour as the user moves his her mouse over the button 5 code for JavaScript that is specific to this web page s buttons 6 inclusion of the JavaEnd lasso file to insert the end of the JavaScript for this web page 7 inclusion of the Metas lasso file to insert the html meta tag instructions into the web page 8 reference to the cascading style sheet css file 9 the title information for this page the information that appears in the window header bar at the top of the browser window 10 inclusion of the PageBackground lasso file to insert the instructions for page background colour and image and the colour of the links of the page 11 the body code for this page the actual meat of this page 12 inclusion of the FooterButtons lasso file to insert the code for the buttons that appear at the bottom of every Questionna
68. your survey Company info Server Ancillary Files Web Page Format Question Format E Mail Admin Buttons Password Text Background IndexPage Text f Export confirm atlogoff No Back Button ves description of yoursurvey who shouldand should riot complete it etc Farthis sample questionnaire please read what follows to gebanidea of whatto expectinthe Sample questionnaire The Sample For The Web surveyis an example of aresearch f Resp Creation Text d Thank You Tex Thanks for completing this questionnaire We greatly tappreciate your help and patience lf vau have any comments or questions aboutthe questionnaire orthe survey as a whole please contact us Contact Page Text es Please feelfreeto eqnall us al lt script language javascript gt RES ar person Info varser idelicel VWarser sert com vartedname ourcontact emal address document wite lt a href mall to persori A ser 2 bextrame lt a i gt lelscantssensenmnk fn st coe danse dee rink hu small Export wes she Privacy Statement lt the Because we wantto demonstrate its commitment to aur users 146 privacy it has agree do disclose its information practices on its web site lt table width 100 cells pacing 0 cellpadding 0 gt lt tr gt zFd aliam afk salina s Figure 107 Set Up gt Ancillary Files pane Note the two pull down menues at the top right of the p
69. 13 59 41 200412 0BackupText lasso 867 12 20 2004 13 59 42 Next decide if you d like the export file s to have a tab or comma delimited format and whethre you would like any existing files with the Figure 171 Sample Admin export web page showing export set selection pop up names you ve provided to be overritten You can also decide if you d like to have the results of your Display field calculations exported to the exported file s Select from that menu to tell The Surveyor what you d like If you decide Yes these results will be exported to both the numerical and the text files In the case of the former if the result of your Lasso code for a particular record is numeric it will be exported to the numeric file If it is other than numeric that field of the export file will have nothing in it i e no data 124 v8 0 THE SURVEYOR USER MANUAL If you like you can send a copy of the export file you create to a single e mail address i e this e mailing is for one e mail address at a time The e mail is send in the clear i e it is not an encrypted If you need to encrypt the e mail you should independently send the file from the web server to the recipient Now click the Export button to perform the export Note that the list of files in the Exports folder is checked and updated each time your display this web page 4 7 3 16 EXPORTDATAREPLY LASSO When the exportis complete you will be presented with
70. 33 Background Color 88BBFF YLink Color anna Metas Ovemde Document Type Override Questionnaire Headers Face Futura Book Futura Bk Helvetica Arial Verdana Page Header Background Image CloudBanner gi nA dem z Color 333333 css Size 10pt Width 723 Height 84 Text Colour 333333 ES 3 Header Background ESEGES Page Header Background Colour ADCSFF Alignment Centre Show Percent Complete Yes Percent Complete Calc By Humber Page Header Override ATT Web Buttons M Admin Start New Requires Web Page Table Include Start Mew Button Yes Numberho Pass w ordHo EMail es r Question Table Width 90 pixels or of questionnaire page width ince nes Hun gs Border i Include Lasso Bulton Yes Cell Padding 4 Normal Large Cell Spacing 2 width 70 width 160 Height 22 Height 22 Questionnaire Inf o Questionnaires Tithe Sample Surveys CEE Questionnaire Name The Videlicet Sample Giuestionriaire i oli h Copyright zi Questionnaire Name Abbreviation Sample no spaces Copyright TrevorH Jacques Questionnaire Name Prose the Videlicet sample questionnaire Copyright Date 2002 2005 Questionnaire Name Prose Short Sample Questionnaire Questionnaire Division F Web Page Footer Last Actual Questionnaire Page 5 Footer Links No Page Footer Override Record of 98 records found from total of 98 records There are 10 es ih your SURE Figure 108 Set Up gt Web Page Format pane 4 6 4 1 WEB P
71. 5 Example e mail confirmation e mail Sending e mail messages to every respondent with an e mail address is a handy way to make broad announcements to your respondents It is often used as a way to remind people who have agreed to take part in your research to start complete their questionnaire There is how ever one real world problem with sending to such a broad list of recipients If you ve just added a respondent within the past day or so that respondent would also receive the reminder This can appear to the recently added respondents as though you are nagging them To help mitigate this effect we ve provided a date entry so that you will only e mail those people who were last e mail before the date you spec ify here Hence recently added or e mailed respondents will not get a rapid succession of e mails from your questionnaire administrator v8 0 THE SURVEYOR USER MANUAL The next three fields are the usual Subject Copy and Body items of the e mail you want to send You might find it useful to store the text of the body of say a reminder message somewhere accessible on your computer so that you can copy and paste the text each time a reminder is sent thereby saving time Any e mail address in the Copy To field changes the BCC from the default questionnaire administrator e mail address to the address you enter on the web page The final field is a pop up menu that tells The Surveyor whether each of the chosen respondents
72. 6 6 3 Textua E NMaUbDPOROAECDOC sian Swed ado ele e EL asa Vr ae dts 94 4 6 6 3 body Text for Administrator E Mail corria Eve Pale e 95 40 7 Bet AMP ANS oet donatae e iy s dr ee iti eae ded 95 AOS SEL Dp C Buttons Pane oteend b Xue end d rone atte 99 ALO Set UD gt Las Word Pane si oo Ee bre ERES tou debet Mes 101 16 00 Set UD Imbort Lado sise ns Ee Sp e Quo une abr fud ee 101 a MPH EP 102 dul Export Espor o Pane as Rodeo te ER UIS Es AAA 102 4 7 1 1 Px port Indes Dil episodio 104 d Be MS Export l der ASS ss ete ety Netto Gn ae awake oe mis etd ae 105 duo eX DOLE FAC Der iS Lane euo pdt id actos nn cult ceni deo oer d 106 HSM Export pases les PA OS a tons c op debo hu NAS depu deoa 107 4 7 3 1 Pto cd B Pcr TC uh a E NT 108 4 7 3 2 Admin EMN otcelassO a da ae ow eet e d ed 109 4 7 3 3 Ado EMAINOriee Rep plas Cu oorr tou oerte is 111 4 7 3 4 AdminImportQuestionnaires lasso dada radios 111 4 7 3 5 ANS IA A send ach a hd ree S Pede ets 113 4 7 3 6 Aka MyS LReplylAssO pistas Deos base E ETRE E pua due d 114 4 7 3 6 1 Questionnaire Tasso LISOES corsarios patentes 115 4 7 3 6 2 CQuestioa atre Lasso GOTOUDS msi 116 4 7 3 7 NAS e o A A een 116 4 7 3 8 AdminsarvevGreation Reply 4880 4 ioa veu dada e aa 118 4 7 3 9 AdminUploadQuestionnaires lasso 52209 opa ace cosa tante 119 200427107 COMPACE ASSO Loo nao ick od a etek ae eot d tet NN DEA 120 Zl JTMDSent teil Js di Pho dae Aa ee Skee eee ba ex 120
73. 74 From SampleRYidelicet com Subject Export files 2864121BBackup lasso and 26641216BackupText lassa from the Videlicet sample questionnaire questionnaires Here are the files with the data for the questionnaires z004121 Backup lasso z0041210BackupText lassn Figure 173 Sample help web page Note in the reply web pages that the Export button between the Back and E Mail buttons simply takes the browser back to the initial export page in the same manner as the Export button in the footer button tow The file list is updated after the export and each e mail 1s performed and so 1s always a current list of files in the Export folder at that time revor Videlicet com sort Survey E E 1 A LE f tasso iz Cren t n nar i nn rw a y mi Expor ln a Of Figure 174 Sample Admin export confirmation web page 126 v8 0 v8 0 THE SURVEYOR USER MANUAL 4 7 3 17 HELP LASSO If you d like to provide a help web page to your respondents you enter the body text of that page in the Set Up gt Ancillary Files pane of The Surveyor and it is stored in the Help lasso file for when the respondent clicks the Help button at the bottom of the web page assum ing that you did not use The Surveyor to exclude that page button Figure 175 Sample help web page You can insert any text and simple html in this page so that it formats the way you d like it The example shown in Figure 175 is
74. 8 0 v8 0 THE SURVEYOR USER MANUAL 2 3 WEB SERVER The web server computer may be separate from the database server computer although there is no requirement for this Any computer web serv er software combination that can run the Lasso Web Data engine is acceptable for this function The server software and operating system should be configured by the system administrator to minimise potential for unauthorised entry Web Respondent Desktop Computer CRE DMZ Firewall ee E Im M Local Network A A DB Server Web Server Development Figure 21 Developing questionnaires Where necessary the web server computer may have to be put in a network De Militarised Zone DMZ When this is the case and where possible the database server computer should be placed inside the DMZ on the same network subnet or one very close to the subnet of the web server com puter since these two computers exchange data and communications very frequently and the time lag between the two computers may have an effect the snappiness of the web server as questionnaire pages are served You should discuss your network and server configuration s with your net work administrator before deploying your questionnaire 3 0 TAILORING TO YOUR NEEDS This section assumes that you have a basic understanding of html web page design and the Lasso database and web page tags programming and where relevant SPSS In this section you will see
75. 8iJjbKkLMm4MnoCcDcDu Y d8SCcDd8EeP cDeFf GgHhbid SKkLMm4NnoP pBmd4Nn8Eev9vesgxxavv Zz amp aBbSCcDd8EeFf 7GgHhBiJiSKkLMm4NnoP p3G qRr2 SsTt iUv9WwX2f GoPp3XxxeYGqRrHBiJ iSKkLMmd4NnoCc 6521957935856654897 156988328791256493812235 8465459658596489964897 198 1569956985964328 12 348584654596489718971265523846544 7179125649 5 minutes 10 minutes SPSS Yes Figure 9 Set Up gt Server pane when creating your questionnaire Check with your Lasso administrator We recommend that before exporting your pages from The Surveyor you quit The Surveyor and make a back up of your Surveyor databases This will protect your data should your computer lose power or there is another problem with your computer during the export allowing your computer to damage your Surveyor files When you have changed the path in The Surveyor and if necessary changed the MySQL Host and Connector numbers go to the Export pane of The Surveyor using the Export tab and click the button to export All Survey Web Pages Figure 10 Wait until the export is complete Do not force quit The Surveyor during this process because there is a small risk that your questionnaire devel opment database could become corrupted If you believe there is a risk that you might lose power to your computer during the export process quit The Surveyor and make a copy of both the Surveyor AS3 and the Surveyor Field Choices AS3 files before you initiate the export process No matter y
76. AGE SETTINGS As you look at the figures of web pages in this manual you ll notice that each page has a background texture to it This is provided by the Background Image The image is assumed to be in the Images folder of your questionnaire web folder hierarchy If you leave the file name 19 THE SURVEYOR USER MANUAL 80 blank then The Surveyor assumes that the Page Background Colour is what you want as the background for the entire web page The colour is set using the usual hexadecimal notation for colour used by html You set the link colours in the three fields to the right of this part of the pane The questionnaire page width settting is in percent of the browser s window and specifies that you d like your questionnaire width to be x of the window width You can think of it as the question naire being a piece of paper covering the desk of the browser window Using 90 in this case provides for a 5 wide peek at the page background image to the right and to the left of the questionnaire main html table Figure 107 shows this well Web Page Inf Background Image Name StipedBack ground gif Page Background Color FFFFFF RRGGB EB Link Color 000066 Questionnaire Page Width 3085 ALink Color 000033 Link Color ABBESS Metas Override Document Type Override Page Header Background Image CloudBanner gif Width 723 Height 84 Text Colour 353353 Page Header Background Colour ADCSFF Show Percent Complete Yes Percent Com
77. ALUE For textual responses above you can choose from the two question response orientations according to your needs The Matrix Value field type provides the same formatting but the column headings are the numerical values so they take up less space A legend is pro vided at the beginning of the question so that the respondent knows which value represents which response Putting the legend for the possible responses at the top of the question however can use a lot of horizontal space particularly when you have a large number of possible responses in your Likert scale Hence we decided to provide two formats that correspond to the Matrix Text format but also two more that put the data value number immediately next to the radio button since the numbers do not take up vast amounts of horizontal space and add nothing to the height of the row of buttons Any add on responses N A Decline etc that you want to include are included with textual labels to differentiate them from the Likert scale itself and are separated by a lit tle extra space to provide a visual break between your Likert responses and those that have a non Likert meaning 47 THE SURVEYOR USER MANUAL e Do you like apples Required Please answer using the followin gscale Always 1 Mostly 2 Frequently 3 Uncertain neutral 4 Sometimes 5 Rarely 6 Never 7 N A B Decline 9 F 8 9 pF F7 e 1 2 3 E e fe amp Le E Lu i g
78. BEHR Do you like strawberries Extra Sort Field 4 TotalWorkload Override Question Total Workload TOTO REL Please estimate the percent of your work time you spend an Extra Sort Field 5 NumberOfMothersc Override Question Number of Mothers Children MTHCHRPIaA To how many children did your BIOLOGICAL mother give Figure 139 Setting up sort fields The last part of the Administer QuestionnaireData web page allows the questionnaire administrator to specify how many records are to be returned to the subsequent list pages at a time which field to use to sort them and whether they are to be in ascending or descending order The Surveyor provides for 5 10 20 or 50 records per list page These numbers are fixed unless you decide to manually edit the web page html after the export from The Surveyor The sort pop up menu however can be changed from its default of the fields upon which you ve decid ed to allow a search to those fields please any five others that you enter Figure 139 shows how you would add these extra sort fields to the web page pop up menu It functions much the same as in the Figure 138 part of the pane except that the Overrides become lines in the web page pop up menu Hence again you should aim for short concise labels here Figure 140 shows the results of a search made by the questionnaire administrator Note the link button on the left of the information for each ques tionnaire This link allows the administrator to
79. Body Text for Admin Create E Mail Figure 135 Default e mail body text 4 6 7 SET UP gt ADMIN PANE The Set Up gt Admin pane allows you to tailor the contents of the Administer Questionnaire Data and List Records web pages The settings in Figure 136 produce the two pages in Figures 137 and 140 The first thing you should do before creating the pages is to click the Update Fields List button This button reviews all of the questionnaire records you have created and produces a list of the eligible fields for the two web pages in Figures 137 and 140 The reason that this is done 95 THE SURVEYOR USER MANUAL 96 here is that for large questionnaires this can take several seconds which would slow down the user interface of The Surveyor if it were done every time you changed a Field Name Once this is done the pop up menues in this pane will show you the correct field names and the text associated with their questions The Override Intro Text field allows you to replace the text Alternatively you can retrieve a list of records using the survey questions and list button below in the Questionnaire Review page in Figure 137 with any text you d like Note that the first html form on this web page will remain the same no matter what is done in the Set Up gt Admin pane of The Surveyor ee Of Company Info Semen tela Ovemde Intro Text Question Field 1 FirstName First ame Question Field 2 LastName
80. CUPA Server PANNE Sr Sen aide nait bit io code Ciara 70 4 6 2 1 Data Collection Database amp Tables 70 4 6 2 2 DELVED OCU Dira neha lc Each DP EAE qb spears bemyio eens T2 4 6 2 3 Lasso Site Host Connector amp Respondent IDs 74 4 6 2 4 Seenaa A UD Pm 75 4 6 2 5 ERMA STIS VOOM anata culus anu dfc An Ah Mand acit at uates ON 76 40 5 Set Up anclar Miles Panes euo east ERES Gada rata rede ide ds TI 404 Setup Web Page Fotmat Pane ita ds T9 4 6 4 1 We BPO EOS a io is da de 79 4 6 4 2 Web rade Table Settnos axe r api ee ditate Su E ue bae ede 81 4 6 4 5 Questionnaire Division Page number astros ir EPA 82 4 6 4 4 Questionmare Body Settines viet av Reed as anb Rp EA es 82 4 6 2 8 Web Page Footer Setines suo Lente ee hae PERCHE dote deu 83 405 Seb Question Format Pane 42229 1e Sese Rete ete en o4 4 6 5 1 Question Forman s esetteadt eov epe me ERI EA EHE ERR VD 85 4 6 5 2 Response Formalno iore ones ettet esee EEDEN 80 4 6 5 3 Related tecor SEPARAS 5 deus Bs a dead b tenia ie oa ed 87 4 6 5 4 Pop UP o in ene al has pe ela Voici voor toc a ease ded at 89 4 6 5 5 Additional Choices for Choices Lists 89 4 7 4 6 5 6 Default Menu Label uud kite ees oad el has Ge eee ERG 90 AOG Set Up E Mal Pane siens tes acreditada dental 90 4 6 6 1 EV SMTP Server torna Odin 91 4 6 6 2 Textual E Mail Subject Introduction and Exit Text 92 4
81. Day Month and Year Sometimes you ll want to include the label for each element of the response sometimes not The penultimate field in this part of the pane allows you to specify whether to include the labels in the body of the e mail The final field in this part of the pane lets you specify whether to include the extra responses provided to the respondents as part of the body text 4 6 6 3 BODY TEXT FOR ADMINISTRATOR E MAIL The questionnaire administrator can send e mail with any body text using the E Mail web page of the Admin area of your questionnaire Generally however e mail is most often send from the questionnaire web pages to announce to the respondent to announce that his her questionnaire is ready for completion Rather than have the questionnaire administrator recreate this body text every time an e mail is sent we assume that the text for the introduction to the questionnaire will likely be the same for most of the e mails sent whether at the time of questionnaire number import or at the time a single or multiple e mail is sent By typing your default text in the field shown in Figure 135 the questionnaire administrator will not have to recreate it or search for a version of it to cut and paste into the body field each time since The Surveyor will include it by default in the Body text section of the Admin area web pages It can be deleted or modified at will on the web page before the e mail s is are sent Default
82. ED answer to the previous question is Male this question must have an answer so 3 Some college credit but less than 1 year that you can proceed to the next page 4 1 or more years college no degree FormalEducation FRMLEDU 5 Associate degree for example AA AS Menu E Bachelors degree for example BA AB BS 7 ree for p MA MS MEng M Ed MSW MBA 8 Pi toasional degree or example DDS DM LLB JD P ones degree for example MD PhD dD Figure 150 Summary Survey RTF file seen in Microsoft Word The second column contains the question text the field names associated with the question the field type for the web presentation of the responses whether the response is required ands the width of the textual response fields The maximum and minimum value test for the response is also shown as a sentence in this column Not shown is that jumping page information and the page headers The latter are formatted in bold in a manner that helps distinguish them from the rest of the text on the page Wach page is highlighted with a grey background to its page number to make it easy to see the web page breaks in the Word document The third column shows the possible responses when Choice lists are chosen for a question The value of each choice is shown in italics before the textual information for the choice presented to the respondent We can add more information to the RTF file as customers requ
83. Height pixels Other Subquestion Humber Postpend PT ER Responses Defaull Menu Label Related Record Hdr Ear Colour Text Face Palatino Times Times Roman Times New Roman n 33FF Height 1 pixels Record 3 of 98 records found from total of 98 records Thete are 10 Pages in your Survey Color 333333 ess Size 10pt Background Colour 1 DDEBFF Background Colour 2 DOESFF Matrix Value Format Plain Max Pictures Wide 3 SavelDelate Alignment Centre Related R ec ord Pick Here Text Pick Here Figure 119 Set Up gt Question Format pane v8 0 THE SURVEYOR USER MANUAL 4 6 5 1 QUESTION FORMATTING Question formatting has three basic areas look and feel numbering and subquestion numbering Working our way down this part of the pane we start with the minimum width of the page that a question with left right orientation should use This is expressed as x percent and implies that the response part will occupy 100 x The next three fields are for the font attributes We recommend specifying several fonts so that you can ensure that the questionnaire looks the way you want it Since this information goes into the Style css file generated by The Surveyor it s something easily changed here or later on the web server Good choices for cross platform fonts are Helvetica Arial and Ver dana for sans serif fonts and Palatino Times and TimesNewRoman or TimesRoman for serf fonts Most computers will have versions of
84. IOLOGICAL mother give Button Width Button Height Heading 1 Heading 2 Heading 3 Heading 4 Heading 5 Record 15 of 15 records found fom total of 99 records There are 10 pages in your SURE First Marne Please enter your first name here Last Mame Please enter your Famil name here Gender What is your gender Children Do you have any children This questionis used to Marital Status From this list please pick the one closest to our current Ovemde Format Override Format Override Format Overmide Format Cverride Format Field Field Mert Radio Menu Picture Radia Radio Figure 136 Set Up gt Admin pane In the first full row of this pane see Figure 138 you enter the Field Name and the calculated Export Field Name will be displayed immedi ately below it N b Field and Checkbox field types will display the Field Name here because they have text responses not numerical ones v8 0 v8 0 THE SURVEYOR USER MANUAL Note that you can choose Other from the Question Field Extra Sort Field and List Field see Figures 138 139 and 140 pop up menues on the left of the Set Up gt Admin pane so that you can type in one of the special field names used by The Surveyor itself These fields are named ID UserNumber UserPassword PagesCompleted ReturnToPage CreationDate Creation Time and ModificationDate Make sure that you spell the name correctly or you may get error message
85. If the current field is not empty then it must choices List zero to Nine Default Yalue the value of field 0 0 1 1 2 23 3 4 4 5 5 6 6 7 7 8 g on this page E Mail of Results Exclude Record Fxclude Menu Label f Omit From Web Page If orra previous web survey page field Exclude Header Text field MC gt icd od i Pop Up Results Button Yas then omit this field from the web survey page Context Sensitive Help Text Extra JavaScript Tests SPSS Partially Maybe Uncertain Data Type Format AGE Precision GO es amp Nd OYes SNo OYes ONG r DNK NIA Decline Other Jump To Page OYes amp Ng OYes amp Nd OYes ONd OYes amp Ng Field name Operator Comparison Yalue Field name Operator Comparison Yalue Jump to Page Number IF GOTO OR End Field name Operator Comparison Yalue Field name Operator Comparison Yalue Jump to Page Number ELSE IP GOTO OR DEnd Field name Operator Comparison Yalue Field name Operator Comparison Yalue Jump te Page Number ELSE IF GOTO OR End Jump to Page Number ELSE GOTO OR DEnd Record 5 of 98 records found from total of 98 records There are 10 pages in your survey Figure 19 Detail pane Each question in a paper survey instrument is represented by one or more records in the main Surveyor database For example What is your first name would translate to only one field in the data collection database bu
86. LDER The Questionnaires level Images folder provides a single common location for all the images used at the Questionnaires level All the Ques tionnaires web page buttons and other images should be stored here so that they can be found easily and so that html references to the images have a standardised path thereby making coding much easier Figure 24 shows some of examples of the images 25 THE SURVEYOR USER MANUAL 26 Back button Back button Upload button cursor elsewhere cursor over button cursor over button Figure 24 Web page button examples It is recommended that only image files be stored in this folder Figure 24 shows how the colour change of a button is made to happen as the browser s mouse is moved over the image 1 e how the mouse will make the word Back appear to light up from black to blue as the mouse passes over the web button This same highlighting allpies to all buttons in your questionnaire 3 1 1 5 QUESTIONNAIRE FOLDERS If you have not already read Section 3 1 1 to this point you should do so before you inspect the contents of the files in the folders of spe cific questionnaires Each questionnaire exported from The Surveyor should have its own folder and the structure of that folder should be the same as shown in this section This helps keep everything related to a particular questionnaire in a single place thereby making operations such as backup and archiving much easier 3 1 1 5 1 QUE
87. List of MySQL tables and table detail in Lasso Admin 154 Figure A 6 List of MySQL tables and table detail using JDBC in Lasso Admin 155 xiii XIV v8 0 THE SURVEYOR USER MANUAL 1 0 INTRODUCTION Welcome to The Surveyor The Surveyor is the complete World Wide Web based data collection system for surveys questionnaires and polls for a Lasso based server for information about Lasso please see the OmniPilot com web site You can use this versatile tool to create simple one to two page surveys right up to complex multi page questionnaires with multiple skip patterns and other features The data collected by the web pages that The Surveyor creates can be exported for use directly by statistical analysis programmes such as SPSS The template provided with The Surveyor helps users to quickly and easily get new questionnaires up and running with the minimum of effort 1 1 COMPONENTS The Surveyor comprises these basic components e two FileMaker databases and their associated runtime engine files for Mac OS and Windows one to design the survey instrument in the form of survey web pages and one to hold your possible end user choices in response to specific multiple choice questions e a series of example hypertext mark up language html files collected in the Pages and Includes folders a series of example JavaScript language files in the Pages folder example questionnaire data and cascadin
88. Menu fields Figure 56 for the Age question produces two pull down menus on the web page rather than two questions each of which would have been in a separate question response Each of the pull down menus is set to a specific list of possible responses in this case the numerals 0 to 9 and this ensures that only one of these can be selected by the respondent This avoids free form text entry that might include spaces dashes and other spurious characters that would have to be cleaned up by the investigators after data collection is complete You should carefully consider whether using a text field or a text box is appropriate for v8 0 49 THE SURVEYOR USER MANUAL each question since cleaning up dirty data of this kind after collection is a very very tedious and time consuming job You Can cre ate a Display field to display the concatenated age You could easily do the same for dates social security numbers etc From version 7 1 3 and above The Surveyor can export Display field types 4 2 1 11 8 PICTURE FIELD TYPE When you want your respondents to choose from a number of pictures use this field type The name of the picture is entered in the Field Choices database of The Surveyor as is its location You can also set the maximum number of pictures in each row on the brows er page which can be useful if you have particularly large or small images The Surveyor does not resize your images but it does provide with an
89. Metis Inuit Australian aboriginal etc English U K Figure 199 Sample of textual summary of responses written to file Note how all of the headers on the page have not been excluded from the summary text that the Menu labels for the age decade and year have been included and that the last two questions have the text of the response rather than the number that is stored in the MySQL data base Hence you have the best of both worlds numerical data for analysis and textual data for review or inclusion in your reports 4 7 3 13 WRITEQUESTIONNAIREREPLY TXT When the questionnaire administrator has clicked the button on the WriteQuestionnaire lasso page the subsequent page is WriteQuestion naireReply lasso Figure 200 This page calls WriteQuestionnaire txt to create the summary file and then presents the adminstrator with information about the various stages of the file creation useful for debugging a form to send the file to another email address and a refreshed list of files in the Summaries folder to further confirm that the file has been written correctly The Write button lets the admin istrator go back to the WriteQuestionnaire lasso page to write the responses to another file 144 v8 0 THE SURVEYOR USER MANUAL o Info Videlicet com Figure 200 Sample Write Summary Text File confirmation web page 4 7 4 EXPORT gt INCLUDES PANE The Includes folder shown in Figure 201 contains files tha
90. Name lasso file include paths to Questionnaires level and individual questionnaire level folder s Questionnaires level background colours images and default button sizes Inspection of the contents of this file will be a use ful exercise for anyone planning to change the look and feel of the Questionnaires level web pages 3 1 1 3 7 QUESTIONNAIRES PAGEBACKGROUND LASSO Contains the html BODY statement for all the Questionnaires level pages This help ensure that all of the Questionnaires level pages have the same look and feel because they have the same background image or colour and the same text and html link colours Some of this colour information may be overridden by the information in the MyDomain com Includes Style css file 3 1 1 3 8 QUESTIONNAIRES PAGEFOOTER LASSO A small file that provides the means to put information at the very bottom of the Questionnaires level pages Currently it is used to put in a copyright statement that is visible to the respondent at the bottom of each Questionnaires level lasso page 3 1 1 3 9 QUESTIONNAIRES PAGEHEADER LASSO The header layout for each Questionnaires level lasso page is defined in this file Normally it would contain say an html CENTER statement followed by a table with an image or text possibly with links on the image or text and a close of the CENTER statement use of this included file ensures that the top of every Surveys level page is the same 3 1 1 4 QUESTIONNAIRES IMAGES FO
91. O CODE If you have decided that you d like to display the result of a Lasso calculation usually based upon ddata in the database you enter the Lasso code for it here For full details on Lasso syntax please see the documentation for Lasso at OmniPilot com 4 3 16 CHOICES LIST Default Value Figure 81 Choosing a list of choices This part of the Detail pane lets you choose a Choice list to associate with the current question It also provides a pop up list that will show you the values in your selected Choices list to set a default value for this field when the web page is first shown to the respondent You choose the text of the response and immediatly to the right of the selection you will be shown the numerical equivalent of that choice based upon the information in the selected Choices list Note that you cannot set the extra options as defaults The lower line in the choices part of the Detail pane shows you the choices and their numerical equivalents so that you can get a quick look at the Choices The Choices List button is blue to indicate that it will take you to the Field Choices database for that Choice list when you click it 61 THE SURVEYOR USER MANUAL 62 4 3 17 EXCLUSION FROM E MAIL RESULTS When the server sends a text copy of the questions and responses to a respondent you can exclude questions and page headers on a per ques tion header basis If your questionnaire assumes a defaul
92. OME EE LES 16 sTtx8YyZ IUU Yv9EVIKLME dBeC EwyZzAaBb9CcD dB E eFf Default MySQL Number Precision 8 TGgHh6iJjiSKAaBbSCeFf7Ggt 1Uu2SsmdNnoP p3G qRr2 SsTTE Wu VkLHm4dNGg Vv Ww oPp3QqRbSCcDdK aB Server Information bSCeFfnx8vYyzZaBb9FE7 GgHhbiJ ibKkLHhBiJ S KKLTE TUu VkLMm4Nnx8YyZaBb9Ff 7zAhiJ SK eFf TG aHhG gHz Ah6i JiSKeFf7GgHhBiJ SKkLMm4NnoCcDcDuY d89CcDd8EeP cDeFf GgHhbiJj5 KkLMm4NnoP pBm4Nn8Eev9 Vx xev v j Zz amp aBbSCcDd8EeFE 7 GgHhbiJj5 KkLMmd4MNnoP p3G qRr2 Uieieive te fami For DI net inriude RARE SsTLIUvSWXzf 2Go P p 3Xx8YO qRrHBIJ SKkLMm4NnoCc r Seed Numeric 6521957935856654897156988328791256493812235 Questionnaire Home Folder Path Samples Sample fill this box With 54654596585964899648971981569856985964326 12 Questionnaire Pages Folder Path ISamplesiSample Pages random numerals 3485846545964897189712855238455447179125643 Questionnaire Images Folder Path Samples Sample lmages Questionnaire Includes Folder Path Samples Samplelincludes Questionnaire Imports Folder Path SamplesiSamplellmports Questionnaire Exports Folder Path Samples Sample Exports Questionr Summaries Folder Path Samples Sample Summaries Domain Yidelicet com Questionnaires Home Folder Path Samples Timeout for Admin 5 minutes Respondent Timeout 10 minutes f Lasso c Analysis SitelD 1 For Lasso 8 Usually 1 Analysis Tool SPSS DataSourcelConnector ID 4 LassoMySGL 1 MySQL usually 4 Export Display Fields Yes
93. OPUP LASSO Foir each of your numeric reponse questions i e matrix menu picture select radio button formats you can provide the results in a pop up window This can be provided to the respondents only the administroators only or both The text Click here button for results 1s appended to the question text where button is the small graphic button you d like to use as the button figure 185 New Brunswick H Figure 185 Button to pop up question results When the button is clicked The Surveyor code pops up the results window as shown in Figure 186 The text of the question that was asked of the respondents is at the top of the results followed by the results themselves in tabular format The labels are taken from the choices list associated with the question including the optional extra responses such as Decline N A etc and the bar widths and percentages are calculated on the fly each time the page is displayed so your results are always the most up to date possible v8 0 THE SURVEYOR USER MANUAL The Surveyor uses three alternating colours for the bars If you prefer to use other images for the bars simply replace the images Fade BarRed gif FadeBarGreen gif and FadeBarBlue gif in the Images folder with your own images If you do not want differing colours simply use the same image for each of the three files At the bottom of the results window The Surveyor notes the number of respon
94. ReviewPageSelection lasso eva cb br RR EE e Ee bd re eee 140 Ada utverleviewbpddte3sSO qs dedu S bati do E d wea ole tro dot udo bu 141 4 04950 OUVERT NAN You AAA oed deett dca dee o eg dtc o ad 141 AT 2 MUtlte QUestiODalre lasso si dt Mene tec SEI er ed SACRO 142 Ao M tite OUCStO nale Ot LIL Ti Teener uerb ipu requises ss 143 4945 WiteOuestonnalteleplwtXxE ae ans ratas rbd va iris eee 144 BExpott Ineludes Pane gt order an 145 4 7 4 1 Admito TASSO usant din nac d UR den pd Ps ERE ode none dob 145 4 7 4 2 AA My S LRep ly lm port ASSO nn msn outed cette ae yes 146 4 7 4 3 amin Ny SOLREDI SCPE aS O wack a5 ed oth acest aci ade te AR aco tt 146 4 7 4 4 EootetbuttonslassOnas ui bun dada adan boos et Dur aos ees 147 4 7 4 5 JavabeetildS SO eu rea RME ete era dul ede iota ad ftt 147 4 7 4 6 Javabindlassec deve A up as Bee aoe ae 147 4 7 4 7 Metals lso edad ici 147 4 7 4 8 MySQEERMIA eds lass ti SEA E E E A 147 4 7 4 9 MySQL Parenthtelds 14880 ca ui tnd AR UE 147 AO Name las ria ES A AAA A eee 147 Aled PaceDackeround ASS ee oen A aaa 147 AXIS APCE OOter lassol Sacred ein ora A 148 LAS Page ooter inks ASSO 410i dues os Ries A ween eas 148 Adela Ser ver sponse CHERS ass Dinars ais eir Po ri dent C Pn 148 dd 15 M SRI ESS ouod teh dt des ox Pep debat abdo Une erp edad ii ed ust totae e St 148 ATOS asutveyLicaderbesinla880 tus dede a OE dto ete 148 Avail SuryveyileaderEnd lassO 455599 i cd p DR LO eee AA 148 ARTS ES o2 waned ele ah
95. STIONNAIRE INDEX LASSO Figure 25 Sample questionnaire level home web page browser with JavaScript v8 0 THE SURVEYOR USER MANUAL This is the home page for your questionnaire This page is constructed by Lasso each time a respondent user requests the page It is built from building blocks from the individual Questionnaire level Includes folder in the same manner as the Index lasso file at the Questionnaires level This file is designed to skip to the Index html file if cookies have not been implemented in the respondent s browser or if this is the first visit to the questionnaire When the referring page is Index html or the presence of cookies is shown in the respondent s browser this page introduces the respondent to the questionnaire The body text of this page is included by The Surveyor from information you provide in the Set Up gt Ancillary pane The standard page header and footer building blocks are inserted to provide a complete page 3 1 1 5 2 QUESTIONNAIRE INDEX HTML This page tests whether the respondent s browser has JavaScript active If it does the browser is pointed to Index lasso The latter sets a cookie that is subsequently used to test if cookies are enabled in the browser When both cookies and JavaScript have been shown to be enabled respondents can proceed to the questionnaire pages If JavaScript is not enabled this page tells the respondent to enable JavaScript to proceed to the questionnaire
96. Slider Fields Skip Pattems and Minus Fifty To Plus Fifty Monogamous Relationship Duration 2 2 HeaderT ext 6 Two af the fields on this page arerequired One Month Test 2 5 Myers Briggs 1 MYERSBRG 6 Nhat is yourMyers Briggs or Keirsevy Myers Briggs HMumber hours 2 4 HeaderText 6 I thecheckboxforthenext response contains ND SCC nildren 2 5 HeaderT ext a We ve mixed upthe questioniresponse Hurnber Of Children 4 Home 2 amp EmplaverCategary EMPRCAT 6 Choaosethe categorythat best describes your Radio delos e A 2 EmplovercCategoryOLther EMPRCATO a lou chose Otherforthe category of your Field NES T 2 8 QOccupalionaliat egor OCCUPEAT e Pleaseindicatethe occupational categarythat Menu Occupational Category 2 9 StaffPartTime STAFPTTM 6 How many percent of yourstaffare parttime Slider d in Increments of Five 2 10 HeaderT ext e If vau answered Female on the previous page Period Medical Problem 2 11 Adopted ADOPTED a Were you adopted Radio Profit type Race 2 6 2 e 2 e 2 e cn JumpT aPagelf H i Hx of Sex Offences HA Lived With Bia Parents RAG Marital History RAG Number of Previous Convictions RAG FP hallom etry RAG School RAG Sex of Victim RAG Victim Injury Figure 69 Choices lists pop up menu a Do you like strawberries Click here O for results Yes very much so Yes sort of Uncertain neutral No not really Definitely not O O e O O Figure 70 Sample questionnaire w
97. T US BUTTON The code for this button calls an image for the Surveys level About Us page button on the browser page provides JavaScript to make the button change to a different colour when the user moves the mouse over the button and provides a link to the surveys level home page This button is not shown if the page being displayed is the Surveys level About Us page 3 1 1 3 1 5 QUESTIONNAIRES CONTACT US BUTTON The code for this button calls an image for the Surveys level Contact Us page button on the browser page provides JavaScript to make the button change to different colour when the user moves the mouse over the button and provides link to the surveys level home page This button is not shown if the page being displayed is the Surveys level Contact Us page 3 1 1 3 2 QUESTIONNAIRES JAVAEND LASSO This file contains the unchanging code at the end of the JavaScript at the beginning of the Questionnaires pages which require JavaScript almost all pages It closes off JavaScript statements that are assumed to have been written in the body of the calling file provides the code for some JavaScript functions and provides the html lt endscript gt to terminate that part of the JavaScript for the calling file This file should not be included in the calling file if the Questionnaires level JavaBegin lasso is not also included 3 1 1 3 3 QUESTIONNAIRES JAVASTART LASSO This file contains the unchanging code at the start of the JavaScript at
98. Tags Groups Users List Hosts Databases Tables Files Tags Search Groups Listing Any User Group Any User Name Status Links 1 Survey SampleAdmin Enabled List Users 2 Survey SampleRespondent Enabled List Users 3 SurveySBClIntakeAdmin Enabled List Users 4 SurveySBClIntakeRespondent Enabled List Users Showing 4 groups out of 4 i __Add Group Logout Figure 161 Sample web page for creation of individual questionnaire Since the names of the Lasso groups for each questionnaire are not used during questionnaire adminstration there is no need for us to provide the flexibility of group names as we do for the user names 4 7 3 7 ADMINSURVEYCREATION LASSO Your questionnaire administrator can create new respondent records in the data collection database using the Create Questionnaire web page shown in Figure 162 The first three fields are included in this web page if you specify in the Set Up gt Web Page Format pane If either of the first two fields is not on the web page for use by the questionnaire administrator The Surveyor will create a random value for you If no e mail field is specified for this web page either in the Web Page Format pane or by the questionnaire adminstrator the e mail address for the new respondent will be left empty v8 0 v8 0 THE SURVEYOR USER MANUAL Create Questionnaire QUESTIONNAIRE INFORMATION Please type in the questionnaire number use only alphanumeric characters Le a z AZ and 0
99. a OMIS aran oer Spes et En ned RESCUE MAIS EE LE 60 2052 OME SHOU TEX tocca dcus as antea Oras ded Le deris amp dria dia edad 60 2 9 L9 Response UD DG ced ats bun bendi e doh dhe ah ine e e Ee Geek ond de iade d qui 61 49 14 Response Width amp Herit soie eoe bp TER o otto ata ded 61 111 iv 4 4 4 5 4 6 4315 Display Med Lasso Code au eio ode sstsirsses o oco E I e dy dol 61 RS 15 COCA EE a6 di ade tie ae sedate Hob a dem oe a Aree eat eo vd Std 61 43 17 EXxClUSIOn from E Mail Resaltar ao CC ET RUE PC bend 62 d ouo TOSS Or lel aie Arana O A dente d debout Mad acutior trat atico ted ats 62 4 3 19 SPSS Data Type Format amp Precision oed zie ed Vea E Seb eben se edens t 62 2 5 20 Ela Toor maton iaa Ate a ode a B obs ado t o cca ctos o doe Wh has 62 doo Da CCC MN Oe i eU bb eos doloe dc D ona d aera eat aa s 63 AO ONE mit CDeele cesa Se wa BS dor e dealer aa acea 63 del BPE Lest ALA Cie del en daa abi gu ioa a Mees 63 Ales NOE BP RSS SLR e TA boe dit uc Sa esrb 64 dul COMPA On ESE iaa as ORPHEO TA SERE EH 64 dolo Opti Trond Web Paces ela ea reise rni etta e bebidas 64 43 240 Extra Javaseupt A dnt eee eed aed oe eet PR 65 522 PACA To CHOC eS ema code ee eh ibt re EL hee She SE ee 65 AO 25 Jump Lo Page Skippinge DAC ett du ue me deeds de or we 66 AMES ea cree ii ee S De do io er ee ecd 66 JU UPS suos Laut debe Sd ed acca 67 viridi Er 69 ao Sera a Company Pane visos Dobson bod bein o x creed 70 A02 O
100. a manner similar to the question the field format of the chosen question is shown and can also be overriden on the administration web page In the case of the first row a Field type is appropriate for the adminstrator so nothing was entered in the override field In rows three to five however we have overriden the field type to produce the format shown in Figure 138 98 Question Field 1 FirstName Override Question FirstName Override Format FirstName List 1 Please enter your first name here Field Question Field 2 LastName Override Question Last Name Override Format LastName List 2 Please enter your Family name here Field Question Field 3 senderMow Override Question Gender Override Format Menu CENDERN YY List 3 Gender What is your gender 1 Mele 2 Female 3 Radio Question Field 4 Droplets Override Question Droplets Picture Owerride Format Menu DROPLET List 4 Droplets Please select the picture you like 1 Droplet 1 2 Droplet Picture Question Field 5 HaveChildren Override Question Children Override Format Radio CHILDREM List Yes Mo Do you have any children This ves z Mo Radio Figure 138 Setting up seach fields Extra Sort Field 1 FormalEducation Override Question Formal Education FRMLEDU What is the highest degree or level of school you have Extra Sort Field 2 PeanutButter Override Question Peanut Butter PEAMUTET Do you like peanut butter Extra Sort Field 3 Strawbemies Override Question Stravbenies STRAW
101. a none ed netic awe Gee oe Lae wad Se 148 duo EPON SES NCS PANE en ter hee io ace AD E 148 4 7 5 1 SPSSChldData Formats Scipt sps sie Me Mie tal bo ete ewes 149 4 7 5 2 SPSSChildP tequenclesScChpisps eau duos re eie ho ie honda wes s 150 4 7 5 3 SPSsGhild ValueLabelsSCtptsDS 2 5422 racheter o noe dee 150 4 7 5 4 SPSSChild Variable Labels SpE a uma TR Ue ewe d den 150 4 7 5 5 sP55DPatenitDatal ottuatS5ettDES So e oe Robe Y OU ed e aes 150 4 7 5 6 eso Patente requienciesSeripesps esses iu pr e EE UC E Pa ES 150 4 7 5 7 SPSSParent Value AbelsScripUsps sis ER eb ded orca 150 4 7 5 8 SPSS Tarent VAA ble LAD SSpS ada toes End de orto dto ads 151 46 JModIIDS Survey WED Pap s arc yh atid te hh hel nissan aad ie da 151 ao Oxeatne Web Pate BUON cut hid se en inde eens hd dtd d edes 151 Appendixes External MySQL Databases ads Ses st den NN OSEE TEN 151 vil viii Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8 Figure 9 Figure 10 Figure 11 Figure 12 Figure 13 Figure 14 Figure 15 Figure 16 Figure 17 Figure 18 Figure 19 Figure 20 Figure 21 Figure 22 Figure 23 Figure 24 Figure 25 Figure 26 Figure 27 Figure 28 Figure 29 Figure 30 Figure 31 Figure 32 Figure 33 Figure 34 Figure 35 FIGURES The SURV VOL told eta RS LA dde ho me Doi th eS eer 2 Ouestionnaite folder R MARCAN 64 teda irn incu dia ten OP a babe oad dee 3 PASS Ord MANO OU Cae une idee neme
102. address es from your questionnaire contact page This very significantly reduces the likelihood of spam being sent to your published e mail address 0 Tootbarunavaitabie A petai tist Y nimis Company Info Server Ancillary Files Web Page Format ne A Oo Question Format E Mail Admin Buttons Password Survey Company Name Videlicet Mailing Address F O Box 19581 55 Bloor Street West Toronto Ontario amp nbsp amp nbsp M4W amp nbsp 3T9 Canada Phone Number 416 952 1040 Facsimile 415 962 1044 Business Hours 09 00 17 00 E S T Contact Name Trevor Jacques Contact EMail lt script language javascript gt To avoid spam you may want to use this format forthe e mail address for display on survey lt l remember that the space between the two slashes should not be in your code web pages var person Info varser Videlicet script language javascriptl gt varserz ser com varLextname ourcontact email address var person Info document wite lt a href mail 4 Eo person var ser Yidelicel 7 ser textname e t var ser ser com lis var textname our contact e mail address lt iscript gt lt noscript gt info at our dornain lt inoscrpt gt document write lt a href mail to person Figure 96 Set Up gt Company pane 4 6 2 SET UP gt SERVER PANE The Set Up gt Server pane is where you set up the data collection
103. age 123 Sample Admin export web page showing export set selection pop up 124 Sample Admin export confirmation web page x once rm ehe 125 DA DIE El D PAR mm 126 Sample Admin export confirmation web page acs no site aod anata hc qt A Ie eor 126 Sample Melb We Paces 63d gid NN A AU Abe ane seed ane Rte ent 127 Top Of Sample privacy statement web page insertas epe Eee v etd ets 128 SAC SULVCY WED PATO o d aces do bte IS Mate DE eo un 129 sample Java eubE pop up alei tact voa dead dn ira dX or dt ep eS feat 130 Sample Admin lobem and secutiby Check us evo sad o ene edu p Ae DAS 131 Sample respondent questionnaire creation web page 131 Sample respondent questionnaire creation confirmation web page 132 Sample web page for respondent to find own questionnaire 133 Sample respondent questionnaire found web page evocar ise et ER 133 Sample respondent questionnaire found web page 134 D rton to pop up question Tes Ule add acte Sra eos rl d aret C o de d 134 Sample question results pop up web page sse heb Se EE ue be eae esse ee 135 Sample Admin questionnaire review search web page 136 Figure 188 Sample Admin related record deletion web page 0 cece eee eee eee 137 Figure 189 Sample Admin related record deletion confirmation web page 137 Figure 190 Admin Sample main
104. age The Confirm at logoff will put the number of the questionnaire on the web index page that results from logging off from a questionnaire This helps respondents remember their questionnaire number if they decide to complete their questionnaire entries at a later date The Back Button choice allows you to decide whether you want a Back button on your ques tionnaire s home page 78 v8 0 v8 0 THE SURVEYOR USER MANUAL 4 6 4 SET UP gt WEB PAGE FORMAT PANE This pane contains all the information needed to create the overall look and feel of your questionnaire pages It is here that you set up the text fonts and colours the background images and colours and the table sizes and margins as well as the questionnaire name information A unique feature of The Surveyor is that you can also divide your questionnaire into two parts one for the respondents and one for the questionnaire administrators This can be very useful when you need to add comments to particular questionnaires and you don t want your respondents to see the comments Figure 108 shows the whole pane Web Page Format Question Format E Mail Admin Buttons Password Companyinfo Server Ancillary Files oe PI A Web Page Info Questionnaire Body Background image Name StripedBackground gif Face Palatino Times Times Roman Times Mew Roman Page Background Color FFFFFF RRGGBE Link Color 000066 Color 333333 ess Size 10pt Questionnaire Page Width 9036 ALink Color 0000
105. age is the SurveyFound lasso pagein the section immediately below 4 7 3 26 SURVEYFOUND LASSO Figure 183 Sample respondent questionnaire found web page When a respondent returns to his her questionnaire and successfully enters the questionnaire number and password the reply page con firms the gestionnaire number and password and tells the respondent how many pages have been completed to date If only one page has been completed a textual rather than numeric version of the page number is displayed as shown in Figure 183 The Surveyor then takes care of taking the respondent to the first uncompleted page This prevents respondents from modifying previously entered data and pro v8 0 133 THE SURVEYOR USER MANUAL 134 vides a user friendly way for the respondent to remember wherehe she left off last time This can be really useful when the questionnaire is many pages long Remember that the questionnaire administrator can visit any page of any respondent s questionnaire at any time so if any changes are reqired they can be made easily If the respondent correctly logs in to his her questionnaire but has already completed the questionnaire the reply page confirms this as shown in Figure 184 Note that in the case of the completed questionnaire the password is not displayed since it s unnecessay Figure 184 Sample respondent questionnaire found web page 4 7 3 27 SURVEYRESULTSP
106. ail pane as shown in Figure 130 v8 0 THE SURVEYOR USER MANUAL ee 2 Company into Server Ancilli ee ee t f E Mail Responses E Mail Field Mame Useremailaddress E Mail From Sample widelicet corn E Mail Host ajdelicct con account must have relay capability and following password CUm E Mail From Password EMail bee Inforvidelicet com 13 EL May DE mar al nrc unm es this field be blank E Mail Bcc Only r l you leave the Following three fields blank the e mail will use the default contents EMail Subject Text Sample Videlicet carn questionnaire Include Negatives No Page Header lead in EMail Intro Text inTeRobucrion Uppercase Headers es This is a r por for ift Field GENDHCW J 1 Mr inetude Pages o else if Field GEHDNO Ww 2 Ms if if Fisld Include Page Headers ves FirstMarne Field LastMarne It is the result af include Text Headers es Your having completed a sample questionnaire at httpi Pvidelicet cam Samples 20035amplae Include s Ho f spacing ves 0 Question spacing Yes 2 Include Menu Label res Include MIA ett Mo EMail Exit Text All the best Default Body Text for Admin Create E Mail Trevor Jacques Widelicet PF Box 19591 55 Bloor Street West Toronto Ontario Mew 3T3 Phone 416 962 1040 Facsimile 416 262 1044 Email Info Videlicet com Www Videlicet corn Record 15 of 15 records found from total of 99 records T
107. aires Through their respective groups the demo user has administration access to both questionnaires whereas the Resp and SBC users have respondent access only to their respective questionnaires The user names for this example illustrate how it is possible to make it difficult to find your questionnaire user names in Lasso s admin istration A much better solution is to name all of the users for all of your questionnaires with the same characters at the beginning of the name This will help seaparate them from any other user names in the sorted list in the Lasso administration Users List web page v8 0 115 THE SURVEYOR USER MANUAL We suggest using something like Survey at the beginning of the names as we have done for the group names in the next section We ve left the naming up to you to provide for greater flexibility when you set up and use your questionnaire s 4 7 3 6 2 QUESTIONNAIRE LASSO GROUPS The groups created by The Surveyor for two demonstration questionnaires are shown in Figure 161 Notice that the group names are automatically created by The Surveyor from the questionnaire abbreviation By adding the Survey at the beginning of all groups The Surveyor keeps all of your questionnaire groups in a block that helps distinguish them from any other groups in your Lasso adminis tration interface 116 FM Lasso so al 6 Setup Build Browse Monitor Support blueworld Global Settings Data Sources
108. ame e 0000 0 oma ime Use Rqd Pg Ord Field Export Name Group E QuestionText Type W H Choices MenutLabel 377 a ui gt eee __ lt mx E 2 PageHeaderTex OC lt h3 gt Multiple Page Child Records cont J lt 1h3 gt A EE gx 6 3 HeaderTex a This page provides the rernainder of the Hox x5 4 MedicationPurpose MEDPURP 82 Purpose why do you take it Field 115 Figure 38 List pane with last page of portal The Export Field name see the next section below is not required since these records does not define a data entry field in the web questionnire The text in the Question Text field must be descriptive and singular so as to fit into the sentence Do you have any more medication records to enter Text is supplied around the word medication in several parts of the web questionnaire hence the requirement for your entering the singular of the descriptive term for these related records This text 1s used in the Questionnaire web pages the web admin area and the JavaScript alerts This is the first of two could be more pages for a single child record Additional child records can be added once the last page of many has been reached For each prescription medication you are currently taking please enter the following information note that if you answered Male or Transgender on page one a question about effectiveness will not appear This l
109. and SPSS sps files to format the data the result from your online survey Specify the way in which a reponse is formatted onthe web page by choosing the appropriate Type for the field Use the Limits layout to Tel 416 962 1040 specify whether aresponse is required and whether it should be if a question has to be asked in more than one part use the Group EMail Info idelicet com menu to specifiy which web field should contain which part of the answer e g Begin Centre 1 Centre2 and End forthe four digits of Web Yidelicet com the year where the SPSS data field DATE is the combination of these four fields say DateThousands DateHundreds DateTens and DateOnes In this case only the first with the Group position Begin needs to have the question If you choose pull down menu types forthese you can specify the label on the blank menu item Lo Alternatively you could use one response field with say several pre defined years e g 1998 1999 2000 2001 2002 2003 2004 To do this create a Field choices list with these values and link to il from the SPSS layout forthe appropriate field Any field label that is underlined may be clicked to sort the found The Surveyor version 8 0 opyright 2002 2005 Trex6r H Jacques For further information please contact P O Box 19591 665 55 Bloor Street West Ontario M4W 3T9 Please include BOTH the P O Box number AND the street information on your envelope Thank you
110. anks and that your date and number formats are correctly entered Thanks F aback ae ee n You mightalso want to use the Back button to go back to check that you have filled in all the fields not marked Optional Figure 164 Sample MySQL data collection database creation web page 4 7 3 9 ADMINUPLOADQUESTIONNAIRES LASSO Upload File of Empty Respondent Questionnaires 1 Fir r B M Upload respondents list fle name Choose File nofile selected f Upload File Name File Size Last Modified Respondents lasso 104 04 06 2004 09 40 34 Respondents lasso 146 12 03 2004 14 54 03 Respondents lasso 108 12 03 2004 16 30 33 Gack Figure 165 Sample Admin upload of questionnaires web page 119 THE SURVEYOR USER MANUAL 120 The questionnaire administrator can upload files containing blank respondent records to the Imports folder This web page is in two parts The first is an html upload form so that the questionnaire admistrator can send a file from his her local computer to the web server from which your questionnaire web pages are served The file is put into the Imports folder of your questionnaire The lower part of the web page is a list of the current contents of the Import folder These files can be imported into the data collection database using the Import web page The list is updated every time the page is seen including immediateky after an upload The Upload page is returned aft
111. are illustrated in Figure 100 For more on the Lasso user group creation please see the AdminMySQL lasso section The Related table is used for all web page data for the Portal pages in your questionnaire The Security database is used to authenticate your questionnaire respondents and administrators as they log in to the questionnnaire web pages Finally the Value Lists table is used to related v8 0 THE SURVEYOR USER MANUAL data contained in the MySQL database with the text strings of your response Choices lists for functions such as the results pop up web pages and the e mail of textual versions of responses to your questionnaire 8 O Foobar Avaiabid MP petai 0000000000 Company Info Server Ancillary Files Page Format Question Format E Mail Admin Buttons Password Database Information f Sec urity Inf ormation MySQL Database Name Videlicet no spaces Use Password Yes Questionnaire Table Name Sample no spaces Secure Domain Related Table Name no spaces Chars In Questionnaire Number 6 Security Table Name no spaces Enter here or in the AdminInfo lasso file Vaue Lists Table NUNS esperes Seed AlphaNumeri Fi7GgHh idiSKkLMr2SsTt Uu Ya WX xeYyzzAau Vv ao fill this box with wXxaYyzz doEaBbMm4NuYnoPp3GqRr2SsTE TUSGqRr Default MySQL Character Length 128 random alpha characters 25sTL IU vSvWvxxeYvzz amp sBb9CcDd8p3QqRr25sTE uy NOVWWVEXSYvyZzAaBbSF gHh6iJ SKkLMm4NnoP p3G qRr23 DIM MODI
112. astName If The Surveyor sees var emailSubject var emailSub ject variable emailSubject or variable emailSubject in this field it will assume that you have used the field to assign a value to the Lasso variable for the e mail subject If none of the above text is found The Surveyor will remove the leading and trail ing brackets and assign the subject variable used in its web code to the trimmed text If the EMail Intro Text is empty The Surveyor will use Here are your responses to OvestionnaireName questionnaire that you completed on CurrentDate at Current Ig Your questionnaire number was OuestionnaireNumber Due to skip patterns some questions may not have been asked in the survey These will appear below with a comment Not Answered as will those that were not answered If the EMail Intro Text is empty The Surveyor will use If you have any questions about the survey please contact us Thank you SurveyContactName SurveyCompanyName Survey Address Phone SurveyPhone Facsimile Swrvey Facsimile Email SurveyContactE Mail WWW https SurveyDomain v8 0 93 THE SURVEYOR USER MANUAL 94 where the italicised items are the respective contents of the entries in the Set Up gt Web Page Format pane Note the italicised s in https This character is added if you have specified a secure domain for your questionnaire At the bottom of each Admin review web page for a particular respondent you ll fin
113. ation will be based upon the question itself others on your preferred style for your questionnaires We ve found that long or short questions have a way of convincing you to change the orientation for that one question as do a large number or small number of possible choices hence we recommend first exporting your final questionnaire with all ques tions response in the default orientation so that you get a feel for how the questionnaire will look on the web page You should bear 45 THE SURVEYOR USER MANUAL 46 in mind that some people have small monitors so reducing your browser window to 800x600 or even down to 640x480 will likely help you with your decision c Do you like apples Required Uncertain Always Mostly Frequently neutral Sometimes Rarely Never N A Decline O O O O O L2 O O Figure 46 Matrix Text field type top bottom orientation Yes No N A Decline b Do you like peanut butter O O e O Figure 47 Matrix Text field type left right orientation Uncertain Always Mostly Frequently neutral Sometimes Rarely Never a Do you like bananas e o 0 O O O O Figure 48 Matrix Text field type Likert scale left right orientation c Do you like apples Required Uncertain Always Mostly Frequently neutral Sometimes Rarely Never N A Decline O O e O O O O O O Figure 49 Matrix Text field type top bottom orientation separated extra selections
114. atrix Yalue Format Plain Max Pictures Wide 3 Figure 122 Response formatting The Max Pictures wide field sets the number of images that should be shown in a row of images in the response area before another line of images is shown on the web page If you have very small images you might want to increase this number and you will want to decrease it if you have large images from which you want your respondents to choose The Sample questionnaire shows the picturesthree wise as in Figure 57 v8 0 THE SURVEYOR USER MANUAL Please answer using the following scale Yes 1 Mo 2 N A 3 Decline 4 1 2 3 4 b Do you like peanut butter O O fe O Please answer using the following scale Yes 1 No 2 a Do you like butter O1 2 O N A Decline c Do you like jam Required O1 O2 ON A Decline Uncertain Always Mostly Frequently neutral Sometimes Rarely Never a Do you like bananas e o o o o o o Figure 123 Matrix field types left right orientation plain and values Matrix Value Format 4 6 5 3 RELATED RECORD SEPARATORS In the Admin section of the web pages you can review the main questionnaire This includes examining any responses related to the main record When there are more than one related record to be reviewed for a questionnaire main record there needs to be a visual separator between the information for each related record Here you set the colour and
115. atterns 4 4 LiMITS PANE The Limits pane repeats a few of the fields shown on other panes but it is provided as a neat way to view widths and heights to help in establish ing a consistent lok and feel for your questionnaire the basic limit test to be performed on responses to questions and the formats for the SPSS data types and precisions The Choices list Name can be clicked to pop up a menu of Choice lists and the blue text at the right of the pane shows the Choices and their associated values Clicking this blus text will take to to the Field Choices database record for the Choices list of the question record where you click the blue text v8 0 v8 0 THE SURVEYOR USER MANUAL Mm En o M e e Deta st Jp Expor TEE EEE bo A A SA mu ER Field Reqd Type W SPSS Prec SOLType Lyth Prec Choices List Name Choices List Pairs PageHeaderT ext fa HeaderT ext E Firsthame Ej Field 15 CHAR 45 Lastharie A Field 15 CHAR 45 geDecade Li Menu 1 T INT o Zero ta Nine DA 1 1 252 3 RBA AgeY ear iti Menu INT Zeroto Mine Tigh Reece ee ee GenderMosw Radia INT Gender Male 2 Female 3 intersex 4 FonnalE ducation C Menu INT Formal Education Grades 1 12 NO DIPLOMA 2 EthnicGroup JE Select b CHAR 220 Ethnic V Abonginal Cree Micmac Metis Ethniciroupother O Field 30 CHARI SO Marital Status Radio INT Marital Status 1 Legallvmarried 2 Lringtagether
116. ay field in left right orientation and the code used to show the example was note the inclusion of the brackets and parentheses in your code String Concatenate field FirstName field LastName Figure 43 Display field type Please note that this code is not checked for syntax or any other errors by The Surveyor Hence for this example there must be both a FirstName field and a LastName field in the data collection database You must be sure that the code is in correct syntax If you get 44 v8 0 v8 0 THE SURVEYOR USER MANUAL strange results on a page with a Display field one of the first things you should do is check your Lasso code in the Display field s For more information about the correct form and use of Lasso syntax please see the Lasso documentation from OmniPilot com 4 2 1 11 3 EMAIL Figure 44 shows the EMail field type in top bottom orientation This field type looks the same as the Field field type but it tells The Surveyor to export extra JavaScript and Lasso code to test the field for a valid e mail address The respondent is given a detailed alert if the format is not correct and the e mail format is validated at the server to ensure that attempts to insert malicious code in the data base ate foiled since that code would have to look like an e mail address Sales Videlicet com Figure 44 EMail field type You can enter many EMail fields in a single questionnaire and you can choos
117. b site although the two may be the same Note that this may not be the same list of contacts that the developer might want shown for any of the individual surveys The top and bottom parts of this file are called from the building blocks detailed in the Surveys Includes Folder on page 8 3 1 1 2 4 QUESTIONNAIRES OTHER SURVEYS LEVEL WEB PAGE FILES Other pages at this level of the web site can easily be created by making a copy of say the About Us page renaming it and then mod ifying the body contents Appropriate links to any new pages created by the developer should be made in other web site pages The top and bottom parts of these files should called from the building blocks detailed in the Surveys Includes Folder on page 8 If one of the newly created web pages is to have a button that is included in the row of buttons at the bottom of the Surveys level lasso pages appropriate changes should also be made to the Surveys level FooterButtons lasso file 3 1 1 3 QUESTIONNAIRES INCLUDES FOLDER Just as images are included in web pages code can be included in web pages to add detail and or functionality to the page The Includes folder contains files that contain both html and Lasso code for inclusion as building blocks of html web pages in the Pages folder below and the Questionnaires Index lasso web page You can edit the contents of any of these files to change the look and feel of your question naire from the default of The Sur
118. ble clicking the The Surveyor runtime file or by dragging Surveyor AS3 onto the The Surveyor file or onto your own licensed copy of FileMaker Note that The Surveyor is actually two FileMaker runtime database files and the layouts and scripts within them If you have a licence for The Surveyor ensure that you hold down the Option key Macintosh or the Shift key Windows as the application starts up This will present you the password dialogue shown in Figure 3 File 5urveyor A53 Leave blank for limited access x Figure 3 Password dialogue The Surveyor Welcome to the Surveyor Your demonstration licence will expire on Wednesday 5 January 2005 so you have 30 days left to try it out Your demonstration licence allows you to do everything that the full version does It allows export of all helper files but you may only export the first page of the pages you create both for the web JavaScript pages and the Word export You will be taken to the list layout in a few seconds Figure 4 Splash screen for The Surveyor Enter your password which you can change from the Set Up gt Password menu which is the link at the right of the main Set Up pane and click OK If you do not hold down the key for the password dialogue you will not be shown the password dialogue and you will be put into demo mode with only demo privileges such as only being able to export the first of your questionnaire pages and other
119. by The Surveyor whenever an error is encountered It is designed to provide as much data as possible to the per son who encounters it without giving away any information about the structure of your data collection database In the example shown in Figure 170 the error was caused by a questionnaire adminstrator trying to ad a respondent record for the second time The Surveyor has identified the error and reports it back to the web browser 4 7 3 15 EXPORTDATA LASSO Exporting data is one of the most important parts of your questionnaire and of The Surveyor You need to be able to export to file and to ensure that off site backups are made The Surveyor provides this mechanism for you As illustrated in Figure 171 the first field on this web page is a pop up menu that lets you choose all the response records in the main data collection database or just the ones for completed questionnaires Note also how this figure shows a slightly different graphical style from most of the figures in this manul It is the result of differenct choices for the look and feel of the Sample questionnaire not because this web page is different from the others For the related records a pop up menu selection is provided for each portal of related records The Surveyor will export all records for that portal irrespective of whether the parent record has been completed In the example shown there are two portals one for the children of the respondent and one for
120. ciated with the questionnaire including the helper files and the SPSS scripts The All Helper Files and All SPSS Script Files buttons export all of the files for their respective v8 0 THE SURVEYOR USER MANUAL area of the questionnaire The All Survey Web Pages will export both the pages for the Pages folder and the pages for the Includes folder The latter files being the building blocks of the repeated and multiply used parts of the questionnaires web pages The buttons to export the Index html and Index lasso files are addresses in subsections below The Export All Pages Files No Survey button exports all of the files for the Pages folder except SurveyN lasso and SurveyNjs1 lasso files where N is the page number It does not export any files for the Includes folder this is useful when you ve almost completed a questionnaire but you ve made some small changes to individual questions throught your questionnaire muni iioi n oo A Record D af D records found from total af 88 records There are pages itr sour survey Figure 146 Export gt All pane The Pages button allows you to export individual questionnaire pages or a range of pages with their associated JavaScript page The JavaScript button is useful if you ve say added a min max test to a question and want to export just the JavaScript testing code during your developement v8 0 103 THE SURVEYOR USER MANUAL Note that you should
121. cluded by Survey lasso when the questionnaire administrator reviews the responses given by a given respondent 4 7 3 30 SURVEYREVIEWDELETE LASSO Figure 188 Sample Admin related record deletion web page When reviewing a respondent s questionnaire the administrator may want to delete one of the related records The page shown in Figure 188 is used to have the adminsitrator confirm the desire to delete the related record The number of the related record as shown in the list of related records noted on this page to clarify to the administratro which record is to be deleted The reply page for when the administra tor clicks the Delete button to confirm is shown in the next section 4 7 3 31 SURVEYREVIEWDELETEDONE LASSO Figure 189 Sample Admin related record deletion confirmation web page v8 0 137 THE SURVEYOR USER MANUAL Once the questionnaire administrator has confirmed the deletion of a related record The Surveyor s web files delete the record and return the Deletion complete page as shown in Figure 189 Clicking the Review button takes the adminsitrator back to the list of related records for the portal of the deleted record 4 7 3 32 SURVEYREVIEWDELPARENT LASSO The questionnaire administrator may want to delete a main record parent record and any associated related records child records This is done from the Found Questionnaire SurveyReviewFound lasso page Clicking the Delete button on that
122. ctor is shown in the web apee so it s easy to get the right number for your questionnaire pge y to g 8 y q v8 0 151 THE SURVEYOR USER MANUAL PILK SOFTWARE Jtility support SOMNI Connector for Lasso MySQ Enabled List Databases or for FII nable List Hosts 3 Lasso Connector for MySQL nabled List Hosts Add Host ma Figure A 1 List of MySQL connectors in Lasso Admin SOFTWARE List Hosts List Hosts Figure A 2 MySQL JDBC connector detail in Lasso Admin 152 v8 0 THE SURVEYOR USER MANUAL PILOT SOFTWARE Lasso Connector for MySQL Name localhost 3306 3306 localhost 3306 nabled List Databases Add Host List Databases Figure A 3 Host detail for MySQL connector in Lasso Admin SOFTWARE YMNIPILOT com mwysgl jdbc Driver Add Host Figure A 4 Host detail for MySQL JDBS connector in Lasso Admin v8 0 153 THE SURVEYOR USER MANUAL JMNIPIL SOFTWARE Refresh Lasso Administration 7 1 2 e Multi User Current User trevor Logout Figure A 5 List of MySQL tables and table detail in Lasso Admin 154 v8 0 THE SURVEYOR USER MANUAL Lasso SOMNI PIL SOFTWARE Refresh Lasso Administration 7 1 2 Multi User Current User trevor kg Figure A 6 List of MySQL tables and table detail using JDBC in Lasso Admi
123. d height fields for each image you specify in the Field Choices database We wrestled with normalising the height or width of the images but eventually had to decide that specifying the dimensions in the Field Choices database provided you with the greatest flexibility for this field type Hence if your images are large you should perform the scaling calculations and enter the results in the Field Choices database or chose to have only one or two image s per row The number of pictures in a row is specified once for the entire questionnaires but this can be overridden for any particular question 4 2 1 11 9 RADIO BUTTON FIELD TYPE m Male Figure 58 Radio button field type A radio button presents a set of choices to the respondent Only one choice may be made much as for the Menu field type but in this case all the possible choices are presented within the body of the web page rather than as responses that are hidden until the respon 50 v8 0 v8 0 THE SURVEYOR USER MANUAL dent clicks the pop up menu There is a trade off that you may have to make in this case when there are many possible responses a great deal of web page space is used If you are concerned that many of your respondents may have smaller monitors this could be a concern If you are concerned about browser space you might want to use the Menu or Select field type instead Once one radio button in a set has been clicked clicking another choice in the s
124. d the E Mail and Write buttons next to the page selec tion and Jump button Figure 133 The E Mail button initiates an e mail of the textual summary to the default administrator e mail address The Write button performs a similar function but the summary is written to file which can be e mailed immediately after creation to any e mail address For more about the Write function please see the WriteQuestionnaire lasso section Page Li Menu Select an d Text Fields Text Boxes and Radio Buttons Figure 133 Menu fields with question specific menu labels 4 6 6 3 TEXTUAL E MAIL FORMATTING When The Surveyor sends a textual form of a respondent s answers it performs many formatting functions to ensure that the body text of the e mail looks the way you want In the Detail pane you can specify whether a particular question should be included in the e mail If so The Surveyor will then format the question according to your selections in the formatting part of the Set Up gt E Mail pane as shown in Figure 134 If the respondent does not answer a question or answers No to the question you may not want the response to take up room in the body of the e mail Selecting No to the first field in this part of the pane will ensure that negative responses are omitted Include Negatives Mo Page Header lead in Uppercase Headers es Include Page s Ho Include Page Headers es Include Text Headers res Include Q Fs Ho
125. d the pop up list as opposed to pop up menu lets you choose one of the values from the Choices list associated with this record If there is no Choices list associations the pop up list unlike a pop up menu allows you to type free form text into the data for comparison If there is a Choices list association and once you ve picked a value the textual equivalent is shown You can specify the upper limit the lower limit or both Note that the pop up list is sorted alphabetically so all numbers starting with 1 are sorted together 1 e 1 11 12 13 14 etc Also note that no code is generated if the comparison field is empty even when in some cases this empty field provokes The Surveyor to show a 0 in the Choice Text field to the right of the blank field This behaviour is due to the tool we have used to build The Surveyor It has not been shown to diminish performance of The Surveyor in any way Web Limits Check Choice text FirstName gt To FirstName lt To Figure 86 Data limit testing When conparing text values not that 0 to 9 are first then all the upper case letters then all the lower case letters You should bear this in mind as you enter limits in the gt and the lt fields For example to ensure that the response is in the alphabetic range you should enter A in the gt column and zzz in the lt column 4 3 21 2 EMPTY TEST You can set conditions for when the re
126. database and table names Each area of the pane is covered below Note the Toolbar button at the top of the pane It is provided to allow disallow you to reveal and hide the FileMaker Pro toolbar that you may find useful as you use The Surveyor Simply click the blue Toolbar label to toggle the permission to reveal hide the toolbar This is particularly useful if you have a small computer screen and need as much vertical space as possible 4 6 2 1 DATA COLLECTION DATABASE amp TABLES The Surveyor will create your data collection database if you do not already have one It also creates all of the tables required to collect your survey data The example shown in Figure 98 illustrates the set up for this You need to specify the name of your database and the main table for data collection If you leave the other three table names empty The Surveyor will assume that you want them the same as the Ques tion Table Name but with Related Security and ValueLists added to the Questionnaire Table Name Hence in this example the MySQL table names would be Sample Related SampleSecurity and SampleValueLists You can see how this looks in the Lasso Administration web page in Figure 99 From the Create MySQL Data Collection Database and Tables web page you ask the code exported by The Surveyor to create your database tables and the required Lasso users with the appro priate names and Lasso privileges The result of the database and table creation
127. do a complete export of the questionnaire before you publish it since adding a range means that that range needs to be added to the data validation performed by the server as well as by the browser The Export Files For Includes Folder exports all of the supporting files needed in the Includes folder and the Host Error Files button exports the error files used if the Surveyor web pages and server interactions encounter an error 4 7 1 1 EXPORT INDEX HTML BOS EE Sample Surveys The Videlicet Sample Sur d c Vre videlicet com Samples Sample Index html This survey requires JavaScript to function properly Either you do not have JavaScript enabled on your browser or the browser is not capable of executing JavaScript To fill out the questionnaire please enable JavaScript in the browser you are using and then refresh this page or find a JavaScript enabled browser and return to this web address If you have any questions about our use of JavaScript for this questionnaire please contact us at Info at our domain Thanks HOME PAGE SURVEYS E Copyright Trevor H Jacques 2002 2009 The Surveyor HTML and JavaScript C copyrkght Trevor EL Jacques 2001 2004 Figure 147 Sample Index html for browsers without JavaScript When respondents first arrive at your questionnaire s home page The Surveyor code tests whether the respondent s browser has JavaScript enabled It does this by redirec
128. e Figure 15 Type in the user name and password you d like your questionnaire administrator to use and the Lasso administrator s user name and password you may have to ask your Lasso administrator to do this Also if applicable enter the name of the file with your list of respondents for more on this file and its internal format please see the Import Folder section When you are satisfied with your usernames and passwords click the Cre ate button Figure 16 From the moment that you click the Create button shown in Figure16 the database creation may take a while Wait for your browser to load the next web page which will result in a page similar to Figure 17 Please note that some browsers have a built in time out of one minute and depending on the speed s of your web Lasso MySQL server s it may take longer than that to create your databases the Lasso users and groups and load your respondents information into the data collec tion database Hence for this task only we recommend the use of a browser such as Microsoft Internet Explorer which does not have such a short time out For everyday browsing and web use of your questionnaire we recommend a browser such as Safari FireFox Netscape or anoth et Gekko based browser Errors will be highlighted in bold red text The resulting page will tell you in detail what happened during the database creation process If all is well you can click the Sample button and start usi
129. e Abbreviation Sample no spaces Questionnaire Mame Prose the Videlicet sample questionnaire Questionnaire Name Prose Short Sample Questionnaire Figure 112 Setting questionnaire name information v8 0 61 THE SURVEYOR USER MANUAL 02 4 6 4 3 QUESTIONNAIRE DIVISION PAGE NUMBER When creating a questionnaire you may want to divide it into one part for the respondent and one for the questionnaire administrator For example if you were a doctor creating a patient intake questionnaire you d ive the first part of the questionnaire to the patient and you d add your own observations in a second part of the questionnaire by using the adminstration area of the questionnaire on the web To divide your questionnaire simply type the last page of the first part of your questionnaire into the field in this part of the questionnaire The Surveyor will do the rest for you When the respondent reaches the page you have specified it is shown and the subsequent page shown to the respondent will be the thank you page When the questionnaire administrator moves from page to page this limitation does not apply and the administrator is taken to the remaining pages of the questionnaire until the true last page is reached and has its data submitted A M P fe Fes Questionnaire Division Last Actual Questionnaire Page 5 Figure 113 Dividing the questionnaire into two parts 4 6 4 4 QUESTIONNAIRE BODY SETTINGS These setti
130. e If on a previous web survey page field field then omit this field from the web survey page Extra JavaScri pt Tests Id i Partially Maybe Uncertain GYes GNo GYes ONG OYes ONd DNK NIA Decline Other OYes amp Nd OYes amp Nd OYes ONd OYes 5 Na Comparison value Jump to Page Number GO TO OR O End GO TO OR O End GO TO OR O End f Jump to Page Number GO TO OR OEnd Figure 74 Detail pane The Surveyor was designed to make it easy to generate web based questionnaires Part of the approach was to make sure that all the information about a questionnaire was available in one place As The Surveyor developed the Detail pane has accumulated more information about each question There is little doubt that the Detail pane will soon have to be divided into functional areas but for now all of the information still fits onto a single pane if only just We feel that the benefits of having everything in one place far outweigh the amount of detail on the pane This section addresses each part of the Detail pane to provide a full grounding in the functions of The Surveyor 4 3 1 TRASH CAN You can delete the current question record by clicking the trash can You will be prompted to ensure that you want to delete the record just in case you ve clicked the trash can by accident 57 THE SURVEYOR USER MANUAL 58 660666006060 f ff Use Yes Web Figure 75 Trash can 4 3
131. e ae 71 Sample MySQL data collection database creation web page 12 Leto MiS OL tablessin LASSO RMI nouus terna e pu ed ele totale 73 Questionnaire folder ee a eL A Os SE dua 74 Setting up the questionnaire domain and file paths sites diese 74 Setting up Lasso data connexions and user name der RP tas EP PRU 75 Setting up MySQL data collection information 2 4v xen Ret sata 76 Settine up for analysis of your collected data ve se RESET EE EAE secre ws 76 Sample Questionnaire honie web Pagers sina ii cw ER ek eee dents Te Set Up nella Miles pane eoe hota ahaa eee insat e o b eee aan 78 Seti Web Page Format pane oscuras stie edle in ie 79 Det Web page IDIOEFBADOD slide di Motard rade 80 Sample completion bar in a questionaire web page 81 POEL We Dabe table INO MAHON ltda baa bo C NR e tae Mae 81 Figure 112 Figure 113 Figure 114 Figure 115 Figure 116 Figure 117 Figure 118 Figure 119 Figure 120 Figure 121 Figure 122 Figure 123 Figure 124 Figure 125 Figure 126 Figure 127 Figure 128 Figure 129 Figure 130 Figure 131 Figure 132 Figure 133 Figure 134 Figure 135 Figure 136 Figure 137 Figure 138 Figure 139 Figure 140 Figure 141 Figure 142 Figure 143 Figure 144 Figure 145 Figure 146 Figure 147 Figure 148 Figure 149 Setting questionnaire name information hisser eet ti iet ae oe leis den o1 Dividing the questionnaire into two Par
132. e know of occasions where researchers felt that for their purposes just a question number was sufficient If you d like all of your questionnaire pages served from a secure https server you should enter the domain name here This should be the same domain as you entered in the Domain field at the top right of the pane Once this is done this instructs The Surveyor to make all page references to https when it exports the web files for the questionnaire Since most browsers will not cache secure pages setting the secure domain automatically removes the back button from the web pages since all it would do is confuse your respondents as the browser asks if they want to reload the page since it has expired from the browser cache v8 0 75 THE SURVEYOR USER MANUAL 76 When the respondent is allowed to create a new questionnaire see Figure 104 you can determine the number of characters in the random alphanumeric questionnaire number that the Surveyor web pages create on the fly We recommend that you use a minimum of six char acters but we have provided for between four and ten Figure 104 shows the button that allows a visitor to the questionnaire index page to create a questionnaire This button can be omitted from the page by a setting in the Set Up gt Web Page Format pane of The Surveyor d Security Inf ormati on Use Password Yes Secure Domain FE Chars In Questionnaire Humber 6 Enter here or in the Admininfo lasso file
133. e one of those to be the one to which the server will send responses by e mail For more on selecting the primary e mail address please see the section Set Up gt E Mail 4 2 1 11 4 FIELD FIELD TYPE Trevor 2 Please enter your family name here Required Jacques Figure 45 Field field type A Field on the web page allows the respondent to enter alphanumeric text into your data collection database using a single line field on the web browser The first and last name fields in Figure 45 are a good example You should specify the width of the field presented to the respondent otherwise the default is used The width of the field is specified in terms of number of characters in the W column of the List pane or in the Response Width field of the Detail pane From Figure 45 it is easy to see the difference between the top bot tom and the left right orientations that The Surveyor provides you for the presentation of the question and response on your questionnaire s web pages 4 2 1 11 5 MATRIX LIKERT TEXT The Matrix Likert field format is one of the most important and commonly used in any questionnaire For reasons of psychometry it is important to ensure that each possible response be equally spaced from its neighbours As you can see from Figures 46 to 54 The Surveyor provides you with many ways to present your questions responses in evenly spaced columns Sometimes your choice of question response orient
134. e page shown in Figure 148 The body text of the page is entered into The Sur veyor set up and is presented as the text block in the centere of the web page The figure shows all of the buttons that are possible but you have to option to turn off the Start New Surveys Help About Us Contact Us Privacy and Admin buttons according to the needs of your questionnaire For example omitting the Start New button will prevent anyone without the questionnaire administrator s name and password from creating new questionnaires Likewise removing the Admin button will hide the entire Admin area from casual surfers Sample Surveys The Videlicet Sample Survey The Sample For The Web survey is an example of a research project By design this Sample survey shows all of the major functions and response types of The Surveyor so you may experience many pop up dialogues if you do not enter data into required fields You can enter data or simply press the Next button to see the sample pages until your questionnaire is complete You need to get to page nine to see all the possible response types in the Surveyor There are nine data entry pages in this sample questionnaire There are two examples of jumping skipping from one page to another based upon the respondant s replies Finally there are two examples of child record input for the questionnaire parent record The Sample survey is not monitored In page eight you should not enter comments
135. e same text to present to the respondent but have different numerical values i e they have dif ferent weights The Surveyor would normally restart a new matrix as it runs across a different Choices list name For example if the first question has Yes 1 No 0 and the second list has Yes 5 No 1 you don t want the respondent to know about the weighting that is going on behind the scenes Clicking the Same Matrix ensures that the only one set of column headings is provided for the Yes and No columns for the matrix of responses on the web page Hence there s no way for the respondent to tell from the web page that you have different weighting for each question 4 3 9 QUESTION ORIENTATION The default value for each question when you add a record to The Surveyor is Default You can use this pop up to override the questionnaire default of left right ot top bottom This provides a one click way for you to change just one question to make you web page look the way you want it 4 3 10 QUESTION ALIGNMENT This pop up allows you to change the text alignment of the paragraph of question text For example some people like a left right question response format for their pages and want the question text right justified on the page so that it abuts the response fields 4 3 11 WIDTH OVERRIDE For left right orientation you set the default questionnaire width of the question column in the Set Up gt Question Format pane You can over ride
136. e with right left Matrix Text responses 52 Subquestion field type with top bottom Matrix Text field response 52 Sun Total Held pesos 53 Subquestion field type with left right orientation 53 Subquestion field type with top bottom orientation 53 List pane field and text box width dnd height 22440 bu esu ve SEHE Le eV essieu 54 hist pane Choice COMM coo e A ho eee ea hee RA 55 Choices Nsts POP AIPIN ENE a saa aside ad head Grind et se nee ERI eret oed 55 Sample questionnaire with Matrix Text choices cus ees seeded ae ne whole EE ees 55 Sample questionnaire with Radio button choices 56 Sample questionnaire with Select menu choices oues ceb re ER beet epu 56 We b mend A deut oret De e MEAE a aet a de 56 ix Figure 74 Figure 75 Figure 76 Figure 77 Figure 78 Figure 79 Figure 80 Figure 81 Figure 82 Figure 83 Figure 84 Figure 85 Figure 86 Figure 87 Figure 88 Figure 89 Figure 90 Figure 91 Figure 92 Figure 93 Figure 94 Dari PPP 27 TA OCA esos ee od acne ee dada mb ne cte 58 Question ate Pase SUMIM ALY cec Lees e prb qo E eO aee b tie miennes 58 Field ames required Held and order dnb tOUD e e aes Sow ch cs acu CHR ec qt ie Ace dte 58 List pane with Colum Meadings and Helds s ees a ere RAE Seen Se ede ion d 59 Same questi n NUMDER AS DEEVIOUS vadat eee pU bue apu ate me acr ach
137. ecord on the page only the page number is shown in the pop up menu on the Found Questionnaire web page 4 7 3 37 SURVEYREVIEWUPDATE LASSO Figure 195 Sample Admin update confirmation web page When the questionnaire administror reviews the list of related records for a portal changes can be made to any record on that page and save by clicking the Save button associated with that related record The confirmation of the update is provided in the form shown in Fig ure 195 There s no need to reload all the related records since the change made is on the cached browser page of the list of records hence all that is needed is a Back button on the confirmation page 4 7 3 38 SURVEY THANKYOU LASSO When a respondent has completed the last page of data entry he she is presented with a thank you page as shown in Figure 196 If dur ing development the author of the questionnaire has specified that the E Mail function should be made available to the respondent it will be shown as in the figure If the respondent clicks the e mail button at this point a textual e mail of the respondent s answers is sent imme diately to the respodent and a copy is sent to the questionnaire administrator s default address If no e mail function is specificed in The Surveyor only the first paragraph of Figure 196 is presented and the respondent s browser has its questionnaire cookies removed If the E Mail button is not present nor will the L
138. eld DE dude Qin a scien nn be enter Sees 45 ARETES Matix Likert Text serried Tig Gaede ya SN eek dae deenemtee kes 45 ADO Matte Likert Value ss SERA ERE chao mete weed 47 PALM Menu Field Dvpe esse M CERE ERA iaa 49 Alois Picture Feld Type debi noi cs air ette d eese 50 RAR Radio Button Pied pecan Cen e er task PEE EE 50 do I LO Select Weld Wye prnl e ace 51 dA Mell DAs select Multiple Feld Dy DO sn ie ad estem cio o 51 Addc D Shaor Teld PR 51 d LILIS Subaquestion Header Field Eype dd S beide oa da ob teris 52 ADE sou Total biela Vy pe denia ida treo toos dun hab o epulas 53 dT LT Testo Mela IPS a Sato eere ten o be CREE Sete dide 53 AN W dtlr pica eod Vs Ee emo arate Seq i Pseud s ied 54 AOL Fed sio uc Cr 54 d dde eld CDOICGS irreal 54 LM MES MENTRE MP 56 DA ran DT II ORE Vet ui A ete eee 57 De SEa Ovi A nee ate ata A 57 tora wdeeconbin Use heck DOX estaa dadas tie aa al 58 too G ucsuonhatre D asc SOMMA a eina ari ese 58 495 5 Question Number On Web Pase 4 cu o eee ee E ond 58 4 3 4 Field Name Export Data Collection Field Name and Required Fields 58 4 3 6 Order In Group and EMail Write Group Separator 59 4 2 7 Same Question Number as Previous o in uas ox oo oet eue dr REN EVA 60 Ae Dame Mte as PEeVIOUS 2 4o ex bb ae EE Eel eB ERE 60 d XOUOSHOIC TIeDEt 40D ES nes Pera es OH meute dirai deo Oe AA 60 4 9 105 QUESTION IUIEORIeDE xe d seca ted ove p pee iron be ded Eee ut 60 Ae Wid
139. er each upload so that the questionnaire administrator can uplod more files to the Imports folder This function is one of the features of The Surveyor in that you can have the author of the questionnaire in one geographic location the questionnaire administrator in another and the web server in yet another thereby providing distribution of these functions 4 7 3 10 CONTACT LASSO Figure 166 Sample contact web page The Contact web page of your questionnaire is there ot provide any contact information you d like your respondents to see The body of this page is entered in the Set Up gt Ancillary Pages pane of The Surveyor you can enter any text and basic html formatting that you d like in this part of the Contact page 4 7 3 11 EMAILSENT HTML When the questionnaire administrator is examining a respondent s data there is always an e mail button available so that a textual copy of the respondent s information can be sent by e mail to the default questionnaire administrator e mail address Confirmation of that the e mail has been sent is provided by the EMailSent html page which is called from the EMailSent lasso file The latter file name is the one that will appear in the questionnaire administrator s browser location field v8 0 v8 0 THE SURVEYOR USER MANUAL Figure 167 Sample contact web page shown with administrator buttons 4 7 3 12 EMAILSENT LASSO When a respondent completes a ques
140. erator Comparison Yalue Field name Operator comparison value Jump to Page Number IF GOTO OR O End Field name Operator Comparison Yalue Field name Operator Comparison Yalue Jump to Page Number ELSE IP GOTO OR DEnd Field name Operator Comparison Yalue Field name Operator Comparison value Jump te Page Number ELSE IF GO TO OR End Jump to Page Number ELSE GOTO OR End Record 5 of 98 records found from total of 98 records There are 10 pages in your survey Figure 30 Detail pane While there are benefits to having all the information on a single page as of version 8 0 this pane has reached the point at which we feel that the advantages of having all the informaiton in one place are about to be outweighed by crowding on the page It is very likely that the next ver sion of The Surveyor will remove at least the jumping section at the bottom of the page since this is only required in a very small proportion of the records for a questionnaire and is well covered by the Detail pane for the jumping records shown when clicking the detail button for a jumping record in the List pane We would appreciate your comments about the format of this page including whether we should separate the testing conditional information on the right of the page from the attributes on the left The Limits pane Figure 31 allows you to place numerical limits on the responses that may be entered into the responden
141. erator ELSE IF Field name Operator ELSE IP Overrid e JavaScript Fieldname Operator am JunmpToPagelf equals Fieldname Operator ELSE IF JumpToPagel Field name I Operator ELSE IF Jum pT oPagelt a Comparison value Fieta name Operator No Comparison value Fiera name Operator Comparison value Fiera name Operator comparison value Jumpio Page Number GOTO 4 OR DEnd Comparison Yalue Jump to Page Number GOTO OR OEnd Comparison Yalue Jump te Page Number GO TO OR OEnd Jump to Page Number GOTO OR OEnd The lower part of this layout is Tor functions inthe next version of The Surveyor Please ignore Comparison value Field name Operator Ho JumpToPagelf Comparison value Field name Operalor JumpT oPagelf Comparison value Field name Operator JumpT oPagelf Record 15 of 15 records Found fram total of 98 records There are 10 pages in your survey HACE IT LE 3 z This Field Mote Entries here override jumps based upon fields on previous pages see lower comparisons on this Surveyor layout Comparison Yalue Jumpto Page Number GO TO 4 Comparison Yalue Jump to Page Number GOTO comparison Yalue Jump to Page Number GO TO Jump to Page Humber GO TO NEXT PAGE Figure 95 Jump pane if parseFloat RadioValue 1 0 alert You will now be taken to page
142. erolo Gender Formal Ethnic Menu Label Tens Y ears We ll use the List pane Figure 32 to describe the basic fields require to define each question and header in your questionnaire There are many Figure 32 List pane with column headings and fields more function available to you and these are covered in the Detail pane section 4 2 1 1 DELETING QUESTION RECORDS While it may seem strange to start the section on creating question records the way to delete them is at the left of the List pane and we re going to work from left to right of this pane The trash can at the left of each record can be clicked to delete a question record You will be prompted to confirm your desire to delete the question record so as to prevent accidental deletion of question records 4 2 1 2 REQUIRED FIELDS If you want to be sure that every respondent addresses a particular question you should click the Reqd check box for that question s record We strongly recommend that quantitative responses be required You can use the Declined option for those respondents who do not want to answer the question The reason for the is that should a respondent not address a question with no Decline option there is no way to tell i the respondent meant a negative response or if the respondent simply missed the question This provides null values for analysis thereby diminishing the quality of your data and results If yoiu provide a Decline op
143. ersions of The Surveyor version 7 1 operates only with your external installation of MySQL and as you saw above the data collection database is created automatically by The Surveyor s web files so no more work needs to be done by you All the required security set tings were also created at the time the database was created No more work is required to get your questionnaire up and running Any browser should now be able to surf to your site and start entering data into the database The sections A Quick Tour and Tailoring To Your Needs provide full instructions for the use of The Surveyor v8 0 THE SURVEYOR USER MANUAL V rep vielet com Samp TITO CO Come Surveys SANE Help gt Abt net Privacy Figure 17 Sample questionnaire MySQL database creation reply web page v8 0 15 THE SURVEYOR USER MANUAL 16 1 4 REGISTERING THE SYSTEM No registration is required for The Surveyor 1 5 WHAT S NEW IN THIS VERSION Please see the Read Me file that came with your download of The Surveyor for this and other late breaking information 2 0 A QUICK TOUR This introduction will give you an appreciation of the structure of The Surveyor This tour assumes at least a basic knowledge of SQL and the html lan give y PP y S guage To find complete information about any feature please see the table of contents the index or refer to the contents of the Tailoring To Your Needs section
144. est them In principle any of the values you enter for questions or for the ques tionnaire formattiing can be included in the RIF file 4 7 3 EXPORT gt PAGES FILES PANE The Pages folder contains most of the files used for your web questionnaire Each page can be exported separately giving us an opportunity to describe the content and function of The Surveyor s exports We will address these files in alphabetical order 107 THE SURVEYOR USER MANUAL Record 3 of 98 records found from total of 98 records There are 10 pages in your survey Figure 151 Export gt Pages Folder Files pane 4 7 3 1 ABOUTUS LASSO You can put as much information about the author s of your questionnaire as you want in this file The Sample questionnaire has very lit tle so the page is as shown in Figure 152 You could also use this page for contact information if you d prefer not to have two pages for these areas of information In your text you can use any of the Lasso variables defined for the questionnaire Please see the Sample Surveyor database for examples of how this can be acheived The variables are defined in the Name lasso file in the Includes folder section 108 v8 0 THE SURVEYOR USER MANUAL Figure 152 Sample About Us web page 4 7 3 2 ADMINEMAILNOTICE LASSO Please pick hare Only Respondents Not Previously E Mailed Only Respondents Who Completed The Survey The most recent respondent ques
145. et deselects the choice previously made 1 e only once radio button can be chosen for each Radio field type question The gender question in Figure 58 illustrates how this might look when presented to the respondent in top bottom question orientation 4 2 1 11 10 SELECT FIELD TYPE 6 Towhich ethnic group s do you belong For strictly valid data for analysis this nultiple entry format should not be used Itis provided for completeness however for the case when one is not attempting to be scientifically rigourous Please contact us for more information about this Required English Canadian French Belgian Luxembourg French Canadian German East German West Figure 59 Select field type This field type is similar to the Menu field type in that all of the possible responses are confined to a small part of the web page The respondent scrolls through the list of possible responses and again like the Menu field type can choose only one of those responses You can increase the number of rows shown the height for the scrolling area by setting the height for the questions response The default height for the Select field is five rows 4 2 1 11 11 SELECT MULTIPLE FIELD TYPE 6 To which ethnic group s do you belong For strictly valid data for analysis this nultiple entry format should not be used Itis provided for completeness however for the case when one is not a ttempting to be scientifically rigour
146. f field on this page Figure 89 Comparison testing 4 3 21 5 OMIT FROM WEB PAGE This is a particularly useful test If the conditions of the test are met the entire question row or field if in a Group is omitted You can supply two comparisons with the logical AND OR at the end of the first line 64 v8 0 THE SURVEYOR USER MANUAL Omit From Web Page If on a previous web survey page field field then omit this field from the web survey page Figure 90 Omitting from web page By combining two identical question records but with reverse conditions you could say show one version to a male respondent and the other to a female This saves the respondent having to determine if the question is approproate to him her thereby increasing the quality of yout data 4 3 21 6 EXTRA JAVASCRIPT TESTS f Extra JavaScript Tes ts Figure 91 Extra JavaScript tests You can add tests to the limit and other checks above by adding the appropriate JavaScript code in the Extra JavaScript Tests field Note that you are adding a test to an existing IF statement so your code should begin with ELSE IF as shown in the example below else if parseFloat RadioValue 1 0 amp amp parseFloat RadioValue 2 0 amp amp document NextPage OFFANMH options document NextPage OFFANMH options selectedIndex value alert Given your answers to questions 4 and 5 your response to either or both of ques
147. ferred from The Surveyor to the SPSS data file The SPSS Value Labels Script button produces an SPSS script file that when executed in SPSS defines the value labels in SPSS It should be run before the associated Frequencies script file above v8 0 THE SURVEYOR USER MANUAL 4 7 5 8 SPSSPARENTVARIABLELABELS SPS SPSS calls its field columns variables Each variable can have a textual representation for when SPSS produces output in textual tabls or in graph formats The SPSS Variable Labels button produces an SPSS sps file that when executed in SPSS defines the variable labels in SPSS It should be run before the associated Frequencies sps file above 4 8 MODIFYING SURVEY WEB PAGES If you d like to modify the exported web pages you should be sure that you are proficient in html coding before you begin You should also be pro ficient in Lasso and JavaScript coding All three languages are used in various parts of the exported files All modifications to the automatically exported files should be done with great care to ensure that the multiple levels of subroutine calls are not affected by your changes That said any one proficient in the three languages should have little problem in making minor changes to the exported files They are constructed of code building blocks that are easily identified and modified 4 9 CREATING WEB PAGE BUTTONS The images for the web page buttons are provided in two forms The Sample Images folder co
148. finished designing your questionnaire Your licence for The Surveyor permits you to duplicate the above folder and its content as many times as you like on your development com puter so that you can define an unlimited number of web based questionnaires Please note that the single developer licence for The Surveyor permits you to run The Surveyor on this computer only If at a later date you choose to run The Surveyor on another computer your licence for The Surveyor requires that you move all your Surveyor run time files The Surveyor and its contents shown in Figure 1 and questionnaire data files Surveyor AS3 and Surveyor Field Choices AS3 in Figure 1 used for questionnaire development to the other computer and then delete the originals from the first computer The second two of these files may also be run on your development computer using your own licensed copy of FileMaker 5 or 6 but these files must still remain on your development computer This manual assumes the web server folder structure in Figure 2 for your web based questionnaires This would translate to the following URL http MyDomain com Questionnaires Sample MyDomain com Index html Index lasso Pages Includes Images Import Export Figure 2 Questionnaire folder heirarchy v8 0 3 THE SURVEYOR USER MANUAL Once you have moved or copied the downloaded folder to a convenient place on your development Macintosh or Windows PC open The Sur veyor application by dou
149. g style sheet files in the Includes and Imports folders a series of graphic images in the Adobe PhotoShop Images folder for use as buttons to be pressed by the end user at a standard web browser such as Netscape Communicator or Navigator or Microsoft s Internet Explorer Safari FireFox Camino Opera etc The images are creat ed in Adobe Photoshop for eventual use on the World Wide Web web as graphic interchange format GIF format A copy of the gif files is also provided in the Images folder folder of example support files for exporting data to SPSS The Surveyor will create your web page files to replace the examples each time you export your questionnaire for deployment 1 2 SYSTEM REQUIREMENTS 1 2 1 SURVEYOR The Surveyor itself runs under Macintosh 7 6 and up and Windows NT and up Please note that the questionnaire files exported from The Surveyor can be used on any platform supported by Lasso so Mac OS X Windows 2000 and up and Linux depending on your version of Lasso Please see the next section for details of web server requirements 1 2 2 WEB SERVER For questionnaire deployment Lasso is required so you can use Macintosh OS X 10 3 5 and above Windows NT and above and any Linux server supported by Lasso Please note that The Surveyor 7 1 uses your external installation of MySQL The Surveyor supports Lasso versions 6 and 7 up to Lasso 7 1 3 Questionnaires created with Lasso versions 6 x and 7 x will almost cer
150. he first time you create them The Surveyor allows you to run the creation function more than once and tests for changes to any existing databases as it does so Please note that if you decide to change a field name the original field in the data collection database is left intact since it is possible that you may already have data in that field Each time you run the creation function the value lists are recreated by deleting the old values and adding the new ones as shown in the middle of Figure 159 This is to ensure that your pop up results have current field labels in them Figure 159 also shows that the Lasso priv ileges for the questionnaire admin and respondent users are explicitly set so that you have no configuration to do to ensure that your questionnaire is immediately ready for action 4 7 3 6 1 QUESTIONNAIRE LASSO USERS Lasso aso a Setup Build Browse Monitor Support blueworld Global Settings Data Sources Tags Groups Users List Search User Listing Group Any User Name Status Groups 1 ANONYMOUS Enabled No Group 2 demo Enabled SurveySampleAdmin SurveySampleRespondent SurveySBCIntakeAdmin SurveySBCIntakeRespondent 3 Resp Enabled SurveySampleRespondent 4 SBC Enabled SurveySBCIntakeRespondent Showing 4 users out of 4 Figure 160 Sample web page for creation of individual questionnaire Figure 160 shows the Lasso administration page for a Lasso installation with two active demonstration questionn
151. he list with a Bs mouse click in The Surveyor Required 88 Figure 125 Related records showing separator bar formatting v8 0 THE SURVEYOR USER MANUAL 4 6 5 4 POP UP WINDOWS The Surveyor provides two forms of pop up windows The first is for showing the results of responses to a particular question The sec ond is for pop up context sensitive help you want to provide to your respondents on a per question basis During your questionnaire development you will have a good idea if you want to show any of the results of your questionnaire to your respondents only the questionnaire administrator only or to both Use the first field pop up menu in this part of the pane to tell The Sur veyor who should be able to see the results The default image button used is 11x11 pixels You can replace it with another image of the same name but you should make sure to put the image size in the fileds provided PopUp Show Results During Both Button Width Button Height Default is 11x11 Show Help es Button Width Button Height Default is 11x11 Figure 126 Pop Up window settings Even if you have specified that you want to make context sensitive help pop up windows available for some of the questions in your ques tionnaire you need to tell The Surveyor to display the pop ups The setting in this part of the pane sets whether the help is shown for the entire questionnaire As above the image can be changed bu
152. here sre 10 pages in your SUEY Figure 130 Set Up gt E Mail pane 4 6 6 1 E MAIL SMTP SERVER INFORMATION F E Mail Responses E Mail Field Hame UserEmailaddress E Mail From Samplea Videlicet cam E Mail Host videlicet com account must have relay capability and following password gt E Mail From Password EMail bec Infomwidelicet corn this field may be blank E Mail Bcc Only res Figure 131 E mail server set up The first field in this area is selected from the e mail fields that you have defined for your questionnaire You can select any of the EMail fields you have have defined in your questionnaire If you have not defined any e mail fields the default field named EMail is created in the v8 0 91 THE SURVEYOR USER MANUAL database To delete a previously selected EMail field name click on the field to pop up the menu unclick the mouse and then hit your delete key The field name will disappear and hence be deselected The E Mail From address should be the address you want your respondents to see in any e mails you send to them This address should have relay capability in your e mail server If you enter the password associat ed with the account in the E Mail From Password field The Surveyor assumes that you have password authentication enabled on the server If there s nothing in the E Mail From Password field The Surveyor assumes that password authentication is not required for sending e mails from
153. hildren This question is used to List Field 5 Marital Status Heading 5 Marital Status From this list please pick the one closest to your current Figure 141 Specifying found list columns 4 6 8 SET UP gt BUTTONS PANE All of the clickable buttons in the webpages created by The Surveyor use a JavaScript for when the mouse is over on the button and when it is off it The format of thefile names for the graphic files is ButtonNameOffoif and ButtonNameOffeif Hence when comparing the Next button in Figures 139 and 142 we see the mouse is not on the button in Figure 139 and it is in Figure 141 thereby having the effect of light ing up the button text from the point of view of the respondent Next group of respondents Figure 142 Mouse over graphic with title text 29 THE SURVEYOR USER MANUAL 100 Modern browsers also support the html title attribute of graphics such that when the mouse is on the graphic a textual label describing the function of the button can be provided to the viewer The Surveyor comes with a default set of labels These are found in the Set Up gt Admin pane and can be changed if you want to Simply find the appropriate button text and type in the replacement text The next time the text is needed in an exported file your new text will be used If you leave a field in the first column of the pane blank no pop up label will be speci fied in the html code for that button
154. hould jump to page 6 male respondents to page 10 and all others should continue the pages in sequence one has great flexibility in which questions are presented to which users This function prvides three sets of two conditional elements and a default other than the following page We have found that this is quite suf ficient for almost all questionnaires A glance at Figure 93 shows that all you have to do is read along each line to determine how to create your conditions and destination pages The Sample questionnaire has plenty of examples for you to see how this function works Note that in future versions this part of the Detail pane is likely to be let to the Jump pane since the Detail pane is becoming tight for space as we include extra functions in The Surveyor Please see the Jump Pane section for more information P x UNR WA DECIME Uer Jump To Page OYes No O Yes No o Yes No Yes No Field name Operator Comparison Value Field name Operator Comparison Value Jump to Page Number f IF GO TO OR O End Field name Operator Comparison Value Field name Operator Comparison Value Jump to Page Number f ELSE IP GO TO OR O End Field name Operator Comparison Value Field name Operator Comparison Value Jump to Page Number ELSE IP GO TO OR O End Jump to Page Number ELSE GO TO OR O End Figure 93 Specifying jump skip branching p
155. how the questionnaire web site is structured and how you can change it to suit your needs A basic template and example of a questionnaire is provided in the download of The Surveyor We have assumed that you have acquired a domain name for your survey site and that you have assigned one of your IP numbers to this domain To create your own questionnaire web site create a copy of the MyDomain com folder and follow the sections below 19 THE SURVEYOR USER MANUAL 20 3 1 THE MYDOMAIN COM FOLDER This is the home folder of your domain You should place a link to your questionnaire s URL somewhere on your home page or other page that is convenient unless of course you have good reason to keep the location of your questionnaire confidential Somewhere within your web site you should place your Questionnaires folder within which you will have your various questionnaire folders If you decide against a Questionnaires folder because you just want a stand alone questionnaire and its folder this is also possible The latter requires a very slight change to your questionnaire Set Up More details on this are in the Set Up section of this manual NN MyDomain com p Index lasso Pages Includes V Wal Index html Index lasso Pages Includes Images Import Export Figure 22 Questionnaire folder heirarchy on web server 3 1 1 THE QUESTIONNAIRES FOLDER Assuming that you decide to keep all of your questionnaires in a s
156. ic questionnaire unless the data submission inlcudes THE SURVEYOR USER MANUAL the questionnaire number and password associiated with the questionnaire to be updated 4 7 3 20 questionnaire web page to the respondent These pages are included in the Survey lasso page so that the actual page file names are never m Samples Sam ple Pages Survey lasso me Three of the fields on this page are required The two Other fields have traps to prevent them being blank when other is filled in above them This page also shows all of the possible response field types except the matrix slider and picture formats which you will find on page four Note also that the running question numbers can be turned on or off as desired Jacques Grades 1 12 NO DIPLOMA Figure 177 Sample survey web page SURVEYN LASSO Where N is the page number of the questionnaire page the SurveyN lasso files contain the html and lasso code required to display each 129 THE SURVEYOR USER MANUAL 130 revealed to the respondents All the formatting of questions response fields menues radio buttons etc are contained in these pages The JavaSCript for the questionnaire web apges are contained in the SurveyNjs1 lassofiles covered in the next section 4 7 3 21 SURVEYNJS1 LASSO Associated with each SurveyN lasso file there is a SurveyNjs1 lasso file The latter file provides the JavaScript code to provide
157. iece of paper on which your questionnaire appears in the browser window you can speci fy how wide the text and graphics should be as a portion of the paper width so that you leave a suitable margin around them Again we ve found 90 to be a good number but you may have other requirements so The Surveyor lets you set the width If you choose you can put an html border around the question response table cells of your questionnaire and you can specify if there should be any table spacing or padding these should be coded as if you were entering them into an html table statement Again the default values as shown in Figure 111 have served us well so you may find that you have no need to modify them i Web Page Table Question Table Width 90 pixels or of questionnaire page width Border 0 Cell Padding 4 Cell Spacing 2 Figure 111 Set web page table information 4 6 4 3 SPECIFYING THE QUESTIONNAIRE NAME This part of the pane lets you specify both the name of your Questionnaires level and your Questionnaire level The abbreviation should be kept to no more than about eight to ten characters The prose versions of the name are intended for where the name is used in the mid dle of a sentence whereas the others are used in browser window titles f Questionnaire Info Questionnaires Title Sample Surveys Questionnaire Name The Videlicet Sample Questionnaire Questionnaire Nam
158. ine itself is a comment that is simply typed into The Surveyor which then does all the formatting for you 29 Medication name Required Aspirin Once daily in the evenin 31 Times Taken Required once daily in the evening II Might be effective Figure 39 Web Admin for Sample questionnaire detail to show portal subject As you can see at the top of Figure 39 the Question Text for a portal helps create entries for each related record within a portal Again the need for entering the subject in the singular is evident Note how more than one question can be put into a single response space on your questionnaires web pages see Group below The Width and Height fields in the case of a portal definition record note the starting page of the portal and the ending page You can enter this by hand but The Surveyor will check and re enter these values as it performs its checks before exporting questionnaire pages Under some circumstances you are provided the option to skip this checking to speed up page export a little but we recommend against skipping the checks 4 2 1 6 EXPORT NAME Enter the corresponding name for the analysis software field in the Export Field Name column Note that for SPSS the Export Field Name should have no more than eight letters If you put more than eight characters in the Export Field name SPSS will truncate the name when 40 v8 0 v8 0 THE SURVEYOR USER MANUAL you import your col
159. ingle folder we suggest that you maintain a Questionnaires folder per Figure 22 The Questionnaires folder in the MyDomain com folder or at a lower folder level can contain a folder for each survey on your web site we will address the individual questionnare folders in the Questionnaire Folder section below The Questionnaires folder also contains the usual Pages Includes and Images folders that are used in our standard file folder structure Note that the structure of the folders is such that the Questionnaires level is the level where the top level of all of the individual surveys are intended to be seen The questionnaire level note the lack of the s is the level of the individual questionnaires Each survey folder contains its own Pages Includes and Images folders that all have the same structure as the Questionnaires folder The files in the questionnaires level Includes folder contain code and variables that are used as building blocks by Lasso to create and format the pages for the questionnares level web pages which are held in the Pages folder v8 0 v8 0 THE SURVEYOR USER MANUAL The home pages for the Questionnaires folder and all folders inside it are assumed to be named Index lasso rather than Index html since to present complete web pages to the respondents users these pages must be processed by Lasso before being sent to the respondent 3 1 1 1 QUESTIONNAIRES INDEX LASSO FILE This page like all of
160. ion you can sort the records by cliucking the underlined Pg column heading If you compare Figure 32 and 33 you will see how the first six questions are defined and subsequently presented to the respondent in web page format If you add or delete question header records manually the numbering for the records of a particular page may not be consecutive even though they are in sequence in the List pane To correct this click the blue Ord column heading The found records will be numbered from 1 up to the number of found records You ll notice that in the Sample questionnaire and as shown in Figure 33 that one can have both a top bottom and a left right presenta tion of the questions and responses on the same page Questions 1 and 2 illustrate this well They are only shown this way to demonstrate the different presentation possibilities You would not normally have different presentations for questions that are so alike You can set the default orientation for questions responses in the Set Up gt Question Format pane of the Surveyor and can be overridden on a question by question basis in the Detail pane For more on this please see the appropriate section of this manual 4 2 1 4 ORDER ON PAGE 4 2 1 5 FIELD NAME The Field field is used to both name your data entry fields and lets The Surveyor provide you with a way to perform special functions such as page headers and non question text header text on the web pages The Field name i
161. ires level web pase 13 inclusion of the PageFooter lasso page to insert the footer information that appears at the bottom of every Questionnaires level page in this case most likely the copyright notice 14 final html closing statements like the end of body and end of html instructions 21 THE SURVEYOR USER MANUAL Note that all of the lasso web pages are constructed in a similar fashion This building block approach provides for a consistent look and feel across the Questionnares level web pages and a very simple and easy to maintain means to make formatting changes across the entire Questionnares level pages in a single place For example if the page background colour needs to be changed for all the Questionnaires level pages it simply has to be changed in the PageBackground lasso file once This will change the background of all the Questionnaires level pages It s an instantaneous single change that results in a significant saving of time and effort when formatting changes are required ADE Videlicet Sample Surveys lt gt G W http videlicet com Samples Videlicet Please choose the survey you d like to try by pressing the associated button The Surveyor sample Mixed question response orientation Please note that this is only to show the differences and possibilities of the appearance of the orientations on the web page One would not normally set pages up this way Figure 23 Sample Q
162. it the visible copyright information from your web pages but there will always be a hidden copyright to help protect your rights web Page Copyright Ho Copyright TrevorH Jacques Copyright Date 2002 2005 Figure 117 Setting up your copyright information 4 6 2 8 WEB PAGE FOOTER SETTINGS At the bottom of all of your pages you can put a footer for information such as the copyright of the text of your questionnaire see also the next section The footer contains the link buttons to the various questionnaire web pages textual links to pages of interest and the copyright information for the questionnaire Currently the footer links are links to the Videlicet domain since this function simply requires a simple cut and paste of the URLs for the links Please examine the FooterLinks lasso to see how this works should you want your ques tionnaire web pages to have textual footer links If you want this information to show on the web pages select Yes for the Footer Links pop up menu this part of the pane Web Page Footer Footer Links Mo Page Footer Override Figure 118 Web page footer settings 83 THE SURVEYOR USER MANUAL o4 If you want text other than the automatic footer enter it in the override field Note that you should include a lt body gt and lt html gt at the end of your override code Generally you will not need to override the default Surveyor footers since there are already lo
163. ith Matrix Text choices 55 THE SURVEYOR USER MANUAL Figure 71 Sample questionnaire with Radio button choices English U K English Canadian French Belgian Luxembourg French Canadian German East German West Figure 72 Sample questionnaire with Select menu choices 4 2 1 15 MENU LABEL When using a Menu field type the empty response is set in the Set Up gt Question Format pane You can override this by typing the text you d like shown to the respondent in the Menu Label field of the List pane The upper part of Figure 73 shows how the Sample question naire uses the text Times Taken to prompt the respondent about the purpose of the pop up menu The lower part of the figure shows how menu items look once the respondent has chosen a response Note that in the latter case two responses were asked of the respondent whereas the former case only asks for one Times Taken Once daily in the evening TF Might be effective DE Figure 73 Web menu labels 56 v8 0 v8 0 4 3 DETAIL PANE THE SURVEYOR USER MANUAL f Useves Web Width Override Question Text Response Type Response Width characters Display Field Lasso Code 4 Pop up Help Context Sensitive Help Text Mir Ta E Mail of Results Exclude Header Text Number of pages in the questionnaire 10 Number of questions inthe questionnaire 11 On page 1 this field is at pos
164. ition 5 andis question number 3 FieldName AgeDecade Export Field Name AGE Required Yes Orderin Group Begin EMail Write Group Separator No Same Question Number as Previous Yes Same Matrix as Previous Yes Question Orientation Default Alignment Default Override Max Pictures Wide Please enter your age here This is an example of many fields collected as part of Menu Menu Label Tens Response Height rows Zero to Nine Defaull Yalue 0 0 a A 4 2 12 3 3 4 y 5 5 6 16 7 y 8 g Exclude Record Fxclude Menu Label Pop Up Results Button Yes SPSS Data Type Format AGE Precision F Jump To Page Fier name Operator r Comparison value A Field name Operator Comparison Yalue FELSE IP Field name Operator Comparison Yalue ELSE IF PELSE Field name Operator Field name Operator Comparison value Jump to Page Number Field name Operator Comparison value Jump te Page Number Field Information 01 08 2005 16 45 40 Trevor CommentsiNotes C imi A I Web Limits Check Choice text AgeDecade gt To 1 i AgeDecade lt To 7 7 g Empty Test If on this page field _ field then the current field must be empty a Not Empty Test If on this page field field then the current field must NOT be empty F Comparison Test If the current field is not empty then it must EE the value of field onthis page omit From Web Pag
165. kes The Delete button allows the adminstrator to delete the main record and its associated related records The E Mail button will send a textual copy of the respondent s entries to the default e mail address for the questionnaire administrator 4 7 3 35 SURVEYREVIEWLIST LASSO When the questionnaire administrator searches for a set of respondent records in the data collection database from the Administer Ques tionnaire Data web page a list of matching questionnaire records is displayed if applicable The form of this list is specified during questionnaire development in the Set Up gt Admin pave of The Surveyor The fields and their columnar positions are determined in that pane of The Surveyor The Sample questionnaire produces the format shown in Figure 193 Clicking the link buttons in the rows of the list or the textual links if that is the formatting will take the administrator to the individual questionnainre to be put under review See the next section for the reply page to clicking the individual link buttons v8 0 159 THE SURVEYOR USER MANUAL 140 List Records 1 to 5 of 11 Found FirstName LastName Gender Children Marital Status Fred Bloggs Female No Divorced A Mary Contrary Uncertain AIO Polvamorous E Jenny Craig Female INO Legally married r Dude Foo Female Yes Living together 2 or more years Common law Trevor Jacques Mate Yes Single Currently no steady girl boy friend Ed Back Next
166. lahblahblah Respondents lasso Figure 158 Sample MySQL data collection database creation web page The next two fields are for the Lasso administrator user name and password You may need to speak with your Lasso administrator for these ot have the Lasso administrator enter them for you You need the Lasso administrator information because you will be creating a new MySQL database and that is part of the responsibility of the Lasso administrator This information and this web page are needed only once for your questionnaire set up After that you can delete the file The last field on this page is so that you can import a file of respondents from the Imports folder if you already have that file prepared at the time of creating your data collection databases You can send e mail to those imported questionnaires with an e mail address by using the E Mail button at the bottom of each Admin area page The Surveyor will provide you a detailed record of the database creation process Please see the next section for details of this web page v8 0 113 THE SURVEYOR USER MANUAL 114 4 7 3 6 ADMINMYSQLREPLY LASSO lv tp videicet com Samples d Sam iple Pages i Admi iminMySQLRepy CD E O The table Sample already exists The table Sample already has an index on field UserNumber The Sample table UserNumber field has been successfully updated The Sample table UserPassword field has been successfully updated The table
167. lasso contains the required JavaScript code for buttons on the survey web pages created by the FileMaker tool This is the place you should add the appropriate JavaScript for any survey related buttons that occur on all of the survey lasso pages Other than home page links this file creates two sets of buttons one for respondents and one for the questionnaire administrator The administrator has no need of the regular buttons since they contain only links to help web pages 4 7 4 5 JAVABEGIN LASSO This file is called by almost all of the web pages to set up the JavaScripts needed on all pages It opens the lt script gt statement but does not close it The latter function is performed by the JavaEnd lasso file 4 7 4 6 JAVAEND LASSO This file is the complement to the JavaBegin lasso file and serves to close out the lt script gt statement for the JavaScripts used on all ques tionnaire web pages 4 7 4 7 METAS LASSO This file is one that you might want to modity It contains a default set of html meta tags fot your questionnaire Like al groups of meta tags it is designed to help both browsers and web spiders do their job Speak to your web site administrator if you don t know about html meta tags 4 7 4 8 MYSQL CHILDFIELDS LASSO This is a list of the fields related to the main questionnaire that are for the portal questions of your questionnaire They are used in a Lasso script that is called when your realted database is c
168. lease type in the password you d like to use please use only alphanumeric characters i e a z A Z and 0 9 Fd Back f Next p Figure 180 Sample respondent questionnaire creation web page This page is presented to respondents who have clicked the Start New button on the questionnaire home page assuming that you specified that you wanted that button shown on the home page The advantage of this method is that the respondent can choose his her own pass v8 0 131 THE SURVEYOR USER MANUAL 132 word and so is much more likely to remember it The disadvantage is that it is arguably less secure since the password may be used by more than one respondent The Surveyor will generate a random questionnaire number for the questionnaire This albhnumeric number will have the number of char y 8 q q p acters that you specify in the Set Up gt Server pane of The Surveyor database The user will only be asked for an e mail address if you specify it as a question in The Surveyor database 4 7 3 24 SURVEYCREATIONREPLY LASSO Figure 181 Sample respondent questionnaire creation confirmation web page When a respondent has created his her own questionnaire by entering a password in the SurveyCreation lasso web page above success ful completion page is presented with both the questionnaire number and the password supplied by the respondent This is the only time this information is provided on a web page to a
169. lected data into it thereby effectively renaming your field This could be a problem if the resultant field name is the same as another Export Field name in your data collection database Hence we strongly recommend using the eight character limit for this the names you put into this field You ll note that the heading for this field is underlined Clicking the heading label will sort the found question records by the Export Field name This sorting label is also present on the Detail pane 4 2 1 7 GROUP In Figure 37 you will see that page items 7 and 8 have a Begin and End for their Group Any contiguous series of question records with the Group field not empty will be considered as a group of responses to be put into a single web page response block The result for these two responses can be seen in Figure 39 where the response type is pull down menu Field types are covered in the Field Type section below You can put as many question records in the group as you want The first in the groups should have Begin in the Group field and the last should have End For the question records between the Begin and End you can use any of the provided CentreX Group names The Surveyor will always sort the intervening fields by their Centre selection Each time The Surveyor comes across a Begin Group name it assumes that a new block of grouped responses should be implemented on the web page The Group function can be very useful in the cases such
170. lick interface of The Surveyor There is not need for you to code any of this 4 7 3 22 SURVEYADMINSECURITY LASSO Figure 179 shows the questionnaire administrator log in web page The user name and password supplied at the time the data collection databases were created should be entered here to gain access to all the admin area functions such as Import Export E Mail of messages questionnaire reviews etc If the name and password are correct the adminstrator is taken to the Admin questionnaire review web page If they are not correct an error is displayed and the adminstrator is asked to try again Any attempt to go directly to an admin area page with out the browser having been authenticated will cause the browser to be redirected to the Security Check page v8 0 THE SURVEYOR USER MANUAL Security Check Please type in your name and password Name Password FA Back f tasso gt Next PA Figure 179 Sample Admin login and security check 4 7 3 23 SURVEYCREATION LASSO Create Questionnaire QUESTIONNAIRE CREATION To begin your survey please provide a password below This password will ensure that only you have access to your survey It will also allow vou to return if you wish to complete your survey at a later time If vou forget your password or questionnaire number and want to come back to your survey please DO NOT start a new J rs F 1 F questionnaire Please contact us to obtain this information P
171. lumn see Figure 36 This should be without spaces Note that The Surveyor will remove any spaces when it exports files for your web site If you click the field name for a particular question header The Surveyor will pop up a list of spcial field names see Figure 37 If you do not want one of these special fields described in the next sections just click the field again so that you can type your field name into the field on the List pane The pop up list will also appear if you tab into the Field field With the exception of the special Field names you should not allow the Field for a question to be a duplicate of another You will be prompted if the first twenty characters of your Field name are the same as those of another question record you should either change the current Field name or make sure that the duplication is only in the first twenty characters Also with the exception of the special Field names the field name is used in html forms and JavaScript alerts of your Questionnaire web pages that are exported by The Surveyor To find all the records with duplicate names click the magnifying glass button and then enter an exclamation mark in the Field field and hit the Return key on your keyboard You will be shown a list of all questions headers with duplicate Field names sorted by page You ll note that the heading for this field is underlined Clicking the heading label will sort the found question records by the Field name
172. main no spaces Chars In Questionnaire Number no spaces A Seed AlphaNumeri fill this box with 128 random alpha characters Relative to domain folder Do not 1 Samples Seed Numeric fill this box with random numerals Samples Sample Samples Sample Pages Samples Sam ple lmagest si SamplestSamplefincludest Respondent Timeout Samples Sarnple lmportst Samples Sample Exports Samples Sample Surmmariest Analysis 1 For Lasso 8 Usually 1 4 LassoMySQL 1 MySQL usually 4 mysql LassoMySQL lasso internal MySQL usually mys qi Analysis Tool Export Display Fields Default is database name This pairis not seen by respondent but chould be changed for each questionnaire SampleResp SampleRespPassword Record 4 of 98 records found from total of 98 records There are 10 pages in your survey 2909009940 Admin Buttons Password Yes 6 Enter here or in the Admininfo lasso file FI GgHh6iJjbKkLMr25sTt Uu v9Wwxxe8y vzz amp au v9 wXx8vYvzzAd8EaBbMm4NuVnoPp3QqRr25sTE TUSG qRr 28sTE IUvSWVvXx8Yvzz amp aBb9CcDd8p3QgqRr2SsTE Uy V v9VWwxxaYvzz amp aBb9FgHhbiJi5KkLMm4NnoPp3G qRr2S sTtx8v yz tUuVvSEWKkLMEd8eCEwyZz amp aBbSCcDd8EeFf TGgHhbiJibSK amp aBbSCeFf7Ggt 1Uu2Ssmd4NnoPp3G qRr2 SsTTt fUu VkLMm4NGg Yvi Ww oPp3G qRbSCcDdKAaB bS8CeFfnx8vyzaBb9SFE7 GgHh5iJjiSKkLHh6iJib Kk LTE Uu VkLMm4Ninx yZaB b 9 Ff 7z amp hBiJibKeFf 7G gHhG gHzhbi JibKeFf GgHh
173. mbers can be turned on or off as desired ra 1 7 O er Grades 1 12 NO DIPLOMA nglish Canadian French Belgian Luxembourg French Canadian Figure 33 Sample questionnaire web page PAGE HEADER RECORDS vide this extra formatting of your page header text 36 v8 0 v8 0 THE SURVEYOR USER MANUAL ATQ Google This is the first of two could be more pages for a single child record Additional child records can be added once the last page of many has been reached For each prescription medication you are currently taking piease enter the following information note that if you answered Male or Transgender on page one a question about effectiveness will not appear This line itself is a comment that is simply typed into The Surveyor which then does all the formatting for you Once daily in the evening Might be effective Page 1 Menu Select and Text Fields Text Boxes and Radio Buttons Page 2 Slider Fields Skip Patterns and Conditional Testing Page 3 Child Records and Context Sensitive Help for Each Question Page 4 Matrix Likert Fields Page 5 Multiple Page Child Records Page 6 Multiple Page Child Records cont Page 7 Sum of Several Fields Page 8 Display E Mail and Text Box Fields Page 9 Picture and Interval Scale Fields Page 10 Matrix Presentation both text and value headings ione Gran CE Tasso Co Cup import EMI Chii Cort logo
174. mentsiNotes On page 1 this field is at position 5 andis question number 3 Web Limits Check Choice text Field Name AgeDecade AgeDecade To 1 i Export Field Name AGE Required Yes AgeDecade lt To 7 7 Orderin Group Begin EMail Write Group Separator No C Empty Test If on this page field Same Question Number as Previous Yes Same Matrix as Previous Yes field Question Orientation Default Alignment Default Width Override Override Max Pictures Wide then the current field must be empty Question Text Please enter your age here This is an Not Empty Test If on this page field example of many fields collected as part of field Response Type Menu Menu Label Tens Response Width characters Response Height rows then the current field must NOT be empty Display Field Lasso Code Comparison Test If the current field is not empty then it must Zero to Nine Default Yalue the value of field n nti 1 2 2 313 4 4 5 8 15 6 1 17 8 B on this page 4 E Mail of Results Exclude Record __Fxctude Menu Label Omit From Web Page If ona previous web survey page field Exclude Header Text field f di Pop Up Results Button Yas then omit this field from the web survey page Context Sensitive Help Text Extra JavaScri pt Tests SPSS Partially Maybe Uncertain Data Type Formal AGE Precision OYes amp Nd DYes amp Nd O Yes ONd DNK NIA Decline Other Jump To Page OYes amp Nd OYes amp Nd OYes ONG OYes amp Nd Field name Op
175. mple if you have a Yes No Choices list it will probably be used many times in a multi page questionnaire The download contains many sample lists both to speed your development and show you examples of what is possible You can select a choices list for each ques tion in the List pane and in the Detail pane Figures 68 and 69 show how the Choices lists are displayed in the List pane and how the pop up shows the current list of Choices lists that you have defined in the Field Choices database You can simply select the Choices list you want and all of its choices and values are auto matically associated with the question If you change the Type to a Field Textbox header or other non numeric record type any choices list previously select for that question is simply ignored Some examples are shown in Figures 70 to 72 v8 0 v8 0 THE SURVEYOR USER MANUAL 666006 60 mx m X EX Hx mx Bx Bx gx gx it Ma Bx mx mx E RS p UseHqdPg Ord Field Export Name Grow GuestionText Type Bx 1 PagHewerex home Select and Text Fields Tet 0 al 1 2 HeaderTex Al Three of thefields onthis page are required li GRE 3 FirstMame NAME ei 1 Please enter vour first name here Field 15 X 1 4 LaslName NAME 6j 2 Please enter yourfamilyname here Field 15 5 jAgeDecade AGE Begin 3 Please enter yourage here Thisis an example Menu Zeroto Tens x
176. n v8 0 155
177. n Figure 102 as 1 v8 0 THE SURVEYOR USER MANUAL If you are using LassoMySQL for data collection the DataSource Connector ID should also be 1 In this case the Default MySQL Data base Name should be lasso_internal no quotation marks If you want to use an external installation of MySQL you should obtain the DataSource Connector ID and Default MySQL Database Name information from your Lasso administrator and enter them in the appropriate fields of The Surveyor in the lower highlighted area in Figure 9 Normally these would be 4 and mysql no quotation marks respectively These values and a few other useful ones are avail able in the pop up menues in the pane If your MySQL administrator has removed the mysql database that are installed in the standard MySQL release you will have to choose Other for the Default MySQL Database Name and enter the appropriate name manually Note that communication with the external installation of MySQL must be working before you attempt to create your questionnaire database and tables If futher security is desired for the Lasso MySQL communication your Lasso and MySQL administrator s should set the appropri ate user names and passwords Please see the respective manual s if you don t know how to do this d Lasso d Site ID 1 For Lasso 8 Usually 1 DataSourcefConnectorID 4 LassoMySQL 1 MySQL usually 4 Expo Default MySQL DB Name rs ql LassoMySQL lasso internal MySQL
178. n Yes Humberto PasswordhHo EMail es Include Admin Button Yes Include Lasso Button Yes Figure 116 Showing and hiding web buttons If you want the questionnaire administrator to be able to create questionnaires you should decide whether creating questionnaires with this questionnaire web page should require the administrator to enter the question number password and or e mail address If you select No for any of the three fields to the right of this part of the Set Up gt Web Page Format pane The Surveyor will not show the fields in the cre ation web page In this case the number and password will be randomly generated by The Surveyor as it adds the record to your data collection database Selecting No for the E Mail address simply creates an empty field for the e mail address in the database Depending on how private want your questionnaire you may not want the Admin area revealed Again selecting the No option will remove this button from your questionnaire s home page Equally as the questionnaire database administrator you may not want the MySQL Lasso button to the MySQL database creation page to be visible to your questionnaire administrators Selecting No will remove this button from the Admin area security page and the row of footer buttons 4 6 2 7 COPYRIGHT SETTINGS Figure 117 shows where you can enter the name of the owner of the copyright of your questionnaire text and the date of the copyright You can select to om
179. n the questionnaire administrator reviews questionnaires v8 0 v8 0 THE SURVEYOR USER MANUAL All of the field types have their data checked for validity at both the browser and the server They are checked at the browser to provide val idation information in the form of JavaScript alerts to the respondent They are performed at the server to ensure that a malicious web site cracker does not try to hijack the web form and submit bad data and or malicious code to the servet Three of the fields on this page are required The two Other fields have traps to prevent them being blank when other is filled in above them This page also shows all of the possible response field types except the matrix slider and picture formats which you will find on page four Note also that the running question numbers can be turned on or off as desired English Canadian French Belgian Luxembourg French Canadian German East German West Figure 41 Sample questionnaire web field type examples 4 2 1 11 1 CHECKBOX FIELD TYPE A checkbox selection response is similar to the radio button but it allows the respondent to select any and all of the possible respons es to a question We include this field type for reasons of completeness but we strongly recommend against its use because in terms of the quality of your collected data there is no way to differentiate between for example a null response and a negative response Fig
180. n the text has to be used elswhere You can include basic html code in the Question Text field for text headers so that you can add extra formatting to your text if required You can use the html pairs lt i gt lt u gt lt b gt lt h1 gt lt h2 gt and lt h3 gt to provide this extra formatting of your question text You ll note that the heading for this field is underlined Clicking the heading label will sort the found question records by the Question Text This sorting label is also present on the Detail pane 41 THE SURVEYOR USER MANUAL 42 In the Question Text column see Figures 36 to 38 type the question you d like to ask of the respondents in for form that you d like it to appear on their web browser This should be a copy and paste of the question in your survey instrument When you have a group of response fields records in the Fields database you should only enter the question text in the first record of the group Any bolding or italics that you d like in the question should be entered in html not in FileMaker bolding or italics Note that if your questions are normally presented in bold text using the global page formatting set up then to bold text here you will need to unbold it and then bold it at the end of your bold text This way your bold text will stand out from the rest of the question by virtue of its being not bold You can add a special record to the Fields database to give you
181. nding F f List e From this page the questionnaire administrator can use the upper web form to search for a specific questionnaire number in the data col lection database From the lower form the administrator can create much more complex search parameters to find a set of respondents which are listed in the reply page per the specification in the Set Up gt Admin pane of The Surveyor The fields from which the adminstra tor can choose are determined by the settings you make in the Set Up gt Admin pane of The Surveyor The format of the selections on the right of the web page are also determined in that pane Where possible The Surveyor picks pop up menu selections appropriate to the type of data for the field chosen Hence you ll only see contains for textual fields 1 e the Field and Textbox fields 136 Figure 187 Sample Admin questionnaire review search web page v8 0 THE SURVEYOR USER MANUAL If you choose radio buttons for the presentation The Surveyor adds a Blank so that you can search for records that equal blank i e search for only records with nothing in this field 4 7 3 29 SURVEYREVIEWN LASSO These pages where N is the number of a related record portal is used to format realted record pages when a questionnaire administrator reviews records realted to the main questionnaire record Each of these files corresponds to associated SurveyN lasso page The SurveyRe viewNlasso pages are in
182. ng your questionnaire As you can see from Figure 17 there is a great deal of detail in the reply web page This is so that you can easily debug should there be a problem Note that at the bottom of the page there is confirmation of any respondents that have been imported from the File your specified in the last field shown on the web page in Figure 16 If in the case for Figure 17 you had specified a file of respondent records The Surveyor will tell you about the file type and how many respondent questionnaires were created in your data collection database Once the reply page is shown to you your questionnaire is live and available for use by anyone who browses to the questionnaire home page To test it you need only click the SAMPLE button and act as a respondent by creating finding a questionnaire Note that you will likely want to change the text of the SAMPLE button to something specific to your questionnaire The same is true for the questionnaire administration area of your questionnaire To get to the Admin area simply click the SAMPLE button to go to the home page of the questionnaire per Figure 14 and then click the Admin button and enter your questionnaire administrator name and password as entered when you created the databases using the web page in Figure 16 That s all there is to testing your installation of The Surveyor and the Sample questionnaire 1 3 4 CONNECTING THE WEB SERVER TO THE DATABASE Unlike earlier v
183. ngs allow you to specify how your Admin page text and backgrounds will look as well as the introduction pages of the question naire These attributes are different from the question and response text background attributes of the quesitonnaire web pages themselves Use normal html hexadecimal triads to specify the colour as shown in Figure 114 F Questionnaire Bn dy Face Palatina Times Times Roman Times New Roman Color 333333 css Size 10pt Back ground Color 88B8FF Figure 114 Body Text and background settings 4 6 2 6 QUESTIONNAIRE HEADER SETTINGS Each part of the web questionnaire pages can be tailored to provide the overall look and feel of your questionnaire The questionnaire head ers specified in your PageHeaderText and HeaderText records will be shown with the attributes shown in Figure 115 h Questionnaire Headers Face Futura Book Futura Bk Helvetica Arial Verdana Color 333333 css Size 10pt Header Background EBEBEB Alignment Centre Figure 115 Header settings 4 6 2 7 QUESTIONNAIRE WEB BUTTON SETTINGS If you intend to use the Admin area of your questionnaire to Upload and Import or individually Create questionnaires for your respon dents you will not want a Start New button on the home page of your questionnaire Simply choose No from the first pop up menu in Figure 116 to do this v8 0 v8 0 THE SURVEYOR USER MANUAL d Web Buttons Admin Start New Requires Include Start New Butto
184. nheritance is from the question number font attributes rather than the question font attributes The first field in this group however is unique to the subquestion numbers You can select from abc xiv in both lower case and uppercase The maximum number of subquestions is 52 34 Actual work 90 CI 36 Writing Figure 121 Sample completion bar in a questionaire web page 4 6 5 2 RESPONSE FORMATTING With the exception of the last two fields in this group the formatting settings for Responses are the same as for the Question formatting i e you can specify the face colour and text size for the text in the Response part of your web pages These settings are put into the Style css folder in the same manner as the Question format settings The Matrix Value Format pull down menu shown in Figure 122 allows you to put matrix values next to your Matrix Value radio buttons on the web page and have the extra selections separated from the Likert values by an extra column in the matrix Please refer to Figure 123 for examples of what the formatting looks like in Plain and Values formats The exmaples in Figure 123 are for left right orientation and the format change is similar for the corresponding matrix selection in the top bottom question response orientation f Responses Text Face Palatino Times Times Roman Times Nes Roman Color 333333 css Size 10pt Background Colour 1 DDEBFF Background Colour 2 D ES3FF M
185. nt dead in rames 4 Splash scicen tor Tue SULVC OL 1o pte eode ates e ERI LP RU NE OOS eee wate oe 4 E Ae s aie tak eausa dit dot made teen ui et uis 5 Set Up Dane o oos e PARED SA vele ha a ders n A DRIN ACE HN E OA rete a o Bee 6 Seb Lp Password pane wid tate dau qo SNA AS 6 Chance password Halo pue srd VR RE due ooa dS A Eb ds n DeL Dp Server Pane cies eae E debts us bo ecc eg does 8 IR DOLD PAra pies ina da pale ee en idet exam br eta eet 9 Multi file batch search and replace dialogue in BBEdit 9 MOVING exported les tothe web SEC 4a eaceteea s eot qe pee aret beoe dos eei 11 5Sample questionnaite home Web paso o6 d sti o kem sei irreal dees 12 Sample questionnaire home web page Admin button 12 Sample questionnaire admin security check web page 13 Sample questionnaire MySQL database creation web page 13 Sample questionnaire MySQL database creation reply web page 15 IDevelopinecmuliiple euesttODPBalfes 25 1 ea ded bo batch e PUR aes totu et e RE Ad 16 TSE AM A AM depu qos E EE E EE ENN E E A edd due Deb nep dan es ed 17 FI Choices Dail Panes PET 18 ID velopins questtonbidlteS sais dnt ati tins eee CN SLT PERS ese domes 19 Questionnaire folder heirarchy on web server 24 ere Sods od tus eR his oen 20 Sample Questioniaites level Index page vasa ba data AAA IE PER ets 22 Webi pace Dutton examples ss veste duo
186. ntains a set of gif images that should get you going immediately with the default buttons and page header backgrounds The second form is PhotoShop files The GIF images that appear on the web page are flat and transparent in that they have no layering of their internal elements and that the unused ortions of the rectangles that contain the images are set to the colour transparent The transparency allows the web page elements under these P 8 8 P P y pag ortions of the images to show through to the respondent P 8 8 p The second form of the images is in layered Photoshop files Version 6 0 of Photoshop or better is recommended to use these images you should be familiar with Photoshop version 6 0 or better before attempting to modify these psd image files If you d like to modify the provided buttons simply edit the psd file backgrounds Layer 1 and the text layer in these files as you d like save them and then save a GIF copy for the appropri ate questionnaire web Images folder You will then be able to call the image into any location on the web pages for that level of the System APPENDIX A EXTERNAL MYSQL DATABASES Lasso can connect to external MySQL databases i e non LassoMySQL in two ways 1 directly through the MySQL connector or 2 indirectly using the JDBC connector Figure A 1 and Figure A 2 show the Lasso Administration pages for the MySQL and JDBC connectots respectively Note that the ID of the conne
187. o make the change as you start to enter the records for your new questionnaire and then never visit these fields again for that particular questionnaire The last two fields in this part of the pane allow you to set up separate timeouts for the cookies that The Surveyor sets in the browser of the respondents and the questionnaire s administrator s These cookies will expire at the time you set which will require the person to log back in again when he she tries to load another web page related to the questionnaire or in the case of the questionnaire administrator s the Admin section 4 6 2 5 ANALYSIS TOOL The Surveyor will export set up scripts for SPSS Export of other scripts can be made available by request Analysis Analysis Tool SP55 Export Display Fields Yes Figure 105 Setting up for analysis of your collected data v8 0 THE SURVEYOR USER MANUAL You can specify whether the web pages will show a pull down menu that allows your questionnaire administrator to select whether The Sur veyor should export the results of your Diusplay field Lasso calculations to the file for your analysis software Just choose Yes or No for the Export Display Fields in the Analysis part of the pane Note that the results of the calculations will be exported to both the numerical and the text export files If the result of the calculation is not numeric The Surveyor will export nothing to the numeric file for that field of that questi
188. og Off button be since the logging off will have been accomplished as the page was displayed to the respondent From the respondent s point of view this is the end of the questionnaire If however the questionnaire has been divided into two parts the questionnaire administrator would be shown the subsequent page rather than the Thnk You page to permit complettion of the second part of the questionnaire v8 0 141 THE SURVEYOR USER MANUAL 142 Figure 196 Sample questionnaire thank you web page with e mail button 4 7 3 12 WRITEQUESTIONNAIRE LASSO At the bottom of each questionnaire page in the Admin area is a selection menu and button for jumping from page to page Figure 197 Next to the Jump to Chosen Page button are two buttons that allow the questionnaire administrator to send a textual summary of the cur rent respondent s data to the default administrator e mail address or to a file and then e mail that file to any address Page 1 Menu Select and Text Fields Text Boxes and Radio Buttons LR Ad Figure 197 Administrator E Mail Write and Jump to Page buttons Clicking the E Mail button sends the e mail immediately and presents the adminstrator with confirmation and a simple Back button to get back to the previous page Clicking the Write button however presents a web page Figure 198 for the administrator to name a file for the summary determine whether to overwrite
189. onnaire Lag off by deleting my Soto next page Our privacy statement Sheet my questionnaire Home page for Gotothe surveys home Goto selected E mail exported data file to E mail this notice t Mest group af Heview all thechild Save mw entries Deletethischildrecord Delete this Upload text file of Record 1 af 14 records found from total of 99 records There are 10 pages in your survey Archive Fran ais plus d informations sur Administrez les Ala page precedente Fournous contacter Cr erles bases de E mailles r ponses Exportez les r ponses J ai besoin d aide Alapage d accueil Cr ezles bases de Enum rez les Trouvez questionnaire Quitter en supprimant Ala prochaine page Notre avis de Commencez man Ala page d accueil la page d accueil pour Ala page choisie du Par E mail envoyez moi E mail cette notification Montrezle prochain Passez enrevue toutes Enregistrez mes Question Format Deutsch Arc hiv Mehrinformatian ber ben Sie die Antworten Zur ck zu der vorigen Kontaktinfomatian en Stellen Sie die E mail die Antworten zu Expartieren die Ic h benatige Hilfe Zur Startseite F r Stellen Sie die Verzeichnen Sie die Finden Sie den Beendigt durch das zZurfolgenden Seite Unsere Beginnen meinen Zur Startseite F r Zur Startseite f r die zur vorgesvahlten Seibe Durch E nail schicken E mail diese Mac hricht Zeigen Sie die Falgende
190. onnaire If there are no portal pages only the parent files are needed exported The purpose of these files is to save you time as you prepare your SPSS database from the data exported by The Surveyor from your collection database The files perform the functions of specifying the data fomats for each of the SPSS variables adding the text for the variable labels i e the text of your questions for use in graphs etc and value labels text for the appropriate textual representation of each possible response to the numberical values in the SPSS database i e the equivalent of the Choices correspondences from The Surveyor itself The last of the sps files the Fre quencies file allows you to perform quick data integrity checks v8 0 THE SURVEYOR USER MANUAL Record af records found From total of 99 records There are pages ir your survey Figure 202 Export SPSS Folder Files pane 4 7 5 1 SPSSCHILDDATAFORMATSSCRIPT SPS The SPSS Formats Script button produces an SPSS sps file with the code required to define the field data types within SPSS Unless you ve specified otherwise for individual questions the default data type and values are used in this file Running this sps file in SPSS saves having to manually enter these data or manually create the script file itself All fields for the related questionnaire data collection database that are the result of a numeric response i e they use a Choice list
191. onnaire This prevents text getting into a database designed to do analysis of numbers The textual export will have that textual result of the calculation so your data are always exported 4 6 3 SET UP gt ANCILLARY FILES PANE There are several web pages in any questionnaire where you want to send information about the questionnaire and the authors of the question naire to your respondents The Set Up gt Ancillary Files pane lets you enter this information and decide which of the standard pages you d like your respondents to be shown Figure 106 Sample questionnaire home web page For these pages alone you can set a different background image or colour for the text block of your text It does not have to be the same as the text backgrounds for your question and response web pages This information is entered at the top left of the pane Your introduction to the questionnaire should go in the Index Page Text field and will appear when the respondent surfs to http MyDomain com Questionnaires Questionnaire as shown in Figure 107 You can include simple additional html formatting and JavaScript code in this field to tailor the look and feel of the page The Sample in the download of The Surveyor illustrates how Figure 106 was created including the JavaSrcipt created e mail address to help prevent e mail address harvesting by uncrupulous spammers Notice that for the sake of convenience we have provided export buttons for
192. or You should set up two separate virtual domain records one for MyDomain xxx and one for www MyDomain xxx to ensure that everyone can visit your site The web server s default index page names for this domain should include Index html From this point all visitors who surf the web to http YourDomain xxx Questionnaires Sample or whatever you have chosen for the URL to your questionnaire will be shown the survey s home page Test that you arrive at the page shown in Figure 13 with your own browser before proceding further v8 0 THE SURVEYOR USER MANUAL 3 The Surveyor The Surveyor Surveyor AS3 Surveyor Field Choices AS3 Opa Import Export SPSS Surveys Pages Example Scripts one level up Import Files et eiie Pr tl d Nas sonha E Va us men Net be Pape 4 E Pee mas Error html waite ris rms M Index html Index lasso Developmentomputer 3 MyDomain com A L 3 Questionnaires 3 WE Questionnairel 3 Questionnaire2 Index html Index lasso Pages Includes Images Import Export Web Server Figure 12 Moving exported files to the web server 11 v8 0 THE SURVEYOR USER MANUAL d CY d N N Figure 13 Sample questionnaire home web page 1 3 3 DATABASE SERVER Figure 14 Sample questionnaire home web page Admin button 12 v8 0 THE SURVEYOR USER MANUAL FE cet Samopi Ury oy a urveyadmin
193. or Jacques It is the result of your having completed a sample questionnaire at http Videlicet com Samples Sample MENU SELECT AND TEXT FIELDS TEXT BOXES AND RADIO BUTTONS Note also that the running question numbers can be turned on or off as desired Please enter your first name here Trevor Please enter your family name here Jacques Please enter your age here This is an example of many fields collected as part of a single answer Another good example of this use is Social Security numbers The format prevents spurious data being entered Tens 3 Years 3 What is your gender Male What is the highest degree or level of school you have COMPLETED if the answer to the previous ques tion is Male this question must have an answer so that you can proceed to the next page Grades 1 12 NO DIPLOMA To which ethnic group s do you belong For strictly valid data for analysis this nultiple entry format should not be used It is provided for completeness however for the case when one is not attempting to be scientif ically rigourous Please contact us for more information about this Aboriginal Cree Micmac Metis Inuit Australian aboriginal etc American White English U K Figure 169 Sample of textual e mail of responses 122 v8 0 THE SURVEYOR USER MANUAL 4 7 3 14 ERROR LASSO Figure 170 Sample MySQL data collection database creation web page The Error lasso file is used
194. ou d like to append the respondent s questionnaire number and password as well as the URL of the questionnaire home page to the e mail message select Yes from the pop up menu at the bottom of the web page Once you entries for the new respondent questionnaire are complete click the next button to create the record in the data collection data base The Surveyor will both create the record and then send the e mail message if requested Confirmation of the record createion and e mail transmission are provided in the page that is returned after the Next button is clicked Please see the next section for details about the confirmation web page 4 7 3 8 ADMINSURVEYCREATIONREPLY LASSO Magma E Hus m R Aja are A cm ME Le or E Me Admin AP z Og x Figure 163 Sample MySQL data collection database creation web page When The Surveyor has completed the creation of an individual questionnaire record it sends confirmation back to the questionnaire administrator in a web page with the details of the created recotd If the record already exists an error page is shown with the details of the problem as shown in Figure 164 Note that this is a generic web page used by The Surveyor for all the errors it encounters v8 0 v8 0 THE SURVEYOR USER MANUAL Error Please contact us and tell us the page number where this occurred and give us this error code There is already a record with this user number 999 Th
195. our Installation Is Working veias S hir denis send 7 1 92 Web Servettc lt 091 3 5 edo Ones eens 5e de Roo eS xa lota db ote got equidem ed 10 Teo WD ata Ase SEV onere Done Momo eue didt estt altes meti um dud 12 1 3 4 Connecting the Web Server to the Database eu sind b be rd ET ib 14 TE Reene e Oyster ee Oh o DU Se noe agi leis od oe eut 16 L5 Whats new IIS Version devastada 16 ZU OUI TOf sodas ctor s etd T btc oo edet dd on ass dud eum apa o a pda 16 C Sete DUELO und dede mean me oder comic d A act Coco rome 16 Ze Une Surveyor Databases 5 din ss died ein deniers A d ie 17 24d urveyotblelds Choices Database aun Iota se prado vae heros ore cb PAPA 18 A puta ethan eae evar denis ee dat dte ade Sd eae 18 ZO WEDO IVO EEE oe wd 19 Se Talon NO cO IN CCAS RE ed demanda acht tas ind ee es 19 51 Whey Domainscont older ita passer ES On RU ds dedi e ub 20 o1 Whe Cluestonnales Poleras ont 20 3 1 1 1 Q s onnaites Tndexlass oile ES LS Te E ECCE a 21 3 1 1 2 Questonnaites Pages Foldet ess chp tea dia sad oad daba Sa ete bled 22 3 1 1 2 1 Ouestionnartes ETelp laS SO vas secat dense rune 22 3 1 1 2 2 Questionnaires AboutUs lasso onde P Co I oth e eqs 23 211 25 QuestHormires GontactlasSO spread meute o tait deo o Hee 23 3 1 1 2 4 Questionnaires Other Surveys Level Web Page Files 23 Deleted Questionnaires Includes Folder siria EE eee od a ts 23 254 1 5 Questionnaires FooterButtonslasso
196. our computer it s good practice to back up your files regularly just in case of problems such as unexpected power failure v8 0 v8 0 Record 0 of 0 records found from total of 99 records There are pages in your survey Figure 10 Export pane A gt Search For fey Use Grep G Patterns e Find F Replace GR Vi Start at Top ST Search Selection Only 5 7 Wrap Around W W Extend Selection RE Er 3 aU Search Backwards R _ Case Sensitive EN Match Entire Words HE Replace With Ee a Batch Find ll Exclude Matches U User rs webstar Documents Files Th e Surveyor Surveyor 5 2 1 _ Users webstar M Use File Filter L current criteria ED Figure 11 Multi file batch search and replace dialogue in BBEdit THE SURVEYOR USER MANUAL THE SURVEYOR USER MANUAL 10 Once you have exported the web files they must have their soft return characters converted into hard returns using a text editor search and replace function for all the files created by The Surveyor for example in BBEdit search for all occurrences in the Questionnaires folder of x0B and replace them with Ar where r is a hard return If you d like to use the e mail in text format feature of The Surveyor also search for all occurrences of zzzzzz r t zzzzzz t and zzzzzz and replace them with nothing i e blank You should perform the latter sea
197. ous Please contact us for more information about this Required English U K English Canadian French Belgian Luxembourg French Canadian German East German West Figure 60 Select Multiple responses field type In appearance the Select Multiple field type is identical to the Select field type It differs only in that many of the possible responses can be selected at once Just as for the Checkbox we do not recommend this field type It is included for completeness only The rea sons for not recommending this field ype are the same as for the Checkbox field type 4 2 1 11 12 SLIDER FIELD TYPE Figure 61 shows the Slider field type in left right and top bottom orientation respectively The Surveyor is the only web based survey software that can provide you with a true interval scale that the respondent simply clicks to enter a number The value of the location 51 THE SURVEYOR USER MANUAL 52 clicked is entered into the field associated with the slider Alternatively the respondent can type the exact desired value into the field Note the two end stops so that it s easier for the respondent to select and end of the range of permissible values Figure 61 Slider field type 4 2 1 11 13 SUBQUESTION HEADER FIELD TYPE In order to provide a form of contextual grouping of quesitons one often wants to have a set of several questions numbered as a sub set of of a main question number The Surveyor p
198. plete Calc By Humber Page Header Override Figure 109 Set web page information If you d like to override the automatic html meta descriptions and document type you should enter the overrides in the middle two fields of this part of the pane Normally you re not likely to need this so leaving the fields blank is just fine This html information is not visible to the respondent on the web page The browser need the document type automatic or overridden but the meta tags are not usually of any interest unless you want your questionnaire spidered by the web search engines and directoties At the top of Figure 109 is the questionnaire banner header The Surveyor puts the page name in here and if requested the bar to show the respondent how much of the questionnaire has been completed so far To specify the look and feel of the header you can refer to a header image by name The Surveyor assumes that the image is in the Images folder You should provide the height and width of this image in the asociated fields This ensures that you know exactly how big the image will apear on the page The respondent s browser will resize the image to fit the width and height you specity here Next to last in this part of the pane is the line that includes the on off pop up menu for the horizontal bar showing the amount of the questionnaire that the respondent has completed as shown in Figure 110 The second item in this line allows you to decide the
199. questionnaire deletion web page 138 Figure 191 Sample Admin main questionnaire deletion confirmation web page 138 Figure 192 Sample Admin specific questionnaire found web page 139 Figure 193 Sample Admin list of found questionnaires web page 140 Figure 194 Sample Admin questionnaire page selection pop up menu 140 Figure 195 Sample Admin update confirmation web PILES 141 Figure 196 Sample questionnaire thank you web page with e mail button 142 Figure 197 Administrator E Mail Write and Jump to Page buttons 142 Figure 199 Sample Write Summary Text Fle web pape cenit aran ne diese 143 Figure 199 Sample of textual summary of responses written to file 144 Figure 200 Sample Write Summary Text File confirmation web page 145 Figure 201 Export gt Includes Foldet Files palle ua 4a dae qr ttm au diapos teet 146 Pour 202 Bportt Shoo Folder Elles DANG ee dad aw Ac ecu eat ie A eg acuden 149 Fis re A 1 Listrot MySOL connectors in Lasso Admin sersa peg Ceo A ERR 152 Figure A 2 MySQL JDBC connector detail in Lasso Admin 152 Figure A 3 Host detail for MySQL connector in Lasso Admin 153 Figure A 4 Host detail for MySQL JDBS connector in Lasso Admin 153 Figure A 5
200. r Piles pane 4 oeend dd mouche e Ee e per ade ioo in de 108 Sample AboutUs Wen Ate acetic trt pite ni eni ERR Aaa 109 Sai le Admin equal web Paro qc nd te Po at c CR Pac Aa Rr ida 109 Example camal tocreSpOHdeDE adu eiue devent CIR eed a te ANR bees 110 Example HA confirmation emal ihn dub ona eee oy Rn e tecto tbe tertie 110 Sample reply to Admin e Mail web page i es edo E PRU de Bd ee Wa Se 111 Sample Admin import questionnaires web page ui duce ses e be d pb Rd 112 Sample MySQL data collection database creation web page 113 Sample web page with results of database creation 114 Sample web page for creation of individual questionnaire 115 Sample web page for creation of individual questionnaire 116 Sample web page for creation of individual questionnaire 117 Sample MySQL data collection database creation web page 118 Sample MySQL data collection database creation web page 119 Sample Admin upload of questionnaires web page 119 Sample Contact Web Pale dsd e ai d eo e re de 120 Sample contact web page shown with administrator buttons 121 Sample e mail sent confirmation web page shown with respondent buttons 121 Sample or textual equal Gf responses Lilas ne indesit ess 122 Sample MySQL data collection database creation web p
201. r analysis software currently the main Surveyor database assumes that the output is to be sent to SPSS so you should enter an SPSS compatible field name for the Export Field Name in the question record 1 e up 17 THE SURVEYOR USER MANUAL to eight alphanumeric characters There is a secondary purpose to having both names it will allow future versions of The Surveyor to use the Field Name on the web pages and the Export Field Name in the data collection database thereby hiding the database structure from web users and increas ing the security of your data even more For this version however the incoming data is validated by both the JavaScript generated by The Surveyor and by Lasso as it arrives for entry into the database 1 e both client and server data validation 2 2 1 SURVEYOR FIELDS CHOICES DATABASE The Surveyor Fields Choices database file allows you to specify and quickly review lists of permissible responses to your questions These lists exported by The Surveyor to produce the web page questions the results web pages and to create scripts for formatting SPSS value labels for the collected data Keeping these lists in a database also allows you to use them for more than one question thereby saving you development time 0000 86e Choice SPSS Yalue Picture Name Grades 1 12 NO DIPLOMA tame of Choice List 3 Lu High School Diploma GED Panal Education Some college credit but less 1 2 3 1 or more yea
202. r questionnaire so you should enter it without a trailing slash character in the Domain field In our sample we have used our own domain Videlicet com as shown in Figure 102 The next level down is the folder where at your option you store more than one questionnaire The path from the domain itself to the questionnaires folder is entered in the next field in the pane Note the underlining of the s in the label for this field If you enter a simple slash in this field The Surveyor assumes that there is no questionnaires v8 0 THE SURVEYOR USER MANUAL level folder and no button is produced at the bottom of the web page to link to the Questionnaires web page because in this case it does not exist The same is true if enter the same path in both the Questionnaires and the Questionnaire Home Page fields Figure 97 shows that the Sample questionnaire is set up with both the Questionnaires and the Questionnaire level configuration Pay Lasso Passo al 6 Setup Build Browse Monitor Support blueworld Global Settings Data Sources Tags Groups Users Connectors Hosts Databases Tables Fields Search Table Listing Connector Lasso Connector for Lasso MySQL Host Lasso MySQL Database Name Status Links 1 Sample Enabled List Fields 2 SampleRelated Enabled List Fields 3 SampleSecurity Enabled List Fields 4 SamplevalueLists Enabled List Fields Showing 4 tables out of 4 7 u Enable All Refresh Disable All Delete All Setting
203. r respondent instructions for the web page or a part of the page For more details please see Page Header Records and Text Header Records 4 2 1 11 FIELD TYPE With this Surveyor field you specify the type of web response presented to the user for each and every question The possible web field types from which you can choose are Checkbox Dsiplay EMail Field Matrix both text and numerical headers for columns pull down Menues Pictures Radio buttons Radio Buttons with values Select menues Select Multiple menues many selections from a single list on the web page Slider a true interval scale for point and click on all browsers Subquestion Headers SumTotals and Textboxes Each of these is covered in its own subsection below Figures 39 show part of the web page that results from some of the selections made in the Surveyor database for the Sample questionnaire shown in Figure 37 O 9000 sax us fumo sump auf 200 QOOO OQQDOQOOMOO Use Rqd Pg Ord Field Export Name Group z F Question Text Type Wo H Choices Menu Label it x 1 PageHeaderT ext O ch3eMenu Select and Text Fields Text se mx 1 2 HeaderTest 15 Three af the fields onthis page are required EMail Mx x 1 3 FirstName NAME 1 Please enter your first name here vw Field fx x 1 4 Lasthame NAME a 2 Please enter your family name here ru qmm x 1 5 AgeDecade AGE Begin o 3 Please entervourage here This is an example Men
204. r the questionnaire help related to the ques tionnaire and information about the people conducting the questionnaire please see Questionnaires Pages Folder for further details about the structure of these files v8 0 27 THE SURVEYOR USER MANUAL 28 Other pages in this folder are to help during questionnaire generation finding a previously started questionnaire error pages for when the respondent makes an error and a ThankYou lasso page for when the respondent has completed the quesitonnaire As in the case of the Questoinnaire Index lasso file above all the Lasso files in this folder are constructed from building blocks kept the Name lasso file and in the Questionnaire Includes folder An inspection of the contents of any of these files will show how they work 3 1 1 5 4 QUESTIONNAIRE IMAGES FOLDER Just as for the web site level the individual Questionnaire level Images folder provides a single common location for all the images used for that questionnaire All the Questionnaire level web page buttons and other images should be stored here so that they can be found easily and so that html references to the images have a standardised path thereby making coding much easier It is recommended that only image files be stored in this folder 3 1 1 95 95 QUESTIONNAIRE INCLUDES FOLDER Just as images are included in web pages code can be included in web pages to add detail and or functionality to the page This folder contains
205. rch and replaces in the order given here Depending on the speed of your processor the export of the Sample questionnaire provided in the download will take up to approximately 15 minutes benchmark is an iMac 20 G5 at 1 8GHz The text editor line feed substitutions should take no more than about a minute 1 3 2 WEB SERVER Copy the updated files from your development folder to the appropriate locations on your web server see Figure 12 It s easiest to move the two Index files the two Error files and the Pages and Includes folders all at once These six items are all that are needed on the web server for questionnaire deployment To use the Import and Export functions of your questionnaire s Admin area you should also create an Imports and an Exports folder in the questionnaire folder as in Figure 12 with privileges such that Lasso can read and write to them Note that the The Surveyor folder could be any name you want such as the name of your questionnaire and likewise the MyDomain com fold er could be named YourDomain xxx to mimic your domain name and to minimise confusion in folder names but this name change may be restricted by you web server administrator Check with your web server administrator if necessary Set up a virtual domain in your web server application software to point to the renamed MyDomain com folder if you don t know how to do this see your web server sofware manual or your web server administrat
206. reated or modified 4 7 4 9 MYSQL PARENTFIELDS LASSO This is a list of the fields in the main questionnaire They are used in a Lasso script that is called when your realted database is created or modified 4 7 4 10 NAME LASSO This file contains all of the settings for your questionnaire with the exception of the cascading style sheet information The latter are held in the Style css file The file is called by every web page and at the bottom of this file it sets up the privileges used for intereaction with your data collection database through Lasso 4 7 4 11 PAGEBACKGROUND LASSO Called from every page this file simply sets up the look and feel of the background colour and image for your questionnaire web pages It also sets up the html link colours 147 THE SURVEYOR USER MANUAL 148 4 7 4 12 PAGEFOOTER LASSO This file displays the footer navigation buttons at the bottom of the web pages It is called by every questionnaire web page 4 7 4 13 PAGEFOOTERLINKS LASSO When you want textual links at the bottom of your web pages this is the file to modify to include them Please see the Sample question naire for an example of this file 4 7 4 14 SERVERRESPONSECHECKS LASSO This file contains the basic validation code that the server uses to validate incoming data for the collection database Ranges and data types are checked depending on your specifications for the questions in the questionnaire 4 7 4 15 STYLE CSS Thi
207. respondent other than when the respondent returns to his her quesitonnaire and correct ly enters both the correct questionnaire number and correct password The respendent is asked to then click the Next button to proceeed to the his her questionnaire 4 7 3 25 SURVEYFIND LASSO LOG IN PAGE One of the strongest features of questionnaires created by The Surveyor is that they are designed to enter respondent data as they are sub mitted at the end of each page This ensures that at worst only one page of respondent data is lost if the respondent s computer has a failure such as a loss of power At the same time as saving the data submitted for any given page The Surveyor code also makes a not of the last page completed and the next page that the respondent should answer the latter allowing for skip branching patterns A key advan tage here is that the respondent can interrupt responses to the questionnaire for any leneth of time and then return to complete the questionnaire at a later date v8 0 THE SURVEYOR USER MANUAL Figure 182 Sample web page for respondent to find own questionnaire To come back to complete his her questionnaire the respondent has but to click the Login button on the questionnaire home page to have The Surveyor present the web page shown in Figure 182 Upon entry of the questionnaire number and password the respondnet clicks the Login button to gain access to the questionnaire The response p
208. restrictions v8 0 v8 0 THE SURVEYOR USER MANUAL Do not attempt to export a production questionnaire from demo mode since it will lack functionality and the web files have an expiry date p p p q pity built into them If you are running in demo mode after presenting you with the splash screen shown in Figure 4 The Surveyor will show you the last selection of question records in the List layout something like the list in Figure 5 If you have a passwotd for The Surveyor you will be taken directly to the List pane which will appear something like Figure 5 depending on which records had been found the last time you closed The Surveyor databases The first thing you should do after opening The Surveyor is to change the password we supplied to one that you would like for your question naire The reason for this is that it protects your Surveyor development data from users who may have had access to the default user password that we provided when you bought The Surveyot 9999 0 fosa v uma amo Use Rqd Pg Ord Field PageHeaderText HeaderT ext W H Choices Menu tabel Export Name Group Question Text Type EE lt h3 gt Menu Select and Text Fields Text Three of the fields onthis page are required Please enter your first name here Field 15 FirstName NAME LastName NAME Please enter yourfamily name here Field 15 Please enter yourage here Thisis an example Menu Zeroto Tens
209. review the responses made by the respondents in web pages that look exactly the same as the respondent saw at the time of data entry The columns for this web page are specified at the bottom of the Set Up gt Admin pane Figure 140 The Link Type pop up menu allows you to put the link button at the left or the right of the rows of quesitonnaire data or to use the text of any one of the five columns as the link If you use a link button leaving the Button image blank will tell The Surveyor to use the default but tons provided with the download If you enter and image name here you should make sure that the image is present in the Images folder and the you tell The Surveyor its dimensions As Figures 140 and 141 show you can choose any fields you want for the results list web page and you can specify concise column headings to override any verbose questions associated with the question record v8 0 v8 0 THE SURVEYOR USER MANUAL jet E un Ae 1 ta E O n Scenes Mrs ur os Figure 140 Sample Admin list of found questionnaires web page Results Listing Link Type Left Button Image Button Width Button Height List Field 1 FirstName Heading 1 FirstName Please enter your first name here List Field 2 LastName Heading 2 LastName Please enter your Family name here List Field 3 aenderMow Heading 3 Gender What is your gender List Field 4 Havechildren Heading 4 Children Do you have any c
210. rovides for this and puts a subquestion divider bar before the main question You can choose the height and colour of the bar just as you can choose the colour size etc for the question numbers you can set a sepa rate set of colours separator period parenthsis colon or a hyphen etc for the subquestion numbers These subquestion numbers may be in numeric alpha or roman format All these format settings apply to the entire questionnaire LT 1 Fa i T 13 A zr pur I oua b Do you like peanut butter Figure 62 Subquestion field type with right left Matrix Text responses a Do vou like strawberries Click here s for results ix E ER E j is j j j i n j NU uu a me m 2 Figure 63 Subquestion field type with top bottom Matrix Text field response v8 0 v8 0 THE SURVEYOR USER MANUAL 4 2 1 11 14 SUMTOTAL FIELD TYPE Often you ll want to ensure that the sum of numeric responses equals a given number The Surveyor lets you specify how many ques tions in a group must add up to the total It then inserts a row in the web page above the set of summed responses with a field that maintains a running total of the respondent s entries You set the sum to be reached in the width of the SumTotal field and the num ber of questions to be summed in the height Figure 64 SumTotal field type The individual questions can still have their limit checking etc but the sum must be correct before
211. rs college no 4 Associate degree for example 5 6 7 8 3 Max Pictures Wide Bachelor s degree for Master s degree for example Professional degree for Doctorate degree for example Numerical Choice List From to Interval Used for these field 1 FormalEducation i Creation Date 14 6 2001 Creation Time 14 39 54 Creator Name Trevor Modification Date 3 12 2004 Modification Time 14 54 38 Modifier Name Trevor Record 1 of 1 records found from total of 146 records English Associat Bachelor Master s Professio Doctorat Fran ais Deutsch Espa ol Other Figure 20 Field Choices Detail pane 2 2 2 SURVEY DATABASE The main Surveyor database above contains a database record for every field data point in the final data collection database The data collec tion database contains one record with fields that correspond exactly to the fields in the main database for each and every respondent Each question in the questionnaire will have one or more collection fields in the MySQL database The data collection database is designed to output the responses into SPSS With a click of a web button the questionnaire administrator can export the collected data in a tab or text delimited file for immediate import into SPSS Because these formats are well known to all major data analysis software if you do not use SPSS you will still be able to easily import your data into your analysis tool 18 v
212. s Figure 100 List of MySQL tables in Lasso Admin The subsequent fields in this part of the Set Up gt Server pane are for the file paths to your questionnaire folders as illustrated in Figure 102 The Surveyor exports its files on your development computer with the names you see in the figure but you can change these on your web server Indeed the reason we have provided for naming these paths is to both provide flexibility and to provide added security since crackers will have a harder finding your files if the folders do not have the naming the we have used in our examples The Pages folder correponds to the Pages folder on the development computer as does the Includes folder These two folders contains the files needed to send the questionnaire web pages to the respondents browsers The images folder contains all the images needed by the que sitonnaire web pages to give your quesitonnaire the look and feel you want The Imports folder is for any files that you upload to your server for importing respondents into the data collection database The Exports folder will contain the data files exported for your analysis soft ware by the questionnaire administrator from the Admin section of the web pages The Summaries folder contains the textual versions of the individual questionnaires that have been exported and e mailed by the questionnaire administrator v8 0 73 THE SURVEYOR USER MANUAL 74 Questionnaire2
213. s also used to provide a means to create a separate data collection database of data associated with each respondent s questionnaire For more on the latter function please see the Related Records section 35 THE SURVEYOR USER MANUAL 4 2 1 5 1 Particularly when your questionnaire has many pages you will find that giving your questionnaire web pages names can help not only to provide context for the questions on a given page but also to provide the questionnaire administrator a quick way to determine to which page to jump when examining a particular response record in the questionnaire s web Admin area In Figure 35 you can see that the first record in the Sample Surveyor database puts up a textual page header in page five of the ques tionnaire that reads Multiple Page Child Records You can include basic html code in the Question Text field for page headers so that you can add extra formatting to your text if required You can use the html pairs lt i gt lt u gt lt b gt lt h1 gt lt h2 gt and lt h3 gt to pro _ ae 7 Three of the fields on this page are required The two Other fields have traps to prevent them being blank when other is filled in above them This page also shows all of the possible response field types except the matrix slider and picture formats which you will find on page four Note also that the running question nu
214. s file is a standard Style css file with all the settings you made in the Set Up panes of The Surveyor You can modify this file as much as you want ptovided that it remains in css format 4 7 4 16 SURVEYHEADERBEGIN LASSO At the top of your web pages there is an area designed for a banner in which the tpage names are displayed to the respondent and if appli cable the progress bar is shown This file begins that code The code is conpleted by the SurveyHeaderEnd lasso file If you want to change the way your header is displayed these two files are the ones to modify They contain a simple html table with a small amount of Lasso code 4 7 4 17 SURVEYHEADEREND LASSO Please see the SurveyHeaderBegin lasso section above for information about this file 4 7 4 18 VALUELISTS MRG This file contains a list of the values used in all of the numerical responses that have textual equvalents i e a summary of the Field Choic es database of The Surveyor It is imported into the OvestionnaireValueLists MySQL table each time the AdminMySQL lasso file is run by the questionnaire administrator the table provides the labels for the results pop up windows Do not alter the contents of this file except by re xporting it from The Surveyot 4 7 5 EXPORT SPSS FILES PANE The SPSS script files are exported using the buttons on the right of the Export gt SPSS Files pane Each of the buttons will produce two files if there are portal pages in your questi
215. s when the questionnaire administrator searches for questionnaires We recommend against using ID UserNumber and UserPassword unless you use a secure https connexion for your questionnaire web pages Administer Questionnaire Data Please type in the questionnaire number Questionnaire Number f Next EN Alternatively you can retrieve a list of records using the survey questions and list button below First Name has a word that begins with Last Name has a word that begins with 1 Ea Gender E s equals Droplets Pictur is not equal to a is greater than is greater than or equal to i Blank Is less than Children Yes is less than or equal to RE O amp _ No In groups of Sorted By In this order l en Bs Taian AAN T i 50 Ht Last Name gt Descending FF f tst 5 K m 4 Back Figure 137 Sample Admin questionnaire review search web page Once you have selected the field you want to display in the first row of the Administer Questionnaire data web page the Question text associ ated with the chosen Field Name will appear below the middle field i e the Override Question Since some questions can be long and we want to use this pane to put labels next to selections on the web page we have provided the override field to do this As shown in Figures 138 and 140 Please enter your first name here has been overriden with First Name 97 THE SURVEYOR USER MANUAL In
216. screen to show the database again This button is pres ent on all panes of The Surveyor v8 0 v8 0 THE SURVEYOR USER MANUAL The magnifying glass button takes you to the Find pane Figure 29 so that you can search your questionnaire database Depending on context this button is present on most panes of The Surveyor a 4 Usef Yes Web Field information 16 12 2004 9 59 04 Trevor CommentsiNotes Onpage 1 this field is at position 3 Web Limits Check Choice Lext Field Name FirstName Field To Export Field Name NAME Required K Yes Field lt To Question Number on Web Page 1 Orderin Group Empty Test If on this page field Same Question Number as Previous Yes Same Matrix as Previous Yes ifield Question Orientalion Default Alignment Default Width Override Override Max Piclures Wide then the current field must be empty Question Text Please enter your first name here f Not Empty Test If on this page field ifield Response Type Field Menu Label Response Width characters Response Height rows p z is p ght J then the current field must NOT be empty Display Field Lasso Code _ Comparison Test If the current field is not empty then it must Choices List Default alue the value of field on this page 2 Exclude Record 3 Exclude Menu Label PA SS E Mail of Results Yes omit From Web Page If on a previous web survey page field Exclude Header Text Ifietd gt j Pop
217. secur O ar O O O O Videlicet Sample Su ples Sample Pages S Erme Esurveys COANE CE C E Crea Figure 15 Sample questionnaire admin security check web page 7 AA 1 CUI a Am AAD a d Me nnnaire rez vs ECSU RAEC GA n E s Admin blahblahblah Respondents lasso lt Q Back Create eate Cone Cives SAMPLE Crete Con Cimport CEA Chii Cio logo Figure 16 Sample questionnaire MySQL database creation web page Depending on your version of Lasso and whether you are using an installation of MySQL that is internal or external to Lasso your data collec tion data may be created on a computer other than your web server This will not change the operation of your questionnaire The data collection database in MySQL or LassoMySQL is created with little more than a couple of button clicks in your web browser Once your files have been moved to the correct location on your web server surf to http MyDomain com Questionnaires Questionnairel which will automatically v8 0 13 THE SURVEYOR USER MANUAL 14 test that your browser has both cookies and JavaScript enabled both are required for your questionnaire to operate properly and redirect your browser to the questionnaire home page you should see something like Figure 13 in your browser Now click the Admin button Figure 14 at the bottom right of the page and then click the Lasso button on the resulting pag
218. ses that contributed to the current results The pop up win dow can be dismissed with the Close button EM 4 F 3 o i Or EB 1 AA A V http videlicet com Samples Sample in Results for the question If applicable in which state province county do you live now Note that for this sample questionnaire you must pick an answer from Alberta to Nunavut inclusive response limit testing E 36 36 18 18 9 09 9 09 9 09 18 18 Figure 186 Sample question results pop up web page v8 0 135 THE SURVEYOR USER MANUAL 4 7 3 28 When a questionnaire administrator has sucessfully logged in to the Admin area of the questionnaire the Administer Questionnaire Data web page is displayed Figure 187 This page is also accessible by clicking the Admin button from any page once the administrator is logged in SURVEYREVIEW LASSO Administer Questionnaire Data Please type in the questionnaire number Questionnaire Number Alternatively vou can retrieve a list of records using the survey questions and list button below First Name has a word that begins with M Last Name Gender T equals Droplets Pictur is not equal to is greater than ls greater than or equal to ls less than Children amp is less than or equal to o 5 In groups of Sorted By so MA Last Name 1 K ee lt back E N ex l ip i Blank Yes AO In this order Desce
219. since The Surveoyr comes with the run time engine for Mac OS and Windows depending upon which download you request from us Regardless of the operating system dragging The Surveyor AS3 file onto the runtime engine file will open The Surveyor of you to use If you have FileMaker you can drag the Surveyor AS3 file onto you copy of FileMaker To tell The Surveyor that you have a valid password remember to hold down the Option key Macintosh or the Control key Wondows as The Surveyor opens so that you can then enter your passwotd 4 1 1 VERSION INFORMATION Figure 27 shows the About pane where you can see the version of The Surveyor that you are using 29 THE SURVEYOR USER MANUAL 30 The Surveyor Welcome to the Surveyor Surveyor manual which can be found at within certain limits guide your user records by that field column http idelicet comiDemos Pages Downloads lasso To use this tool simply enter the specifications forthe questions you d like to ask your respondents Full details are available in the The Detail List SPSS Limits and Jump layouts allow you to specify Trevor Jacques your questions as they will appear on the web online survey pages The Export layout allows you to export the Word format version of your questions for inclusion say in your human subject review Toronto documentation the survey web pages html and JavaScript code data collection database creation files
220. sponse to the current question should be blank e g when the respondent has not chosen Other you can ensure that no unwanted text is typed in the current If Other above please describe question The first field is the Field Name of another field on this page the second is for the logical operator e g is greater than is less than etc and the third field is for the value 63 THE SURVEYOR USER MANUAL for comparison The last field on the first line shown in Figure 87 is a logical AND or OR so that a second set of criteria can be added to the comparison If the conditions are met the respondent will not be allowed to supply any answer to the current question a Empty Test If on this page field field then the current field must be empty Figure 87 Empty testing 4 3 21 3 NOT EMPTY TEST This function is the reverse of the Empty test in that if the conditions specified are met the respondent must respond to this question f NotEmpty Test If on this page field field then the current field must NOT be empty Figure 88 Not Empty testing 4 3 21 4 COMPARISON TEST While similar to the previous two tests this test makes sue that the value supplied is within a range specified here Simply read the sentence and supply the conditions that make the sentence have the meaning you want f Comparison Test If the current field is not empty thenit must the value o
221. ssword in a safe place THE SURVEYOR USER MANUAL E OA nee Companyinfo Server Ancillary Files Web Page Formal Question Format E Mail Admin Buttons reves C Survey Company Name Videlicet Mailing Address P O Box 19591 55 Bloor Street West Toronto Ontario amp nbsp amp nbsp M4W amp nbs p 3T9 Canada Phone Number 416 962 1040 Facsimile 416 962 1044 Business Hours 09 00 17 00 E S T Contact Name Trevor Jacques Contact EMail lt script languagezjavascript gt To avoid spam you may want to use this format forthe e mail address for display on survey lt remember that the space between the two slashes should not be in your code web pages var person Info varser idelicet lt script languag e javascript gt yarser ser com vartextname our contact e mail address var person Info document write a href mail to person var ser Yidelicet ser gt textname lt ta gt var ser ser com di gt var textname our contact e mail address Isctipt noscript Info at our domain lt noscript gt document write lt a href mail 7to person Q ser textname lt a gt 11 2 lt iscript gt lt noscript Inf o at our domain noscript gt Record 1 of 12 records found from total of 99 records There are 10 pages in your survey Figure 6 Set Up pane mnt
222. t What is your date of birth would properly translate into three fields in the data collection database This is because the year month and date entered by the respondent are far less likely to contain bad data if we restrict the potential answers to those that fit the bill say a list of all the calendar months or a range of years that would be valid for our sample Our experience has shown that this vastly improves accuracy and greatly reduces the effort required to clean up the survey database once submissions are complete In terms of how the questions will ultimately be presented to your repondents the main Surveyor database allows you to specify on which page of the web survey each question will appear and in which order it will appear on that page This makes revisions to the web questionnaire easy and almost instantaneous since the web question pages can be moved around and or exported in seconds from main Surveyor database During the question definition process you must provide a Field Name for the question This should be descriptive alphanumeric text of up to about 32 characters in length although it can be longer If the first 20 characters of the name match the first 20 characters of another Field Name you will be prompted that the names are the same You can see from Figures 5 and 19 that these are some of the few fields that are on both the Detail and List panes You should also enter the name of the corresponding field in you
223. t s browser It also lets you specifiy the width and height of the field and text box response types The following fields are to allow you to override the default data types precision etc for the data exported from your MySQL data collection database to SPSS You can also use the FileMaker Pro N Control N in Windows to create a new question header record A blank line will appear in the List layout You have only to type the information you need into the relevant Surveyor database fields The last field in the line for each question record is the name of the list of possible respondent answers For information about these reusable lists that are also used by the SPSS sps script files please see the Response Lists and the Field Choices Database section For more infor mation about exporting your web pages and SPSS script filess please see the Exporting Web Pages and Seripts section v8 0 THE SURVEYOR USER MANUAL The Jump tab takes you to a pane where you can specify the conditions under which the web pages will skip to a page other than the subse quent page For example if the respondent answered male to a previous question then skip to page 5 otherwise skip to page 8 If there is no Jump record for the page of the first record in the found set you will be prompted with that fact and asked if you d like to add a Jump record The Jump pane is essentially the bottom section of the Detail pane shown in Figure
224. t contain mostly Lasso code to generate html that is served to the respondent s browser Each file and its purpose is briefly described below 4 7 4 1 ADMININFO LASSO This file contains the information for calculating the random seed used for encryption of data The information here is based on the entries in the Set Up gt Admin pane of The Surveyor There should never be any need for you to modify the contents of this file v8 0 145 THE SURVEYOR USER MANUAL E oa E el tail ges Folder Files includes Folder Files SPSS Script Files _HelperFiles Pa Record 0 of 0 records found from total of 89 records There are pages in your survey Figure 201 Export gt Includes Folder Files pane 4 7 4 2 ADMINMYSQLREPLYIMPORT LASSO When the questionnaire administrator uses the AdminMySQL lasso page to create the data colection databases one option is to import ques tions The AdminMySQLReplyImport lasso file is called at the end of the database creation script in AdminMySQLReplyScript below It is also called when the administrator Imports a file from the Import page of the Admin area 4 7 4 3 ADMINMYSQLREPLYSCRIPT LASSO This file contains the body of the data collection database Lasso scripting It is one of several called when the questionnaire administrator creates the data collection databases 146 v8 0 v8 0 THE SURVEYOR USER MANUAL 4 7 4 4 FOOTERBUTTONS LASSO FooterButtons
225. t if you change its size be sure to amend the dimensions here 4 6 5 5 ADDITIONAL CHOICES FOR CHOICES LISTS There are seven extra response choices that you can select from when you specify each question in your questionnaires The Surveyor lets you choose the text values of these extra choices the numerical values are determined on a question by question bassis depending on the values in the Choices list chosen for that question The defaults supplied with The Surveyor cover many of the common extra choices You can however type in anything for these seven choices but we recommend that you try to keep them short so as not to risk too much text text causing an unbalanced visual presentation of your responses Your choices texts appear as the labels for the extra choices in the Detail pane Add to Choices Text Partially Maybe Partially Maybe DAK Uncertain DHE lnc ertain HIA Decline MiA Decline Other Other Figure 127 Entering text for the extra choices 69 THE SURVEYOR USER MANUAL 90 4 6 5 6 DEFAULT MENU LABEL The menu fields on the web page all have a blank selection You can keep the selection looking blank on the page or provide a bit of use ful text such as the Pick Here in Figure 128 If the menu label has not been specified for a particular question the default text in this field of the Set Up gt Question Format pane a D efault M enu Lab el Pick
226. t of not including empty or None responses you can override that setting on a question by question basis by choosing Force Include No in the Exclude Record pull down menu This greatly helps formatting of the text in the resulting e mail You can also exclude the Menu Label for this question from the e mail if you ve set it The is useful for occasions such at the Further questionnaire wide settings for e mail can be found in the Set Up gt E Mail pane f E Mail of Results Exclude Record Exclude Menu Label Exclude Header T ext Figure 82 Excluding question from textual e mail 4 3 18 POP UP HELP Proving help for your respondents is often of great concern The Surveyor provides a way for you to set a pop up window with help text for each question if desired The pop up help can be toggled on and off by checking or unchecking the check box in this part of the Detail pane This helps you leave useful text in the database in case you d like to use it again latet d Pop up Help Pop Up Results Button Yes Context Sensitive Help Text Figure 83 Specifying pop up help 4 3 19 SPSS DATA TYPE FORMAT amp PRECISION d spss Data Type Format Precision Figure 84 SPSS data type format amp precision The Surveyor will export a file to tell SPSS what the data type and precision should be based upon the field type you ve selected for a question You can overrride
227. tainly run properly with Lasso 8 but we have yet to test questionnaire database creation with Lasso 8 We anticipate that a few changes will be required to make The Surveyor fully compati ble with Lasso 8 THE SURVEYOR USER MANUAL 1 2 2 1 MACINTOSH OS X You can use the Apache web server that comes with your computer version 1 x or 2 x or WebSTAR Installation of Apache is done when you install your OS X operating system WebSTAR is a third party product available from 41 com Please note that installation and configuration of these products is beyond the scope of this document You should use the manuals associated with the web server of your choice 1 2 2 2 WINDOWS The Surveyor supports web servers such as IIS under Windows that are supported by Lasso Please note that installation and configuration of these products is beyond the scope of this document You should use the manuals associated with the web server of your choice 1 2 2 3 LINUX The Surveyor supports web servers under Linux that are supported by Lasso Please note that installation and configuration of these prod ucts is beyond the scope of this document You should use the manuals associated with the web server of your choice 1 3 QUICK START 1 3 1 INSTALLING THE SURVEYOR _ The Surveyor NY c ss _ C The Surveyor Surveyor AS3 Surveyor Field Choices AS3 Pages Includes Images Import Index html Index lasso Error html V WW
228. tart page of a portal and the total to be reached for a SumTotal field 6800 its aber OOOO r a e o f a a n a Use Aqd Pg Ord Field Export Name Group F F Question Text Ww H Choices Menu Label mx 7 PageHeaderT ext e 2h35 Sum of Several Fields lt h3 gt mx T 2 HeaderText a The following is an example of ensuring that the mx T 3 Total orkload TOTWOREL A 33 Please estimate the percent of your work time SumT otal nn 5 x T 4 Actus Work AICTUALWK Al 34 Actual work Field 30 mx 7 5 Filing ork FILING A 85 Filing Field 30 mx 7 B Writing York WRITING M 38 Writing Field 30 Tx T T Meetings Wore MEETINGS A 37 Meetings Field 30 Hx 7 8 JOtherWork OTHERWE 38 Otherwork please specify Field 30 mx 3 OtherWork Specify WOREOTH La 39 f you spent anytime on Other work please Textbox 40 3 Figure 67 List pane field and text box width and height 4 2 1 13 FIELD HEIGHT The Height field is used for Textboxes on the web page to specify an override of the default number of rows of the text box It is also con venient for us to use this field to specify the ending page of a portal 4 2 1 14 FIELD CHOICES Choice lists are one of the powerful features of The Surveyor that make it so easy to create questionnaires Using the Field Choices data base you create a series of lists of choices with values associated with each choice in a list Each list can be used by any question you define For exa
229. the lasso web pages at the Questionnaires level look the way they do It contains a series of vatiables that should be used by the developer to change the look and feel of the Lasso web pages at the Questionnaires level It is here that much of the text that might be repeated throughout the Questionnaires level would be coded once so that it changes many pages at once Since this level is beyond the control of The Surveyor s individual questionnaires exports we have provided a model with the Sample questionnaire You can modify it any way that you want to conform the look and feel of this level of your web site to the rest of your web site or to its own look and feel Any changes made and saved in this file will instantly update all of the Questionnaires level lasso pages that use the changed variables For example if the contact for the Questionnaires level is at 800 xxx xxxx using the variable on Questionnaires level lasso pages means that they all show consistent information Changing the number to 800 yyy yyyy and saving the file will ensure that all the pages that use the variable instantly display the new number to respondents If the variable is not used one has to make a note of every page where the contact telephone number is located and then edit and save each of those This latter process is time consuming and prone to error whereas using the variable is easy to find and quick to change Other elements covered by the variables in the
230. the medications taken by the respondent These portals correspond to pages three and five and six in the Sam ple questionnaire Please refer to the Sample questionnaire database in your download of The Surveyor for details about these portal pages The second field on the web page is for the name of the export file to contain the numerical data for your analysis software The textual responses provided by your respondents cannot be analysed by programmes such as SPSS so it is exported separately If you want the text exported enter the file name you d like for the text reponses into the second text field on the web page with the word TEXT in it If you enter nothing in this field you will not be prompted and the file will not be exported v8 0 123 THE SURVEYOR USER MANUAL Please pick here All Response Records Please choose the questionnaires you would like to ex port All child records All medication records Please enter a file name for the exported records 3 Please enter a file name for the ex ported TEXT records Usea tab or comma quotation mark delimiter Please pick here 14 Export calculated value from display fields Please pick here i l the export file already exists do you wantit deleted Please pick here It you d like to e mail the exported file please enter the e mail re OT address here File Name File Size Last Modified 2004121 0Backupitasso 1453 12 20 2004
231. these fonts on them Questions Minimum Column Width 40 Text Face Palatino Times Times Roman Times Nes Roman Text Colour 333333 css Size 10pt Background Colour 1 DDEBFF Background Colour 2 D ES3FF Required ends question Yes Default Alignment Left Default Orientation Top Bottom Question Zs on web page Yes Question Es pixels width 25 Question E Face Question Number Colour 333398 css Size 12pt Style Bald Question Number Postpend Subquestion E Format abc Subquestion Header Face Subquestion Hdr Colour 333333 css Size Style Bold Subquestion Hdr Bar Colour 6699FF Height 1 pixels Subquestion Number Postpend Figure 120 Question formatting The two background colours that you can specify allow you to alternate the background colour behind the text of each of your questions mak ing it easier for your respondents to follow to the correct response field s on the web page Note that the Sample questionnaire uses a large colour difference as shown in Figure 121 partly to make the colours obvious if you print this manual on a black and white printer Generally we would recommend a much more subtle colour difference between the colours usually rather less than one html colour safe colour apart If a response to a given question is required you can have The Surveyor put Required after the question text That text will be in the colour you specify for the Link Colour in the Set Up gt Web Page format pane
232. this default here For information on the proper formatting of this specification please see the SPSS manuals from SPSS com 4 3 20 FIELD INFORMATION Some bsic information about the current question is shown at the top right of the Detail pan You can add comments about the question head er in the field under the modification date time information While there s only one line shown you can enter up to 64k of text to this field v8 0 v8 0 THE SURVEYOR USER MANUAL Field Intormstori 01 08 2005 16 45 40 Trevor Comments Notes Figure 85 Commenting your questions 4 3 21 DATA CHECKING Checking the data before submission and at entry into your data collection database is one of the best ways to ensure that you will have as little data clean up as possible to do as you enter your analysis phase The Surveyor provides this to you in several simple to use parts o the Detail pane You can compare the value entered by the respondent against fixed value limits as well as against other fields in the database Testing against previously entered data is part of the data validation process in your questionnaire Testing against other fields helps determine what is presented to the respondents 4 3 21 1 WEB LIMITS CHECK You can force your respondents to provide an answer that is between two limits Simply read the phrase on this section as Field must be greater than or equal to chosen value where Field is the current field name an
233. this on a per question basis using the pop up menu in the Detail pane Note that some browsers treat table cell widths in percentages slightly differently so there slight differences in presentation on each browser type and operating system 4 3 12 QUESTION TEXT This is the question you want to ask of your respondents You can use most accented characters and simple html formatting such as i lt b gt lt u gt lt br gt and lt p gt in this field to present the question the way you want it The Surveyor places your text including any Lasso code you put in this field as is into the questionnaire web page file Hence if you make any Lasso coding mistakes here you will have to debug them v8 0 v8 0 THE SURVEYOR USER MANUAL Question Text Please enter your first name here Response Type Field Menu Label Response Width characters 15 Response Height rows Display Field Lasso Code Figure 80 Question text entry response field type width amp Height 8 Lasso code 4 3 13 RESPONSE TYPE This Surveyor field corresponds to the on covered in detail in the List pane section of this manual Please refer to that section for details on the presentation of response type to your respondents 4 3 14 RESPONSE WIDTH amp HEIGHT As for the response type these items are fully covered in the List pane section of the manual They correspond to the W and H column head ings in that pane 4 3 15 DISPLAY FIELD LASS
234. ting a request for the Index lasso page to the Index html page assuming that you have set your web server to assume an Index lasso home page for the folder that contains the questionnaire The Index html page attempts to use JavaScript to redi rect the browser back to the Index lasso page If the JavaScript fails to redirect the browser the web page shown in Figure 147 is presented to the respondent The page informs the respondent that JavsScript is required for the questionnaire and to return to this page once it is enabled Please note that some modern browsers have a poroblem with how they handle the JavaScript top command so the redirected page is han dled with a token as in http MyDomain com Questionnaires Questionnaire Index lassor Token Related Index 104 v8 0 v8 0 THE SURVEYOR USER MANUAL This can be a problem when this URL is bookmarked and JavaScript is not enabled on the browser We are very interested to hear of a way to have modern browsers redirect properly with the top command We really want to be able to send an html form using JavaScript in these browsers Please contact us if you can help in this area Thanks We will update The Surveyor immediately If JavaScript is properly enabled on the browser the browser is redirected to Index lasso Please see the next section and Figure 148 for more on the questionnaire home page 4 7 1 2 EXPORT INDEX LASSO The questionnaire home page will have the structure of th
235. tion forcing the respondents to address a question is not the same as forcing them to answer the question thereby providing better date for analysis 34 v8 0 v8 0 THE SURVEYOR USER MANUAL The same is true for check box presentation of questions on the web page If the box is unchecked there is no way to tell what the respon dent intended by that For that reason we strongly discourage use of check box presentation but we have provided it for purposes of completeness 4 2 1 3 PAGE NUMBER Given on which page and in which position on the page with respect to other questions on the page fill in the Page and Order on page fields This allows you to change the positioning of the question within the web survey pages This is very useful if one wants to shuffle pages of questions from one place on the web survey to another for example to keep questions grouped according to the category of data being collected You ll note that the heading for this field is underlined Clicking the heading label will sort the found question records by web page number and then the order on the web page This sorting label is also present on the Detail pane The order of each question and header item is automatically determined each time you add a record using the button at the top of the pane but you may decide that you want to change this order To do so simply change the numbers in this field Once you ve changed the numbers to your satisfact
236. tionnaire an option is provided in the thank you web page if set in The Surveyor by the author of the questionnaire to send a textual copy of the respondent s submission by e mail The EMailSent lasso file is used to provide confirmation that the e mail was sent to the respondent The text in the presentation is slightly different from the confirmation sent to the questionnaire administrator if the adminstrator initiates the e mail while reviewing the respondent s responses Figure 168 Sample e mail sent confirmation web page shown with respondent buttons 4 7 3 13 EMAILSURVEY TXT The contents of the textual version of the responses for a particular questionnaire are created by this file It ensures that rather than the numerical values stored in the MySQL database the e mail contains the textual equivalent of the responses In large questionnaires this file can be quite large An example of part of the e mail body is shown in Figure 169 121 THE SURVEYOR USER MANUAL Note how all of the headers on the page have not been excluded from the text of the e mail in this case that the Menu labels for the age decade and year have been included and that the last two questions have the text of the response rather than the number that is stored in the MySQL database Hence you have the best of both worlds numerical data for analysis and textual data for review or inclusion in reports INTRODUCTION This is a report for Trev
237. tionnaire you examined Y just for the questionnaire number below Figure 153 Sample Admin e mail web page v8 0 109 THE SURVEYOR USER MANUAL 110 If the questionnaire administrator wants to send e mail to any of the respondents it can be done with the E Mail Notice To Respondents web page shown in Figure 152 As shown in the figure the first field is a pop up menuthat allows you to choose which respondents are to recieve the current e mail message If the administrator has recently examined a questionnaire the second to last line of the pop up menu is shown since The Surveyor keeps a record of which record it was The last selection in the menu lets you specify the questionnaire num ber and the second field on the web page is where you enter that number The second field on this web page is used only when you select the last item in the pop up menu To Respondent Videlicet com From Sample Videlicet com Subject Testing 1 2 3 This is a test This is only a test Questionnaire web page is http Videlicet com Samples Sample Your questionnaire number is 77037C Your questionnaire password is test Figure 154 Example e mail to respondent To Tester Videlicet com From Sample Videlicet com Subject Testing 1 2 3 The following e mail was sent to 1 respondents The questionnaire number password was append ed to each e mail This is a test This is only a test Figure 15
238. tions 1 and 2 must be True or you must not answer question 3 return false 4 3 22 ADD TO CHOICES If you want to tailor a reusable Choice list to this question only you can click the appropriate radio button to have that additional choice added to the list when the web page is exported by The Surveyor You can change the label texts in the Set Up gt Question Format pane Note that changing the text in the Question Format pane will change the label for all questions that have the associated button checked so the Set Up should modified with care Partially Maybe Uncertain Yes No o Yes No Yes e No Figure 92 Adding extra choices to Choices list v8 0 65 THE SURVEYOR USER MANUAL 66 When you click Yes to any of these extra cohices The Surveyor calculates a numerical value to represent the choice in the database It does this based upon the highest numerical value of the choices in the list For each additional choice The Surveyor adds one to that number so that the values for that question are all unique 4 3 23 JUMP TO PAGE SKIPPING BRANCHING Skipping also known as branching from one page to one beyond the subsequent page is a function used in many questionnaires While the Omit From Web Page function can be used for a single question you may have whole pages or sections for women to answer and others for men For example by specifying a condition that male respondents s
239. ts 2o mou sae Fade Pe e aee deno edis 82 Body lextand backeround See tele curadora 82 ESA e RP da ie PS tio ni qae rd OT edic de 92 Showing a a hiding Seb DULLONS Susi diesen dla aa A 83 5et unc up your copyright into rai o9 Rr dou ere vai nen DUR Ne 83 MW Cle pase oore E Ser OS vs St obo ADS nost Md aote pita OS Ae duod 83 Set Up Question Format pane soe tied Ne di AR aN aise o4 OC HO TOMATE ver aa ESAS AA AA SEAN 85 Sample completion bar in a questionaire web page 86 Response TOL MAING erpi ud dita a tat a tole dpa ee aero Lede 86 Matrix field types left right orientation plain and values Matrix Value Format 87 Related feCOrd Se pal OE ada ria ren eee eek ben 88 Related records showing separator bar formatting 88 PoP UP TOUN SC LON Os eds a dla pata cs fia ple dis ld 89 FE ntennotext Orne erta cn IES add dass 89 Detaultimena label 35 42 p tt di is add 90 Menu fields with question specific menu labels rs id aia 90 SEU EMU Dane tt too E tas aia 91 Emal servers UP eo dd Doe ea a a a N A EE 91 Textual e mail subject introduction and exit text ci eere bI EAR ote aes Fee deo 92 Menu fields with question specific menu labels 4 amp 2 obo pe tbv be tee 94 Textual MAlTOEMAIUNS eesto glade med b o geh e uh euh eed cro b deis e dd al 94 Benal eama Dody TEST es een Ree tp id oie Een reve bc be petes oap 95 eG E le BE A II uid etr uan EE E E E T 96 Sample Admin questionnaire re
240. ts of ways to tailor them to your needs 4 6 5 SET UP QUESTION FORMAT PANE Now that the basic web page format has been set we re ready to set up how the data gathering pages will look Just as for the other areas of your quesitonnaire you can set the background colours and font attributes of the question and response parts of the questionnaire Figure 119 shows the Set Up gt Question Format pane O O Tom Avo 9 Doran f ua Y mite aum set up export import 00 qe i E E ne _ ee Se C A e E EE ee naua Questions Pop Up Minimum Column Width 40 Show Results During Both Text Face Palatino Times Times Roman Times N s Roman Button Width niin EkDefauit is 11x11 TextColour 333333 ess Size Opt Button Height Background Colour 1 DDEBFF Background Colour2 DOESFF Required ends question Yes Default Alignment Lett ShowHeip Yes Button Width Button Height Default is 11x11 add to Choices Text Default Onentation Top Bottorn Question 5 on web page Yes Question Zs pixels width 25 Question Face Question Number Colour 333399 Si Partially Maybe css Size 12pt Style Bold Partially Maybe Question Number Postpend DHK Uncertain DMK Uncertain Subquestion E Formal abc pr Subquestion Header Face NIA Decline MEA Decline Subquestion Hdr Colour 993333 cas Size Style Bold Subquestion Hdr Bar Colour 6699FF
241. u couldn t overcome our difficulties 25 Beenableto enjoy 0 ur riormal day dav 27 Beenabletoface Upto our problems 28 amp b Been feeling unhappyand depressed Beenlosing confidence in yourself E m Beenthinking of yourself as avorthless Been feeling reasonably happy all things CocococeceoceoCcooCa Subquestion Matriz T ext Matrix T ext Matrix T ext Matrix T ext Matrix T ext Matrix Value Matrix Value Matrix value Subquestion Matrix Value Matrix Value Matis Value Matrix Value Figure 36 List pane with Jump To Page record WOW Choices aHa Frequency GHG Frequency GHG Frequency GHG Frequency GHG Frequency GHG Frequency GHE Frequency iHa Frequency GHG Frequency GHG Frequency GHG Frequency GHG Frequency Menu Label Related records are an exclusive feature of The Surveyor A respondent may for example have many children have many addresses or many telephone number or take many medications There remains however only one respondent for all of these related items The Surveyor provides you an easy way to create a database related to the main questionnaire data collection database to collect all of these responses and keep them attached to the appropriate record in the main questionnaire data collection database The process is achieved by little more than a bit of pointing and clicking JW H Choices en E a re p p
242. u n Mine Tens qm x 1 6 AgeYear AGE End o 4 Picture o Mine Y ears it x 1 7 GenderNow GENDERNW C 4 Whatis your gender L er mx 1 8 FornalEducation FRMLEDU a 5 What isthe highest degree orlevel of school Select 3 mx 1 9 EthnicGroup ETNICTY Al B Towhich ethnic group s da you belong For ue Bm x 1 1 EthnicGroupOther ETMICTYO e T f other please specify Subquestion Header mx 1 11 Marital Status MARS TAT a 8 Fromthis list please pick the one closest to sum otal i Status mx 1 12 MeritalStatusOther MARSTATO 8 If other please specify penne mx 1 13 Havechildren CHILDREN a 10 Da vou have any children This question is Radio YesMo mx 1 14 Residence State STATERES 6 11 If applicable in which statelprovincercaunty da Menu State Province Figure 40 List pane with Field Type pop up menu With the exception of the Field and Textbox and under some circumstances the Checkbox field type all the field types are numerical and save the number you specify in the Field Choices database to the MySQL data collection database see Figures 40 to 66 for how they can appear on the web pages When a respondent asks for a results pop up or to have their responses e mailed to them The Surveyor uses Lasso code it exported at the time of the full questionnaire export to link the number in the MySQL database with the text it represents Likewise the individual web pages translate the numbers store in the database to the appropriate text whe
243. uestionnaires level index page 3 1 1 2 QUESTIONNAIRES PAGES FOLDER This folder should contain any pages the developer requires for the Surveys level the Help About and Contact pages are provided in the default system The developer should add files to this folder if they are required at the Surveys level 3 11 2 1 The body of this file provides the help text the developer would like the respondent to see at the Questionnaires level Note that this QUESTIONNAIRES HELP LASSO may not be the same help text as the developer might want for each individual questionnaire The top and bottom parts of this file are called from the building blocks detailed in the Questionnaires Includes Folder 22 v8 0 v8 0 THE SURVEYOR USER MANUAL 3 1 1 2 2 QUESTIONNAIRES ABOUTUS LASSO The body of this file provides the text that the developer would like the respondent to see describing the organization that is running Questionnaires as opposed to the web site although the two may be the same in your case Note that this may not be the same text that you might want shown for any of your individual quesitonnaires The top and bottom parts of this file are called from the building blocks detailed in the Surveys Includes Folder 3 1 1 2 3 QUESTIONNAIRES CONTACT LASSO The body of this file provides contacts that the developer would like the respondent to see for the organization that is running Ques tionnaires as opposed to the we
244. uestions the Export Field Name is used This will change in future versions so that the Field Name is used on the web page and the Export Field name is used in the data collection database We recommend using mixed case descriptive names for the Field Name The Export Field Name however should be v8 0 THE SURVEYOR USER MANUAL restricted to no more than eight characters and we recommend using all uppercase to help distinguish it from the Feild Name Do not use the same name for the Field and Export names if at all possible This will help increase the security of your questionnaire data If you require an answer to this question make sure that the Required check box is checked with a cross as shown at the right of Figure 77 and the left of Figure 78 4 3 6 ORDER IN GROUP AND EMAIL WRITE GROUP SEPARATOR If you want more than one response for a single question such as age decade and number or day month and year you can do so by creating a a group of response fields The response field on the web page are inserted sequentially on the page with no extra formatting This Surveyor selection is also available to you on the List pane Figure 77 shows where to set this in the Detail Pane and Figure 78 shows the location in the List pane O 6 O sau st unis sump sa p RO m mt _ Use Rad Pg Ord Field ExportName Group Question Te
245. ure 42 shows the Checkbox response in top bottom orientation with the check box response type and it illustrates how this could happen If the respondent forgets to click Chinese there s no way to know whether the lack of a response to Chinese a null response means 43 THE SURVEYOR USER MANUAL that the respondent is not Chinese or that the respondent simply missed the question or even that the respondent did not know how to answer the question since he is not sure of ethnicity For this reason it s best to use the Radio button type and include a Decline response if necessary Equally you can see how this field type can consume a great deal of web page space since we ve only show the upper part of the complete list of ethnicities in the response It is not recommended that jumping comparisons be made against the value of Checkbox fields since the results can be unpredictable Figure 42 Checkbox field type 4 2 1 11 2 DISPLAY The Display field type allows you to enter Lasso code to be executed by The Surveyor at the time that the field is displayed on the brows er Note that as of version 7 1 your code should not include the setting of a variable The Surveyor converts your Lasso code appropriately to put the result into the textual summaries e mailed to the respondent and the administrator in the summary textual file written to disk and in data exports that include the Display field result s Figure 43 shows the Displ
246. users at several different points on our Web site The user should check the privacy policy for the respective hosted site and or survey The information collected by us for our hosting clients is not our responsibility Registration In order to use parts of this web site a user will be asked to complete a registration form During registration a user will give contact information such as name and e mail address We use this information to contact the user about services on our site in which he she has expressed i interest To use parts of the site the user is required to provide demographic information such as income level and gender and unique identifiers such as username and password The user is encouraged to do provide this information so that we can provide a more personalized experience on our site Order We request information from the user on our order form A user must provide contact information such as name email and shipping address and financial information such as credit card number expiration date This information is used for billino nurnoses and to fill customer s orders If we have trouble Figure 176 Top of Sample privacy statement web page SURVEY LASSO will be taken to the error page and told that no such page exists This protects your questionnaire by effectively preventing the pages from v8 0 v8 0 being bookmarked Even if they are bookmarked no data can be entered into a specif
247. usually mys qi Default is database name This pair is not seen by respondent but chould be changed for each questionnaire Respondent UserName SampleResp Respondent Password SamnpleRespPassword Figure 103 Setting up Lasso data connexions and user name If you are using Lasso 8 and above the Site number can be whatever you want but the default site is 1 so we ve used that as the default to use when creating your questionnaire If your Lasso administrator tells you to use another site simply change the value in the Site ID field The Lasso respondent name and password for the respondent data entries entered into your data collection database are specified at the bot tom of the Lasso set up It is not too important what you use here except that each questionnaire you create should have a different user name and password so that your Lasso administrator does not accidentally delete the wrong respondent Lasso user once you have finished collecting data for a given questionnaire You will not have to revisit these two after they re entered here 4 6 2 4 SECURITY SET UP As noted in the section above security is a concern for many researchers as they put up their questionnaires on the web If you feel that you on y want your respondents to use a questionnaire number to gain access to their questionnaire then you can remove all references to use of a respondent password from your questionnaire While we do not recommend this w
248. ve to respectively the first previous next and last record in the found set This is particularly use ful when you are in the Detail pane of The Surveyor Depending on context these buttons are present on most panes of The Surveyor as shown in Figure 30 The button with the plus sign is to add a new record This is covered in more detail in the section on adding new question records This button is present on all panes of The Surveyor that show question information The question mark button takes you to the About This Application pane that shows you the version of This Surveyor database It is present on almost all panes of The Surveyor The tab buttons allow you to move between the various Surveyor database panes The current pane is highlighted by the text in the uncoloured tab 31 THE SURVEYOR USER MANUAL The Detail pane Figure 30 shows all the data you can enter for a given response field Sometimes it s more convenient to view your records in this manner particularly when you have many restrictions on the question and how it is shown to the respondent or not shown to the respon dent Moving from one record to another can easily be accomplished using the four arrow buttons at the top left of the pane 22 090009 sca un funis f umo Joao com CA Usefdqves Web Number of pages inthe questionnaire 10 Field Information 01 08 2005 16 45 40 Trevor Number of questions in the questionnaire 11 Com
249. veyor to that of your own web site Briefly the files in alphabetical order perform the following functions 3 1 1 3 1 QUESTIONNAIRES FOOTERBUTTONS LASSO The contents of this file insert an html table with web buttons for the user into the html of the page that calls this file The buttons are 3 1 1 3 1 1 DOMAIN WEB SITE HOME BUTTON The code for this button calls an image for the domain Home button on the browser page provides JavaScript to make the button change to a different colour when the user moves the mouse over the button and provides a link to your domain s home page 3 1 1 3 1 2 QUESTIONNAIRES HOME BUTTON The code for this button calls an image for the Questionnaires level home page button on the browser page provides JavaScript to make the button change to a different colour when the user moves the mouse over the button and provides a link to the Question naires level home page This button is not shown if the page being displayed is the Questionnaires level home page 23 THE SURVEYOR USER MANUAL 24 3 1 1 3 1 3 QUESTIONNAIRES HELP BUTTON The code for this button calls an image for the Surveys level Help button on the browser page provides JavaScript to make the but ton change to a different colour when the user moves the mouse over the button and provides a link to the surveys level help page This button is not shown if the page being displayed is the Questionnaires level help page 3 1 1 3 1 4 QUESTIONNAIRES ABOU
250. view search web page 97 bctuno Obr SEA CD Heels eros ance tat ie Saws So tutte m ed tad debe dd 98 Detto SORTIE BIS uoce tut etc aatem tbi ups ad reas eat ad 98 Sample Admin list of found questionnaires web page 99 Specii yino ound st COINS iad tude adit Uwe Ake qaot u edens s 99 Mouse Over Giap mic With tile extras tua te Peis tue wo da A NEAR 99 Set Up DULOAS TEXCPANE Sedet eda eee dds e DEEP TRUVEO Eat 100 Set Up Password pane Laine la ne ren AAA AAA 101 Set Up Import parie asas he Ue bina ep eripe 102 EXPOR QA DADO cin Seite te rs ae es head edu dt x adpN IS eee 103 Sample Index html for browsers without JavaScript 104 Sample Index lasso page the questionnaire home page 105 Export Helper Files pane sate hahaa rite tet doe M EE iet ions 106 xi xii Figure 150 Figure 151 Figure 152 Figure 153 Figure 154 Figure 155 Figure 156 Figure 157 Figure 158 Figure 159 Figure 160 Figure 161 Figure 162 Figure 163 Figure 164 Figure 165 Figure 166 Figure 167 Figure 168 Figure 169 Figure 170 Figure 171 Figure 172 Figure 173 Figure 174 Figure 175 Figure 176 Figure 177 Figure 178 Figure 179 Figure 180 Figure 181 Figure 182 Figure 183 Figure 184 Figure 185 Figure 186 Figure 187 Summary Survey RTF file seen in Microsoft Word 107 Export Pases Polde
251. web page in your questionnaire The blank tab in each row lets you insert an AND ot an OR into each couple of conditions Hence your condition might read something to the effect of IF Field1a equals No GO TO page 4 ELSE IF Field 2a is not equal to 5 AND Field 2b equals Male GO TO End ELSE GO TO Page 10 You can see how easy it is to build complex branch ing within your questionnaire If the respondent s answers from previous pages meet one of the conditions you set unless that condition says to go to the thank you page your respondent will be told at the bottom of the page that the next page they will see will be the one from the met condition Note that the conditions you set are processed in the order on the page so if the responses meet more than one of the three rows of conditions the first met condition in the Jump pane will be used It s also possible to override the point and click jumping conditions by entering your JavaScript test into the Override field Below are two examples of how you might code your Javascript The first example shows an IF statement illustrating how you might use one of the entry items on a page to control the jumping and the second example shows how to use fields from the database to control the jump 67 THE SURVEYOR USER MANUAL Page Order Field Name 2 15 dumpTaPagelf Previous Page Fields Field name Operator f IF HaveChildren equals Field name Y Op
252. when you want to collect different values for the same response on the web page We ve provided an extra form of the Likert presentation with text labels so that you can separate your actual Likert scale from the extra responses such as N A and Other The separation is by one extra column width If you intend to use the Matrix Likert presentation you should try to keep your extra labels choices to short text for example using N A rather than Not Applicable and DNK rather than Do Not Know These labels are set once in the Set Up gt Question Format pane and are used for all questions where you decide to turn them on For each question vou can specify which of the seven extra choices vou d like to provide q y pectty y p There are seven possible extra items for the Choices list and you can change the text for them all please see the Set Up gt Question Format section There are two main advantages to using the extra choices One is the potential for separating them from a Likert scale response and the other is that it only takes a click on a per question basis rather than spelling it out in a Choices list that is used for many questions The Choices lists are used across the entire questionnaire so having the clickable extras lets you in effect modi fy the choices list on a per question basis saving you a lot of time and providing you much greater flexibility 4 2 1 11 6 MATRIX LIKERT V
253. will be exported in this file ready for execution by SPSS This script file should be run in SPSS before the associated Frequencies sps file is run in SPSS v8 0 149 THE SURVEYOR USER MANUAL 150 4 7 5 2 SPSSCHILDFREQUENCIESSCRIPT SPS The SPSS Frequencies Script button produces an SPSS sps file that when run in SPSS will produce a quick summary of the data frequen cies This is useful when a quick check of the data quality is required Note that this file should only be run in SPSS after the associated SPSS Formats ValueLabels and VariableLabels sps files have been executed in SPSS 4 7 5 3 SPSSCHILDVALUELABELSSCRIPT SPS The permissible values fo a field called a variable in SPSS will be the same as the list of choices you ve made in The Surveyor for that que sitons To have SPSS be able to relate a numeral to a text label for reporting purposes the value labels need to be transferred from The Surveyor to the SPSS data file The SPSS Value Labels Script button produces an SPSS script file that when executed in SPSS defines the value labels in SPSS It should be run before the associated Frequencies script file above 4 7 5 4 SPSSCHILDVARIABLELABELS SPS SPSS calls its field columns variables Each variable can have a textual representation for when SPSS produces output in textual tabls or in graph formats The SPSS Variable Labels button produces an SPSS sps file that when executed in SPSS defines the variable labels in SPSS
254. wner of the questionnaire The Set Up gt Server pane contains the information about the server that will send the web pages to your respondents The Set Up gt Web Page Format pane lets you specify information about the web pages themselves rather than the question and response formats The latter are handled by the Set Up gt Question Format pane In the Set Up gt E Mail pane you set the criteria for e mail addreses and the format of the contents of e mails that your questionnaire can send to both the respondents and the questionnaire administrator s The Set Up gt Admin pane lets you set up which fields can be searched by the question naire administrators when they re looking for respondents in the data collection database and the fields and format of the list of found respondents The Set Up gt Buttons pane lets you set up the text shown in the html code for the buttons on the web pages The Set Up gt Password pane lets you reset the password for the current Surveyor database Each of the panes is described in more detail below 69 THE SURVEYOR USER MANUAL 70 4 6 1 SET UP gt COMPANY PANE Figure 96 shows the Set Up gt Company pane for the Sample questionnaire While the data in most of the fields are are self evident you ll notice the special form of the Contact E Mail field The example shows one method the has proven very effective in preventing e mail address har vesters on the web from being able to read your e mail
255. x 5 ext e 4 h3sMultiple Page Related Records Ih35 Bx 5 PartalSinglePage e This is the first of two could bemore pages For 8x 5 PortsiMiddlePage 3 na F For Ese prescription medication vau are Mx ix 5 Aa 29 Medication name Field 10 Moix 5 MedicationDosage MEDDOSE e 30 Dosage Field 10 Dosage Mil MedicafionTimesTaken MEDFREG Begin A 31 Times Taken Menu Medication Times Taken Mx ix 5 MedicationEffectiveness MEDEFCTY End 32 Effectiveness Menu Medication Effectiveness Figure 37 List pane with portal pop up Figure 37 shows the first of a two web page portal definition This is a special extra type of record that is used to define portals to the related records All questions on a portal page are assumed to be portal i e related records You ll notice that the first line has used the Field name of PortalFirstPage the Export Field is empty there is uncapitalised singular text in the Question Text field and that there are values for the width and height The Field name can be PortalSinglePage for when you only want a single web page for the port to multiple related records or it can be a sequential combinatrion of PortalFirstPage zero or more web pages with PortalMiddlePage and finally a web page defined with Por 39 THE SURVEYOR USER MANUAL talLastPage You ll notice in Figure 38 that the portal definition record for the last page of a portal is in the same form as for the first except for the Field n
256. xt Type W H Choices Menu Label BX 1 1 PageHeaderTest AS ch3sMenu Select and Test Fields Text it d 2 HeaderText Al Three of thefields onthis page are required E mx 3 FirstName NAME ei 1 Please enter your first name here Field 15 fix lt gt 1 4 LastName NAME el 2 Please enter your family name here Field 15 mx 5 AgeDecade AGE Begin gt 3 Please enter yourage here Thisisar example Menu Zernto Tens Mxix 1 6 Agees ANGE End e Menu Zerota Years Moca 1 7 Gendemlow GENDER a 4 Whatis your gender Radio Gender iit 1 8 FormalEducation FRMLEDU amp 5 Whatisthe highest degree orlevel ofschool Menu m i Formal fx x 1 9 EthnicGroup ETMICTY C amp Towhich ethnic groupis do you belong For Select B Ethnic Figure 78 List pane with column headings and fields You should ensure that the responses in a group follow the sequence you d like starting with Begin and finishing with End The Cen tre Order In Goup values will be sorted in order before export of the page so you should be careful to ensure that they are in the otder you want relevant particularly for things like the nine numerals of a social security number etc The best way to check the otder of a group is to find the records for a page which will take you to the List pane where the Order In Goup is easily inspected Figure 78 shows how this looks in the List pane and the result of the Begin and End on the
257. y text in Figure 199 This line is used as protection to prevent anyone attempting to load this file directly into a browser Lasso will send the file to the browser but the first line tells Lasso not to send body content to the browser so a blank page is shown There is a corresponding output_none command at the end of the file You should remove these two lines before using the body of this file 143 THE SURVEYOR USER MANUAL output none MENU SELECT AND TEXT FIELDS TEXT BOXES AND RADIO BUTTONS Please enter your first name here James Please enter your family name here Bond Please enter your age here This is an example of many fields collected as part of a single answer Another good example of this use is Social Security numbers The format prevents spurious data being entered Tens 4 Years 5 What is your gender Male What is the highest degree or level of school you have COMPLETED if the answer to the previous ques tion is Male this question must have an answer so that you can proceed to the next page Master s degree for example MA MS MEng MEd MSW MBA To which ethnic group s do you belong For strictly valid data for analysis this multiple entry format should not be used It is provided for completeness however for the case when one is not attempting to be scientif ically rigourous Please see manual for The Surveyor for more information about this Aboriginal Cree Micmac

Surveyor User Manual, version 8.0

Contents

Download Pdf Manuals

Related Search

Related Contents