NIPO ODIN Scripter's Guide
-
Upload
andreea-georgiana -
Category
Documents
-
view
298 -
download
4
Transcript of NIPO ODIN Scripter's Guide
-
8/10/2019 NIPO ODIN Scripter's Guide
1/415
NIPO ODIN
Scripters GuideVersion 5.16
-
8/10/2019 NIPO ODIN Scripter's Guide
2/415
More information:
For more information please contact the NIPO Software helpdesk at
[email protected] or call +31 20 5225 980.
-
8/10/2019 NIPO ODIN Scripter's Guide
3/415
NIPOODIN
Scripter'sGuide
Version5.16
Lastrevision:Wednesday15December2010
-
8/10/2019 NIPO ODIN Scripter's Guide
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.
-
8/10/2019 NIPO ODIN Scripter's Guide
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
ChangesinNIPOODINScriptLanguage5.14 15
ChangesinNIPOODINScriptLanguage5.13 16
ChangesinNIPOODINScriptLanguage5.12 16
ChangesinNIPOODINScriptLanguage5.11 16
ChangesinNIPOODINScriptLanguage5.10 16
ChangesinNIPOODINScriptLanguage5.09 16
ChangesinNIPOODINScriptLanguage5.08 16
ChangesinNIPOODINDeveloper 18
ChangesinNIPOODINDeveloper5.14 18
ChangesinNIPOODINDeveloper5.11.003 18
ChangesinNIPOODINDeveloper5.11 18
ChangesinNIPOODINDeveloper5.10 18
ChangesinNIPOODINDeveloper5.08 19
ChangesinNIPOODINDeveloper5.06 19
Changesin
NIPO
ODIN
Developer
5.05
19
ChangesinNIPOODINDeveloper5.04 20
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
11/415
Introduction
PageVII
Example4:CenterScales 403
Example5:CenterTextAboveScales 404
Example6:ColorBackgroundforFirstandThirdStatementGray 404
Example7:GridUsingVariousStylingOptions 405
Index 407
-
8/10/2019 NIPO ODIN Scripter's Guide
12/415
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
17/415
Introduction
Page13
Ifcontactingbymail,pleaseencloseversioninformationandthefile(s)associatedwithyourquestionor
problem.PleaseZIPyourfilesbeforesending.
Ifcontactingbyphone,contacttheofficenearesttoyourtimezoneforimmediateassistance.
NIPOSoftwareHelpdesk
GroteBickersstraat74
1013KS
Amsterdam
TheNetherlands
TheEMEAoffice(Amsterdam):+31205225980(GMT+1)
TheAPACoffice(HongKong):+85221164119(GMT+8)
TheAMERoffice(BuenosAires):+541148916470(GMT3)
Email:[email protected]
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
GroteBickersstraat74
1013KS
Amsterdam
TheNetherlands
Email:[email protected]
-
8/10/2019 NIPO ODIN Scripter's Guide
18/415
-
8/10/2019 NIPO ODIN Scripter's Guide
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.
ChangesinNIPOODINScriptLanguage5.15
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 .
ChangesinNIPOODINScriptLanguage5.14
The*TABcommandcannowbeusedtoinfluencecodescolumnswhenusing*AUTO(NIPOCAPIClient
12.06andabove)
The*SI ZEcommandhasbeenextendedfortheNIPOCAPIClienttosettheheightoffullyopenendedanswerandbitmapanswer(*BMP)boxesandtosetthewidthandheightofsemiopenendedanswerandbitmapanswerboxes.
The*DATEcommandinan* I NI Tblocknowalwayscorrectlystoresthecurrentdatewhenfollowing
upappointmentsorsuspendedinterviews.
FixedacrashintheNIPOCATIClientandpreviewswhenusing*FORM,*SCALEand*ORDERinasinglequestion.
Page15
-
8/10/2019 NIPO ODIN Scripter's Guide
20/415
VersionHistory
ChangesinNIPOODINScriptLanguage5.13
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.
ChangesinNIPOODINScriptLanguage5.12
ReleasedwithNIPOCAPIClient5.01only.
Youcan
now
refer
to
fields
in
a*FORMquestion
using
both
literal
numbers
and
expressions.
ChangesinNIPOODINScriptLanguage5.11
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.
ChangesinNIPOODINScriptLanguage5.10
MinorupdatetomaketheNIPOODINScriptlanguageparserandenginesupportthelatestMicrosoft
FoundationClasses.
ChangesinNIPOODINScriptLanguage5.09
Asuspendimageisnowcorrectlyinterpretedtotheoriginalchannel(aswas)ratherthanthecurrent
channel(asis).
ChangesinNIPOODINScriptLanguage5.08
CompleterewriteoftheNIPOODINscriptlanguageforWindows32bitplatforms,introducinganumberof
newcommandsandanewapproachtohandlingscriptparsing,executionandsuspension.
Page16
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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.
ChangesinNIPOODINDeveloper5.11
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.
ChangesinNIPOODINDeveloper5.10
AddedQPSandQuantimeexports.
OpeninganI NI fileofanomnibussurveynowcorrectlystartsthesubsurveysofsurvey. *HEADI NGtextsarenowcorrectlydisplayedinquestionpreviews. Fixedanissuewheresomevariableswentmissingduringanexport.
Fixedanissuewhere*OPENendedcodescpi;dyieldinduplicatevariablenames.
FixedanoccasionalcrashwhenstartingorcheckingaCAWIquestionnaire.
Page18
-
8/10/2019 NIPO ODIN Scripter's Guide
23/415
VersionHistory
ChangesinNIPOODINDeveloper5.08
NIPOCATIpreviewnowsupports*NEXTRECORD.
Addedsyntaxhighlightingfornewcommands.
Fixedissuesintheoverviewofunusedquestionsinthesyntaxcheck.
FixedIBM
SPSS
export
issue
where
incorrect
data
lists
were
occasionally
saved
for
multiple
dichotomies.
Exportof*FORM*SCALEquestionsofNIPODiananolongeroccasionallymixesuplabeltexts. FixedanissueinimportingAscribedcodeddataifthecodedsurveywaspartofanOmnibus.
ChangesinNIPOODINDeveloper5.06
IntroducedaNIPOCAPIClientpreviewforquestionnairetesting.
YoucannowincludeopenendedanswersinexportstoSSSandSPSSPCdatasetswithouttheneedto
codethem.
Addedarightclickmenuoptiontoopenaquestionnairefilesetinthe*MERGEcommandorinthe
surveyconfigurationfile.
YoucanopenandsyntaxcheckallsurveyswithinanOmnibusquestionnairebyopeningthesurvey
configurationfile
for
the
Omnibus.
ChangesinNIPOODINDeveloper5.05
AddedanexporttotheIBMSPSSformat.
AddedanexporttotheQuantimeformat.
Addedanexportforbitmap(*BMP)andsoundrecordings((*REC)fromtheBfile.
Improvedexportof*FORMquestionswith*SCALEor*GRI D. Addedanoptiontoinsertcodenumbersinfrontrowsoftext.
Page19
-
8/10/2019 NIPO ODIN Scripter's Guide
24/415
VersionHistory
ChangesinNIPOODINDeveloper5.04
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
30/415
-
8/10/2019 NIPO ODIN Scripter's Guide
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
-
8/10/2019 NIPO ODIN Scripter's Guide
32/415
UsingtheNIPOODINDeveloper
InsertingQuestionDefinitions
TosimplifycreatingNIPOODINQuestionnaire, rightclicktheeditorwindowandselectInserttochoose
fromtheavailablequestionoptions.
Insertingaquestion
ChangingQuestionOptions
Rightclickonaquestionlinetochangethequestionoptions.Dependingonthetypeofquestion,oneofthe
followingdialogboxesappears.
Changingthegeneralquestionoptions
Page28
-
8/10/2019 NIPO ODIN Scripter's Guide
33/415
UsingtheNIPOODINDeveloper
Changingthequestionoptionsfora*CODESquestion
Changingthequestionoptionsfora*NUMBERquestion
Page29
-
8/10/2019 NIPO ODIN Scripter's Guide
34/415
UsingtheNIPOODINDeveloper
Changingthequestionoptionsforan*OPENquestion
Changingthequestionoptionsforan*ALPHAquestion
Page30
-
8/10/2019 NIPO ODIN Scripter's Guide
35/415
UsingtheNIPOODINDeveloper
Changingthequestionoptionsfora*SCALEquestion
Changingthequestionoptionsfora*LINEquestion
ChangingCodeOptions
Rightclickonacategorycodelinetochangethecodeoptions.Thefollowingdialogappears.
Page31
-
8/10/2019 NIPO ODIN Scripter's Guide
36/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
37/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
38/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
39/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
40/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
41/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
42/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
43/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
44/415
UsingtheNIPOODINDeveloper
Result:
TheNIPO
ODIN
Developer
TheNIPOODINDeveloperallowsyoutoexportyourdatatoavarietyofstatisticalsoftwarepackages.The
followingformatsaresupported:
NIPODiana/NvisionScript
TripleSXML
SPSSPortable
SPSSPC(scriptformat)
Ascribe
Quantime
Image/Sound
NIPODiana
TheexporttoNIPODianamaybeusedtocreatefilesthatmaybeusedbybothNIPODianaandNvision
Script.
Page40
-
8/10/2019 NIPO ODIN Scripter's Guide
45/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
46/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
47/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
48/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
49/415
UsingtheNIPOODINDeveloper
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
-
8/10/2019 NIPO ODIN Scripter's Guide
50/415
UsingtheNIPOODINDeveloper
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
andcodelabelsintheexport.
Includealphanumericquestions
Include*ALPHAand*NUMBERquestionsintheexport.
Includequestionswithouttextandunusedquestions
Exportsquestionswithouttextandquestionsthatarenevershownduetorouting.Bydefaultthesearenot
exported.
Includenullevaluatingfilteranddummyquestions
Exportsquestionsthatuseafilterthatalwaysevaluatestofalse(forexample*I F [ 1 = 0] )and*DUMMYquestions.Bydefaultthesearenotexported.
Recodequestionscontainingcode'0'
Code0forcodecategoriesisbydefaultnotsupportedintheTripleSXMLformat.Thisoptionrecodescode
labelsifcode
0was
used
in
the
questionnaire.
Page46
-
8/10/2019 NIPO ODIN Scripter's Guide
51/415
UsingtheNIPOODINDeveloper
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> ;
&is
replaced
by
&
' isreplacedby' "isreplacedby" ;
SPSSPortable
AnexporttoSPSSPortablerequiresthatthesurveydatafileispresentinsamethedirectoryasthe
questionnairethatisexported.ForaquestionnaireNAMEQ,thedatafileshouldbenamedNAME. DAT.
ExporttoSPSSPORfile
Subsurvey
Selectwhichsurveytoexportif*NEWwasusedwithinthequestionnaire.
Language
Ifmorethanonelanguageisdefinedwithinthequestionnaire, selectthelanguagetouseforthequestion
andcodelabelsintheexport.
Converttextusingcodepage
Selectthecodepagetoconverttheexportinto.Makesuretheselectedcodepagematchesthelanguageof
yourquestionnaire.
Page47
-
8/10/2019 NIPO ODIN Scripter's Guide
52/415
UsingtheNIPOODINDeveloper
RetainODINdataformat
Notavailableforthisformat.
Includeopenanswers
Notavailableforthisformat.
Maxrecord
length
Themaximumnumberofpositionsofasinglerecord.Checkyourstatisticalanalysissoftwareforthelimits.
Longerrecordsaresplitattheconfiguredthreshold.
Includequestionswithouttextandunusedquestions
Exportsquestionswithouttextandquestionsthatarenevershownduetorouting.Bydefaultthesearenot
exported.
Includenullevaluatingfilteranddummyquestions
Exportsquestionsthatuseafilterthatalwaysevaluatestofalse(forexample*I F [ 1 = 0] )and*DUMMYquestions.Bydefaultthesearenotexported.
Includesavescript
Not
available
for
this
format.
Variablenameinfrontofquestiontext
Thequestionlabelisprecededbytheexportnameofthevariable.Optionallyaddalinefeedtothevariable
name.
Questionninfrontofquestiontext
Allquestiontextsareprecededbytheword"Question"followedbythequestionnumberoriginallyusedin
thequestionnaire.
UsequestionID'sasvariablenames
Ifspecified,usenamesdefinedwith*VARasvariablenames.
Usealternativenamesforrandomandordervariables
Usesaslightlyshorterformatfor*RANDOMand*ORDERvariables,wherethedefaultfirstletterisreplacedbyRorOrespectively.
Writerandomandordernumbers
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
-
8/10/2019 NIPO ODIN Scripter's Guide
53/415
UsingtheNIPOODINDeveloper
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
Selectwhichsurveytoexportif*NEWwasusedwithinthequestionnaire.
Language
Ifmore
than
one
language
is
defined
within
the
questionnaire,
select
the
language
to
use
for
the
question
andcodelabelsintheexport.
Converttextusingcodepage
Selectthecodepagetoconverttheexportinto.Makesuretheselectedcodepagematchesthelanguageof
yourquestionnaire.
RetainODINdataformat
Keepstheexporteddatafile(EXTfile)inthesameformatastheoriginalNIPOODINdatafile(DATfile).Includedopenendedanswers,ifany,areappendedattheendofeachrecord.
Includeopenanswers
Includesopenendedanswerverbatiminthedatafileasadditionalvariables.
Page49
-
8/10/2019 NIPO ODIN Scripter's Guide
54/415
UsingtheNIPOODINDeveloper
Maxrecordlength
Themaximumnumberofpositionsofasinglerecord.Checkyourstatisticalanalysissoftwareforthelimits.
Longerrecordsaresplitattheconfiguredthreshold.
Includequestionswithouttextandunusedquestions
Exportsquestions
without
text
and
questions
that
are
never
shown
due
to
routing.
By
default
these
are
not
exported.
Includenullevaluatingfilteranddummyquestions
Exportsquestionsthatuseafilterthatalwaysevaluatestofalse(forexample*I F [ 1 = 0] )and*DUMMYquestions.Bydefaultthesearenotexported.
Includesavescript
Includestheline"SAVE OUTFI LE=' survey. SAV' / COMPRESSED"wheresurveyisthenameofthesurvey.
Variablenameinfrontofquestiontext
Thequestionlabelisprecededbytheexportnameofthevariable.Optionallyaddalinefeedtothevariable
name.
Questionninfrontofquestiontext
Allquestiontextsareprecededbytheword"Question"followedbythequestionnumberoriginallyusedin
thequestionnaire.
UsequestionID'sasvariablenames
Ifspecified,usenamesdefinedwith*VARasvariablenames.
Usealternativenamesforrandomandordervariables
Usesaslightlyshorterformatfor*RANDOMand*ORDERvariables,wherethedefaultfirstletterisreplacedbyRorOrespectively.
Writerandomandordernumbers
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
Setsthemaximumlengthforthevariablelabel(thequestiontext).Longertextsaretruncatedatthe
threshold.
Valuelabellength
Setsthemaximumlengthforthevaluelabel(thecodelabeltext).Longertextsaretruncatedatthe
threshold.
Variablenamesfirstletter
Setsthefirstletterforanexportedvariablename.ThisonlyhappensquestionIDsarenotused,orifthe
questiondoesnothaveaquestionIDdefined(*VAR).
Page50
-
8/10/2019 NIPO ODIN Scripter's Guide
55/415
UsingtheNIPOODINDeveloper
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
Ifmorethanonelanguageisdefinedwithinthequestionnaire, selectthelanguagetouseforthequestion
andcodelabelsintheexport.
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
Includequestionswithouttextandunusedquestions
Exportsquestionswithouttextandquestionsthatarenevershownduetorouting.Bydefaultthesearenot
exported.
Page51
-
8/10/2019 NIPO ODIN Scripter's Guide
56/415
UsingtheNIPOODINDeveloper
Includenullevaluatingfilteranddummyquestions
Exportsquestionsthatuseafilterthatalwaysevaluatestofalse(forexample*I F [ 1 = 0] )and*DUMMYquestions.Bydefaultthesearenotexported.
Subsurvey
Selectwhichsurveytoexportif*NEWwasusedwithinthequestionnaire.
Language
If
more
than
one
language
is
defined
within
the
questionnaire,
select
the
language
to
use
for
the
question
andcodelabelsintheexport.
Converttextusingcodepage
Selectthecodepagetoconverttheexportinto.Makesuretheselectedcodepagematchesthelanguageof
yourquestionnaire.
Variablelabellength
Setsthemaximumlengthforthevariablelabel(thequestiontext).Longertextsaretruncatedatthe
threshold.
Valuelabellength
Setsthemaximumlengthforthevaluelabel(thecodelabeltext).Longertextsaretruncatedatthe
threshold.
Side
Definesthedefaultleftcolumnwidthforthequestiontextandcodelabels.
Variablenameinfrontofquestiontext
Thequestionlabelisprecededbytheexportnameofthevariable.Optionallyaddalinefeedtothevariable
name.
Questionninfrontofquestiontext
Allquestiontextsareprecededbytheword"Question"followedbythequestionnumberoriginallyusedin
thequestionnaire.
Usevariablenames
Insteadofautomaticallyassigningquestionvariablenamesbasedonquestionnumbers,usethelabels
definedby
*VAR.
Page52
-
8/10/2019 NIPO ODIN Scripter's Guide
57/415
UsingtheNIPOODINDeveloper
Includequestionswithouttextandunusedquestions
Exportsquestionswithouttextandquestionsthatarenevershownduetorouting.Bydefaultthesearenot
exported.
Includenullevaluatingfilteranddummyquestions
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
-
8/10/2019 NIPO ODIN Scripter's Guide
58/415
UsingtheNIPOODINDeveloper
Includeappointmentnotes
Includesappointmentnotesasaseparateopenendedquestion.
Includesnotestoclosedquestions
Includesforcedopenendedanswersonclosedquestionsasopenendedquestions.
Language
Selectsthenameoftheoriginallanguageinwhichthequestionnairewasscripted.Notethattheexport
alwaysusesthecodeframedefinedbythedefaultlanguage(theoriginalscript)otherlanguagescannot
beexported.
TheexportedfileissavedwiththenameofthesurveyfileandtheextensionNFC.ThisfilemustbeimportedinNfieldCodetocreateanNfieldCod