Neighbourhood Party Manager

    enketo-validate

    1.14.1 • Public • Published

    npm version Build Status Dependency Status devDependency Status

    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)

    Technical Documentation

    Prerequisites

    1. install nodeJS 12, 14 or 16
    2. if npm is not version 6, downgrade with npm i -g npm@6
    3. (if necessary) install build tools for native modules with apt-get install build-essential
    4. (if necessary) install puppeteer (headless Chrome) prerequisites as mentioned here, e.g. for Ubuntu/Debian do apt-get install ca-certificates fonts-liberation libappindicator3-1 libasound2 libatk-bridge2.0-0 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgbm1 libgcc1 libglib2.0-0 libgtk-3-0 libnspr4 libnss3 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 lsb-release wget xdg-utils

    Via Command-line

    Command-line Install

    To make the enketo-validate command available from any folder on your machine.

    $ npm install -g --production enketo-validate

    Alternatively, you can clone the repo and run npm install --production. This will make the ./validate command available from within the clone folder. Running npm link makes the enketo-validate command available from any folder on your machine.

    Command-line Use

    $ enketo-validate path/to/form.xml

    Errors are returned to stderr and warnings to stdout. If there is no stderr output the form is valid.

    Command-line Help

    $ enketo-validate --help

    Command-line update

    1. npm install -g --production enketo-validate

    As NodeJS module

    Module installation

    npm install enketo-validate --save

    Module Use

    const validator = require('enketo-validate');
    
    // Options:
    // debug: [boolean] outputs unadulterated errors instead of cleaned ones
    // openclinica: [boolean] runs the validator in a special OpenClinica mode
    const options = {};
    
    // Read the xform as string
    const result = validator.validate( xformStr, options );
    
    // The result has the following format:
    // {
    //      warnings: [ 'a warning', 'another warning'],
    //      errors: ['an error', 'another error'],
    //      version: "0.0.0"
    // }
    // if errors.length is 0, the form passed validation

    Develop

    1. Clone repo and install prerequisites.
    2. Run npm install. If there is an error the first thing to do is to run rm -R node_modules and retry especially after changing Node versions or after earlier crashes during installation.
    3. Run via command line, e.g. ./validate test/xform/xpath-fails.xml or ./validate --help.

    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 elementary ODK XForm structure checks.
    • It checks if each bind nodeset exists in the primary instance.
    • It checks if appearance values are supported or deprecated for that type of question.
    • It checks for each <bind> whether the relevant, constraint, calculate, and required expressions are supported and valid* XPath.
    • It checks whether required <label> elements exist.
    • It checks for duplicate question or group names.
    • It checks for nested repeats.
    • It checks for form controls that have a calculation but is not set as readonly.

    * Note, that /path/to/a/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

    Install

    npm i enketo-validate

    DownloadsWeekly Downloads

    113

    Version

    1.14.1

    License

    Apache-2.0

    Unpacked Size

    4.04 MB

    Total Files

    101

    Last publish

    Collaborators

    • martijnr