NIPO ODIN Scripter's Guide

8/10/2019 NIPO ODIN Scripter's Guide

1/415

NIPO ODIN

Scripters GuideVersion 5.16


2/415

More information:

For more information please contact the NIPO Software helpdesk at

[email protected] or call +31 20 5225 980.


3/415

NIPOODIN

Scripter'sGuide

Version5.16

Lastrevision:Wednesday15December2010


4/415

Copyright19972010NIPOSoftware

Allrightsreserved

ThesoftwarecontainsproprietaryinformationofNIPOSoftware.Itisprovidedunderalicenseagreement

containingrestrictions

on

use

and

disclosure

and

is

also

protected

by

copyright

law.

Reverse

engineering

of

thesoftwareisprohibited.

Duetocontinuedproductdevelopmentthisinformationmaychangewithoutnotice.Theinformationand

intellectualpropertycontainedhereinisconfidentialbetweenNIPOSoftwareandtheclientandremains

theexclusivepropertyofNIPOSoftware.Ifyoufindanyproblemsinthedocumentation, pleasereport

themtousinEmail.NIPOSoftwaredoesnotwarrantthatthisdocumentiserrorfree.Incaseswherethe

documentationsignificantly differsfromthesoftwareimplementation,theenduserisencouragedto

contactNIPOSoftware.However,theinformationinthisdocumentcannotbeusedtogranttheenduserof

theproductanyrightswithregardtoupdatesorfixes,demandingamatchwiththeexistingdocumentation.

Nopartofthispublicationmaybereproduced,storedinaretrievalsystem,ortransmittedinanyformorby

anymeans,electronic,mechanical,photocopying,recordingorotherwisewithoutthepriorwritten

permission

of

NIPO

Software.


5/415

ContentsIntroduction 9

Aboutthismanual 9

SoftwareCompatibility

9Terminology 10

General 10

QuestionsandAnswers 10

FilesandTables 10

TypographicalConventions 11

ContactingUs 12

ContactingNIPOSoftwareSales 12

ContactingtheNIPOSoftwareHelpdesk 12

YourFeedbackonthisGuide 13

VersionHistory 15

ChangesinNIPOODINScriptLanguage 15

ChangesinNIPOODINScriptLanguage5.16 15

ChangesinNIPOODINScriptLanguage5.15.001 15

Changesin

NIPO

ODIN

Script

Language

5.15

15








ChangesinNIPOODINDeveloper 18

ChangesinNIPOODINDeveloper5.14 18

ChangesinNIPOODINDeveloper5.11.003 18





Changesin

NIPO

ODIN

Developer

5.05

19


DutchCommandSetDropped 20

MigratingSurveysFromNIPOODIN4.08 20

*WAITCRCommandDroppedforNIPOCATIandNIPOCAWI 21

Dutchcommandsetnolongersupported 21

ObsoleteCommandNames 21

*PLAYNoLongerSupportedAsaQuestionOption 21

VerticalLineQuestionNotSupportedinNIPOCAPIandNIPOCAWI 21

*CENTREDoesNotProperlyCenterHeadingTexts 22

SelfModifyingScriptNoLongerSupported 22

ForwardSlashesNoLongerSeparateCodeLabels 23

CopyingPositionsFromaTfileIsLimitedtoFieldLength 24

*AUTONotSupportedinNIPOCAWI 24

*INITblockisExecutedBeforeSuspendImage 24

SelectingAnother

Character

Set

in

the

*FONT

Command

24

DuplicateInterviewNumbersinTfiles NoLongerContacted 25

Stopwatch[1]andStopwatch[2]NotSupportedinNIPOCAPIandNIPOCAWI 25

UsingCodeNumbersina*FORMQuestion 25

UsingtheNIPOODINDeveloper 27

TheScriptEditorWindow 27

LineSize 27

ToggleDisplayingTabsandSpaces 27

PopupMenuOptions 27

OpenQuestionnaireFile 27

QuestionPreviewinNIPOCATI/CAWI/CAPI 27

InsertingQuestionDefinitions 28

ChangingQuestionOptions 28

ChangingCodeOptions 31

GridComposer

32

SyntaxChecking 35

PageI


6/415

Introduction

WarningMessagefor*CODESQuestionWithoutCodeCategories 37

WarningMessageforUnfixedQuestions 37

Erroron*FORMQuestionLanguageSectionMismatch 37

UndeclaredVariablesareCreatedwhenFixingaQuestionnaire 37

ResultsWindowKeepsPreviousSyntaxChecks 37

SyntaxcheckforOmnibusSurveys 37

TestRun

Questionnaire

in

NIPO

CATI

/CAPI

/CAWI

37

CheckRoutingforStratification 38

ShowVariables 38

MenuOptions 38

OpenallQuestionnairesinOmnibusSurvey 38

OpenDataFiles 38

RemoveCommands 38

Comment/Uncomment 38

CreateQuestionnairesinUnicode 39

FindFunctionwithRegularExpressionsandMarkAll 39

StartEditorinWorkbookMode 39

CreateCodeNumbersBeforeCodeLabelsandFields 39

TheNIPOODINDeveloper 40

NIPODiana 40

CodeLabelExportsina*FORMQuestion 42

RandomCode

Number

Export

in

NIPO

Diana

43

OrderCodeNumberExportinNIPODiana 43Exportsof*FORMQuestionswithCodes 44

TripleSXML 45

SPSSPortable 47

SPSSPC 49

Ascribe 51

Quantime 51

Images/Sound 53

NfieldCode 53

ExportXFile 54

Imports 54

Ascribe 54

NfieldCode 55

NIPOODINDeveloperConfiguration 56

TemplatedRelatedFilesFolderConfiguration 56

SyntaxHighlighting 57

ApplicationConfigurationOptions 57

ODINOptions 57

InterviewSystemOptions 58

CodingSystemOptions 59

CheckOptions 59

DummyDataOptions 61

PrintOptions 62

AutosaveOptions 63

FilesOptions 64

AdditionalConfigurationOptions 65

UsingtheNIPOODINScriptLanguage 67

NamingConventions 67

Questions 67

DataFields 67

AnswerCodes 68

Variables 68

SystemVariables 70

ChannelAwareScripting 70

ChannelAwareScriptingVariablesandConstants 71

ChannelAwareScriptingExample 71

ConsequencesofChannelAwareScriptingandSwitchModeSurveys 72

RepeatNumber 72

SystemVariables09 73

Timers 74

Stopwatch[1] 74

Stopwatch[2] 74

Stopwatch[3] 74

TimersExample 74

PageII


7/415

Introduction

ConjTxt[n] 75

ScriptCommandTemplate 75

JavaScriptSupported 75

BrowserUserAgent 76

Language 76

PreTel 76

Expressions

76ExpressionOperators 77

ExamplesofExpressions 78

CommonMistakesinExpressions 79

FormFieldReferences 79

Backslashes 80

Stratification(Quota) 80

AutomaticSyntaxChangeWhenReferencingPositionsinTfiles 82

Stratificationfile(Sfile)whenusingSampletable 83

Stratificationfiles(Sfiles)forOmnibusSurveys(UsingTfiles) 84

Omnibussurvey,usingSampletablesandOmnibustables 85

Stratificationfile(Sfile)forNIPOCAWI 86

NonAnonymousSurveys 86

AnonymousSurveys 86

SurveysstartedfromaURL 86

CommandIndex 87

88

*? 89

*ABORT 92

*ADDRESS 93

*ALPHA(QuestionType) 95

*ALPHA(in*FORMquestion) 96

*APPOINT 97

*AUTO 98

*BACK 102

*BMP 104

*BUT 106

*CENTRE 108

*CODES 109

*CONJ...

*ENDCONJ

111

*CONTROL 112*COPY 114

*COUNT 115

*CUT 116

*DATE 117

*DELAY 118

*DTIME 119

*DUMMY 120

*END 121

*ENDNGB 123

*ENDST 124

*EXCLUDE 125

*FIELD 127

*FONT(definition) 129

*FONT(switching) 130

*FORM 132

*FORMAT 135

*GOSUB 137

*GOTO 139

*GRID(in*FORMquestion) 141

*GROUP 146

*HEADING 149

*HELP(definition) 151

*HELP(questionoption) 152

*IF(condition)...*ELSE 154

*IF(questionoption) 155

*INCLUDE 156

*INFO 158

*INIT...*END 159

*INSTRUC 161

*INTRO

162

PageIII


8/415

Introduction

*INV 163

*LABEL 165

*LANGUAGE 166

*LEFT 170

*LINE 171

*LIST(definition) 173

*LIST(question

option)

175

*MAX 178

*MERGE 180

*MIN 182

*MOVA 184

*MOVU 185

*MULTI 186

*NCLS 188

*NEW 189

*NEWCOLUMN 190

*NEXT 194

*NEXTRECORD 195

*NMUL 198

*NOCON 199

*NOENTER 200

*NOHIDE

201*NON 202

*NONRESP 203

*NOTBACK 204

*NUMBER(questiontype) 205

*NUMBER(in*FORMquestion) 206

*OPEN(questiontype) 208

*OPEN(codesoption) 210

*ORDER 211

*PAGE 214

*PICT(questionoption) 215

*PICT(codesoption) 217

*PLAY 219

*PNW 220

*PUT 222

*QUESTION 224

*RANDOM 226

*RANGE 228

*READ 230

*REC 232

*REPEAT(questionoption) 234

*REPEAT...*ENDREP 235

*REPNUM 238

*RETURN 239

*RIGHT 240

*ROT 241

*RUN 242

*SAMPLEDATA 244

*SAVE(questionoption) 245

*SAVE(codesoption) 246

*SCALE(questiontype) 247

*SCALE(in

*FORM

question)

249

*SCALERANGE 252

*SHOWDOCUMENT 256

*SIZE 257

*SKIP 260

*SQLADD 261

*SQLGET 265

*SQLPUT 268

*STOPAUTO 270

*STOPRANDOM 273

*STRAT 274

*SUBROUTINE...*ENDSUB 275

*SWILANG 277

*TAB 279

*TABLE 281

*TEXTVARS

283

PageIV


9/415

Introduction

*USELIST 284

*VAR 285

*VARS 287

*VCONTROL 288

*WAITCR 291

*WAITPLAY 292

*WRITE

293

AdvancedScripting 295

AdvancedUseof*NEXTRECORD Command 295

ScenariosUsing*NEXTRECORD 295

Scenario1:UsingSystemdefinedInterviewNumbers 295

Scenario2:InterviewNumbersBasedonHouseholdInterviewNumber 297

Scenario3:UsingaPresetInactiveInterviewNumberforEachRespondent 299

ReturnCodesfor*NEXTRECORD 300

ErrorWhenReadingNextRecord 301

InterruptingtheTelephonicContact 302

RestartingtheInterviewSetsNewRecordstoSystemError 302

Using*NEXTRECORD inCombinationwithStratification 302

HidedialogInterviewWillContinuewithNextPerson 302

ChangeTextinDialogInterviewwillcontinuewithnextperson 303

Advanceduse

of

*SQLADD

Command

303

Scenariosfor*SQLADD 303

Scenario1:StoreNewRecordinTable(NottheSampleTable) 303

