New tutorial on validator integration

A new guide is available on using a validator via its SOAP API

Published on: 28/01/2021

The Test Bed has published a new step-by-step guide on how to integrate a validator in a custom Java application via its SOAP API.

Test Bed logo

The Test Bed’s two main service offerings are conformance testing through the GITB Test Bed platform and content validation through reusable validators. The validators in particular are reusable components that can serve as standalone services or as building blocks to be used in conformance test cases, validating content received via message exchanges with tested systems. Validators can be developed from scratch as fully custom services, or extend the Test Bed’s base validator images that allow validation of specifications based on popular syntaxes via simple configuration. Such advanced support is currently available for specifications based on XML, RDF, JSON and CSV syntaxes.

The common point for all validators is their implementation of the GITB validation service API, a web service API based on SOAP, that defines a validator’s basic operations, inputs, and outputs. This common API allows any validator to be seamlessly integrated in conformance test cases through the GITB Test Bed platform, but also offers the possibility for custom integrations with other software. Such custom integrations allow validators to be used in various scenarios, ranging from quality control of data ingestion workflows to content validation as part of a system’s production operation.

Validation service operations

To facilitate such custom integrations, the Test Bed team has published a new tutorial that explains how to use a validator from a Java application. The included samples and explanations cover various scenarios, highlighting the resources that are available to get started, and the steps needed to prepare inputs, call the validator and process its resulting report. The sample code represents a starting point that could be used in any Java application, be it a simple client or full web application.

Validator integration tutorial screenshot

The new SOAP integration guide is published as part of the Test Bed’s online guides and is accessible here. To complement this, a sample integration project, the one built-up through the tutorial’s steps, is also shared on GitHub.

Be sure to check out this latest tutorial if you are considering using a validator in your own software. For details on how to set up a new validator you can refer to the detailed XML, RDF, JSON or CSV guides, or to the validation service developer guide for a new custom implementation. Details on the Test Bed itself can be found in its Joinup space with its value proposition being a good starting point for newcomers. Finally, to remain updated of all the latest Test Bed news:

  • Join the Test Bed’s community and subscribe to its news feed using your favourite RSS reader, or by managing your email notifications.
  • Follow ISA²'s social media channels (Twitter, LinkedIn) for updates on the Test Bed and other interoperability solutions.

Referenced solution