Revalidation Task to Evaluate Data Validation Functions

The revalidate task creates a periodic task, which is scheduled and runs in the background to evaluate the entity data against data validation function(s).

This task triggers validation on all the entities for which the Reltio/DVFAction LCA is configured.
Note: The revalidate task triggers validation on the existing data of the tenant and also on the newly loaded data. After defining the validation functions for the newly loaded data, the revalidate task must be triggered to evaluate the validation functions.

The table below lists the details of the scenarios when the revalidation task API is executed.

Table 1. Scenarios to Use the Revalidation Task
Scenario API Details
Executed for all data wherein data validation function is configured API URL: POST {{api_uri}}/{{tenant}}/revalidate
Executed for the specific entity type API URL: POST {{api_uri}}/{{tenant}}/revalidate?entityType=HCP
Executed only for specific entries API URL: POST {{api_uri}}/{{tenant}}/revalidate?entityType=HCP
Request Body
Executed with other advanced parameters The following additional parameters are used for this scenario:
  • distributed=true - The default value is false.
  • taskPartsCount=3 - The default value is 2.

Getting the Task status

This Get Task Status API retrieves the revalidation task status.

Request - GET {{api_uri}}/reltio/tasks/{{task_id}}

Sample Response
    "id": "720abb4f-0a2a-445c-aee0-65e54e7cdf93",
    "groupId": "bf41757d-3aad-47c2-a293-52dd916cd569",
    "createdTime": 1592073359997,
    "createdBy": "",
    "updatedTime": 1592073359997,
    "updatedBy": "",
    "type": "com.reltio.businesslogic.tasks.revalidate.ReValidateDataTask",
    "status": "COMPLETED",
    "name": "Re-Validation of 1 entities in tenant dvftest background task. (started by",
    "createdOnHost": "dataload-6875846b9-c56k4",
    "executedOnHost": "dataload-6875846b9-c56k4",
    "parallelExecution": false,
    "nodesGroup": "default",
    "startTime": 1592073361142,
    "endTime": 1592073379229,
    "parameters": {
        "tenantId": "dvftest",
        "entityType": "all types",
        "updatedSince": "0",
        "uriList": "[\n    \"entities/1J3RQtzT\"\n]"
    "currentState": {
        "numberOfSkippedObjectsWithError": 0,
        "lastExecutionEC2Instances": "i-0651e18c7d0800caa",
        "numberOfDVFFailureObjects": 1,
        "numberOfFailedToPublishEvents": 0,
        "lastHourThroughput": 0.0,
        "numberOfProcessedObjects": 1,
        "status": "Completed"
    "throughput": 0.055555556,
    "duration": "18s"