Scenario2:StoreNewRecordinCurrentSampleTable 305

Scenario3:StoreNewRecordinAnotherSampleTable 306

Scenario4:StoreSeveralRecordsinaTable(VariableswithArrays) 308

Scenario5:AddNewRespondentsinNIPOCAWISurveyAndEmailThemDirectly 310

ErrorsUsing*SQLADD 313

ErrorsMessagesUsing*SQLADD 314

GoingBackOver*SQLADDRemovesAddedRecords 315

RestartingtheInterviewDoesNotRemoveNewRecords 315

InstructionModeorTestModeMayCreateNewRecords 315

ReusingSampleRecordsfromTfileThatWereAlreadyCompleted 315

Stratification 315

ChangeInterviewNumber 316

Morethan

5Contacts

316

SystemErrors 316CreateaNewSurvey 316

AlreadyCompletedCode 316

DeleteDfile 317

JumptoQuestionResponseCode 317

SettingtheCodePage 318

NIPOConjointMeasurement 318

OverviewofsupportedcommandsinNIPOConjointMeasurement 320

StartmoduleNIPOConjointMeasurement 321

DefiningTextScreens 322

ReferenceToaFeature 322

Filters 322

CONJTXT[n]TextArray 323

FiltersinNIPOConjointMeasurement 323

HowdoesfilteringinNIPOConjointMeasurementactuallywork? 324

LimitationsontheUseofFilterswithinNIPOConjointMeasurement 324

ExampleNIPOConjointMeasurement 325

ExampleNIPOConjointScript 327

DatapositionsinNIPOConjointMeasurement 331

LimitationsofNIPOConjointMeasurement 334

MultibyteCharacterFields(MBCSFieldsSetting) 334

Scenario:*ALPHAforMBCSStorage 335

ExampleUsingAdobeFlashinNIPOCAWIandNIPOCAPI 337

NIPOODINTemplateUsingAdobeFlash 338

NIPOODINQuestionnaireUsingAdobeFlash 338

AdobeFlashApplication 339

AdditionalRemarks 339

FileStructuresandDatabaseTables 341

DataFiles 341

PageV


10/415

Introduction

ClosedAnswersFile(Ufile) 341

Openanswersfile(Ofile) 342

StoringdatainUnicode 342

TelephoneFile(Tfile) 343

ContactFile(Cfile) 344

Stratificationfile(Sfile) 346

Databasetables

346

Sampletable(SeparateTableforEachSurvey) 346

UsingCustomSampleTableFields 349

UsingSystemFieldsintheSampleTable 350

OmnibusorSubSampleTable(SeparateTableforEachSurvey) 351

UsingCustomOmnibusTableFields 351

UsingSystemFieldsintheOmnibusTable 351

NIPOCAPIClientAddressTable 352

Status,ResponseCodes,TerminateCodes 353

StatusFieldinSurveyTable 353

StatusfieldinSampleTable 353

ChannelandInitialChannelFieldinSampleTable 353

OverviewofResponseCodes 353

SpecificationofResponseCodes 355

TerminateCodes 355

OverviewofCommandsandSystemVariables 357

ListingofCommandsperSystem 357

ListingofSystemVariablesperChannel 361

TheNIPOHTMLGenerator 363

SupportedHTMLstandards 363

ApplyingDesigntoaSurvey 363

DefaultandCustomTemplatesandStylesheets 364

OrderofCheckingOdintemplateFiles 364

ExampleofUsingOdintemplateFiles 365

OrderofCheckingStylesheets 366

ExampleofUsingStylesheets 367

QuestionTypes 367

ExampleofGeneratedHTMLPage 368

WorkingWith

Templates

374

TemplateTags 375

InterviewProgressEstimation 375

UsingJavaScriptinanOdintemplateFile 376

OdintemplateExample 376

WorkingwithCSS 376

CSSFileDetails 377

CharacteristicsforQuestionElements 377

QuestionElementsExample 378

CSSforQuestions 379

DefaultQuestionSelectors 379

*CONJQuestionSelectors(NIPOConjointMeasurement) 379

*CODESQuestionSelectors 381

*CODES*MULTIQuestionSelectors 381

*NUMBERQuestionSelectors 382

*ALPHAQuestion

Selectors

382

*LISTquestionselectors 382

*FORM*NUMBERand*FORM*ALPHAQuestionSelectors 383

*SCALEquestionselectors 383

*FORM*SCALEQuestionSelectors 384

*FORM*GRIDQuestionSelectors 385

CSSforButtons 385

CSSforTabs 386

CSSforFonts 387

CSSforProgressBar 388

SelectorsinNIPOCAWI(AlphabeticalOverview) 389

SelectorsinNIPOCAPI(AlphabeticOverview) 394

CSSExamples 397

ExampleNIPOODINQuestionnaireUsingStylesheets 398

Example1:ChangeBackgroundColorofaSelectedCode 401

Example2:BoxSizeforOpenAnswerCode 401

Example3:boxSizeforOpenQuestion 402

PageVI


11/415

Introduction

PageVII

Example4:CenterScales 403

Example5:CenterTextAboveScales 404

Example6:ColorBackgroundforFirstandThirdStatementGray 404

Example7:GridUsingVariousStylingOptions 405

Index 407


12/415


13/415

Introduction

NIPO

Fieldwork

System

fieldwork

management

for

CATI

/

Web

requires

the

combined

use

of

two

applications:theNIPOFMSandtheNIPOCATI/WebManager.

TheNIPOCATI/WebManagerisusedtoconfiguresurveysandsurveydefaults,tostartandstopsurveys,

andtomanage,monitor,viewandreviewongoingfieldworkprogressintheNIPOCATIcallcenter.

TheNIPOFMSisusedtotodeploysurveyfiles,configureadditionalsurveysettings,setupandmanage

sample,mailmessagesandinvitations(NIPOCAWI)andtoadministerinterviewers,assessinterviewersand

planfieldwork.

DuetotheiroverlapinfunctionalitytheNIPOFMSandtheNIPOCATI/WebManagermaybeusedbyboth

theprojectmanagerandthefieldworksupervisor.Dependingonyourrolewithintheorganization,youmay

wishtoskipthesectionsthatdonotnecessarilyapplytoyou.

Aboutthismanual

ThismanualisintendedfortheNIPOODINScriptwriters.Thefollowingtopicsarediscussedwithinthese

pages:

TheNIPOODINScriptLanguage,theNIPOSoftwarescriptingsolutionforquestionnaires intheNIPO

CATI,NIPOCAPIandNIPOCAWIenvironments.

TheNIPOODINDeveloper,theapplicationfordesigningNIPOODINscripts,testingthequestionnairein

variouschannels,andexportingthedatatoastatisticalanalysissoftwareofchoice.

TheNIPOHTMLGenerator,thestylingguideforNIPOCATIandNIPOCAPIsurveys.

ThismanualisnotintendedfortheNIPOCATI/NIPOCAPIinterviewers,norforsupervisorsand/or

technicianswho

set

up

and

run

the

workstations

(interviewer

workstations)

in

aCATI

Studio.

SoftwareCompatibility

ThisdocumentationisintendedforusewiththeNIPOFieldworkSystem1.12release.Thefollowing

softwareanddocumentationisincludedwiththisrelease.Makesureallsoftwareisuptodatewiththis

releasepriortousingthisdocument.

NIPOFieldworkSystem1.12releaseapplicationsandcomponents

NIPOCATI/WebMaster3.08

NIPOFMS1.12

NIPOCATI

/Web

Manager

3.09

NIPOWebInterviewServer1.05

NIPOSTRAND1.05

NIPOODINScriptLanguage5.16

NIPOCATIClient5.09

NIPOODINDeveloper5.14

NIPOFieldworkSystem1.12releasedocumentation

NIPOFieldworkSystem1.12ReleaseNotes

NIPOFieldworkSystem1.12TechnicalReference(tobedelivered)

NIPOFieldworkSystem1.12User'sGuide

NIPOODIN5.16Scripter'sGuide

Page9


14/415

Introduction

Terminology

General

Questiontype

Definesthetypeofanswerwhichisexpectedforaquestion.Questiontypesareforexampleclosed,open,

numerical,etc.

Questionoption

Defineswhatspecialpropertiesananswermusthaveorhowanswercategorieswillbedisplayed.Thereare

questionoptionstoallowmultipleanswers,setamaximumvaluetobeentered,showanswercategoriesin

randomorder,etc.

Answeroption

Definesthebehavioroftheprogramwhenananswercategoryischosen.Thereareansweroptionsto

preventthatanansweriscombinedwithotheranswercategories,topromptforanopenanswer,etc.

QuestionsandAnswers

Closedquestion

Aquestionwheretheanswerisexpectedtobeachoicefromafixednumberofanswercategories.

Answercodecategory

Oneofthepossibleanswersdefinedfora(semi)closedquestion.

Openquestion

Aquestionwheretheanswerisexpectedtobeenteredliterallyastext.

Semiclosed

question

Aquestionwheretheanswerisexpectedtobeachoicefromafixednumberofanswercategoriesand

wherechoosingcertainanswercategorieswillshowaboxtoentertheanswerliterallyastext.

Openendedanswer

Theliteraltextofananswerenteredforanopenorsemiclosedoropenquestion.

Numericalquestion

Aquestionwhereananswerisexpectedtobeanumericalvalue.

Textquestion

Aquestionwhereananswerisexpectedtobetextoflimitedlength.

Answercode

AnumericvaluewhichisstoredintheUfilewhenananswercategoryischosen.

Answerfield

A(seriesof)positionsintheUfilewhereanswercodes,valuesortextsarestored.

FilesandTables

Qfile(questionnaire)

ASCIIfilecontainingthequestiontextandalltheNIPOODINcommandsforrouting,etcetera.

Sfile(stratification)

ASCIIfile

containing

the

stratification

(quota)

criteria.

Page10


15/415

Introduction

Samplefile(Tfile)

ASCIIfilecontainingthegrosssample.EachrecordintheSamplefile(telephonefileorTfile)contains

information(telephonenumber,address,name,companysize,etc.)aboutone(future)respondent.

Sampletable

Tablein

the

database

containing

the

gross

sample.

Each

record

in

the

Sample

table

contains

information

(telephonenumber,address,name,companysize,etc.)aboutone(future)respondent.

Omnibustable

Tableinthedatabasecontainingtheomnibusinformation,forexamplethenamesandorderofsub

questionnaires.IfaTfileisusedinsteadofaSampletable,theomnibusinformationisstoredintheSample

record.

Ufile

ASCIIorUnicodetextfilecontaininganswercodesthatrefertochosenanswercategoriesofclosed

questions,valuesenteredfornumericalquestionsandtextsenteredfortextquestions.

Ofile

ASCIIor

Unicode

text

file

containing

all

open

answers

entered

by

keyboard.

Cfile

ASCIItextfilecontaininginformationforeachcontact.

Bfile

BinaryfilecontainingopenanswersenteredwithaTabletcomputer(usingthe*OPEN*BMPcommands)and/orrecordedanswers(usingthe*RECcommand).

Dfile

BinaryfilecontainingtheSuspendImage(incaseofaTfile).WhenaSampletableisused,theSuspend

ImageisstoredintheSuspendI magefieldintheSamplerecord.

