LCA Handler

You can create an LCA Handler.

Life Cycle Action Handler

In order to create a Life Cycle Action handler, you need to create a Java class implementing the ILifeCycleAction interface and then assemble this implementation into a JAR file that is deployed to Amazon S3 storage. Because the ILifeCycleAction interface contains many methods, you can implement only some of them by using the base implementation LifeCycleActionBase.

Every hook method receives two arguments:

  • An instance of the IReltioAPI (for sending REST requests to API)
  • One of the implementations of ILifeCycleData (for processing data)

Action implementation takes the changes to the passed object (add/remove/change attributes/crosswalks, and so on) and returns the changed content to the Reltio API, where the changes are applied.

An implementation may set the success property of the returned object to false. In such a case the processing of an appropriate object on the Reltio API side is terminated.

Dependency

In settings.xml, specify the user credentials:

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <servers>
        <server>
            <id>reltio-libs-public</id>
            <username>read.only.life-cycle-framework</username>
            <password>xxxxxxxxxxxx</password>
        </server>       
    </servers>
</settings>

In order to get the Life Cycle Framework library, you need to add the following Maven dependency:

<dependency>
    <groupId>com.reltio</groupId>
    <artifactId>life-cycle-framework</artifactId>
    <version>2016.2.2.0.0</version>
</dependency>

This library contains all necessary interfaces for creating custom Life Cycle Actions.

Important: Ensure that you use the latest version of the life-cycle-framework, otherwise you may face unexpected errors in the Reltio Platform while loading data.

Also, get the dependency from the Reltio private repository as shown below.

<repository>
    <id>reltio-libs-release</id>
    <name>Reltio release repository</name>
    <url>http://repo.dev.reltio.com/content/repositories/releases</url>
</repository>

Life Cycle Action Handler Testing

Use the provided test framework to test Life Cycle Action handlers. This framework enables you to write tests for Life Cycle Action handler by passing the input JSON data and checking the output JSON.