How to validate MDM data records against the master storage through the REST API

An MDM REST interface

POST
        /talendmdm/services/rest/data/{containerName}/validate

is available to allow you to validate data records against the master storage through the REST API.

Before saved to the master database, a data record has to go through a validation process, which involves checking the data record against the database schema, foreign key constraints, validation rules and the Before-Saving process (if any) defined in the entity that the data record pertains to.

For more information about the REST API, see Validate records in a container.

How to validate a data record through the REST API using a Job

Subscription

The following example shows how to use a Talend Job to validate a data record through the REST API and print out the response message accordingly.

The Job is composed of two components: tREST and tJavaRow:

tREST is used to send the HTTP request and get the response correspondingly.
tJavaRow is used to print out the response.

Retrieve the Job file tREST.zip from the Downloads tab in the left panel of this page.

Before you begin

The MDM server is up and running.
You have already launched Talend Studio.
You have already imported the MDM Demo Project.

Procedure

From the Palette, drop two components tREST and tJavaRow on the workspace.
Connect tREST to tJavaRow using a Row > Main link.
Double-click tREST to open its Basic settings tab.
In the URL field, enter the URL to access the MDM REST API service.
In this example, it is http://localhost:8180/talendmdm/services/rest/data/Product/validate.
From the HTTP Method list, select POST.

Click the [+] button to add two lines in the HTTP Headers area to describe the content type of the HTTP request and specify the authorization information.

In this example, provide the following name/value pairs:

name	value
"Content-Type"	"application/xml"
"Authorization"	"Basic YWRtaW5pc3RyYXRvcjphZG1pbmlzdHJhdG9y"

In the HTTP Body area, enter the data record you want to validate against the master storage in XML format.
In this example, the <root> element is used to enclose the data record.
Double-click tJavaRow to open its Basic settings tab.

In the Code area, enter your customized code.

For example:

System.out.println("\n##### An invalid record example #####\n");
System.out.println(restResponse_tREST_1);

Save and execute the Job.
Since no Accept header is specified, the response returns the JSON content. The response shows that the data record is not valid and gives a message about why the data record did not pass the validation.