TypographicalConventions

Inthismanualthefollowingtypographicconventionsareused:

Page11


16/415

Introduction

Example Convention

*QUESTI ON 1 *CODES 61L2 TheCourierfontindicatessyntaxdescriptions,argumentdescriptionsorscriptexamples.

Qn, Qm Insyntax,ifanargumentreferstoaquestion,nindicatesthenumberofthequestion.Ifasecondargumentalsoreferstoaquestionthenm

indicatesthesecondquestionnumber.

var , numvar , t xt var Ifanargumentreferstoavariableorarray,varindicatesbothnumericandtextvars.Numvarindicatesanumericvariableand

txtvarindicatesatextvariable.

Expr essi on Ifanargumentreferstoanexpression,theexpressionwillfirstbeinterpretedandcalculatedandthentheresultisused.

Anglebracketsencloseobligatoryarguments.

[ Argument ] Squarebracketsencloseoptionalarguments.

Argument | Argument 2 Averticalbarseparatestwomutuallyexclusivechoices.

Ar gument [ , Ar gument2, ] Threedotsindicatethatanargumentcanberepeatedinalistanynumberoftimes.Acommaseparatesthelistedarguments.

or [ [ Ar gument ] ] Squarebracketsenclosedbyangleorsquarebracketsarepartoftheargument.

or [ "Ar gument " ] Doublequotesenclosedbyangleorsquarebracketsarepartoftheargument.

Size Indescriptions,italicwordsrefertoapartofthesyntax.

ContactingUs

Forsupport,licensinginformation,productnewsoranyotherqueriesorfeedbackregardingNIPOSoftware

products,feel

free

to

contact

us

by

phone

or

by

mail.

NIPO

Software

has

three

offices

around

the

globe

checktheofficenearesttoyourtimezoneforfeedbackduringyourworkinghours.

ContactingNIPOSoftwareSales

Foranyqueriesonyourlicense,onlicensepricingortoreceiveinformationonanyotherNIPOSoftware

products,pleasecontacttheNIPOSoftwareSalesdepartmentduringworkinghours.

NIPOSoftwareSalesAmsterdam

GroteBickersstraat74

1013KS

Amsterdam

TheNetherlands

Tel:

+31

20

5225

989

(GMT

+1)

Email:[email protected]

ContactingtheNIPOSoftwareHelpdesk

Inthecaseofanyqueriesorissuesnotcoveredinthisguide,orwhenexperiencingtechnicaldifficulties,

youcancontacttheNIPOSoftwareHelpdeskatthreeofficesworldwide.

Page12


17/415

Introduction

Page13

Ifcontactingbymail,pleaseencloseversioninformationandthefile(s)associatedwithyourquestionor

problem.PleaseZIPyourfilesbeforesending.

Ifcontactingbyphone,contacttheofficenearesttoyourtimezoneforimmediateassistance.

NIPOSoftwareHelpdesk


1013KS

Amsterdam

TheNetherlands

TheEMEAoffice(Amsterdam):+31205225980(GMT+1)

TheAPACoffice(HongKong):+85221164119(GMT+8)

TheAMERoffice(BuenosAires):+541148916470(GMT3)


YourFeedbackonthisGuide

Developmentanddocumentationarecontinuouslyongoingprocesses.Newfeaturesareadded,issuesare

solvedandfunctionalityisimproved.Althoughwestrivetokeeptheinformationinourdocumentationup

todateandaccurate,wecannotguaranteethatthisguideiswithouterrorandomission.Youare

encouragedto

contact

us

to

inform

us

of

shortcomings

in

all

our

help

files,

on

line

documentation

or

printedmaterial.Suggestionsandopinionsarealsowelcomed.

Whenprovidingfeedback,pleasemakesuretomentionwhichguideyouarereferringto.

NIPOSoftwareDocumentation


1013KS

Amsterdam

TheNetherlands



18/415


19/415

VersionHistory

ChangesinNIPOODINScriptLanguage

ChangesinNIPOODINScriptLanguage5.16

Introducedexportcommand*TABLEtosupporthierarchicaldataexportsfor*FORMquestionsand*REPEATblocksusingtheNIPODSCforSPSSDimensions.

ChangesinNIPOODINScriptLanguage5.15.001

Fixedthe"FatalErroronposition1L1"errorthatcausedsurveystobeblockedforfurtherinterviewing.

The

issue

could

be

caused

by

a

series

of

actions

performed

by

the

interviewer.


ThelibrarySTDRUN32. DLLcommandhasbeenextendedtosupportexchangeofdatausingan

externalfileratherthantheclipboard.

ImprovedinterviewprogressbarforNIPOCAWIandNIPOCAPItheprogressbarnowcorrectlymaxes

outtowards100%andhasbetterhandlingof*REPEATblocks. A*CONTROLona*FORMquestionwith*AUTOnowhidestheentirerowratherthanleavingasingle

visiblelineonthescreen(NIPOCAPIonly).Without*AUTO,theserowsgettheODI NFORMHI DDENROWselectorsotheymaygetcustomstyling.

Textsbothbeforeandbehindfieldsin*FORMquestionsarenowproperlyhidden(styleapplied)when

theircodes

are

made

(in)visible

through

the

use

of

*CONTROL

(NIPO

CAPI

only).

ThefollowingHTMLselectorshavebeenaddedforNIPOCAPI:odi nf ormel ement af t er ,

odi nf or mel ement af t er N,odi nf or mel ement af t er- even,odi nf or mel ement af t er -odd,odi nf or mel ement af t er _f i r st ,odi nf or mel ement af t er_ l ast ,odi nf or mel ement af t er - pl acement - N,odi nf ormel ement af t er - pl acement _even,odi nf ormel ement af t er - pl acement - odd,odi nf or mel ement af t er - pl acement - f i r st andodi nf or mel ement af t er- pl acement - l ast .


The*TABcommandcannowbeusedtoinfluencecodescolumnswhenusing*AUTO(NIPOCAPIClient

12.06andabove)

The*SI ZEcommandhasbeenextendedfortheNIPOCAPIClienttosettheheightoffullyopenendedanswerandbitmapanswer(*BMP)boxesandtosetthewidthandheightofsemiopenendedanswerandbitmapanswerboxes.

The*DATEcommandinan* I NI Tblocknowalwayscorrectlystoresthecurrentdatewhenfollowing

upappointmentsorsuspendedinterviews.

FixedacrashintheNIPOCATIClientandpreviewswhenusing*FORM,*SCALEand*ORDERinasinglequestion.

Page15


20/415

VersionHistory


Theabilitywasaddedtointerviewmultiplerespondentsatthesametelephonecontactusing

*NEXTRECORD. Newscriptcommand*SQLADDtoaddrecordstoadatabasetable(NIPOCATI/NIPOCAWIonly).

UseMulti

Byte

Character

Fields

to

store

multi

byte

languages

(Chinese,

Japanese,

etc)

in

non

Unicode

datafiles

*I NCLUDEand*EXCLUDEnowsupportranges. Reintroducing*VCONTROLfor*GRI Dquestionstohideordisablecolumnsbasedontheanswersina

previousquestion.

Asoffversion12.06theNIPOCAPIClientnolongeroccasionallyhangswhenusinga*CONTROLin

*FORM*SCALEquestion.


ReleasedwithNIPOCAPIClient5.01only.

Youcan

now

refer

to

fields

in

a*FORMquestion

using

both

literal

numbers

and

expressions.


New(NIPOCATIonly)scriptcommand*NEXTRECORDtocreatesamplerecordsontheflyand

interviewmultiplerespondentsduringthesamecall(version5.11.006andhigher;releasedafterNIPO

FieldworkSystem1.07asanintermediateupdate)

SystemvariablessuchasSTOPWATCH[ 3] and_I SCATI nolongerneedtobedefinedwith*VARSor*TEXTVARS

Introduced*SCALERANGEtodefinealternatevaluesfora*SCALEquestionorfield Introduced*I NTROtospecifydifferentintroductiontextsbasedonthechannel(NIPOCATI,NIPOCAPI,

NIPOCAWI)aswellassetdialingintroductionscreens.

Newscript

command

*HEADI NGto

create

headings

above

alist

of

categories.


MinorupdatetomaketheNIPOODINScriptlanguageparserandenginesupportthelatestMicrosoft

FoundationClasses.


Asuspendimageisnowcorrectlyinterpretedtotheoriginalchannel(aswas)ratherthanthecurrent

channel(asis).


CompleterewriteoftheNIPOODINscriptlanguageforWindows32bitplatforms,introducinganumberof

newcommandsandanewapproachtohandlingscriptparsing,executionandsuspension.

Page16


21/415

VersionHistory

IntroducingComputerAssistedWebInterviewing(CAWI)foronlineinterviewing.

