KoSIT Validator

• Introduction
• Validation Configurations
  • Third Party Validation Configurations
• Usage
  • Standalone Command-Line Interface
  • Application User Interface (API / embedded usage)
  • Daemon-Mode
• Packages

Introduction

The validator is an XML validation engine to validate and process XML files in various formats. It basically does the following in order:

1. identify actual xml format
2. validate the xml file (using schema and schematron rules)
3. generate a custom report / extract custom data from the xml file
4. compute an acceptance status (according the supplied schema and rules)

The validator depends on self definedscenarioswhich are used to fully configure the process. It always creates avalidation report in XML.The actual content of this is controlled by the scenario.

Seearchitecturefor information about the actual validation process.

Validation configurations

The validator is just an engine and does not know anything about XML documents and has no own validation rules. Validation rules and details are defined invalidation scenarioswhich are used to fully configure the validation process. All configurations are self-contained modules which are deployed and developed on their own.

Third party validation configurations

Currently, there are two public third party validation configurations available.

• Validation Configuration forXRechnung:
  • Source code is available onGitHub
  • Releasescan also be downloaded
• Validation Configuration forXGewerbeanzeige
  • Source code is available onGitHub
  • Releasescan also be downloaded

Usage

The validator can be used in three different ways:

• as standalone application running from the cli
• as library embedded within a custom application
• as a daemon providing a http interface

Standalone Command-Line Interface

The general way using the CLI is:

java -jar validationtool-<version>-standalone.jar -s<scenario-config-file>[OPTIONS] [FILE] [FILE] [FILE]...

The help option displays further CLI options to customize the process:

java -jar validationtool-<version>-standalone.jar --help

A concrete example with a specific validator configuration can be found on GitHub

TheCLI documentationshows further configuration options.

Application User Interface (API / embedded usage)

The validator can also be used in own Java Applications via the API. An example use of the API as follows:

Pathscenarios=Paths.get("scenarios.xml");
Configurationconfig=Configuration.load(scenarios.toUri());
Inputdocument=InputFactory.read(testDocument);

Checkvalidator=newDefaultCheck(config);
ResultvalidationResult=validator.checkInput(document);

// examine the result here

TheAPI documentationshows further configuration options.

Note:With Java 11+, you need to include a dependency toorg.glassfish.jaxb:jaxb-runtimein your project explicitly, as that dependency is markedoptionalin this project and will thus not be resolved transitively.

Daemon-Mode

You can also start the validator as a HTTP-Server. Just start it inDaemon-Modewith the-Doption.

java -jar validationtool-<version>-standalone.jar -s<scenario-config-file>-D

Thedaemon documentationshows more usage details and further configuration options.

Packages

The validator distribution contains the following artifacts:

1. validationtool-<version>.jar:Java library for embedded use within an application
2. validationtool-<version>-standalone.jar:Uber-JAR for standalone usage containing all dependencies in one jar file. This file comes with JAXBembeddedand can be used with Java 8 and Java >= 11)
3. validationtool-<version>-java8-standalone.jar:Uber-JAR for standalone usage with Java JDK 8 containing all dependencies in one jar file. This file filedoes notcontain JAXB and depends on the bundled version of the JDK.
4. libs/*: directory containing all (incl. optional) dependencies of the validator