CSPro Data Entry User's
CSPro Data Entry User's
Guide
Version 7.6.0
International Programs
Population Division
U.S. Census Bureau
4600 Silver Hill Road
Washington, DC 20233
cspro@lists.census.gov
Table of Contents
Table of Contents 1
Data Entry User's Guide 3
Introduction to Data Entry 3
Data Entry Concepts 5
Modes of Operation 5
Cases and Levels 5
Trees 5
Forms 6
Fields 6
Repeating Groups of Fields 7
Persistent Fields 7
Field Colors 7
How to ... 9
Open Applications and Data Files 9
Open an Application 9
Open a Data File 9
Define File Associations 10
Add Cases 11
Begin Adding Cases 11
Save Partially Added Case 11
Complete Partially Added Cases 11
Enter Data 11
Add a Note 12
Move Around a Case in Add Mode 12
Finish a Case 14
View or Hide Response Box 14
Change CAPI Language 14
Modify Cases 15
Select a Case 15
Begin Modifying Cases 15
Save Partially Modified Case 15
Move Between Cases 15
Insert a Case 16
Delete a Case 16
Change Case IDs 16
Move Around a Case in Modify Mode 16
Go to a Field 17
Insert a Group Occurrence 17
Delete a Group Occurrence 17
Sort a Group Occurrence 17
Select a Level Occurrence 17
Add a Level Occurrence 18
Insert a Level Occurrence 18
Delete a Level Occurrence 18
Save a Case 18
Edit Interactively 19
Verify Cases 20
Begin Verifying Cases 20
Pa ge 1 of 35 Ta ble of Contents
Save Partially Verified Case 20
Verify Data 20
Show Fields 20
Active Keys in Verify Mode 21
Stop Work 22
Stop Data Entry 22
Save Partial Case 22
Pause Data Entry 22
Assess Performance 23
View Operator Statistics 23
Understand Operator Statistics 23
Synchronize 25
Synchronize Data 25
Views, Settings, and Get Help 26
Change View 26
CSPro Settings 27
Get Help 27
Files 28
Types of Files 28
Index File (.csidx) 28
Operator Statistics File (.log) 28
Listing File 29
Notes File (.csnot) 30
Status File (.sts) 30
Summaries 32
Menu Summary 32
Toolbar Summary 33
Keys Summary 33
Pa ge 2 of 35 Ta ble of Contents
Data Entry User's Guide
Introduction to Data Entry
The Data Entry module allows you to enter data into one or more data files. It uses a previously developed data entry
application to control the data entry process.
How to ...
Open an Application
Begin Adding Cases
Begin Modifying Cases
Begin Verifying Cases
Stop Data Entry
Pause Data Entry
View Operator Statistics
Add a Note
Change View
Get Help
Files
Types of Files
Index File (.csidx)
Listing File
Notes File (.csnot)
Operator Statistics File (.log)
Status File (.sts)
Mode Description
Add Enter new cases.
Modify Modify previously entered cases.
Verify Verify previously entered cases.
Pause Temporarily stop adding, modifying, or verifying cases. The timer maintained for statistics collection is
suspended. Pause is used when you plan to continue from where you left off after a short delay.
Stop Not adding, modifying, or verifying cases in the data file. No form is visible.
Some complex applications have a hierarchical set of questionnaires. For example, the main questionnaire may consist of a
household roster and other household information, and there may be a separate questionnaire for each woman in the
household. The data entry application may then contain two levels: one for the household and one for each woman in the
household. The set of forms corresponding to the household make up level one. The set of forms corresponding to each
woman make up level two. Each case would consist of a level one and a variable number of level occurrences for level two.
Most applications consist of a single level.
Trees
There are two trees on the left side of the screen: the file tree and the case tree.
File Tree
The file tree shows all cases in the data file. In a single level application, the tree shows the complete IDs for each case. The
icons in front of the IDs indicate whether the case is complete or partial. For example the tree might look like:
In the tree above, the first case has been partially verified, the third case has been partially modified, and the last case has
been partially added.
In a multi-level application, the tree shows the level occurrences for each case. In the following example there are two
levels.
Pa ge 5 of 35 Da ta Entry Concepts
Cases in a data entry data file are indexed by their level one ID fields. You cannot have two cases with the same level one IDs
in the same data file. Within cases, level occurrence IDs must also be unique, but within the file they may repeat.
Case Tree
When adding, modifying, or verifying individual cases, a second tree, called a case tree, may be active if this feature was
selected during development of the data entry application. The case tree shows the internal structure of the active case.
The case does not occur when data entry is stopped. The following is an example of a case tree:
In the tree above, the current value is displayed to the right of each data field. Some tree elements, such as BOOK and
PERSON000 have no values beside them because they represent forms and rosters, respectively.
Forms
A form appears on the screen when you Add, Modify, or Verify cases. A form contains data fields and text. Forms may be
larger than the actual screen area. The form will scroll automatically to insure that the field you are entering is visible on the
screen.
Data entry applications may consist of several forms. As you complete one form the next form is presented. If you move
backward from the first field on a form, the previous form is presented.
Fields
A field is the basic element on a data entry form into which you enter data. During data entry the cursor moves from one
field to the next, according to the order and rules defined by the data entry application. Fields are shown on the form as
boxes with tick marks to indicate how many digits or characters may be keyed.
Pa ge 6 of 35 Da ta Entry Concepts
Some fields cannot be entered. They may contain either data previously entered on another form or protected fields. Such
fields appear dark gray in color.
Rosters
The default roster orientation is horizontal, which will show individual fields across the column headings. Each row of the
roster therefore corresponds to an occurrence of this group. The group repeats as many times as there are lines. In the
example above, the group contains four fields and three occurrences.
Use the / (slash) key on the numeric keypad to jump to the next occurrence.
Use the Ctrl+/ key to jump out of the roster entirely.
Repeating Forms
Sometimes the same blank form will appear for you to complete. In this case, the form itself corresponds to a group
occurrence, rather than a roster. Navigation keys (/, Ctrl+/, etc.) will be identical as in the roster because only the
presentation of the information is different.
Persistent Fields
The application designer may define ID fields to be persistent. This usually occurs when the designer does not anticipate the
IDs changing between cases within the data file, such as for geographic IDs. The operator will enter values for the first case,
and then the system will use those values for the IDs of subsequent cases.
However, if the operator needs to change an ID, they can do so by successive presses of the F7 key, which will back the
operator up through the ID fields.
Field Colors
CSEntry uses colors to indicate the status of each field.
White
System-controlled: You have never passed through this field for data entry input or you have passed through this field for
data entry input, but have moved backwards over it.
Pa ge 7 of 35 Da ta Entry Concepts
Operator-controlled: You have never moved this far forward during data entry of this case.
Green
System-controlled: You have passed through this field for data entry input and have not moved backwards over it. If you
move backwards over green fields, they become white.
Operator-controlled: You have passed through this field for data entry input and have not moved backwards over it. If you
move backwards over green fields, they become yellow.
Yellow
System-controlled: This color never occurs.
Operator-controlled: You have passed through this field for data entry input and have moved backwards over it or you have
skipped over this field during data entry. Green and yellow shows you the "high-water mark," that is, how far forward you
have reached in this case.
Gray
Both: You cannot enter the field. The field either contains a previously entered value from another form or is a protected
field.
Light Gray
Both: The field takes on the value from the previous case. You can change the value by using the F7 key to back up into it.
Example
In the following operator-controlled example, Province and District are persistent, which means that their values were
carried over from the previous case. The operator keyed HH No. through CY Income, then backed up to Line number. The PY
Income field is protected and has been filled in via logic in the program.
Pa ge 8 of 35 Da ta Entry Concepts
How to ...
Open Applications and Data
Files
Open an Application
1. Press Ctrl+O; or from the File menu, select Open Application; or click on the toolbar.
2. Select from the Files of type: at the bottom of the dialog box. You can open either a data entry application file (.ent)
or a Program Information file (.pff).
3. If you opened a data entry application file, you will be requested to select the name of the data file(s).
4. Enter the Operator ID (if required).
CSEntry also accepts a single command-line parameter. It may be one of the two following types:
.ent: This is a data entry application file. CSEntry will prompt for the data file(s).
.pff: CSEntry will open both the application and the data file(s).
In either case, you must specify the full filename. For example:
1. Press Ctrl+D; or from the File menu, select Open Data File; or click on the toolbar.
2. Select the data file that you want to open. If you want to create a new data file, enter a new name.
3. Press Open.
4. Enter your operator ID (if required).
Notes
You can create a new data file simply by typing in a new name.
You can only work on one data file at a time. If you open a new data file, the previous one will be closed.
No default extension is provided in CSEntry, therefore, if you want a certain extension, you must type it.
Pa ge 9 of 35 How to ...
CSEntry uses the operator ID in the operator statistics, which are kept in the log file.
The operator ID may be up to 32 characters long and may include any character, including embedded spaces.
Some applications do not require you to enter the operator ID.
You may see the "Define File Associations" dialog box but what is being asked of you may vary. The following shows the order
in which files will be solicited from you, and why:
Write File
If your program includes one or more write functions, CSEntry will ask you for the file to write them all to. If you fail to name
a file, all write function text will be placed in the listing file.
Pa ge 10 of 35 How to ...
Add Cases
Begin Adding Cases
Press Ctrl+A; or from the Mode menu, select Add; or click on the toolbar to begin adding cases at the end of the data
file.
This will begin a new Add mode session. You may add as many cases as you like. To end the session, press Esc or Ctrl+S.
Depending on where you are in the case and if the partial feature is allowed will determine what will happen next.
If you have not yet begun keying a new case: pressing Esc or Ctrl+S will exit the add mode.
If you have begun keying a new case, but have not finished keying the IDs for that case: pressing Esc or Ctrl+S will
present you with a dialog, asking if you want to discard the changes you have made, or cancel the stop request
(which will return you to your form where you left off).
If you have begun keying a new case and have finished keying the IDs for that case, and partial cases are allowed,
the partial save button will be active. Selecting it will save the case and indicate it is partially saved from add mode by
the icon in the file tree.
The most important condition is that during development of the data entry application, the partial feature must have been
selected. During keying if you attempt to exit from your case, the Partial Save button will appear on the Stop Adding dialog
box.
The second condition is that you must have finished entering the IDs for that case. If you have, the Partial Save button will
be enabled on the Stop Adding dialog box. Choosing it will save the case, remembering the field your cursor was last on and
returning you to this field when add is resumed.
To reload a partially added case, select it in the File Tree and press Enter, or double-click the case with the mouse.
You will be asked whether you want to return to the field where you left off, or start at the beginning of the case.
Enter Data
When you begin entering data in a new file, CSEntry will automatically show the first requiring data entry.
When entering decimal numbers, you must always key a decimal character to move to the decimal part of the entry.
After entering data for each field, you may be required to press Enter, depending on your application's runtime settings.
Otherwise, the cursor will automatically move to the next field once the current field is completely filled. If for a given data
field two digits can be entered, and the operator enters 02, the system will automatically advance to the next field (if the
Pa ge 11 of 35 Add Ca s es
application has been designed to do this). If, however, the operator only entered 2 for this field, then the operator would
have to press the Enter key to advance to the next field. In any case, you can press Enter to move to the next field if the
current field is not filled up.
Your application may have been designed with skip logic. This means the system may move you automatically depending on
the values you key and the underlying logic. You may continue to key data and move forward until the end of the case, or
you may use other keys to move around a case before you finish it.
As you move from field to field, the status bar at the bottom of the screen shows you the name and occurrence number of
the current field.
Add a Note
Field Notes
It sometimes is necessary to attach text to a data field in addition to the data value. For example, the enumerator may have
made a notation on the questionnaire which you want to preserve or the field may have an other specify response category
and you want to save the specified response. You can save such text by entering a note for the field.
To enter notes for data field, press Ctrl+N or from the Edit menu select Edit Field Note.
Case Notes
You can also add a case note, which is a single note associated with the entire case. This note is use for more general
information, such as information about a household or notes for a supervisor regarding specifics about the interview.
To add a case note, from the Edit menu select Edit Case Note.
For example, if the operator has finished entering data for a person (a multiple group), he can use this key to start entering
data for the next person.
For example, if the operator has finished entering data for all persons, he can use this key to move to the next group, even if
there is room for more persons. This is an easy way get out of a roster.
In system-controlled applications: If you have moved backward, this key will advance you to the end of the current level
occurrence, or to the "furthest point" forward you have reached, if this is in the current level occurrence. This key is very
similar to the F10 key in this circumstance.
For example, if the first level is a mother questionnaire and the second level is a child questionnaire, pressing this key during
a child questionnaire means you have finished all children and wish to start a new mother.
Go To (F6)
This key allows you may to move to any field (either forward or backward). It is useful if you want to a field that is "far away"
or not on the current form. You must know the name of the field to which you want to move. If the field is multiply occurring
(on a roster, for example), you may also specify a specific occurrence number. If you leave the occurrence number blank the
system assumes the current occurrence number. You can see the field names and occurrence numbers on the status bar at
the bottom of the screen as you key data.
Pa ge 13 of 35 Add Ca s es
Skip to (+ on numeric keypad)
For operator-controlled applications, this key skips to the next field defined by the application. It is used to skip groups of
fields that may all be blank because they are not required to be answered by certain respondents.
Finish a Case
Normally you finish a case when you have completed entering all the forms in the case. CSEntry asks you whether you want
to accept the case or not. If you accept the case, CSEntry immediately writes the case to the data file.
In system-controlled applications the operator must enter data field-by-field until reaching the end of the case. Exactly
when the end of the case is reached is determined by logic. There are no special keys to finish a case prematurely. In
applications with more than one level, the application developer must write logic to tell CSEntry when to finish entering level
occurrences.
In operator-controlled applications, the operator may press F12 or Ctrl-F12 to end a case at any time.
To show or hide responses for this field, press Ctrl+C or from the Options menu, select Show Responses (This Field).
To show of hide responses for all fields, press Ctrl+K or from the Options menu, select Show Responses (All Fields).
You can also move the response box around on the screen using the mouse.
Press Ctrl+L or from the Options menu, select Change CAPI Language. A dlialog box will come up to allow you to select
question and help text from among the available languages.
Pa ge 14 of 35 Add Ca s es
Modify Cases
Select a Case
Use any of the following methods to select a case to view and/or modify.
From the File Tree move the highlight bar to or click on the case ID. Then press Ctrl+M or from the File menu, select
Modify Case.
From the File Tree, double click on the case ID.
Press Ctrl+F or from the Edit menu, select Find Case. Then enter the case ID. The case ID must be entered exactly as
it appears in the file.
The session will end when you stop modifying the current case. You can stop modifying a case by finishing it, or partially
saving the modifications.
Partially modified cases are marked with in the file tree. You can modify these cases as well as any other completed
cases. You cannot modify partially added or verified cases.
The most important condition is that during development of the data entry application, the partial feature must have been
selected. During modification if you attempt to exit the case by pressing Esc or Ctrl+S, the Partial Save button will appear on
the Stop Modifying dialog box.
The second condition is that you must have changed one of the field values in the case. If you have, the Partial Save button
will be enabled on the Stop Modifying dialog box. Choosing it will save the case, remembering the field your cursor was last
on, returning you to this field when modification is resumed.
From the File Tree move the highlight bar to or click on a different case ID.
Use the toolbar to select first, previous, next or last case in the data file.
From the Navigation menu select First Case, Previous Case, Next Case, or Last Case.
Use the special keys to select first, previous, next or last case in the data file.
Pa ge 15 of 35 Modify Ca s es
Insert a Case
1. Make sure you are not in Add, Modify, or Verify mode. You may need to stop (Ctrl+S) data entry first.
2. From the File Tree move the highlight bar to or click on the case ID where you want to insert the case.
3. Press Ctrl+Ins or from the Edit menu, select Insert Case.
Delete a Case
1. Make sure you are not in Add, Modify, or Verify mode. You may need to stop (Ctrl+S) data entry first.
2. From the File Tree move the highlight bar to or click on the case ID you want to delete.
3. Press Ctrl+Del or from the Edit menu, select Delete Case.
CSEntry will ensure that no two cases in the same data file have the same IDs.
System-controlled applications: This key advances to the beginning of the next level occurrence.
A field can have multiple occurrences because it appears in a roster or because it appears on repeating forms. If the filed
does not have multiple occurrences or you want to go to the first occurrence, leave the field occurrence number blank.
1. In Add or Modify mode, position the cursor to the group occurrence before or after which you want to insert, for
example a particular line on a roster.
2. To insert before the current position, press F3, or from the Edit menu, select Insert Group Occ.
3. To insert after the current position, press Ctrl+F3, or or from the Edit menu, select Insert Group Occ After.
See also: Repeating Groups of Fields, Delete a Group Occurrence, Sort a Group Occurrence
1. In Add or Modify mode, position the cursor to the group occurrence you want to delete, for example a particular line
on a roster.
2. Press F4, or from the Edit menu, select Delete Group Occ.
See also: Repeating Groups of Fields, Sort a Group Occurrence, Insert a Group Occurrence
The group data will be always be sorted in ascending order. It will sort the data based on the current field selected; that is,
based on the location of the cursor. Therefore, if you are in the AGE field of the population group and press F5, the
population records will be sorted by age, showing youngest person first.
See also: Repeating Groups of Fields, Insert a Group Occurrence, Delete a Group Occurrence
1. Make sure you are not in Add, Modify, or Verify mode. You may need to stop (Ctrl+S) data entry first.
2. Expand the File Tree for the case which contains the level occurrence of interest.
3. Move the highlight bar or click on level occurrence of interest.
Pa ge 17 of 35 Modify Ca s es
Add a Level Occurrence
This applies only to complex applications that have more than one level.
1. Make sure you are not in Add, Modify, or Verify mode. You may need to stop (Ctrl+S) data entry first.
2. Select the case ID on the File Tree for the case into which you want to add level occurrence.
3. Press Alt+A; from the Edit menu, select Add Level Occ; or right click and select Add Level Occ.
1. Make sure you are not in Add, Modify, or Verify mode. You may need to stop (Ctrl+S) data entry first.
2. Expand the File Tree for the case into which you want to insert a level occurrence.
3. Select the level occurrence before which you want to insert.
4. Press Alt+Ins; from the Edit menu, select Insert Level Occ; or right click and select Insert Level Occ.
1. Make sure you are not in Add, Modify, or Verify mode. You may need to stop (Ctrl+S) data entry first.
2. Expand the File Tree for the case in which you want to delete a level occurrence.
3. Select the level occurrence you want to delete.
4. Press Alt+Del; from the Edit menu, select Delete Level Occ; or right click and select Delete Level Occ.
Save a Case
Saving a case will write the contents of the current case to the data file, including any changes you have made. This includes
all records, of all types, into which data have been entered. If a record type has been declared Required (in the data
dictionary), and no data was entered for this record type, a blank record of the required type will be written as part of the
questionnaire, and a message informing you of this action will be issued. There is no way to suppress this message. Records
are written to the output file in the order in which the record types were defined in the data dictionary.
If the application is defined as operator-controlled, you may use the F12 or Ctrl+F12 keys to save a case. If the application is
one level (most common), use either key. If the application is more than one level, use the Ctrl+F12 key.
If the application is defined as system-controlled type, you may use the F10 key (Advance to End) to save a case. This key
will execute all the procedures from the current field through the end of the case. The application may contain underlying
logic which stops you at a certain point and displays a message. The system will only save the case if there are no such
messages.
If you are in add mode, saving the case will keep you in add mode, allowing the operator to continue adding cases.
If you are in modify mode, saving the case will terminate modify mode. The operator has to select a new case and to
get back into modify mode.
Pa ge 18 of 35 Modify Ca s es
Edit Interactively
You can search through the data file using your data entry logic to find errors or unexpected conditions and display the data
entry form containing each error ready for modification. This is a very convenient way to make corrections to survey data,
provided the data volume is not too large, and the operator is knowledgeable enough to make the necessary corrections.
Interactive editing is performed after the data have already been entered. You can use the same programmed logic that
was in effect during data entry to find problems that were left unresolved by the original keyer, or you can use different logic
to check for other conditions.
1. Open the data file, using the data entry application that contains the logic you want to check.
2. Go to Modify mode, starting on the first case you wish to check (usually the first case in the data file).
3. From the Edit menu, select Interactive Edit; or press F11.
4. Select whether to stop on messages, out of range conditions, or both.
CSEntry will advance from wherever the cursor is currently positioned, field by field, from the current case through the end
of the data file, executing whatever procedures are included in the application’s logic. If you have chosen to stop on
messages, CSEntry will stop whenever the application logic hits an "errmsg" command. If you have chosen to stop on out of
range, CSEntry will stop whenever a field value is other than what is defined in its first value set in the dictionary. (If there
are no value sets for a given field, it will never be considered out of range.) When CSEntry stops, it shows the programmed or
out or range message, then places you on the appropriate form. You can make changes to the data if you like, and press F11
to continue through the data file.
Pa ge 19 of 35 Modify Ca s es
Verify Cases
Begin Verifying Cases
Press Ctrl+V; or from the Mode menu, select Verify; or click on the toolbar to begin verifying cases from the beginning of
the data file or where you left off verifying. This will begin a new Verify mode session. CSEntry keeps track of the last case
that was verified, and positions you automatically to the next case to verify.
If you did not complete verifying the last case, there will be a partially verified case in the data file marked with in the file
tree. When you begin verification, you will be asked whether you want to begin verification where you left off within the
case.
You cannot verify cases if there are partially added or partially modified cases in the file. You must finish these cases before
you can resume verification.
You may verify as many cases as you like until you reach the end of the data file.
The most important condition is that during development of the data entry application, the partial feature must have been
selected. During verification if you attempt to exit the case by pressing Esc or Ctrl+S, the Partial Save button will appear on
the Stop Verifying dialog box.
The second condition is that you must have verified all ID fields in the case. If you have, the Partial Save button will be
enabled on the Stop Verifying dialog box. Choosing it will save the case, remembering the field your cursor was last on, and
returning you to this field when verification is resumed.
Verify Data
When you verify a case, you key the case a second time as if you were in Add mode. Even though there is already data in the
data file, CSEntry does not show this to you. All fields on the current form start out blank. Each time you key a field, the
system compares the value you keyed with the value in the data file. If these two values match, you move to the next field. If
the values do not match, you get a message telling you so. When this happens, simply rekey the field. One of the following
situations will occur:
The second value you key matches the value in the data file. The system assumes your first value is in error and moves
to the next field. There will be no change to the data file for this field.
The second value you key matches the first value you keyed. The system assumes the value in the data file is in error
and moves to the next field. The new value, which you keyed twice, will replace the original value in the data file.
The second value you key matches neither the value in the data file nor the first value you keyed. The system will
throw away the first value you keyed, show you the mismatch message and wait for you to rekey the field again.
Show Fields
Sometimes you need to see the values in the data file on the screen. This is particularly useful if you are unsure which case
you are verifying or exactly where in the case you are. You can use the Ctrl+F2 key to do this. When you press the Ctrl+F2 key
Pa ge 20 of 35 Verify Ca s es
you will see the values for all the fields on the current form. You must press Ctrl+F2 again to resume verifying.
Pa ge 21 of 35 Verify Ca s es
Stop Work
Stop Data Entry
To stop data entry press Esc or Ctrl+S; click Stop Button on the toolbar; or from the Mode menu select Stop. This function
has no effect if you are already stopped. Stopping add, modify, or verify will make an entry into the operator statistics file.
If you are at the beginning of a case or have not made any changes, the session will end immediately.
If you have started, but not completed entry/modification/verification of a case, two or more of the following choices will
appear depending on the mode of data entry and whether partial save is allowed:
Option Description
Partial Save Partially save the changes you have made so far and remember the field you are on, so you can
complete the work later. Available only if partial save is possible. In add and verify mode, all ID fields
must have been entered.
Finish Finish the case and save the modifications you have made. Available only in modify mode.
Discard Discard all the changes you have made since you opened this case. Always available.
Cancel Cancel this operation and return to entering the case. Always available.
If you want to save what you’ve done so far but continue, press Ctrl+R or from the File menu, select Save Partial Case.
Whenever you are in Add, Modify, or Verify mode, a timer is running. This timer is used to generate the operator statistics
for the data entry session. Pause (Ctrl+P) stops the timer until you either resume typing or press Ctrl+P again.
The timer affects the calculation of keystrokes/hour. If you need to leave the computer for a few minutes, but are in the
middle of a session, you should pause data entry so that time will not be counted against you.
Pa ge 22 of 35 Stop Work
Assess Performance
View Operator Statistics
To view operator statistics press Ctrl+W or from the View menu, select Operator Statistics. You can view statistics only
when you are in stop mode; that is, when you have stopped adding, modifying, or verifying cases.
CSEntry shows the number of cases in the data file and the number of cases which have been verified. CSEntry also provides
information about each operator who has worked on the current data file. This information is stored in the log file.
Clicking in the gray heading area for any column will sort the information in that column. Successive clicking of the column
heading toggles that column's data between an ascending or descending sort.
Operator ID
Displays the personal ID assigned to the operator of the relevant session. To ensure reliable statistics, this ID must be unique
for each data entry operator.
Start Date
Indicates the date on which the session began. The date format is DD/MM/YYYY (i.e., Day/Month/Year).
Start Time
Indicates the time at which the session began. The system uses a 24-hr clock, so 2:30 pm will appear as 14:30.
Pause Time
Indicates the total amount of time during the session in which the clock was suspended. The format shown is HH:MM (i.e.,
hours:minutes).
Total Cases
Indicates the total number of cases that the operator added (if in Add mode), modified (if in Modify mode), or verified (if in
Verify mode) during the session.
Pa ge 23 of 35 As s es s Performa nce
Total Records
Indicates the total number of records, of all types, that the operator added (if in Add Mode), modified (if in Modify mode), or
verified (if in Verify mode) during the session.
Total Keystrokes/Hr
Indicates the operator's keying rate during the relevant session. The total number of keystrokes is divided by the duration of
the session, excluding the pause time, and displayed as an integer value.
Errors/1000 Keystrokes
Is the result of a two-step calculation: the total number of keying errors (an internal counter maintained by the system but
not displayed) is multiplied by 1000; the result of this operation is divided by the total number of keystrokes for the session;
the result of the division operation is rounded, if necessary, and displayed as an integer value.
Pa ge 24 of 35 As s es s Performa nce
Synchronize
Synchronize Data
A data entry application may be able to synchronize data with a remote server. If so, the Synchronize menu option (off the
File menu) will be enabled when you are not currently working in any case. When you select this option, CSEntry will attempt
to connect to the remote server and then synchronize data, as well as possibly the data entry application itself, using
parameters specified by the application programmer.
You may have to enter a username and/or password before the synchronization process begins.
Pa ge 25 of 35 Synchronize
Views, Settings, and Get Help
Change View
Full Screen
To toggle between trees on left and full screen press Ctrl+J, or from the View menu, select Full Screen. A check mark
appears next to the Full Screen menu item when the display is in full screen mode. The setting of Full Screen remains in effect
until changed.
Case Tree
To toggle the Case Tree on or off press Ctrl+Z, or from the View menu, select Case Tree. A check mark appears next to the
Case Tree menu item when the Case Tree is displayed. If there is no check mark, the File Tree is displayed.
Show Values
To show all data values in verify mode press Ctrl+F2, or from the View menu, select Show Values (verify). Pressing Ctrl+Z or
keying values will return data entry to verify mode.
Operator Statistics
CSPro Settings
The CSPro Settings dialog is accessed from the CSPro Designer or from CSEntry by selecting CSPro Settings from the File
menu. The dialog has the following options:
Saved Credentials: By selecting Clear Credentials, any cached credentials saved to secure storage will be removed. These
credentials include access tokens to CSWeb servers and Dropbox, passwords to FTP servers, and hashed password keys used
to open encrypted data files.
Get Help
To contact the CSPro development team with comments, questions, or to report problems, please contact:
International Programs
Population Division
U.S. Census Bureau
4600 Silver Hill Road
Washington, DC 20233
Phone: +1 301-763-1451
Support email: cspro@lists.census.gov
Official website: www.census.gov/data/software/cspro.html
CSPro Users forum: www.csprousers.org/forum
When you contact us, please mention that you are using CSPro 7.6.0.
There are often other files associated with the primary data file. They have the same name as the primary data file with the
following extensions added:
Extension File
.csidx Index
.lst Listing
.csnot Notes
.log Operator statistics
.sts Status
If you are using a file format like CSPro DB that is not text based, the data contained in the index, notes, and status files is
embedded within the single file.
CSPro automatically generates an index file when creating a new data file. CSPro then coordinates between both files as
cases are added, modified, or deleted.
When CSPro opens a data file, it looks for the corresponding index file. If it does not find one, CSPro automatically generates
a new one. If you suspect, for any reason, that the index file has been corrupted, or does not match the data file, simply
delete the index file and let CSPro generate a new one.
An index is only created for text files. Prior to CSPro 7.0, the data file index had the extension .idx.
Each record in the log file represents one data entry session. The record layout is as follows:
Position Contents
1-3 Mode (ADD, MOD, or VER)
4 comma
5 - 36 Operator ID (as entered)
37 comma
Pa ge 28 of 35 Files
38 - 47 Start date (mm/dd/yyyy)
48 comma
49 - 56 Start time (hh:mm:ss)
57 comma
58 - 65 End time (hh:mm:ss)
66 comma
67 - 74 Total time (End time - Start time) (seconds)
75 comma
76 - 83 Pause time (seconds)
84 comma
85 - 92 Number of cases written
93 comma
94 - 101 Number of records written
102 comma
103 - 110 Number of keystrokes
111 comma
112 - 119 Number of bad keystrokes
120 comma
121 - 128 Number of fields with errors attributed to keyer
129 comma
130 - 137 Number of fields with errors attributed to verifyer
138 comma
139 - 146 Total number of fields verified
Listing File
The listing file contains information about how an application was run and contains the results of the program's operations.
It gives the following information:
The listing file associated with a batch edit application is often the primary output of the application. For most other
applications and tools, the listing file is a secondary output. For data entry applications, this file can be useful for monitoring
the work of keyers in training and identifying problem keyers.
Pa ge 29 of 35 Files
Using any extension not in the table above will result in a text listing file.
The Excel, CSV (comma-separated values), and CSPro Data listing files can only be used with applications that contain an
input dictionary so they are not suitable for some tabulation applications.
Whereas the text and HTML listing files display keys of cases that had errors in text format, the Excel, CSV, and CSPro Data
listing files output these keys as separate columns/items (e.g., "0901" vs. PROVINCE: 9 / DISTRICT: 1).
Error messages that occur outside of a case (for example during the application procedure) are written to all listing file
formats except for CSPro Data, which only contains information about case-related errors. When using the CSPro Data listing
file, a dictionary that describes the data file will be output using the name of the listing file with the added extension .dcf.
A data entry application's listing file is appended to any existing listing file, whereas listing files for batch and tabulation
applications are created from scratch for the program's run. Excel listing files do not support append mode so they may not
be a suitable format for data entry applications.
Note text can contain "\n" characters, which indicate a newline (Enter key) character. If the note text is automatically
wrapped in the note text box, there will be no newline characters.
The .csnot file can be processed by another CSPro application by creating a data dictionary for it. You can use the Dictionary
Macros function to automatically create this dictionary.
Notes can be created, edited, and deleted using the getnote, putnote, and editnote functions.
Notes for non-text files (such as CSPro DB files) are stored within the file itself and not in a .csnot file. Prior to CSPro 7.0, the
notes file had the extension .not.
Pa ge 30 of 35 Files
Show which cases in the data file are partially entered.
Restart partially entered cases at the last field location entered.
Show the number and percent of verified cases in the operator statistics.
The .sts file is a text file and you can view this file in Text Viewer.
If necessary, you can modify this file in a text editor. However, you should manipulate this file with extreme caution. If you
modify it incorrectly, you can lose information about partially entered cases or which cases have been verified.
Status information for non-text files (such as CSPro DB files) is stored within the file itself and not in a .sts file.
Pa ge 31 of 35 Files
Summaries
Menu Summary
The following is a summary of the Text Viewer menus:
File
Open Application Open a new data entry application.
Open Data File Open a new file for data entry in the current application.
Save Partial Case Partially save the current case and continue entry.
Synchronize Synchronize the data with a remote server.
Mode
Add Case Switch to add mode.
Modify Case Switch to modify mode.
Verify Case Switch to verify mode.
Pause Pause data entry (stops statistics clock).
Stop Stop data entry in current mode.
Edit
Insert Case Insert new case.
Delete Case Delete selected case.
Find Case Find case with particular identifier.
Insert Level Occ Insert a new level before the current level.
Add Level Occ Add a new level at the end of this level.
Delete Level Occ Delete the selected level within a case.
Insert Group Occ Insert a new occurrence before this occurrence.
Insert Group Occ After Insert a new occurrence after this occurrence.
Delete Group Occ Delete this occurrence.
Sort Group Occ Sort occurrences based on values of this field.
Edit Field Note Add, modify, or delete field note.
Edit Case Note Add, modify, or delete a case note.
Interactive Edit Search cases for range and/or edit errors (in modify mode).
Navigation
Previous Screen Skip to previous screen.
Next Screen Advance to next screen.
First Case Go to first case in tree order.
Previous Case Go to previous case in tree order.
Next Case Go to next case in tree order
Last Case Go to last case in tree order.
End Group Occurrence Skip to next occurrence of this group of fields.
End Group Skip to next field after this group of fields.
End Level Occurrence Skip to next occurrence of this level.
End Level Skip to next level after this level.
Pa ge 32 of 35 Summa ries
Advance to End Advance to the furthest point reached.
Go To Go to a particular field in the current case.
Previous Persistent Go to previous persistent field.
View
Full Screen Hide the trees and show full screen view.
Show Case Labels Show case labels (if they exist) rather than case IDs in the file tree.
Cases in Sort Order Show cases in file tree in sort order rather than physical order.
View Partial Cases Only Show only partial cases in file tree.
Case Tree Toggles the case tree on and off.
Names in Case Tree Show names in case tree.
Show Refusal Options Shows any refused values defined in the current field's value set.
Show Values (verify) Show all data values (in verify mode).
Operator Statistics Show operator statistics data file.
Options
Interactive Edit Options Change search options for interactive edit.
Change Language Change current language of the CAPI question text.
Show Responses (This Field) Show or hide response box for this field.
Show Responses (All Fields) Show or hide response box for this and all other fields.
Help
Help Topics Get help on current application.
About Data Entry Get information about the software.
Toolbar Summary
The CSEntry toolbar is displayed across the top of the window, below the menu bar. It provides quick mouse access to many
features used in Sort Data. Click to:
Keys Summary
Shortcuts specific to CSEntry
Ctrl+Home Move to the first case in the file (in modify mode).
Ctrl+PgUp Move to the previous case in the file (in modify mode).
Ctrl+PgDn Move to the next case in the file (in modify mode).
Ctrl+End Move to the last case in the file (in modify mode).
Pa ge 35 of 35 Summa ries