Downloads / XML Validator Tool
DataShop can import XML files of transaction data which conform to the logging standard. While the import process can only be done by DataShop developers, you should first run this tool against your XML files to verify that they are valid XML and comform to the DTD.This tool will validate all files within the provided directory against the schema specified within each file. It will also perform custom validation pertinent to DataShop processing expectations.
DataShop can process multiple XML files for inclusion in a single dataset. When receiving XML data, we prefer many smaller files as opposed to a few large files.
Download the XML Validator Tool
DS_xv.zip (1.6 MB)
Requires the Java Runtime Environment (JRE) version 1.6 or greater
Note: Java must be installed and available from the
command line. To check this, open a command prompt (Windows: Start >
cmd or Mac: Applications > Utilities >
Terminal) and type:
java -version If you see
something like the following, continue to with step 1 below. If you don't, make sure you
have Java installed (see Do I have Java? on
java version "1.6.0_11" Java(TM) SE Runtime Environment (build 1.6.0_11-b03) Java HotSpot(TM) Client VM (build 11.0-b16, mixed mode, sharing)
To validate your XML files:
- Download the ZIP file above and extract its contents to your hard disk.
- Open a command prompt and navigate to the XML Validator tool directory, which should contain both "dist" and "extlib" directories.
- Enter the following on a single line:
java -Xmx512m -classpath "dist\datashop-xv.jar;extlib\jdom.jar; extlib\jdom-contrib.jar;extlib\log4j-1.2.13.jar;extlib\xercesImpl.jar;extlib\commons-lang-2.2.jar;." edu.cmu.pslc.datashop.xml.validator.XMLValidator -inputDir path\to\files_to_validate
java -Xmx512m -classpath "dist/datashop-xv.jar:extlib/jdom.jar: extlib/jdom-contrib.jar:extlib/log4j-1.2.13.jar:extlib/xercesImpl.jar:extlib\commons-lang-2.2.jar:." edu.cmu.pslc.datashop.xml.validator.XMLValidator -inputDir path/to/files_to_validatewhere
path/to/files_to_validateis the path to the directory of XML files to validate.
The XML Validator will run and provide information about the validity of the XML files. Results from the verification are printed to the console and to an output text file called datashop-verify.log.
For more information about what constitutes 'validity', see the guide to the tutor message format.
||The path of the input directory (required).|
||Run the tool in verbose mode (additional logging).|
||Display help and exit.|
||Display version information and exit.|
To get version information for the XML Validator Tool, run the following command on a single line:
java -classpath "dist\datashop-xv.jar;extlib\log4j-1.2.13.jar;." edu.cmu.pslc.datashop.util.VersionInformation
java -classpath "dist/datashop-xv.jar:extlib/log4j-1.2.13.jar:." edu.cmu.pslc.datashop.util.VersionInformation