{"id":13366,"date":"2019-11-14T16:45:36","date_gmt":"2019-11-14T21:45:36","guid":{"rendered":"http:\/\/www.iri.com\/blog\/?p=13366"},"modified":"2019-11-20T14:07:18","modified_gmt":"2019-11-20T19:07:18","slug":"data-class-validator-workbench","status":"publish","type":"post","link":"https:\/\/beta.iri.com\/blog\/iri\/iri-workbench\/data-class-validator-workbench\/","title":{"rendered":"How to Create a Custom Data Class Validator"},"content":{"rendered":"

This is the second of a two-part blog series detailing data class validation in <\/span><\/i>IRI Workbench<\/span><\/i><\/a>. The first article, <\/span><\/i>here<\/span><\/i><\/a>, provided an overview of the validation scripts and how to use them in a data discovery or classification job. This article shows how to create a custom validation script for a special data class or group.\u00a0<\/span><\/i><\/p>\n

In this article, we will create and format a credit card validation script for use in a custom data class. It should be noted that IRI Workbench already provides a credit card data class and validation script for your convenience.\u00a0<\/span><\/p>\n

As a prerequisite, you should probably be familiar with ES5 Javascript and Java 8. To follow along, you will need an IDE or text editor that supports Javascript 5 (ES5) and Java 8.\u00a0<\/span><\/p>\n

I will be using <\/span>Visual Studio Code<\/span><\/a>, an open source IDE from Microsoft for this section of the tutorial. Although I won’t be going into detail on how to setup Visual Studio Code, you can find more information about the setup process <\/span>here<\/span><\/a> and <\/span>here<\/span><\/a>.\u00a0\u00a0<\/span><\/p>\n

How does IRI Workbench interpret and use the code?<\/b><\/h4>\n

Before we get into the tutorial, it might be helpful to give a brief overview on how our platform interprets a validation script. When a Javascript file is uploaded into a custom data class, the IRI Workbench will attempt to run the code through the use of the Java <\/span>ScriptingEngine API<\/span><\/a>.\u00a0<\/span><\/p>\n

The ScriptingEngine will then make the Javascript file implement a validation interface that contains a method called <\/span>validate. <\/span><\/i>An example of the validation interface can be seen in the below image (written in Java):\u00a0<\/span><\/p>\n

\"\"<\/a><\/p>\n

This will search the Javascript file for a function of the same name and make it executable in Java. For your convenience, the below image displays sample Java code calling and executing a method contained in the validation script.<\/span><\/p>\n

\"\"<\/a><\/p>\n

Limitations of the Java ScriptingEngine API<\/b><\/h4>\n

The Java Scripting Engine API utilizes the <\/span>Nashorn engine<\/span><\/a>\u00a0for interpreting Javascript code. With this there are a few notable limitations to keep in mind when creating your script:<\/span><\/p>\n