IntroducingtemplatesandstylesheetstoenhancethelookandfeelofCAWIquestionnaires(Seethe

NIPOODINHTMLGeneratorScripter'sGuidefordetails).

Introducingsampletables,storingsampledataindatabasefieldsratherthan(ASCII)Tfiles.

Introducingsuspendimages,whicharerecordingsofinterviewsupuntilappointments.Suspendimages

arereplayed

by

the

engine,

preventing

small

changes

to

the

questionnaire

from

restarting

asuspended

interview.

Scriptsarenowparsedintoabytecodeformatandexecutedbyaruntimeengine,leadingtostricter

syntaxvalidationandfasterexecution.

Introducingchannelawarescripting,withsystemvariables_I SCATI,_I SCAWI ,_I SCAPI,_I SCASIand_CHANNELtocheckonwhatchannelthequestionnaireisbeingexecuted.

Newscriptcommand*SAMPLEDATAtoreferencesampletablefieldsdirectlyasvariables,ratherthan

usingpositionsinaTfile(the*ADDRESSscriptcommandnowautomaticallymapstopositionswithinthesampletablefields)

Newscriptcommand*ORDERtodisplaycategoriesinanorderofmentionsandtoexecutea*REPEAT

loopinanorderofmentions.

Newscriptbrackets toexecuteHTMLandJavaScriptinlineinCAWIquestionnaires.

Newscript

command

*SQLGET

to

retrieve

data

from

one

or

more

rows

in

adatabase

table

(other

than

thesurvey'ssampletable).

Newscriptcommand*SQLPUT tostoredatainoneormoreexistingrowsinadatabasetable(otherthanthesurvey'ssampletable).

The*TABcommandnowdefinespercentagesofthescreenorwindowwidthratherthanamountsof

characters

Scriptcommand*LANGUAGEnowalsoacceptsanRTLparametertodisplayrighttoleftlanguagessuchasHebrewandArabiccorrectly.

The*RUNscriptcommandnowusesSTDRUN32. DLLtoexecuteWindows32bitapplications SystemvariableSTOPWATCH[ 3] nownolongercountsthetimebetweensuspension(appointment)

andcontinuationofaninterview.

Page17


22/415

VersionHistory

ChangesinNIPOODINDeveloper

ChangesinNIPOODINDeveloper5.14

Forall

exports,

you

can

now

combine

Include

open

ended

answers

and

Retain

ODIN

data

format.

The

openendedanswersareappendedasfixedlengthfieldsattheendofeachrecord.

Forallexports,openendedanswersarenowdefinedandexportedevenifnoopenendedanswershave

beengivenforanyoftheexportedinterviewrecords.

FixedanissueintheSPSSPCexportwhereusingdecimalsin*NUMBERdefinitionscausedthenexttwoquestionstorefertothesamedatafieldwhileshiftingallremainingdatapositions,whennotretaining

theNIPOODINDataformat.

Formultiplecodedquestions,theexportsettingUsecodenumbersforMultipleDichotomyfieldsno

longercreatesvariablesfortheentirerangeofcodesiftherearegapsinthecodenumberingofthe

question.

Forallexports,ifusingasinglequestionwithmultiple*OPENcodes,thecorrespondingvariablesareno

longercreatedinreverseorder.

Fixedan

issue

where

multiple

*OPEN

codes

in

asingle

question

caused

the

export

to

create

too

many

variables.

FixedanissuewhererunningaNIPOCAWIpreviewcouldpopupanerror"Aproblemoccurredwhile

writingthetemporaryhtmlfile,pleasecheckifyourtemplatedirectoryissetupcorrectly".

Fixedanissuewhere(rangesof)variableswerenotexportedbecausethefilteringsuggestedthese

variablesremainedempty.TheNIPOODINDevelopernolongermakesassumptionsaboutthecontents.

Fixedanissuewheretheerrormessage"Error:Illegalarrayindex:0"wasincorrectlyreportedforscripts

referringtoarrayindexesbyvariable.

Fixedanissuewherethemessage"Anerroroccurredduringimport:Cannotaccessaclosedfile"

appearedduringanNfieldCodeimport.

TheNIPOODINDevelopernolongercrashesonasyntaxcheckifaclosingquoteismissingina*BUTbuttontextdefinition.

ChangesinNIPOODINDeveloper5.11.003

AddedsupportforMicrosoftWindows7.

AnimportofanNfieldCodefilenolongerfailsonduplicateCodeFrames.


AddedaGridComposertoquicklyinsert*FORMquestionswithscales. TheTempl at eRel at edFi l esdirectoryforNIPOCAPIandNIPOCAWIarenowseparately

configurable.

AddedNfieldCodeimportandexportfacilities.

Youcan

now

export

Xfiles

of

the

NIPO

Coding

Module

4.08

to

Nfield

Code.


AddedQPSandQuantimeexports.

OpeninganI NI fileofanomnibussurveynowcorrectlystartsthesubsurveysofsurvey. *HEADI NGtextsarenowcorrectlydisplayedinquestionpreviews. Fixedanissuewheresomevariableswentmissingduringanexport.

Fixedanissuewhere*OPENendedcodescpi;dyieldinduplicatevariablenames.

FixedanoccasionalcrashwhenstartingorcheckingaCAWIquestionnaire.

Page18


23/415

VersionHistory


NIPOCATIpreviewnowsupports*NEXTRECORD.

Addedsyntaxhighlightingfornewcommands.

Fixedissuesintheoverviewofunusedquestionsinthesyntaxcheck.

FixedIBM

SPSS

export

issue

where

incorrect

data

lists

were

occasionally

saved

for

multiple

dichotomies.

Exportof*FORM*SCALEquestionsofNIPODiananolongeroccasionallymixesuplabeltexts. FixedanissueinimportingAscribedcodeddataifthecodedsurveywaspartofanOmnibus.


IntroducedaNIPOCAPIClientpreviewforquestionnairetesting.

YoucannowincludeopenendedanswersinexportstoSSSandSPSSPCdatasetswithouttheneedto

codethem.

Addedarightclickmenuoptiontoopenaquestionnairefilesetinthe*MERGEcommandorinthe

surveyconfigurationfile.

YoucanopenandsyntaxcheckallsurveyswithinanOmnibusquestionnairebyopeningthesurvey

configurationfile

for

the

Omnibus.


AddedanexporttotheIBMSPSSformat.

AddedanexporttotheQuantimeformat.

Addedanexportforbitmap(*BMP)andsoundrecordings((*REC)fromtheBfile.

Improvedexportof*FORMquestionswith*SCALEor*GRI D. Addedanoptiontoinsertcodenumbersinfrontrowsoftext.

Page19


24/415

VersionHistory


YoucannowsyntaxcheckandrunallquestionnaireswithinasingleomnibussurveybyopeningtheI NI

configurationfile.

Questionnaires cannowbedisplayedinbidirectionallanguagessuchasHebrewandArabic.

TheResults

window

of

asyntax

check

now

keeps

the

results

of

previous

syntax

checks

to

compare

differences.

Asyntaxchecknowissuesawarningfora*CODESquestionwithquestiontextbutwithoutcodes. ThekeycombinationCTRL+SHIFT+8togglesdisplayingtabandspacecharacters.

Addedrightclicktoquicklyinsertquestiondefinitionsorchangequestionoptionsthroughdialogs.

Asyntaxchecknowissuesawarningifthequestionnairehasanyunfixedpositions.

Addedanexportto/importfromAscribefromLanguageLogic.

YoucannowselecttopreviewaquestionnaireinNIPOCATIorNIPOCAWI.

YoucannowselecttopreviewasinglequestioninNIPOCATIorNIPOCAWI.

Addedanoptiontoviewvariablecontents(NIPOCATIonly).

Addedanoptionaddorremovecomments(**)foraselectionoftext. Fixingaquestionnaireautomaticallydefinesvariablesthathavenotpreviouslybeendefinedwith

*SAMPLEDATA,*VARS

or

*TEXTVARS

as

*TEXTVARS.

Addedanoptiontoremovecommandstocreate*LANGUAGEsectionsbasedonthequestionnaire. Youcannowcreatequestionnaires inUnicode.

Apreviewofaquestionnaireallowsyoutotestroutingforstratification reachedcases.

YoucannowuseregularexpressionsintheFinddialog.

AddedanoptionMarkallintheFinddialogtomarkeveryoccurrenceinthesidebar.

TheNIPOODINDevelopernowsupportsaworkbookmodeformultipledocumenthandling.

Thescripteditorwindownowsupportsconfigurablesyntaxhighlighting.

AddedaNIPODianaexport.

YoucannowconfigurethemaximumallowedrecordlengthforNIPOODINquestionnaires.

Thereisnowaseparatefileopenoptiontoopenfileswithamaximumrecordlengthof99,999.

Addedanautosaveoptiontoperiodicallysavebackupsofallopenedfiles.

Youcan

now

configure

file

types

to

list

in

File

>Open

and

File

>Save

(as...)

dialogs.

Addedasettingtooptionallyrememberthelastusedfiletypefilter.

Youcannowconfiguretoprintheaders,footersandlinenumbersinscriptprints.

Thesyntaxchecknowreportsanerrorifa*FORMquestiondoesnotcontainany*NUMBER,*ALPHA,

*GRI Dor*SCALEfields.

DutchCommandSetDropped

TheDutchcommandsetforNIPOODIN,obsoletesincetheintroductionofNIPOFieldworkSystemproducts

forMicrosoftWindows,isnolongersupported.

MigratingSurveysFromNIPOODIN4.08

SurveyscriptsthathavepreviouslyrunontheNIPOODINInterviewSystemorNIPOCOMPASSmay

generallyrunwithoutproblemsontheNIPO32bitinterviewsoftware.However,duetotheintroductionof

ascriptparserandengineandseveralotherenhancementssuchassampletables,somechangesmaybe

necessarytorunasurveyasrequired.Checkyoursurveysagainstthissectionbeforedeployingitonany

NIPOSoftwaresystemthatusesthe32bitclientswiththeODINScriptlanguageversion5andabove.

Page20


25/415

VersionHistory

*WAITCRCommandDroppedforNIPOCATIandNIPOCAWI

Thescriptcommand*WAI TCRhaslimitedsupportandisavailableforNIPOCAPIscriptsonly.ItisnolongersupportedinNIPOCATIandnotsupportedforNIPOCAWI.

Dutchcommandsetnolongersupported

ItisnolongerpossibletousetheDutchcommandsetinNIPOODIN;youmustusetheEnglishequivalents.

ObsoleteCommandNames

AsofNIPOODIN5,thefollowingobsoletecommandnamescannolongerbeusedandmustbechangedto

theirnewmodernequivalent.

Replacedcommandsthatarenolongersupported

Oldcommand Newcommand

*OR

*I NCLUDE

*XOR *EXCLUDE

*MOVE *COPY

*PLAYWAI T *WAI TPLAY

*REPETE *REPEAT

*PLAYNoLongerSupportedAsaQuestionOption

ThefollowingsyntaxisnolongersupportedinNIPOODIN5.

Valid

ODIN

4.08

syntax

example

*QUESTI ON 7 *CODES L1 *PLAY " movi e. mpeg"Do you recogni se t hi s advert i sement ?

1: Yes2: No

*PLAYisnolongerallowedasaquestionoption.*PLAYmustbespecifiedonaseparatelineorafterafilter.

ValidODIN5syntaxexample

*PLAY "movi e. mpeg"*QUESTI ON 7 *CODES L1Do you recogni se t hi s advert i sement ?

1: Yes2: No

VerticalLineQuestionNotSupportedinNIPOCAPIandNIPOCAWI

TheverticallinequestionisnolongersupportedinNIPOCAPIandNIPOCAWI.

NIPOODIN4.08VerticalLineExample

*QUESTI ON 10 *LI NE L3 *MI N [ 0] *MAX [ - 100]Sel ect your score i n percent age.

Youshoulduseahorizontallineinstead,usingapositivenumberforthe*MAXparameter.

Page21


26/415

VersionHistory

*CENTREDoesNotProperlyCenterHeadingTexts

IntheNIPOCATIandNIPOCAPI,headingsarenotcenterediftheapplicationisconfiguredtocentercode

labels.Inthefollowingexample,headingtextswillleftaligntothecodes.

HeadingTextsExample

*QUESTI ON 10 *CODES L1Choose your f avori t e br and:

*HEADI NG "Ger man"1: BMW2: Mercedes*HEADI NG "Fr ench"3: Renaul t4: Ci t r oen

SelfModifyingScriptNoLongerSupported

Selfmodifyingscriptisscriptthatisabletochangeitselfatruntime.InNIPOODINthiswasdonebyplacing

scriptcommands

and

categories

in

text

variables,

and

then

displaying

the

content

of

that

script

variable

on

aparticularlineinthescript.Suchconstructionswerepossibleduetothenatureofthe4.08interpreter.

Withversion5aparserisintroducedthatcompilesthescript,requiringastrictsyntaxandmakingself

modifyingscriptimpossible.Belowareafewpopularexamplesofselfmodifyingscript,andalternatives

thatcanbeusedtoobtainthesameresultinNIPOODINScriptlanguageversion5andabove.

Example1:Insertingpictures

*TEXTVARS FI GURE

*PUT FI GURE "*PI CT *?NR"*QUESTI ON 1 *CODES L1 "*?FI GURE"

Sincethe*PI CTcommandallowsvariableparameters,thisconstructioncanbeomitted.

Example1:NIPOODIN5Alternative

QUESTI ON 1 *CODES L1 *PI CT [ NR ]

Example2:Togglingthefilter

*TEXTVARS Condi t i on*PUT Condi t i on "* I F [Q1, 1] "*QUESTI ON 1 *CODES L1 "*?Condi t i on"

Thiskindofconstructioncanbeavoidedalltogetherbycreatingabetterfiltercondition.

Example3:Showingandhidingcodes

*TEXTVARS DONTKNOW*I F [ Q2, 1 ] *PUT DONTKNOW "9: Don t know"*QUESTI ON 3 *CODES L1

Do you own a VCR?

1: Yes2: No*?DONTKNOW

Thiskindofconstructionmakesitimpossibletodeterminecodelistsonexports,andcanbeavoidedwith

*CONTROLon*DUMMYquestions:

Page22


27/415

VersionHistory

Example3:NIPOODIN5alternative

*QUESTI ON 4 *CODES L1 *DUMMY

*I F [ Q2, 1 ] *EXCLUDE Q4 Q4 *ELSE * I NCLUDE Q4 [ 9 ]

*QUESTI ON 3 *CODES L1 *CONTROL Q4 NDo you own a VCR?

1: Yes2: No9: Don' t know

Ifmorethanonecodeneedstobetoggled,a*MULTI questionshouldbeusedforQ4.Ifusinghighcodenumbersincombinationwith*MULTI causeslargegapsinthedata,adummycanbereusedasrequiredbyclearingitscontentusing*EXCLUDE Q4 Q4.

Example4:Variablescalelength

*QUESTI ON 2 *NUMBER L1 *SAVE Scal eLenHow l ong do you want t he scal e t o be?*QUESTI ON 1 *FORM

1: *SCALE 61 [Scal eLen] 28Variablescalelengtharenolongerpermitted,butstronglyrecommendedagainstfromamethodological

pointofview.Ifdifferentscalelengthsarerequired,useseparatequestions.

ForwardSlashesNoLongerSeparateCodeLabels

InODIN4.08multiplecodescouldbeplacedonasinglerowbyseparatingthembyforwardslashes.

ExampleofODIN4.08scriptusingcategoriesseparatedbyslashes

*QUESTI ON 5 *CODES L20 *MULTIWhi ch br and do you know?1: Br and A / 4: Brand D / 7: Brand G2: Br and B / 5: Brand E / 8: Brand H3: Br and C / 6: Br and F / 9: Br and I

19: None of t hese

NIPOODIN5uses*AUTOand*NEWCOLUMNtocreatecolumnsofcodesautomatically:

AlternativeinNIPOODIN5

*QUESTI ON 5 *CODES L20 * MULTI *AUTOWhi ch br and do you know?1: Br and A2: Br and B3: Br and C *NEWCOLUMN4: Brand D5: Br and E6: Brand F *NEWCOLUMN7: Brand G8: Br and H9: Br and I

19: None of t hese *STOPAUTO

Note:

INNIPOCATIthecolumnsareonlycreatedifthepagebecomestoolongtofitinthewindow.Since

NIPOCAPIandNIPOCAWIarebrowserbasedtheheightofthewindowcannotbedecided;use

*NEWCOLUMNtoforcecolumnswhererequired.

Page23


28/415

VersionHistory

CopyingPositionsFromaTfileIsLimitedtoFieldLength

Sincetheintroductionofsampletables,theNIPOODINScriptlanguageinternallyreferencesdatabase

fields,evenwhencopyingdatafromaTfile.Positionsreferencedwith*ADDRESSaremappedtodatabasefields.Thismeansthatyoucannotcopypositionsthatexceedthelengthofthedatabasefields.

Example

Script Result

*PUT NAME 251L50 Only35positions(251285)arecopiedbecausethefieldDi spl ayFi el d4islength35(251L35).

*MOVA 101L50 201L50 Only15positions(201215)arecopiedbecausethefieldDi spl ayFi el d2islength35(181L35).

Takespecialcarewhencopyingdatafrom,orinto,literalpositionsusing*ADDRESS.Ifpossible,replace*ADDRESSwithreferencestotheactualfieldnamesusing*SAMPLEDATA.

*AUTONot

Supported

in

NIPO

CAWI

The*AUTOcommandisnotsupportedfortheNIPOCAPIandNIPOCAWIastheenginecannotdeterminetheheightofthebrowserwindow.Use*NEWCOLUMNtosplitthecategoriesintocolumns.

*INITblockisExecutedBeforeSuspendImage

Asuspendimagereplaysapreviously'recorded'interviewusingthecurrentquestionnaireupuntilthefirst

unansweredquestionbeforehandingbackcontroltotheinterviewerortherespondent.Thisfeatureis

usedtofollowupinterviewswithappointmentsorsuspendedCAWIinterviewsandcontinuewherethe

interviewwaslastleft.Inthe32bitclient,an* I NI Tblockisusedtoexecutescriptbeforeresumingtheinterruptedinterview.Thisblockisexecutedbeforethesuspendimageisexecuted.

ThisissignificantlydifferentfromtheAfileimplementationintheNIPOInterviewSystem16bit,which

containedonlythecontentsofvariablesandthequestionnumberwheretoresume.The* I NI Tblockisexecuteddirectlybeforethequestionwheretheinterviewisresumed.Thismadeitpossibletomakechecks

onvariablesorquestionsthatwerefilledinaprevioussession.

Thismeanstheexecutionofthe* I NI TblockintheNIPOInterviewSystem32bitmayleadtodifferentresultsascomparedtothe16bitversion,asvariablesandquestionswillnolongercontainvaluesfrom

previousruns.Thereforean* I NI Tblockcannolongerrelyonvariablesfilledinpreviousinterviewsessions.

Ifthe* I NI Tblockisusedtodisplaysomevariablesfromaprevioussession(likeacounter),youcanstorethiscounterinthetelephonefileorsampletableandusethe*COPYcommandtoretrievethisdata.

SelectingAnotherCharacterSetinthe*FONTCommand

Itisnolongerpossibletochangethecodepagecharactersetwithinyourquestionnaire.UseUnicode

insteadwhenthedefaultcharactersetofWindowsdoesnotsupporttherequiredcharactersforthetarget

language.

Page24


29/415

VersionHistory

Page25

DuplicateInterviewNumbersinTfiles NoLongerContacted

WhenconductingasurveyusingTfiles,withtheintroductionofNIPOODIN5theNIPOFieldworkSystem

nowchecksifacompleted(successful,definitenonresponse)interviewforthatinterviewnumberwas

storedintheDfile(thefilecontainingthesuspendimagesorinterview'recordings').Ifthisisthecase,the

duplicateinterview

number

is

flagged

with

response

code

26.

Only

if

there

is

no

definite

response

code

for

thatinterviewnumber,therecordisreused.ThismeansthatreplacingaTfilenolongerallowsthereuseof

values.

WhenusingaTfileintheNIPOFieldworkSystem,interviewnumberscanbepresetinposition52L8before

startingasurvey.Thesenumbersneedtobe8digitswithleadingzerosandshouldbeunique.TheNIPO

FieldworkSystemdoesnotdistributeTfilerecordswithduplicateinterviewnumbers.Duplicateinterview

numbersareflaggedwithresponsecode26.

Stopwatch[1]andStopwatch[2]NotSupportedinNIPOCAPIandNIPOCAWI

SystemvariablesSTOPWATCH[ 1] andSTOPWATCH[ 2] arenotsupportedinNIPOCAPIandinNIPOCAWI

becausethey

cannot

be

properly

or

accurately

implemented

in

an

HTML

and

JavaScript

interface.

UsingCodeNumbersina*FORMQuestion


30/415


31/415

UsingtheNIPOODINDeveloper

The

NIPO

ODIN

Developer

is

the

NIPO

ODIN

script

author's

tool.

It

can

be

used

for

the

following

purposes:

Create,editandsyntaxcheckquestionnairesforNIPOCATI,NIPOCAPIandNIPOCAWI

RunapreviewofthequestionnaireinNIPOCATI,NIPOCAPIorNIPOCAWI

CreateandeditpicturelibrariesforusewithNIPOODINquestionnaires

Generatedummy(test)datatoverifyquestionnaireintegrity

Exportsurveydataforstatisticalanalysisinvariouspackages.

ThissectionbrieflydiscussesanumberoffeaturesoftheNIPOODINDeveloper.

TheScriptEditorWindow

LineSize

AlineintheNIPOODINDevelopermaybeupto4000characterslong.Scrollinginaverylonglinemightbe

slow useEdit>Gotopositiontoeasilyplacethecursoronacertainposition.Toopenlargerfiles,select

File>Opendatafile...fromthemenu.

ToggleDisplayingTabsandSpaces

ClickCTRL+SHIFT+8toshowthetabandspacecharactersintheNIPOODINDeveloper.Notethatthe*TABcommandinyourquestionnairedoesnotinfluencetheeditoroftheNIPOODINDeveloper.Useapreview

toseetheliveresult.

PopupMenuOptions

Foranyopenfileinthescripteditorwindow,rightclickanywheretoopenthepopupmenu.Thissection

describesanumberofthoseoptions.

OpenQuestionnaireFile

Whenreferringtoanotherfileinyourquestionnaireusing*MERGEorinasurveyconfigurationfileyoucanopenthefilebyrightclickingtheselectingthefilenameinthetextandselectingOpenDocumentfromthe

popupmenu.

Examplequestionnaire

*MERGE I NI TQ

Examplesurveyconfigurationfile

[ Fi l es]Q=""OMNI BUSQ" "TVQ" "PCQ" "CARQ" "ENDQ""

QuestionPreviewinNIPOCATI/CAWI/CAPI

RightclickalinewithaquestiondefinitionandselectQuestionPreviewfromthepopupmenutopreview

thequestioninNIPOCATI,CAWIorCAPI.Alternatively, selectODIN>QuestionPreviewfromthemenu.

Adialogappearstoentervaluesforrelevantvariablesusedinthequestion.Filtersareignored.

Page27


32/415


InsertingQuestionDefinitions

TosimplifycreatingNIPOODINQuestionnaire, rightclicktheeditorwindowandselectInserttochoose

fromtheavailablequestionoptions.

Insertingaquestion

ChangingQuestionOptions

Rightclickonaquestionlinetochangethequestionoptions.Dependingonthetypeofquestion,oneofthe

followingdialogboxesappears.

Changingthegeneralquestionoptions

Page28


33/415


Changingthequestionoptionsfora*CODESquestion

Changingthequestionoptionsfora*NUMBERquestion

Page29


34/415


Changingthequestionoptionsforan*OPENquestion

Changingthequestionoptionsforan*ALPHAquestion

Page30


35/415


Changingthequestionoptionsfora*SCALEquestion

Changingthequestionoptionsfora*LINEquestion

ChangingCodeOptions

Rightclickonacategorycodelinetochangethecodeoptions.Thefollowingdialogappears.

Page31


36/415


Changingthecodeoptionsina*CODESquestion

GridComposer

Auser

friendly

Grid

Composer

is

available

to

generate

the

scripting

of

grids

and

scales

efficiently

with

adequatespacing.RightclicktheeditorwindowandselectInsert>Gridquestionfromthemenu.

EntersomeparametersintheInsertGridQuestiondialogandclickOK.Thescriptforthegrid/scalesis

insertedintothescriptintheQfile.Youcanquicklycreatethescriptofgrid/scalesof*MULTI , *SCALE,*GRI D, *NON,*CONTROL,VCONTROLcommandstobefurthermodifieduponyourneeds.

Examplegridcomposerentry

Page32


37/415


Dialogdescription

Description Meaning

QuestionNumber Thequestionnumberforthisgrid/scales

Checkthistoappend*MULTI toall*SCALEcommandsorthe*GRI DcommandMultipleanswersallowed

Checkthistoappend *NONtothe*QUESTI ONcommandNoanswerallowed

Thelocationofthestatementsdeterminewhetherthecomposerwillgeneratea*GRI Doroneormore*SCALEcommands.Ifthestatementsareonthexaxis,agridisgeneratedandall*CONTROL/ *VCONTROLoptionsareavailable.

Ifthestatementsareontheyaxisoneormore*SCALEcommandsaregenerated.Theoptiontohidethecolumnheaderwillbegrayedoutasthiscombinationisnotpossible)

Statementsonthexaxis/yaxis

Selectingandenteringthequestionnumbertobedependentonresultsina*CONTROLstatementbeingaddedafterthe*QUESTI ONstatement.

Undercontrolofquestion

SelectingresultsinaWafterthe*CONTROL/ *VCONTROL,elseanNisgenerated.Include

Hidecolumnheaderifunder

control

Onlyavailablewhenstatementsareonthexaxistohidecolumnheadersifundercontrol.

Selectingitresultsin*VCONTROLreplacing*CONTROL.

Addanew

statement

or

scale

item.

Deletethecurrentlyselecteditem.

Movethecurrentlyselecteditemupinthelist.

Movethecurrentlyselecteditemdowninthelist.

Reloadprevious Reloadthedataofthelastinsertgrid.

Insert InsertthescripttotheQfile.

Cancel Cancelinsertionofagrid.

Note:

Thegridcomposerworksasawizard:onceinserted,thegridcomposercannolongerbeusedto

modifythegrid.Modificationsneedtobedonedirectlyonthescript.

Validityofthequestionnumberandcontrolquestionnumberinthegridcomposerarenotchecked

againstthequestionnaire.Runasyntaxchecktocheckforerrors.

Thesizeofthefieldassociatedwith*SCALEiscomputedbasedonstandardscalesthatstartfrom1.If*SCALERANGEcommandwithnegativevaluesisused,thecomputedfieldlengthmayhastobemanuallyadjusted.

Page33


38/415


Example1usingtheGridComposer

Example1resultscript

*TAB 20, 40, 60, 80, 100*QUESTI ON 2 *FORM *NON *VCONTROL Q1 WWhy do you buy t hem?

appl e or ange banana pear

1: Easy t o buy *GRI D L12 3. 2 4. 4 *MULTI

Easy t o st ore

I nexpensi ve t o buy

Example1resultoutputinNIPOCATI(assuming'orange'and'banana'notselected)

Page34


39/415


Example2usingtheGridComposer

Example2resultscript

*TAB 20, 46, 72, 100*QUESTI ON 2 *FORM *CONTROL Q1 WWhy do you buy t hem?

easy t o buy easy t o st ore i nexpensi ve t o buy1: appl e *SCALE L3 3 1 * MULTI2: or ange *SCALE L3 3 1 *MULTI3: banana *SCALE L3 3 1 *MULTI4: pear *SCALE L3 3 1 *MULTI

Example2result

output

in

NIPO

CATI

SyntaxChecking

Youcan

now

syntax

check

your

questionnaire

by

selecting

ODIN

>Check

>Check...

from

the

menu.

A

dialog

appearsinwhichwarningoptionsmaybeconfigured.Warningsareissuesthatmayleadtounwanted

behaviorand/orlossofdata,butdonotpreventthequestionnairefromrunning.

Page35


40/415


NIPOODINDevelopercheckoptions

Youmayselectthefollowingoptions:

Dontsuppresswarnings.Allwarningsarereported.

Suppressallwarnings.Noneofthewarningsarereported.

Suppress.Youcanselectwhichwarningstosuppress.

Thefollowingwarningsmayoptionallybesuppressed:

Toomanypositionsforquestion.Appliesifmorepositionsaredefinedthanstrictlyrequiredtostore

theinput

data.

MAXpositionsforDiana.Appliesifmorethan32,000positionsareused,whichistherecordlimitfor

NIPODiana.

Multipleuseofposition.Appliesifaparticularpositionisaccessedtostoreinformationfrommorethan

onequestion.Thismaycausethedatatobeoverwritten.

Jumptopreviousquestion.Appliesifa*GOTO isusedtojumpbackinsteadofforwardinthe

questionnaire,whichmaycauseaninfiniteloop.Itisrecommendedtouse*BACKinstead. Codequestionwithoutcodes.Codequestionswithoutcodesareskipped,thereforeawarningcanbe

issuedifacodequestionmissescodes.

Missingquotes.Appliestoquotedtextwhereaclosingquoteismissing.

Maximumdatapositions

Setsthe

maximum

amount

of

positions

allowed

for

asingle

interview.

This

is

useful

to

match

NIPO

ODIN

to

thelimitofthestatisticalsoftwareinuse.

Filterduplicateerrormessages

Thislimitsthenumberofreportspererrormessage.Forexample,duplicateuseofapositionintheUfile

mayonlyneedtobereportedonce.

Keeppreviousresults

Resultsofaprevioussyntaxcheckarenotclearedforanewsyntaxcheck.

Keepresultsafterclosingfile

KeepstheResultswindowopenoncethequestionnairefileisclosedintheeditor.

Page36


41/415


WarningMessagefor*CODESQuestionWithoutCodeCategories

Ifnocodecategoriesaredefinedfora*CODESquestionawarningisdisplayeduponasyntaxcheck.Nowarningissuppliedifaquestiontextisalsomissing.

WarningMessageforUnfixedQuestions

YoucantestrunaquestionnairewithintheNIPOODINDeveloperNIPOODINDeveloperwithunfixed

questions,butcannotrunthequestionnaireinNIPOCATI,NIPOCAWIorNIPOCAWIwithunfixed

questions.

TheNIPOODINDevelopergivesawarningmessageuponsyntaxcheckifanyunfixedquestions(length

definitionswithoutpositiondefinition)havebeendefinedintheNIPOODINQuestionnaire. Onlyone

warningisevergeneratedforthefirstlinewhereanunfixedquestionwasfound.

SelectODIN>FixorclicktheFixbuttontofixthequestions.

Erroron

*FORM

Question

Language

Section

Mismatch

Thesyntaxcheckreportsanerrormessagewhena*FORMquestioninthelanguagesectiondoesnotcontainanyfields(*NUMBER,*ALPHAor*SCALE).Thesyntaxcheckalsoreportsanerrormessagewhenafield(*NUMBER,*ALPHAor*SCALE)isspecifiedinaquestionthatisnotdefinedas*FORM.

UndeclaredVariablesareCreatedwhenFixingaQuestionnaire

Ifavariableisnotdeclaredbeforeitisbeingused,awarningmessageappearsWhenfixingthedata

positionsorrenumberingaquestionnaire,thesevariablenamedeclarationsareautomaticallyaddedtothe

questionnaireas*TEXTVARSvariables.Makesurenomistakesaremadeinthevariablename,andverifyif*TEXTVARSisanappropriatetype.

ResultsWindowKeepsPreviousSyntaxChecks

TheResultswindowofasyntaxcheckkeepsprevioussyntaxchecks.Rightclickthewindowandselect

Removetabtoclosetheresultwindow.ClickonthecrossontheupperleftcornerorusetheView>

Resultsfromthemenutotoggleshowingthedockingwindow.

SyntaxcheckforOmnibusSurveys

Questionnaires thatarepartofanomnibus,mayusevariablesandquestionnumbersfromaprevious

questionnaireinthatomnibus.Iftheomni bus. I NI fileislocatedinthesamedirectory,thesystem

checksall

other

questionnaires

from

that

omnibus.

TestRunQuestionnaireinNIPOCATI/CAPI/CAWI

SelectODIN>RunfromthemenuandselecttopreviewthequestionnaireinNIPOCATI,CAPIorCAWI.

Page37


42/415


CheckRoutingforStratification

Whenusingthecommand*STRATinaquestionnaire,foreachoccurrenceamessagedialogstratification filled?Yes/Nopopsup.Selecttheappropriateanswertotestyourrouting.Notethatnotelephonefileor

sampletableisused.

ShowVariables

ForNIPOCATIandNIPOCAPIpreviews,youcanshowthecontentsofthecurrentlyknownvariablesby

selectingView>Viewvariables...fromthemenu.Notethatsystemvariables0through9andthe

CONJ TXTvariablesarealwaysavailableevenifnotused.Othervariableshavetobedeclaredwith*VARS,*TEXTVARSor*SAMPLEDATAfirst.

MenuOptions

Openall

Questionnaires

in

Omnibus

Survey

Whenrunninganomnibussurvey,youcandoasyntaxcheckonthesur vey. I NI file.

Allquestionnaireswillbecheckedintheordertheyaredefinedinthesetting

Q=""name1" "name2" " .

WhenscrollingthroughtheResultswindow(withthewarningsanderrors),theNIPOODINDeveloper

automaticallyopensallquestionnairesthatarepartoftheomnibus.Youcanalsoclickonalineinthe

Resultswindowtoopenaspecificquestionnaire.UseView>Workbookmodetomakeswitchingfromone

windowtoanothereasier.

Example

[ Fi l es]Q=""OMNI BUSQ" "TVQ" "PCQ" "CARQ" "ENDQ""

Asyntaxcheckisperformedonall5questionnairesandwillopenallfilesthatarenotalreadyopened,when

youscrollthroughtheResultswindow.

OpenDataFiles

Theregularscripteditoriscapableofmanagingupto4,000horizontalpositions.Toopenlarger(data)files,

selectFile>OpenDataFile...fromthemenu.Thisopensfilesupto99,999horizontalpositions,andcancels

syntaxhighlighting.

Remove

Commands

Tobeabletocreateamultilanguagequestionnaire,selectODIN>RemoveCommands...fromthemenu.

Thisoptioncreatesatranslatable*LANGUAGEsectionwithoutNIPOODINcommands,exceptfor*QUESTI ON,*FONTand*?var name,thatmaybelinkedtotheoriginalquestionnaireusingthe*LANGUAGEcommand.

Comment/Uncomment

SelectablockoracoupleoflinesandselectEdit>Commenttomakecommentsoftheseline.Thisinsertsa

** infrontofallselectedlines.SelectEdit>Uncommenttoremovethe** fromtheselectedlines.

Page38


43/415


CreateQuestionnairesinUnicode

Thismeansfullsupportforallnonwesternlanguages,likeHebrew,Arabic,Chinese,Japanese,etcetera.

UnicodeisenforcedbysavingthefileastypeUTF16.Verifythatsupportfortheselectedlanguageis

availableonthetargetedworkstations.

FindFunctionwithRegularExpressionsandMarkAll

SelectEdit>Findtosearchforspecifictextinyourquestionnaire.ClickMarkAlltomarkentriesfoundin

thesidebar.

Findfunction

StartEditorinWorkbookMode

SelectView>Workbooktoenableordisableshowingwindowsinaworkbookmode.Theworkbookmode

makesswitchingwindowseasier.

CreateCodeNumbersBeforeCodeLabelsandFields

Selectthelinesyouwanttonumber,thenselecttheODIN>Insertnumbersfromthemenu.Fillinthe

dialogasrequired.

The

NIPO

ODIN

Developer

does

not

immediately

verify

code

numbers

against

any

duplicates

or

against

the

questiondefinition.Tocreateuniquenumbers,donotupdatepartiallists.Usethesyntaxchecktocheckon

duplicatecodenumbers.Numberingisperformedonalllinescontainingacarriagereturn

Creatingcodecategorynumbers

Page39


44/415


Result:

TheNIPO

ODIN

Developer

TheNIPOODINDeveloperallowsyoutoexportyourdatatoavarietyofstatisticalsoftwarepackages.The

followingformatsaresupported:

NIPODiana/NvisionScript

TripleSXML

SPSSPortable

SPSSPC(scriptformat)

Ascribe

Quantime

Image/Sound

NIPODiana

TheexporttoNIPODianamaybeusedtocreatefilesthatmaybeusedbybothNIPODianaandNvision

Script.

Page40


45/415


ExporttoNIPODianavariables

Choosethefollowingoptions:

Language

Ifmorethanonelanguageisdefinedwithinthequestionnaire, selectthelanguagetouseforthequestion

andcodelabelsintheexport.

Addfilterstovariables

Anyquestionnairefiltersarealsodefinedinthevariables.

Variablenameinfrontofquestiontext

Thequestionlabelisprecededbytheexportnameofthevariable.Optionallyaddalinefeedtothevariable

name.

UseCODEnifnocodetextspecified

Forcodecategorylabelswithouttext,alabeliscreatedcontainingtheword'CODE'followedbythecode

number.

Questionninfrontofquestiontext

Allquestiontextsareprecededbytheword"Question"followedbythequestionnumberoriginallyusedin

thequestionnaire. Optionallyaddalinefeedtothevariablename.

Writerandomandordernumbers

Where*RANDOMand*ORDERareusedwithapositiondefinition,thisstorestheorderinwhichthecodesappearedduringthequestionnaireinanadditionalvariable.

Insert[LF]inquestiontext

Iflinefeedsareusedinthequestionlabels,thesearetransferredintheexport.Duplicatelinefeedsare

removed.Bydefault,linefeedsaretranslatedintospaces.

Page41


46/415


Insert[LF]incodetext

Iflinefeedsareusedinthecodelabels,thesearetransferredintheexport.Duplicatelinefeedsare

removed.Bydefault,linefeedsaretranslatedintospaces.

Includequestionswithouttextandunusedquestions

Exportsquestions

without

text

and

questions

that

are

never

shown

due

to

routing.

By

default

these

are

not

exported.

Generatecodesforscalequestions

Generatescodenumbersfor*SCALEquestions.Bydefaulttheseareexportedasnumericalvariables.

Includenullevaluatingfilteranddummyquestions

Exportsquestionsthatuseafilterthatalwaysevaluatestofalse(forexample*I F [ 1 = 0] )and*DUMMYquestions.Bydefaultthesearenotexported.

Noduplicatetextfor*OPENand*NUMBERquestions

For*OPENand*NUMBERquestions,createsalabelwiththequestiontext,removingthelabelforthequestiontext.

Maximum

codes

per

variable

Enforcesamaximumnumberofcodespervariable.Codesbeyondthislimitarenotexported.Thismaybe

requiredforNIPODiana,whichhasalimitof200variables.

Setlinelength

Setsthemaximumamountofcharacterstobeusedforquestionlabelsandcodelabelsonasinglerow.

Rowsaresplitusingthebackslashcharacter.Sentencesaresplitatcompletewords.

OpenVARfileafterexport

AutomaticallyopenstheexportedvariablefileintheNIPOODINDeveloper.

UnicodeVARfile

ExportsaUnicodevariablefileinsteadofanASCIIfile(supportedbyNvisionScriptonly).

CodeLabelExportsina*FORMQuestion

Ina*FORMquestion,alltextofacodelabel(bothbeforeandafterthedatafield)isusedfortheexporttoNIPODianavariables.

Exportingtextof*FORMquestion

*QUESTI ON 1 *FORMHow much di d you pay f or :

1: Pr oduct A *NUMBER 61L3. 2 Euros2: Pr oduct B *NUMBER 66L3. 2 Euros

Isexported

as:

*V1_1 61L3. 2: How much di d you pay f or : Product A Eur os*V1_2 66L3. 2: How much di d you pay f or : Product B Eur os

Page42


47/415


RandomCodeNumberExportinNIPODiana

Exportingrandomorder

*QUESTI ON 2 *CODES 81L9 *RANDOM 90L3 *CONTROL Q1 NWhi ch of t he f ol l owi ng brands of beers do you know?( I nt : read out)

1: Hei neken2: Amst el3: Gr ol sch8: Ot her *OPEN *NOCON9: None *NMUL *NOCON

Isexportedas:

*V2 *MV 81L9: V2[LF] Quest i on 2[LF] Whi ch of t he f ol l owi ng brands of brands of beers do youknow? ( I nt : r ead out )1: Hei neken2: Amst el3: Gr ol sch8: Ot her9: None

*V2_R1 *SNG 90L1: V2_R1[LF] Quest i on 2 - Random nr. 1[LF] Whi ch of t he f ol l owi ng brands ofbr ands of beer s do you know? ( I nt: r ead out )1: Hei neken2: Amst el3: Gr ol sch8: Ot her9: None

*V2_R2 *SNG 91L1: V2_R2[LF] Quest i on 2 - Random nr. 2[LF] Whi ch of t he f ol l owi ng brands ofbr ands of beer s do you know? ( I nt: r ead out )1: Hei neken2: Amst el3: Gr ol sch8: Ot her9: None

*V2_R3 *SNG 92L1: V2_R3[LF] Quest i on 2 - Random nr. 3[LF] Whi ch of t he f ol l owi ng brands ofbr ands of beer s do you know? ( I nt: r ead out )

1: Hei neken2: Amst el3: Gr ol sch8: Ot her9: None

OrderCodeNumberExportinNIPODiana

Exportingorderofmentions

*QUESTI ON 1 *CODES 61L9 *MULTI 70L3Whi ch brands of beers do you know?

( I nt : t ype the codes i n t he same or der as ment i oned by r espondent )

1: Hei neken2: Amst el3: Gr ol sch8: Ot her *OPEN9: None *NMUL

Page43


48/415


Isexportedas:

*V1 *MV 61L9: V1[LF] Quest i on 1[LF] Whi ch br ands of beers do you know? ( I nt : t ype the codes i nt he same order as menti oned by r espondent )1: Hei neken2: Amst el3: Gr ol sch8: Ot her9: None*V1_O1 *SNG 70L1: V1_O1[LF] Quest i on 1 - Or der nr . 1[ LF] Whi ch br ands of beer s do you know?( I nt: t ype the codes i n t he same or der as ment i oned by r espondent )1: Hei neken2: Amst el3: Gr ol sch8: Ot her9: None*V1_O2 *SNG 71L1: V1_O2[LF] Quest i on 1 - Or der nr . 2[ LF] Whi ch br ands of beer s do you know?( I nt: t ype the codes i n t he same or der as ment i oned by r espondent )1: Hei neken2: Amst el3: Gr ol sch8: Ot her9: None

*V1_O3 *SNG 72L1: V1_O3[LF] Quest i on 1 - Or der nr . 3[ LF] Whi ch br ands of beer s do you know?( I nt: t ype the codes i n the same or der as ment i oned by r espondent1: Hei neken2: Amst el3: Gr ol sch8: Ot her9: None

Exportsof*FORMQuestionswithCodes

Exportsof*FORMquestionsusingcodesforfieldsappropriatelynumbersvariablesaccordingtothecodenumbers.Thelabeliscreatedfromallsuccessivetextforthatcode.Notethatina*SCALEor*GRI Dquestiontheappropriatecolumnheadersareexportediftabshavebeenusedcorrectlytoseparatethese.

Examplescript

1

*QUESTI ON 1 *FORMWhat i s your address?

1: St r eet *ALPHA 61L352: House number *NUMBER 96L53: Post al code *ALPHA 101L104: Ci t y *ALPHA 111L30

ResultexporttoNIPODianascript1

*V1_1 *TEK 61L35: What i s your address? St r eet*V1_2 *SNG 96L5: What i s your addr ess? House number*V1_3 *TEK 101L10: What i s your address? Post al code*V1_4 *TEK 111L30: What i s your address? Ci t y

Examplescript2

*QUESTI ON 2 *FORMWhat di d you t hi nk of t he ser vi ce at t he f ol l owi ng gas stat i ons?

Esso Mobi l Oi l Shel l Texaco1: Ver y good *GRI D 141L5 6. 1 4. 10GoodAver agePoorVery poorNo opi ni on

Inthescriptabove,tabsareusedtospacecolumnheaders.Notethatthereisalsoatabbetweenthelabel

andthe*GRI Donthefirstline,andthatboththecolumnheaderandthefirstlineareendedwithaspaceandtab.

Page44


49/415


ResultexporttoNIPODianascript2

*V2_1 141L1: What di d you t hi nk of the servi ce at t he f ol l owi ng gas st ati ons? Esso1: Very good2: Good3: Average4: Poor5: Very poor6: No opi ni on

*V2_2 142L1: What di d you t hi nk of the servi ce at t he f ol l owi ng gas st ati ons? Mobi l Oi l1: Very good2: Good3: Average4: Poor5: Very poor6: No opi ni on

*V2_3 143L1: What di d you t hi nk of the servi ce at t he f ol l owi ng gas st ati ons? Shel l1: Very good2: Good3: Average4: Poor5: Very poor6: No opi ni on

*V2_4 144L1: What di d you t hi nk of the servi ce at t he f ol l owi ng gas st ati ons? Texaco1: Very good2: Good3: Average4: Poor5: Very poor6: No opi ni on

TripleSXML

TripleSXMLisaopenstandarddataformatusingXML.Itissupportedbyavarietyofproducts,including

butnotlimitedto:

Bellview

CfMCSurvent

Merlin

Miriad(TNS)

Preport

SNAP

AnexporttoTripleSrequiresthatthesurveydatafileispresentinsamethedirectoryasthequestionnaire

thatisexported.ForaquestionnaireNAMEQ,thedatafileshouldbenamedNAME. DAT.

Page45


50/415


ExporttoTripleSXML

ExporttoTripleSversion

SetstheTripleSformattouse.Checkyourstatisticalanalysispackagefordetails.Supportedexportsare

1.1,1.2and2.0.

Datafile

format

Setsthedatafileformatfortheexport,eitherfixedorcsv(characterdelimited).Thisisonlysupportedfor

TripleSversion2.0.

Converttextusingcodepage

Selectthecodepagetoconverttheexportinto.Makesuretheselectedcodepagematchesthelanguageof

yourquestionnaire.

Subsurvey

Selectwhichsurveytoexportif*NEWwasusedwithinthequestionnaire.Language

Ifmorethanonelanguageisdefinedwithinthequestionnaire,selectthelanguagetouseforthequestion


Includealphanumericquestions

Include*ALPHAand*NUMBERquestionsintheexport.


Exportsquestionswithouttextandquestionsthatarenevershownduetorouting.Bydefaultthesearenot

exported.



Recodequestionscontainingcode'0'

Code0forcodecategoriesisbydefaultnotsupportedintheTripleSXMLformat.Thisoptionrecodescode

labelsifcode

0was

used

in

the

questionnaire.

Page46


51/415


Includeopenanswers

Inadditiontooptionallycodedopenendedquestions,thisexportsopenendedanswerverbatimintothe

datafile.

Openanswerlength

Setsthe

maximum

number

of

characters

to

be

used

for

open

ended

answers.

Answers

beyond

the

length

limitaretruncated.

CheckQPScompliance

CheckscompliancewithTripleSexportsforQPS.Ifthecomplianceisnotmet,awarningmessageis

displayed.

OpenSSSfile

AutomaticallyopenstheTripleSvariabledefinitionfileintheNIPOODINDeveloperafterexport.

ThefollowingcharactersinthequestionandcodetextareescapedwhenexportingtoTripleSXML:

isreplacedby&gt ;

&is

replaced

by

&

' isreplacedby' "isreplacedby&quot ;

SPSSPortable

AnexporttoSPSSPortablerequiresthatthesurveydatafileispresentinsamethedirectoryasthe

questionnairethatisexported.ForaquestionnaireNAMEQ,thedatafileshouldbenamedNAME. DAT.

ExporttoSPSSPORfile

Subsurvey

Selectwhichsurveytoexportif*NEWwasusedwithinthequestionnaire.

Language





yourquestionnaire.

Page47


52/415


RetainODINdataformat

Notavailableforthisformat.

Includeopenanswers

Notavailableforthisformat.

Maxrecord

length

Themaximumnumberofpositionsofasinglerecord.Checkyourstatisticalanalysissoftwareforthelimits.

Longerrecordsaresplitattheconfiguredthreshold.



exported.



Includesavescript

Not

available

for

this

format.



name.



thequestionnaire.

UsequestionID'sasvariablenames

Ifspecified,usenamesdefinedwith*VARasvariablenames.

Usealternativenamesforrandomandordervariables

Usesaslightlyshorterformatfor*RANDOMand*ORDERvariables,wherethedefaultfirstletterisreplacedbyRorOrespectively.


Where*RANDOMand*ORDERareusedwithapositiondefinition,thisstorestheorderinwhichthecodesappearedduringthequestionnaireinanadditionalvariable.

UsecodenumbersforMultipleDichotomyfields

Bydefault,for*MULTI questionsallcodesareexportedasmultipledichotomyquestions(mentioned/notmentioned).Thisoptionplacestheoriginalcodenumberinthequestionlabelforthesequestions.

Textformentioned

Formultipledichotomyquestions,setsthelabeltobeusedfor'mentioned'.

Textfornotmentioned

Formultiple

dichotomy

questions,

sets

the

label

to

be

used

for

'no

mentioned'.

Variablenamelength

Setsthemaximumlengthforvariablenames.Chooseeither8or64,dependentonyourSPSSversioninuse.

Variablelabellength

Setsthemaximumlengthforthevariablelabel(thequestiontext).Longertextsaretruncatedatthe

threshold.

Valuelabellength

Setsthemaximumlengthforthevaluelabel(thecodelabeltext).Longertextsaretruncatedatthe

threshold.

Page48


53/415


Variablenamesfirstletter

Setsthefirstletterforanexportedvariablename.ThisonlyhappensquestionIDsarenotused,orifthe

questiondoesnothaveaquestionIDdefined(*VAR).

Numberofcharsfrommultiquestion

Bydefault,

multiple

dichotomy

questions

receive

the

full

original

question

text

in

addition

to

the

code

label.

Thisoptionconfiguresthemaximumnumberofcharactersfromthequestionlabeltoinclude.

Note:

Theselectedsettingsforvariablenamesmaycausetheexporttogeneratevariablenamesthat

exceedthemaximumnumberofcharactersfortheSPSSversionyouareusing.Awarningisissued

fortheminimumlimitforolderversions adjustthesettingsifrequired.

SPSSPC

Anexport

to

SPSS

PC

script

files

requires

that

the

survey

data

file

is

present

in

same

the

directory

as

the

questionnairethatisexported.ForaquestionnaireNAMEQ,thedatafileshouldbenamedNAME. DAT.Thisexportcreatestwofiles:avariabledefinitionfile(SPSfile)andadatafile(EXTfile).RuntheSPSfileinSPSStocreatethedataset.

ExporttoSPSSPC(scriptfiles)

Subsurvey


Language

Ifmore

than

one

language

is

defined

within

the

questionnaire,

select

the

language

to

use

for

the

question




yourquestionnaire.

RetainODINdataformat

Keepstheexporteddatafile(EXTfile)inthesameformatastheoriginalNIPOODINdatafile(DATfile).Includedopenendedanswers,ifany,areappendedattheendofeachrecord.

Includeopenanswers

Includesopenendedanswerverbatiminthedatafileasadditionalvariables.

Page49


54/415


Maxrecordlength

Themaximumnumberofpositionsofasinglerecord.Checkyourstatisticalanalysissoftwareforthelimits.

Longerrecordsaresplitattheconfiguredthreshold.


Exportsquestions

without

text

and

questions

that

are

never

shown

due

to

routing.

By

default

these

are

not

exported.



Includesavescript

Includestheline"SAVE OUTFI LE=' survey. SAV' / COMPRESSED"wheresurveyisthenameofthesurvey.



name.



thequestionnaire.

UsequestionID'sasvariablenames

Ifspecified,usenamesdefinedwith*VARasvariablenames.

Usealternativenamesforrandomandordervariables

Usesaslightlyshorterformatfor*RANDOMand*ORDERvariables,wherethedefaultfirstletterisreplacedbyRorOrespectively.


Where*RANDOMand*ORDERareusedwithapositiondefinition,thisstorestheorderinwhichthecodes

appearedduring

the

questionnaire

in

an

additional

variable.

UsecodenumbersforMultipleDichotomyfields

Bydefault,for*MULTI questionsallcodesareexportedasmultipledichotomyquestions(mentioned/notmentioned).Thisoptionplacestheoriginalcodenumberinthequestionlabelforthesequestions.

Textformentioned

Formultipledichotomyquestions,setsthelabeltobeusedfor'mentioned'.

Textfornotmentioned

Formultipledichotomyquestions,setsthelabeltobeusedfor'nomentioned'.

Variablenamelength

Setsthemaximumlengthforvariablenames.Chooseeither8or64,dependentonyourSPSSversioninuse.

Variablelabel

length


threshold.

Valuelabellength


threshold.

Variablenamesfirstletter

Setsthefirstletterforanexportedvariablename.ThisonlyhappensquestionIDsarenotused,orifthe

questiondoesnothaveaquestionIDdefined(*VAR).

Page50


55/415


Numberofcharsfrommultiquestion

Bydefault,multipledichotomyquestionsreceivethefulloriginalquestiontextinadditiontothecodelabel.

Thisoptionconfiguresthemaximumnumberofcharactersfromthequestionlabeltoinclude.

Note:

Theselectedsettingsforvariablenamesmaycausetheexporttogeneratevariablenamesthat

exceedthemaximumnumberofcharactersfortheSPSSversionyouareusing.Awarningisissued

fortheminimumlimitforolderversions adjustthesettingsifrequired.

Ascribe

OpenendedanswersinNIPOFieldworkSystemsurveysmaybecodedusingLanguageLogic'sonlinecoding

solutionAscribe.Ascribeimportscodingprojectsusingaproprietary(ZIPcompressed)XMLformat.

AnexporttoAscriberequiresthatthesurveydatafileispresentinsamethedirectoryasthequestionnaire

thatis

exported.

For

aquestionnaire

NAMEQ,

the

data

file

should

be

named

NAME. DAT.

AscribeExport

Language



Codeframefile

Iftheprojectwaspreviouslycoded,thecurrentquestionnaire maynotcontaintherequiredCodeFrames.

SelecttheAscribeCodeFramefiletouseforcoding.

Incremental

CheckthisoptionifyouplantoaddthecurrentexporttoanexistingAscribeproject.Usethisfeaturetoadd

newdatatoanexistingproject.

Theresultfileiscalled[ sur veyname]_set up. zi pwheresur veynameisthenameofyoursurvey.SeetheAscribedocumentationfordetailsonhowtocreateaprojectfromthisfileorhowtoadd

incrementaldata

to

an

existing

project.

Quantime

AnexporttoQuantimerequiresthatthesurveydatafileispresentinsamethedirectoryasthe

questionnairethatisexported.ForaquestionnaireNAMEQ,thedatafileshouldbenamedNAME. DAT.

ExporttoQuantime



exported.

Page51


56/415




Subsurvey


Language

If

more

than

one

language

is

defined

within

the

questionnaire,

select

the

language

to

use

for

the

question




yourquestionnaire.

Variablelabellength


threshold.

Valuelabellength


threshold.

Side

Definesthedefaultleftcolumnwidthforthequestiontextandcodelabels.



name.



thequestionnaire.

Usevariablenames

Insteadofautomaticallyassigningquestionvariablenamesbasedonquestionnumbers,usethelabels

definedby

*VAR.

Page52


57/415




exported.


Exportsquestions

that

use

afilter

that

always

evaluates

to

false

(for

example

*I F [ 1 = 0] )

and

*DUMMYquestions.Bydefaultthesearenotexported.

Images/Sound

Ifeither*BMPor*RECareusedintheNIPOODINquestionnaire,thesemaybeexportedasseparateimageandsoundfiles.Bitmapfilesareexportedas*. BMPfilesandrecordingsareexportedas*. WAVfiles.

ExportImages/Sound(extractBfile)

Bfile

SelecttheBfiletoextract.

Location

Specifyadirectorywheretheextractedfilesmustbeplaced.

Filenamesaregeneratedautomatically.AseparatefileiscreatedforimageorwaveclipintheBfile.The

followingnamingconventionisused:

I _S_P

_L_C. BMP

I _S_P

_L_C. WAV

Where:

Interviewnumber Subsurveynumber

PositiondefinitioninUfile

LengthdefinitioninUfile

Codeiftheanswerisrelatedtoacodecategory

NfieldCode

This

exports

creates

an

import

file

for

Nfield

Code,

the

successor

to

the

NIPO

ODIN

Coding

Module.

ExporttoNfieldCode

Usevariablelabelsifpresent

Uselabelsdefinedwith*VARand*LABEL.

Page53


58/415


Includeappointmentnotes

Includesappointmentnotesasaseparateopenendedquestion.

Includesnotestoclosedquestions

Includesforcedopenendedanswersonclosedquestionsasopenendedquestions.

Language

Selectsthenameoftheoriginallanguageinwhichthequestionnairewasscripted.Notethattheexport

alwaysusesthecodeframedefinedbythedefaultlanguage(theoriginalscript)otherlanguagescannot

beexported.

TheexportedfileissavedwiththenameofthesurveyfileandtheextensionNFC.ThisfilemustbeimportedinNfieldCodetocreateanNfieldCod

Documents

NIPO ODIN Scripter's Guide