Version 2.00.005
User's Guide
Page I
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Variable Translation 33
Index 35
Page II
Introduction
The NIPO DSC for IBM SPSS is NIPO Software's data source component for the IBM SPSS Data Collection
Data Model, previously known as SPSS Dimensions or the PASW Data Model.
Key features
Open and use NIPO Software data directly in PASW Statistics, IBM SPSS Data Collection Survey Reporter
and IBM SPSS Data Collection Base Professional.
Includes both closed and open answer sets.
Use hierarchical data views in the IBM SPSS Data Collection suite on NIPO Software data.
Run NIPO Diana / Nvision Script processing jobs automatically upon opening NIPO Software data in IBM
SPSS products, combining the power of both.
Important note:
An installation of the IBM SPSS Data Collection Survey Reporter Developer Kit is required to open
NIPO Software data in IBM SPSS Statistics and PASW Statistics. The Survey Reporter Developer Kit is
automatically installed with the IBM SPSS Data Collection suite. For information on obtaining a
version of the Survey Reporter Developer Kit that is compatible with your installation, go to
http://www.ibm.com/support.
Page 1
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Contacting Us
For support, licensing information, product news or any other queries or feedback regarding NIPO Software
products, feel free to contact us by phone or by mail. NIPO Software has three offices around the globe -
check the office nearest to your time zone for feedback during your working hours.
Page 2
Introduction
Typographical Conventions
Before you start using this guide, it is important to understand the terms and typographical conventions
used in the documentation.
The following kinds of formatting in the text identify special information:
Example Type of Information
Page 3
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Page 4
Installing the NIPO DSC for IBM SPSS
This section is intended for the system administrator who deploys the software on a workstation.
Prerequisites
Before installing this software, make sure the workstation where this software is installed meets the
following prerequisites:
An installation of the IBM SPSS Data Collection suite. IBM SPSS Statistics and PASW Statistics require the
Data Collection Data Model in this software to be able to open NIPO Software data. This software is
included in the IBM SPSS Data Collection suite. For information on obtaining a version of the Survey
Reporter or the Survey Reporter Developer Kit that is compatible with your installation, go to
http://www.ibm.com/support.
Any IBM SPSS application that supports the Data Collection Data Model. This includes several
applications within the IBM SPSS Data Collection Suite and IBM SPSS Statistics or PASW Statistics.
The installation must be be performed with a user account with administrator privileges.
System Requirements
The following operating systems are supported for the NIPO DSC for IBM SPSS:
Supported Operating Systems
Microsoft Windows XP SP3 (all editions except Starter)
Microsoft Windows Vista SP2 32-bit and 64-bit (all editions except Starter)
Microsoft Windows 7 32-bit and 64-bit (Starter, Home Basic, Home Premium, Professional, Ultimate
Windows 8/8.1 (all versions)
Windows 10, as released per July 2015
Page 5
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Changes the settings according to the requirements and click OK to finish the installation (listed
below). Clicking Cancel cancels the installation of the NIPO DSC for IBM SPSS.
The following settings can only be set by an administrator. If these settings need to be edited after
installation, right-click Start > Program Files > NIPO Software > NIPO DSC for IBM SPSS > Configure NIPO
DSC for IBM SPSS from the start-up menu and select Run as... to run as administrator.
Log Directory
The location is the folder where the NIPO DSC for IBM SPSS stores log files for all attempts to load NIPO
Software data in IBM SPSS products. These files may be requested by the NIPO Software Helpdesk for
investigation in case of technical issues. Specify an existing path where all users of the current workstation
have read / write access. If no folder is specified, no log files are created. Files are stored with the name
NipNvDscActionsLog.nnn where nnn is the log number (NipNvDscActionsLog.001 is always
the latest log file).
Log Level
This sets the level of log detail, a value ranging from 1 to 9 inclusive where 1 is low detail and 9 is high
detail. If left blank, the default value 3 is used.
The remaining settings (see "NIPO DSC for IBM SPSS Settings Panel" on page 29) do not need to be
configured at this point, but you may change these options to set a default configuration for all users of this
workstation. Users have access to this configuration panel to customize settings to their requirements.
Page 6
Opening NIPO Software Data in IBM SPSS
Applications
This section deals with opening NIPO Software data in IBM SPSS Statistics, IBM SPSS Data Collection Survey
Reporter and IBM SPSS Data Collection Base Professional.
To start, you need any of the following:
A NIPO variable definition file without data (*.var). This is a variable map only and does not contain
any data.
A NIPO data file and NIPO variable definition file (*.dat or *u and *.var). This is a variable map with
data.
An Nvision Script / NIPO Diana job file (*.job). This is a file that executes variable file definitions, data
file definitions and data transformation on the fly before opening the data. This file may, but does not
have to be, delivered with variable files and data files.
Note:
If a job file was provided with data files and variable files, you must open the job file in your IBM
SPSS application rather than the variable file. The job file should contain preprocessing instructions
such as data merging and data transformation that are to be executed before reviewing the data in
the IBM SPSS application.
Page 7
NIPO DSC for IBM SPSS 2.00.005 User's Guide
» To open NIPO Software data in IBM SPSS Statistics or PASW SPSS Statistics
1. Start IBM SPSS Statistics (version 19 or 20) or PASW SPSS Statistics (version 17 or 18).
2. From the menu, select File > Open Data Collection Data (version 19 and 20), or File > Open PASW
Data Collection Data (version 17 and 18). A dialog appears:
Note that the dialog appearance may differ depending on the version of the application you are
using.
3. From the Metadata Type drop-down menu, select NIPO Metadata (read-only).
4. At Metadata Location, click Browse... An open file dialog appears.
5. Select the variable file (*.var) to open. If you have a job file (*.job) in addition or instead of a
variable file, select that file instead. Click Open.
6. If you opened a job file, or if you only wish to open a variable definition without loading data,
proceed at step 9. Otherwise, from the Case Data Type drop-down menu, select NIPO Case Data
(read-only).
7. At Case Data Location, click Browse... An open file dialog appears.
8. Select the data file (*.dat or *u) to open and click Open.
9. Back at the Data Link Properties dialog, click OK to proceed. The Data Collection Data Import dialog
appears.
10. Optionally de-select the variables to exclude and / or make a Case Selection and click OK to finish.
Page 8
Opening NIPO Software Data in IBM SPSS Applications
Note:
Due to an mrScriptBasic issue, case data and meta data output files in some products require to have
different project names. For example, for a project.var input file you cannot use a
project.ddf and project.mdd as output file names. Use alternative names for output.
Example mrScriptBasic file opening NIPO Software data for input (variable file)
#define root "C:\MyProjects\"
#define INPUT_METADATA root + "project.var"
#define OUTPUT_CASEDATA root + "project_out.ddf"
#define OUTPUT_METADATA root + "project_out.mdd"
InputDataSource(myInputDataSource)
ConnectionString = "Provider=mrOleDB.Provider.2; _
Data Source=nipNvDsc; _
Initial Catalog=" + INPUT_METADATA + "; _
MR Init MDSC=nipNvDsc"
End InputDataSource
OutputDataSource(myOutputDataSource)
ConnectionString = "Provider=mrOleDB.Provider.2; _
Data Source=mrdatafileDsc; _
Location=" + OUTPUT_CASEDATA
MetaDataOutputName = OUTPUT_METADATA
End OutputDataSource
You may also load an Nvision Script / NIPO Diana job file.
Page 9
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Example mrScriptBasic file opening NIPO Software data for input (job file)
#define root "C:\MyProjects\"
#define INPUT_METADATA root + "project.job"
#define OUTPUT_CASEDATA root + "project_out.ddf"
#define OUTPUT_METADATA root + "project_out.mdd"
InputDataSource(myInputDataSource)
ConnectionString = "Provider=mrOleDB.Provider.2; _
Data Source=nipNvDsc; _
Initial Catalog=" + INPUT_METADATA + "; _
MR Init MDSC=nipNvDsc"
End InputDataSource
OutputDataSource(myOutputDataSource)
ConnectionString = "Provider=mrOleDB.Provider.2; _
Data Source=mrdatafileDsc; _
Location=" + OUTPUT_CASEDATA
MetaDataOutputName = OUTPUT_METADATA
End OutputDataSource
Any data transformations in the job file are executed before the data is accessed by IBM SPSS Data
Collection Base Professional.
Note:
If the output file already exist, IBM SPSS Data Collection Base Professional attempts to merge new
meta-data with existing meta-data in the specified output files, causing unwanted effects. To
prevent this, delete your *.DDF and *.MDD files before running your jobs. You can also add the
following code snippet to your scripts to delete existing output files. The script assumes that the files
OUTPUT_CASEDATA and OUTPUT_METADATA have already been defined.
If fso.FileExists(OUTPUT_CASEDATA) Then
fso.DeleteFile(OUTPUT_CASEDATA)
debug.Log("Deleted: " + OUTPUT_CASEDATA)
end if
End Event
Page 10
Working with Open-Ended Answers
The NIPO DSC for IBM SPSS can automatically include answers to open-ended and semi-open ended
questions, both from NIPO ODIN scripts and Nvision Script / NIPO Diana job and variable files enriched with
open-ended answer files from the NIPO Fieldwork System. Open-ended answers result in IBM SPSS
application as Text type variables.
Nvision Script / NIPO Diana lists does not make a semantic difference between coded questions and
open-ended answer questions. Assuming the variable definition file was not exported using the NIPO ODIN
Developer, you must add special directives to the variable definition file to ensure the data can be opened
in IBM SPSS applications.
Page 11
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Page 12
Working with Missing Case Values
In NIPO Software data, missing case values are represented by blanks in the data. No category for missing
case values is available unless it is explicitly created in the NIPO Software data files. If required, the NIPO
DSC for IBM SPSS can automatically add categories for missing values when the data is opened in an IBM
SPSS application. These categories appear with a "No answer" label.
This may be done in two ways:
You can select to automatically add categories for missing case values in variables, and optionally mark
the variables that do not require categories for missing case values. This is appropriate if categories for
missing values are a requirement to work with the data.
You can select to automatically add categories for missing case values in variables only if those variables
have been marked to include categories for missing case values. This is appropriate if categories for
missing values are required only by exception.
Both methods are described in this section.
Page 13
NIPO DSC for IBM SPSS 2.00.005 User's Guide
1. At Add 'No Answer' Category, ensure Only when #COUNTBLHOR (#HBT) is not used is selected.
2. Click OK. Proceed to open the file in your application of choice (see "Opening NIPO Software Data in
IBM SPSS Applications" on page 7).
To mark exceptions, you need to make modifications to the NIPO Software variable definition file (*.VAR)
before opening the file in an IBM SPSS application.
Page 14
Working with Missing Case Values
» To mark variables that should not receive a missing case value category
1. Open the Nvision Script / NIPO Diana VAR file in a text editor of your choice.
2. Search for the variables that should not have a category for missing case values. A variable is defined
using an asterisk (*) at the beginning of a line, immediately followed by the variable name. Below is
an example of a variable defining the respondent's age, in which V10 is the variable name.
Page 15
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Page 16
Working with Missing Case Values
2. At Add 'No Answer' Category, ensure Only when COUNTBLHOR (HBT) is used is selected.
3. Click OK.
4. Open the Nvision Script / NIPO Diana VAR file in a text editor of your choice.
5. Search for the variables that need a category for missing case values. A variable is defined by using
an asterisk (*) at the beginning of a line, immediately followed by the variable name. Below is an
example of a variable defining the respondent's age, in which V10 is the variable name.
Page 17
Working with Hierarchical Data
IBM SPSS Data Collection Survey Reporter and IBM SPSS Data Collection Survey Tables support hierarchical
data (HDATA) views, which enables variables to be presented in relationship to each other. Using the NIPO
DSC for IBM SPSS, NIPO Software data offers two types of hierarchical data views:
Tables, which are typically used for variables that come from questions in loops (NIPO ODIN *REPEAT
command).
Grids, which are typically used series of variables using the same set or type of answers (NIPO ODIN
*FORM question).
The NIPO DSC for IBM SPSS supports nested tables and grids.
Hierarchical data structures can be applied by either editing the NIPO ODIN script before the variable export
or by editing the Nvision Script / NIPO Diana variable definitions. Both methods are discussed in this
section. Editing the NIPO ODIN questionnaire is the recommended format, since the export produces the
required Nvision Script / NIPO Diana syntax.
Before you continue, make sure Hierarchical Data Structures are enabled in the NIPO DSC for IBM SPSS:
» To enable using hierarchical data structures
1. Click Start > Program Files > NIPO Software > NIPO DSC for IBM SPSS > Configure NIPO DSC for IBM
SPSS. A settings panel appears:
Page 19
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Note:
NIPO ODIN Developer 5.16.006 or later (with integrated NIPO ODIN parser 1.13.001 or later) must be
used in combination with the NIPO DSC for IBM SPSS 2.0.
Do not use Hierarchical Data commands on scripts that are to be deployed in the NIPO Fieldwork
System or the NIPO CAPI System. These systems generate a syntax error on the *TABLE command.
Instead, it is highly recommended to insert *TABLE commands on a copy of the questionnaire file.
Adding Tables
In NIPO ODIN script, tables are created from repetition blocks. Tables are created using the *TABLE
command. The *TABLE command is placed inside the repeat block. It takes a text as the parameter that
must contain the name of the table and the current horizontal iteration against which the set of questions
are asked. Tables themselves may embed grids.
Example NIPO ODIN script REPEAT BLOCK
The following example creates a table called "Rating" with 4 brands horizontally and 2 questions vertically.
The *TABLE command sets the horizontal iteration texts, while the *LABEL directives are used to
generate the vertical variable texts.
*TEXTVARS Brand
*REPEAT 4
*REPNUM 1: *PUT Brand "Grolsch"
*REPNUM 2: *PUT Brand "Hertog Jan"
*REPNUM 3: *PUT Brand "Amstel"
*REPNUM 4: *PUT Brand "Leeuw"
1: Good
2: Above average
3: Average
4: Below average
5: Bad
1: Yes
2: No
*ENDREP
Page 20
Working with Hierarchical Data
Requirements
The *TABLE command must be used before the first question in the *REPEAT block
The parameter for the *TABLE must be fixed text. It cannot start with a text substitution (*?).
In NIPO ODIN script, tables are also created from Matrix questions. Tables are created using the *TABLE
command. The *TABLE command is placed below the Matrix question. It takes a text as the parameter
that must contain the name of the table.
Example NIPO ODIN script MATRIX
The following example creates a table called "Rating" with 4 brands horizontally and 2 questions vertically.
The *TABLE command sets the horizontal iteration texts, while the *LABEL directives are used to
generate the vertical variable texts.
*QUESTION 1 *CODES L4 *MULTI
Which of the following beers do you drink?
1: "Grolsch"
2: "Hertog Jan"
3: "Amstel"
4: "Leeuw"
*MATRIX 4 Q1 W *FIELD L8
*TABLE "Rating"
*QUESTION 5 *CODES L1 *LABEL "Taste experience"
Please rate your overall taste experience:
1: Good
2: Above average
3: Average
4: Below average
5: Bad
*QUESTION 10 *CODES L1 *LABEL "Drinks weekly"
Do you drink this on a weekly basis?
1: Yes
2: No
*ENDMATRIX
Requirements
The *TABLE command must be used right after the *MATRIX command
The parameter for the *TABLE must be fixed text. It cannot start with a text substitution (*?).
Adding Grids
In NIPO ODIN script, grids are created from *FORM questions. The NIPO DSC for IBM SPSS mimics the
structure of the *FORM question in order to display the grid: horizontal fields are placed as columns, while
the vertical categories are placed as rows. The *SCALE command generates a scale using the header texts
as horizontal iterations.
For grids, the *TABLE command is placed on the *FORM question definition. No parameter is used. The
standard export name or the defined export variable name for the question is used. You may also use a
*LABEL to set the grid's label text.
Example NIPO ODIN script using scales
The following example creates a grid with the name "ConsumptionRate" with a text label "Weekly
Consumption rate". The grid contains the 5 scales horizontally against the the 5 brands vertically.
*TAB 40,50,60,70,80
Drink often» Drink sometimes» Drink not very often» Do not drink at all» Don't
know»»
1: Heineken» *SCALE L1 5 5»
Page 21
NIPO DSC for IBM SPSS 2.00.005 User's Guide
2: Grolsch» *SCALE L1 5 5»
4: Amstel» *SCALE L1 5 5»
5: Leeuw» *SCALE L1 5 5»
*ENDREP
Requirements
The vertical categories must be preceded by category numbers.
Fields in the same column must all be of the same type and size.
To apply Hierarchical Data structures to Nvision Script / NIPO Diana, the variable definition file(s) (*.VAR)
must be edited before the data is loaded in an IBM SPSS application. Hierarchical Data structures are
applied by specifying comments below the variable definition using the comment (COM) keyword. The NIPO
DSC for IBM SPSS uses these comments to apply hierarchical data structures when data is being loaded in
an IBM SPSS application. The comments are ignored in Nvision Script / NIPO Diana job execution.
Comments are placed directly below the variable definition:
Example Nvision Script / NIPO Diana variable definitions
*V4_1 *SNG 73L1: Please state your rate of satisfaction on the following items
COM SPSSGRID:Satisfaction,GN:4,GI:1,QC:"Consumptions on offer"
1:Very satisfied
2:Satisfied
3:Neither Satisfied nor unsatisfied
4:Unsatisfied
5:Very unsatisfied
Comments must use either a GRID or a TABLE specification which will result in a grid or table respectively.
Both specifications are discussed in this section.
Page 22
Working with Hierarchical Data
Adding Tables
A table represents the answers to a number of questions vertically against a fixed number of iterations
horizontally. With NIPO Software data a table is typically useful for representing a list of questions that
came from a repetition block.
An IBM SPSS table has a name, a label, a fixed number of questions vertically, and a fixed set of iterations
horizontally.
Syntax
COM SPSSTABLE:<tablename>,<AN:iterations>,<AI:current>,<QN:questions>
<QI:question>[,QT:"Label"][,QC:"Iteration Text"]
tablename
The table's name. Must be valid IBM SPSS syntax for a table name.
AN:iterations
Total number of iterations (columns) in the table. Must be the same value for all variables in this table.
AI:current
Specifies which iteration number the current variable applies to, in other words, the horizontal position of
the iteration. Must be unique within the table.
QN:questions
Total number of questions (rows) in the table. Must be the same value for all variable definitions in this
table.
QI:question
The current question in the table, in other words, the vertical position of the question in the table. Must be
unique within the table.
QT:"Label"
Defines the label for the question (row) variable. Only the first defined label for the row is used, it may be
omitted for the remaining variables that belong to the row. If omitted entirely, the Nvision Script / NIPO
Diana variable label is used.
QC:"Iteration text"
The text of the current iteration in the table. If omitted, the iteration number is used. The iteration text only
needs to be defined once for a certain iteration number, as it is used for all row variables.
The variable categories need to be defined only once, as they are assumed to be the same for all variables
in the grid.
Requirements
Each SPSSTABLE definition must include the table's name, total number of iterations, the current
iteration, the total number of questions and the current question.
All questions (rows) must use at least one variable. If a table is listed to contain 5 questions, the NIPO
DSC for IBM SPSS expects to find at least 5 variables that have been defined to be part of the table.
However, not all iterations need to be defined. Missing iterations result as "undefined" in the output.
All questions on a single row must be of the same type. If the question has a category list, then the first
category list encountered for the question on the row is used.
The iteration number for each variable must be unique in the grid. No two variables in a grid can have
the same iteration number.
The variable name for the IBM SPSS variable for a question index is the name of the first (alphabetically
ordered) NIPO Diana / Nvision Script variable for this question index.
Tables, like repetition blocks, may be nested in other tables. Multiple SPSSTABLE commands are allowed
within the variable comment - the first specifies the root level table, the second the table within the root
level table, et cetera.
Page 23
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Table example
The following example results in a table called "Rating" containing two questions vertically against 4 brands
iterated horizontally.
*V10_1 *SNG 62L1: BMW ownership
COM SPSSTABLE:Rating,AN:4,AI:1,QN:2,QI:1,QT:"BMW ownership"
1:Yes
2:No
*V20_1 63L2
COM SPSSTABLE:Rating,AN:4,AI:1,QN:2,QI:2
%V20_1: How would you rate BMW as a brand on a scale of 1 to 10?
*V20_2 66L2
COM SPSSTABLE:Rating,AN:4,AI:2,QN:2,QI:2
%V20_2: How would you rate Mercedes as a brand on a scale of 1 to 10?
*V20_3 69L2
COM SPSSTABLE:Rating,AN:4,AI:3,QN:2,QI:2
%V20_3: How would you rate Audi as a brand on a scale of 1 to 10?
*V20_4 72L2
COM SPSSTABLE:Rating,AN:4,AI:4,QN:2,QI:2
%V20_4: How would you rate Volkswagen as a brand on a scale of 1 to 10?
Adding Grids
Grids present a number of questions vertically against a set list of categories horizontally. With NIPO
Software data a grid is typically useful for representing a grid of scales.
An IBM SPSS grid has a name, a label, and a fixed number of iterations vertically, and a fixed set of
categories horizontally.
Syntax
COM
SPSSGRID:<gridname>,<GN:iterations>,<GI:current>[,QT:"Label"][,QC:"Iterat
ion text"]
gridname
The grid's name. Must be valid IBM SPSS syntax for a grid name.
GN:iterations
Specifies the number of iterations in the grid. Must be the same value for all variable definitions in this grid.
GI:current
Specifies which iteration number the current variable applies to. This number must be unique within the
grid.
QT:"Label"
Defines the label for the grid. Only the first defined label for the grid is used, it may be omitted for the
remaining variables that belong to the grid. If omitted entirely, the Nvision Script / NIPO Diana variable label
is used.
QC:"Iteration text"
The text of the current iteration in the grid.
Page 24
Working with Hierarchical Data
The variable categories need to be defined only once, as they are assumed to be the same for all variables
in the grid.
Requirements
All variables in a single grid must be of the same type.
Each SPSSGRID definition must include the grid's name, total number of iterations, and the iteration
this variable is in.
All iterations must be specified. If a grid is listed to contain 5 iterations, the NIPO DSC for IBM SPSS
expects to find 5 variables that have been defined to be part of the grid.
The iteration number for each variable must be unique in the grid. No two variables in a grid can have
the same iteration number.
Grid example
The following example results in a grid called "Satisfaction" with the label "Drink" with 4 iterations.
*V4_1 *SNG 73L1: Please state your rate of satisfaction with the following drinks:
COM SPSSGRID:Satisfaction,GN:4,GI:1,QT:"Drink",QC:"Heineken"
1:Very satisfied
2:Satisfied
3:Neither Satisfied nor unsatisfied
4:Unsatisfied
5:Very unsatisfied
*V4_2 *SNG 74L1: Please state your rate of satisfaction with the following drinks:
COM SPSSGRID:Satisfaction,GN:4,GI:2,QC:"Amstel"
*V4_3 *SNG 75L1: Please state your rate of satisfaction with the following drinks:
COM SPSSGRID:Satisfaction,GN:4,GI:3,QC:"Grolsch"
*V4_4 *SNG 76L1: Please state your rate of satisfaction with the following drinks:
COM SPSSGRID:Satisfaction,GN:4,GI:4,QC:"Hertog Jan"
To place grids in a table, the SPSSTABLE and SPSSGRID parameters must be specified in the same
comment:
Syntax for an SPSSGRID in an SPSSTABLE
COM SPSSTABLE:<tablename>,<AN:iterations>,<AI:current>,<QN:questions> \
<QI:iteration>[,QT:"Label"][,QC:"Iteration Text"] \
SPSSGRID:<gridname>,<GN:iterations>,<GI:current>[,QT:"Label"][,QC:"Iteration text"]
Page 25
Working with Job Files
This section is primarily intended for the Nvision Script / NIPO Diana user who provides data files to the
data analyst.
With the NIPO DSC for IBM SPSS, the data analyst can open job files instead of data and variable files
directly in IBM SPSS applications. The data and variable sets loaded or produced by the job file are made
available as a single data set in the IBM SPSS application. This offers several possibilities for "just-in-time"
data manipulation and enrichment:
You can easily combine several data files using the DEFINE (Nvision Script) or DE (NIPO Diana)
directives, thereby accessing several data sources as if they were contained within a single file.
You can load several variable sets at once using the DEFVAR (Nvision Script) or DV (NIPO Diana)
directives, making all of the contained variables accessible in your IBM SPSS application as if they were
contained within a single file.
You can access and retrieve information coming from sources contained within database tables.
You can sort and merge data files before accessing the data in your IBM SPSS application.
You can apply any kind of data transformations using Typologies to clean or modify data in any sense
required.
With careful preparation, using JOB files you can pull and adjust data from various sources of continuous
fieldwork and unify these every time the file is accessed.
Note:
The IBM SPSS applications open the data in read-only mode. The original job, variable and data files
are never modified.
Job Requirements
To successfully open data and variable files in IBM SPSS applications, the job file has the following
requirements:
It must load at least one data file or open one database table for reading.
It must define variables or load a variable file.
The last data file opened in the Nvision Script / NIPO Diana file is the data file to be accessed by the IBM
SPSS application. All variables defined or loaded within the scope of the job are used as the variable map.
The following is a valid job file that can be used with the NIPO DSC for IBM SPSS:
DEFINE C:\MyProject\project.dat
DEFVAR C:\MyProject\project.var
You can combine several files into one in a single job file:
DEFINE C:\MyProject\wave1.dat+C:\MyProject\wave2.dat+C:\MyProject\wave3.dat
DEFVAR C:\MyProject\project.var+C:\Defaults\Background.var
In addition, you can perform data transformations and enrichment using sorting, merging and Typologies.
When Typologies are executed by the job, the output file last opened, sorted or written is the data file
accessed by the IBM SPSS application.
Page 27
NIPO DSC for IBM SPSS 2.00.005 User's Guide
Page 28
NIPO DSC for IBM SPSS Configuration
The NIPO DSC for IBM SPSS applies the following default configuration. The defaults apply to data opened in
all IBM SPSS products.
NIPO DSC for IBM SPSS defaults
No categories are added to count blank ('no answer') values
No axis lines are created
No NIPO Software system variables are included
No hierarchical data structures are applied, even if available in the variable definitions.
Note:
The defaults may have been changed by the administrator who installed the software.
The default settings may be changed according to your requirements. This section deals with advanced
configuration of the NIPO DSC for IBM SPSS using the settings panel.
Page 29
NIPO DSC for IBM SPSS 2.00.005 User's Guide
InputDataSource(myInputDataSource)
ConnectionString = "Provider=mrOleDB.Provider.2; _
Data Source=nipNvDsc; _
Initial Catalog=" + INPUT_METADATA + "; _
MR Init MDSC=nipNvDsc; _
MR Init Custom=' _
AddAxis=0; _
AddStatLines=0; _
AddSystemVariables=0; _
AddTotalAnswers=0; _
NoanswerIndication=0; _
UseHDATA=0'"
End InputDataSource
OutputDataSource(myOutputDataSource)
Page 30
NIPO DSC for IBM SPSS Configuration
ConnectionString = "Provider=mrOleDB.Provider.2; _
Data Source=mrdatafileDsc; _
Location=" + OUTPUT_CASEDATA
MetaDataOutputName = OUTPUT_METADATA
End OutputDataSource
TThe script above loads the file project.var (and implicitly project.dat and optionally projecto)
from C:\MyProjects and applies the settings as provided in the ConnectionString. The data is
transformed into meta data files project_out.ddf and project_out.mdd. The settings applied in
the example are the default settings.
Alternatively, an Nvision Script / NIPO Diana job file can be loaded as the Initial Catalog file. The job
file is assumed to define the data files and variable files.
Note:
It is recommended to always specify all settings in the custom settings of the
ConnectionString.
Page 31
Variable Translation
This section provides a brief overview of how NIPO ODIN question types and Nvision Script / NIPO Diana
variables are translated into IBM SPSS types.
Question type and variable translation in the NIPO DSC for IBM SPSS
NIPO ODIN question type Nvision Script / NIPO Diana variable IBM SPSS type
*CODES question with categories, Single-coded variable (variable definition Categorical variable.
not *MULTI containing *SINGLE / *SNG) with categories
*CODES question without categories Single-coded variable (variable definition Integer variable.
(typically a *DUMMY question), not containing *SINGLE / *SNG) without categories,
*MULTI no decimal places, up to nine digits
*CODES question using *MULTI Multiple-coded variable (any variable definition Categorical variable.
without *SINGLE / *SNG but with one or more
categories).
Question using *NUMBER Numerical variable (variable without type Long variable.
specification and without categories)
Question using *ALPHA Text variable (*TEXT / *TEK) without categories Text variable. The length of the field is set
to the length defined in the Nvision Script /
NIPO Diana variable.
Question using *OPEN Numerical variable (variable without type Text variable.
specification and without categories) using the
QTYPE:OPEN comment
*CODES question using *BUT Categorical variable. The codes defined
with *BUT are added as categories to the
variable.
*OPEN and *NUMBER question using Text or Long variable respectively with a
*BUT categorical helper field containing all defined
buttons as categories.
Compound variable consisting of categories using Several Categorical variables with an
code references, the!C operator or the %operator iteration number. The number of variables
using category references created depends on the number of
categories in the Nvision Script / NIPO Diana
variable.
Compound variable consisting of one or more Long variable. The value is set to the value
categories using the !V or !W operator or the % of the first category in the Nvision Script /
operator without category references NIPO Diana variable.
Compound variable consisting of categories using Several Categorical variables with an
a combination of %, !C and !V or !W operators iteration number. The number of variables
created depends on the number of
categories in the Nvision Script / NIPO Diana
variable.
Categorical. Nvision Script / NIPO Diana
categories using the !V or !W operators or
the % operator without category references
are not included as IBM SPSS variable.
Note:
Incorrect variable definitions in Nvision Script / NIPO Diana variable files are ignored and do not
appear in the variable map.
Page 33
Index
A U
Adding Grids ................................................................... 21, 24 Using Open-Ended Answers on Data from NIPO Diana /
Adding Hierarchical Data in NIPO ODIN ................................ 20 Nvision Script ................................................................... 11
Adding Hierarchical Data in Nvision Script / NIPO Diana....... 22 Using Open-Ended Answers on Data from NIPO ODIN Script11
Adding Missing Case Value Categories as a Rule ................... 13
Adding Missing Case Value Categories by Exception ............ 15 V
Adding Tables.................................................................. 20, 23
Variable Translation ............................................................. 33
C
W
Changes in NIPO DSC for IBM SPSS 2.00 ................................. 2
Changes in NIPO DSC for IBM SPSS 2.00.001 .......................... 2 Working with Hierarchical Data ............................................ 19
Changes in NIPO DSC for IBM SPSS 2.00.002 .......................... 2 Working with Job Files .......................................................... 27
Changes in NIPO DSC for IBM SPSS 2.00.003 .......................... 2 Working with Missing Case Values ....................................... 13
Changes in NIPO DSC for IBM SPSS 2.00.005 .......................... 2 Working with Open-Ended Answers..................................... 11
Changing the Configuration in mrScriptBasic ........................ 30
Contacting NIPO Software Sales ............................................. 2 Y
Contacting the NIPO Software Helpdesk................................. 3
Your Feedback on this Guide .................................................. 3
Contacting Us .......................................................................... 2
I
IBM SPSS Data Collection Base Professional ........................... 9
IBM SPSS Data Collection Survey Reporter ............................. 9
IBM SPSS Statistics and PASW SPSS Statistics ......................... 7
Included in This Release .......................................................... 1
Installing the NIPO DSC for IBM SPSS ...................................... 5
Introduction ............................................................................ 1
J
Job Requirements ................................................................. 27
K
Known Issues and Incompatibilities ........................................ 4
N
NIPO DSC for IBM SPSS Configuration ................................... 29
NIPO DSC for IBM SPSS Settings Panel .................................. 29
NIPO DSC for IBM SPSS Version History .................................. 2
Not Included in This Release ................................................... 1
O
Opening NIPO Software Data in IBM SPSS Applications .......... 7
P
Prerequisites ........................................................................... 5
R
Running the Installer ............................................................... 6
S
Supported IBM SPSS Products ................................................ 1
System Requirements ............................................................. 5
T
Typographical Conventions ..................................................... 3
Page 35
NIPO Software is a specialist software supplier to the market research industry. We
focus on adding value to our customers’ businesses. Today we serve over 200
companies all over the world. We have developed multiple industry standards
and we keep innovating to this day.
NIPO Software
Grote Bickersstraat 74
1013 KS Amsterdam
The Netherlands
http://www.niposoftware.com
info@niposoftware.com
Page 36