Revision 3.4.2 Update
This release of DASH adds additional functionality to bring DASH
up to a full CATI/Web capable implementation. DASH 2 is included to
allow dual operation and an easy transition to the new DASH.
The included DASH 2 has additional functionality not available in
DASH 2.9. It is also fully compatible with DASH 2.9.
New Functionality
-
A new licence is required to run version 3.4.2.
-
A browser based graphical form editor is now available.
-
New Tcl commands have been added.
- fieldGetOrder
- fieldSetListDynamic
- fieldSetListStatic
- fieldSetOrder
- formGetScript
- formGetStyle
- fieldGetListDynamic
- fieldGetListStatic
- getUserFormat
- insertFile
- listMentions
- recallLabel
- setEqual
- setFromText
- setGuessText
- setLength
- setMentions
- setSort
- setSubset
- userIsTimeout
-
Quota cutoff control has been redesigned and is now managed in the
form by Tcl commands.
The parameter "quotaCutoff" has been removed from scheduler control.
- quotaComplete
- quotaGet
- quotaGetAll
- quotaGetCompletes
- quotaIsFilled
- quotaIsFilledField
- quotaSet
-
A stand-alone supervisor login is now available from a Mozilla or
Firefox browser.
-
A stand-alone web interviewer login is now available from any browser.
-
Monitoring of data entry terminal clients by the supervisor is now
available. The monitor window will automatically display a terminal
or browser client depending on what device the interviewer is using.
-
The supervisor interface now includes a View menu option with direct
access to a list of Interviewers or Forms.
-
The supervisor interface now includes a Reports option on the Form
page which allows the supervisor to configure and run reports.
-
The supervisor interface now includes a Revise Form option on the Form
page which allows the supervisor to allocate another window for
accessing a specific case and start page for revise entry.
-
The terminal option now works on the Test Form menu. This option will
display a terminal window in the browser.
-
A command line tool "dashadmin" is provided to monitor and control
both new DASH and DASH 2 users. All DASH users may be
terminated and individual DASH 2 processes may be terminated with
automatic save of data.
Improvements
-
The administrator menu now eliminates the additional supervisor login
screen.
-
The administrator menu now requests a confirmation before writing
over an active manu in a panel.
-
The supervisor quota display now lists the quotas in the same order
that they are defined in the schedule xml file.
-
If an interviewer or web user times out, the post page and post case
commands are now executed. A flag is also set which may be queried
via a Tcl command "userIsTimeout".
-
Refuse, Don't Know and Note now work fully for all fields in both
the terminal and browser data entry clients.
-
Table variable bins may now have new types of "t" or "total" and
"label". A bin with no type and no <if> will continue to be
equivalent to type "total".
-
The table index now defaults to "row_variable_id by column_variable_id".
The table title no longer includes the fields.
-
The mail application only allowed the <http_link> marker to be placed
on a line by itself. The <http_link> marker may now be embedded
in text on a line.
-
The mail application now generates the short form URL format
/dash3/Dash?id=i,p,f,r as the default.
-
The randomPageInit and randomPageInitSync commands have added an
optional history store field which keeps track of the accessed pages
so that an interrupt in the middle of a random sequence can be
continued from the same point.
-
Marginal formatting has a number of new options
- indexInclude
- fieldZeroSuppress
- aFieldInclude
- textFieldInclude
- totalCountInclude
- totalPercentInclude
- countInclude
- countZeroSuppress
- countZeroText
- percentInclude
-
Marginals now output the count and percent columns right-justified by
default if no style is applied to these columns.
-
Data export no longer outputs data for "alias", "button", "link" or
"script" field types.
-
The ip address "spoof check" has been removed due to network address
translation usage which causes multiple client computers to appear to come
from the same address and also DHCP servers which allocate a new ip
address during a client session.
-
Rowgrids and colgrids (grids with type="rowgrid" or type="colgrid")
now work for all array field types (button fields, image fields,
output fields, link fields, and so on, that have "list" or "dynamic"
attributes specified).
-
Log files now output "Message repeated (n) times" (to save log file space).
-
Button fields with images (using the "uri" attribute) now store the X,Y
coordinates (within the image, relative to the upper left corner and
starting at 0,0) that the user clicked on.
-
Tomcat has been upgraded to version 5.0.28.
-
Xerces has been upgraded to version 2.6.2.
-
Xalan has been upgraded to version 2.6.0.
DASH 2 Enhancements
-
DASH 2 is now included with the distribution and runs under the
control of the new DASH licence server. This allows all new and old DASH
functions to be run under one user licence.
-
DASH 2 is enabled to work from the DASH browser menu and may
also be run stand-alone in a generic browser (Sun's Java plugin
is required).
The traditional terminal and DASH X interfaces work as expected.
-
The DASH 2 software may be duplicated on multiple machines and
run under control of a single licence server. To do this only the
environment variable LICENCE_HOST needs to be specified on additional
machines.
-
DASH 2 has a new menu page to allow export of data to SPSS in tab
delimited format. This avoids the 80 character card format cutoff
for open end field data.
-
The DASH data export function "Create Data File" which allows card
format output has been enhanced to allow the card number to be output
in a field of length up to 9 digits. The menu has an additional field
to specify the card number length. Any shell script using this menu
will have to be modified to take into account this additional field.
-
The process monitor now shows all processes for a user.
-
Target weighting now handles larger variables.
-
DASH 2 processes such as form edit and data entry may now be
terminated from the command line with no loss of data (dashadmin).
-
This version of DASH 2 includes Tcl/Tk 8.3.5 for embedded DASH use
to prevent incompatibilities with Tcl/Tk versions on various Linux
operating systems.
Bug fixes
-
A dependent quota now counts automatically when it's dependencies
count.
-
The <field> filter now works and also overrides the <page> filter.
If you have a list of pages and a list of fields, then only the
specified fields on the specified pages will be output.
Prior to this all fields on the specified pages would be output.
-
The web interview short form link "http:.../Dash?id=i,p,f,r" had "f"
and "r" reversed in the software. It is now set up correctly as documented.
-
Logins are not allowed by the server until the system has completed the
start up phase. This prevents a user hangup if the server is not ready.
-
Synchronization error in web interviewer servlet caused 2 users to be
denied access during heavy load.
-
Tabs in alphanumeric fields caused errors in reports and data export.
Tabs are now converted to spaces immediately after the user submits
their data.
-
Obsolete file references in the configuration files caused (harmless)
messages to be output in the Tomcat logs.
-
Supervisor menu reported "Floating point value to large to represent"
occasionally when showing web users.
-
Marginals did not show European characters properly.
-
Default language did not change when using commands to "insert" into it.
-
Fields with use="returnHref" were sometimes ignored during logout, and
so no return page would show up.
-
The "field" filter (for marginals and so on) did not function.
-
showFields and hideFields commands did not work for fields in a row grid or a
column grid (a grid with type="rowgrid" or type="colgrid").
-
insertChecks and insertUnchecks commands did not function properly.
-
The Tcl commands callbackDate and dateTime now produce the same
date/time format. Timezones may also be initially set via the callbackDate
command.
-
The DASH 2 error message file did not report errors correctly for
a few rare error conditions.
-
In DASH 2 data entry revise, if the page range selected for access
included a non-existent page then the error message
"The page number specified does not exist" would be repeated for every
case in the file until the end was reached. Now it returns to the
menu to allow immediate correction of the page range.
Limitations
-
DASH 3.4.2 will only run with Java Development Kit J2SE 5.0 JDK.
-
The unlicensed demo system now restricts data entry and data
processing to the first 50 cases in the file.
-
The form editor causes both Mozilla and Firefox on Windows to crash
after a limited number of operations are carried out. This does not
happen on Linux.
-
The form editor requires access to a dummy internet URI at this time.
If the server does not have internet access then some form editor
operations will be extremely slow as it waits for access.
-
If the form editor screen is lost then the only way to save the file
is to log out. This will force the open form to a backup file on disk
in directory /home/projects/unsaved/. The file will be named with a
date/time stamp.
-
If the form editor is used, it creates and updates a DASH "macroform"
not a "dashform". If any manual editing on the XML file is to be
done, it must be done on the macroform to remain compatible with the
editor. If manual editing is done the macroform may be converted
to a dashform for execution by the editor or the command line utility
"rundash MacroForm -formname xxx" where xxx is the DASH form name.
-
The form editor allows you to enter only one line between pieces of text.
In order to properly separate paragraphs and also get predictable results,
you should always hit enter twice.
-
When you hit Del or Backspace to delete a field in the formeditor
"Edit Page" screen, the field is deleted but the field list (top right
corner of the screen) is not updated to reflect the deleted field.
Refreshing the screen by re-visiting the page will update the field list.
-
Interviewer monitoring updates the screen only when a field is
complete and does not echo each character for open end fields.
-
To enable test, recode, revise and view in the terminal client
an administrator login is currently required.
-
Updating the scheduler may be used to add and modify parameters.
However parameters and definitions cannot be removed by an update.
-
The DASH 2 method of accessing form field values has been
removed from new DASH. For example "${name}" returned the field value
for a field named "name".
-
On Redhat systems if the default system language encoding, as defined in file
/etc/sysconfig/i18n, specifies UTF-8 encoding then accented characters
will not display correctly. The setting in the file should be
"en_US", "en_CA" or an encoding which is consistent with ISO-8859-1
encoding as specified in the DASH XML files.
-
A list must include a "default" language item if the list is to be
displayed in the default language (eg. in marginals).
If the list does not
include a "default" language then it can only be displayed in a
language included in the list.
-
The default configuration for Tomcat does not allow symbolic links from
the webapps applications to external image files. To allow forms to
access images place the images in webapps/ROOT/images and access them
with a URL of "/images/xxx.png". The Tomcat configuration may
be modified to allow symbolic links but this is a security concern.
-
Firefox 1.0 is not able to print the supervisor screen contents.
Firefox 1.0 is also unable to page forward with the PageDown key if
the cursor is in a text entry field.
-
For this release do not set <log> to false in the
"client request interface" of the startup file "data.xml".
Doing this causes menu requests to occasionally fail.
-
When running DASH 2 in a browser the utilities output screen will
report "Process not complete, Do you really want to exit?" when
pressing "Q" for quit even though all the ouput is on the screen.
By entering "PageDown" first the ouput will complete and then "Q"
will exit. This does not occur in a terminal window.