Administration GUI

The Administration GUI of the Compliance Checker allows the users with administrator account to execute the followings:

  • Update the legislations taken into account during the checking processes of the application.

  • Monitoring the services

  • Checking the available categories and creating / editing user defined levels

Login

Administration GUI is available after login as administrator on the web GUI of Compliance Checker and clicking on the Administration button in the upper right corner.

images/download/attachments/49836181/adminstart.png

Update legislations

When the Knowledge Base version is not up to date then both the user and the admin gets a warning:

images/download/attachments/49836181/warning2updateDB.png

Admins can update the legislations from the Administration page by clicking the Update legislations images/download/attachments/49836181/updateicon.png button.
Actual legislations are covered by a rule set and an exclusion set which are sets of special chemical query structures confirming the actually valid relevant legal rules.
The scope of the legal relevancy depends on the scope of the Compliance Checker license you have.

Two ways are provided for the update:

Manual DB update

You can execute the update by selecting the necessary jar file containing the rule set and the exclusion set, and clicking on Update to selected file button.

Automatic DB update

Or the Knowledge Base can be auto-updated by clicking on the Download and update to the latest version button.

images/download/attachments/49836181/dbinfo2.png

Service monitor

Click images/download/attachments/49836181/serviceicon.png to open the Service monitor page where you can check the actual status of the running services of Compliance Checker.

Three types of services can be monitored here:

  • cc-backend

  • cc-bigdata

  • cc-web

images/download/attachments/49836181/service_monitor.png

Category monitor

Click images/download/attachments/49836181/categoryicon.png to open the Category monitor page.

This page lists the Available categories in three groups:

  • Countries

  • Groups and associations

  • User defined levels

These Countries and User defined levels will be displayed on the Compliance Checker User Interface in the 'Regulation categories' section as 'Available countries' and as 'Available check levels'.

images/download/attachments/49836181/categorymonitor.png

Browse the available levels

Countries

The displayed Countries are in accordance with your license file.

Here you can check which legislations are included in the individual countries.

You can clone the available countries and the created clone will be a new User defined level.

Editing or deleting is not available.

Groups and associations

The displayed Groups and associations are in accordance with your license file.

Here you can check which legislations are included in the individual groups and associations.

You can clone the available groups and associations. The created clone will be a new User defined level.

Editing or deleting is not available.

User defined levels

User defined levels can be created, edited and deleted as well.

Create: creates a new level, named and defined by the admin.

Edit: opens the Edit level page displaying the actual composition of the selected User defined level and makes possible to make changes.

Delete: deletes the selected User defined level.

Create new Level

The Create new level button on the page showing the Available categories opens the Create new Level page.
To narrow the search in the Available rules you can use the Countries & Groups drop-down and/or the Quick search field.

images/download/attachments/49836181/leveleditorcreate.png

Name: enter the name of the new level

ID: unique identifier

Available rules: By default, all the rules are listed here. Two filters are provided to help to select the needed rules for the new level. The set values of these two filters are combined and taken into account with AND logic.

Countries & Groups: one country or group or association can be selected

Quick Search: text filtering is available here

Select all: moves all pre-filtered rules to the right side Selected rules panel

Selected rules: lists the already selected rules

Clear: moves all selected rules back to the left side Available rules panel

Save: saves the new level

Cancel: cancels the creation of the new level

Edit Level

When you click on one of the User defined levels you can check which legislations are included in this definition.

images/download/attachments/49836181/leveleditoreditdelete.png

There are 3 available options: Close, Edit and Delete this level.

Close: Closes this level's drop-down

Edit: Opens the Edit level page displaying the actual composition of the selected User defined level and makes possible to make changes in the selected rules.

After the changes you have to click on the Save button to save these changes. Clicking on the Cancel button or opening another page results in to discarding the changes.

images/download/attachments/49836181/leveleditoredit.png

Delete

To delete the selected User defined level. This has a confirmation pop-up:

images/download/attachments/49836181/leveleditordelete.png

Database update history

Selecting the images/download/attachments/49836181/dbupdatehistorybutton.png Database update history button on the left navigation bar the updates can be searched. The following filters are available to narrow the search:

Legislation code (from-to numbers)

Update date (from-to dates)

Substance ID (from-to numbers)

Legislation name (free text search)

Update type (ADD/UPDATE/DELETE drop-down)

images/download/attachments/49836181/dbupdatehistory.png

Integration API

To check molecules listed in a file against regulations, the Compliance Checker API was developed with three endpoints:

1. <host>/cc-bigdata/filecheck/upload

This is a POST method. It uploads a file containing molecules and creates a job which executes the checks for each structure.
It has four parameters:

- file (mandatory): The file that contains the molecules to be checked.
- categories: Array of category ids which defines the regulations. Leaving it empty results in checking against all regulations.
- date: Should be set in case molecules need to be checked against past regulations. Expected date format is 'yyyyMMdd'. Leaving it empty is the same as setting today's date.
- description (optional): Short description can be provided for the input.

The output elements of the response:

- jobId: The identifier of the job created to process the input file.
- url: The url where the information of the generated job can be requested from.
- description: Constant description message 'Use this ID or the URL to access your job status and information'.

2. - <host>/cc-bigdata/filecheck/job/{id}

This is a POST method. It submits a report generation request for a given job.
It has five parameters:

- id: The id of the job to generate the report for.
- containsErrors: Defines whether the report should contain unsuccessful checks (true/false).
- containsHits: Defines whether the report should contain regulated molecules (true/false).
- containsPasses: Defines whether the report should contain not regulated molecules (true/false).
- formats: Array of requested report formats. Accepted values: PDF, HTML, SDF, MRV, XLSX, JSON.

3. <host>/cc-bigdata/filecheck/job/{id}

This is a GET method. Returns status information about the given job.
It has one parameter:

- id: The id of the job which we would like to get the status information of.

The output elements of the response:

- status: Status of the job. Possible values: FINISHED, PENDING, FAILED, IN_PROGRESS.
- percentage: Percentage of checked molecules.
- inputSize: Number of all molecules.
- hitCount: Number of regulated molecules.
- errorCount: Number of unsuccessful checks.
- passedCount: Number of not regulated molecules.
- reports: An array of reports generated for the given job.

reports has five fields:

- format: Format of the report. Possible values: PDF, HTML, SDF, MRV, XLSX, JSON.
- reportContent: The content of the report that has been selected before generation.
Possible values: 'full', 'hit only', 'certificate only', 'error only', 'result only', 'error and hit', 'error and passed', 'summary only'
- generated: Timestamp of the report generation.
- state: Status of the report. Possible values: FINISHED, PENDING, FAILED, IN_PROGRESS.
- url: Url of the report where it can be downloaded from.

To invoke these endpoints admin privileges are needed.

A Swagger UI for these endpoints is also available at <host>/cc-bigdata/file-api.