enketo-validate

Enketo Validate

Validate ODK XForms using Enketo's form engine

This app can be used:

1. via the command-line, e.g. in a non-javascript form builder such as pyxform.
2. as a nodeJS module to be used in your own javascript application

Live demo web application (meant for testing purposes only) that uses Enketo Validate (and ODK Validate) as a module: validate.enketo.org (source code)

Via Command-line

Command-line Install

1. install nodeJS 6+
2. install build tools for native modules with apt-get install build-essential
3. clone repo
4. npm install --production

Command-line Use

$ ./validate test/xform/xpath-fails.xml

Command-line Help

$ ./validate --help

Command-line update

1. git pull && npm install --production

As NodeJS module

Module installation

npm install enketo-validate --save

Module Use

const validator = require('enketo-validate');

// read the xform as string

let result = validator.validate( xformStr, options );

// The result has the following format:
// {
//      warnings: [ 'a warning', 'another warning'],
//      errors: ['an error', 'another error']
// }
// if errors.length is 0, the form passed validation

How it works

In it's current iteration, the validator does the following:

• It checks whether the XForm is a valid XML document.
• It performs some basic ODK XForm structure checks.
• It checks if each bind nodeset exists in the primary instance.
• It checks for each <bind> whether the relevant, constraint, calculate, and required expressions are supported and valid* XPath.

* Note, that /path/to/nonexisting/node is perfectly valid XPath.

Funding

The development of this application was funded by OpenClinica.

License

See the license document for this application's license.

Change log

See change log