Rule business object and data model

Business object

The rule file written in the Drools language uses a business object that contains all input and processed data values required for adjudication and decision-making. You can find this object in the message_wrapper column in Control Tower output for every request.

See sample business object in JSON

{
    "message": {
        "id": "5384557",
        "type": "PAYMENT_TRANSFER",
        "subtype": null,
        "content": null,
        "contentFormat": null,
        "payment": null,
        "customAttributes": null
    },
    "hits": [
        {
            "hit": {
                "id": "687139127",
                "tagContent": "rubber meets the road Mueller-Bode customer journey",
                "tagName": null,
                "tagType": "FREETEXT",
                "hitType": null,
                "hitStartIndex": null,
                "hitEndIndex": null,
                "hitText": null,
                "paymentInput": {
                    "id": null,
                    "type": null,
                    "subType": null,
                    "name": null,
                    "dob": null,
                    "address": null,
                    "locations": null,
                    "country": "",
                    "city": null,
                    "state": null,
                    "zip": null,
                    "codeMap": null
                },
                "derived": {
                    "id": null,
                    "idSource": null,
                    "name": "rubber meets the road",
                    "nameConfirmed": null,
                    "nameScore": 0.9959743469953537,
                    "nameSource": "NER",
                    "country": null,
                    "countryConfirmed": null,
                    "countrySource": null,
                    "address": null,
                    "addressConfirmed": null,
                    "addressSource": null,
                    "addressScore": 0.0,
                    "zip": null,
                    "zipConfirmed": null,
                    "zipSource": null,
                    "type": "NONENTITY",
                    "subType": null,
                    "typeConfirmed": null,
                    "typeSource": "NER"
                }
            },
            "wle": {
                "id": null,
                "name": "RUBBER AB Science S.A. ",
                "primaryName": "RUBBER AB Science S.A. ",
                "aliases": [],
                "address": "",
                "locations": [],
                "country": "PT",
                "city": null,
                "state": null,
                "zip": null,
                "type": "ORGANIZATION",
                "dob": "",
                "listType": "WORLD_COMPLIANCE",
                "source": "SANCTIONS",
                "sourceEntryId": null,
                "sourceKeywords": null,
                "codeMap": null,
                "customAttributes": null
            },
            "idMatch": {
                "match": null,
                "input": "",
                "inputProcessed": null,
                "wle": "",
                "wleProcessed": null,
                "source": null
            },
            "typeMatch": {
                "inputType": "NONENTITY",
                "wleType": "ORGANIZATION",
                "inputTypeConfidenceScore": 0.9959743469953537,
                "match": false,
                "input": "rubber meets the road",
                "inputProcessed": null,
                "wle": "RUBBER AB Science S.A. ",
                "wleProcessed": null,
                "source": "NER"
            },
            "nameMatch": {
                "score": 0.4643,
                "blackListed": false,
                "blackListedWordStr": "",
                "blacklistedSource": "NONE",
                "nameMatcherSource": "wf-name-matcher",
                "matchedWLEEntity": "WLE_NAME",
                "inputHasLegalEnding": false,
                "wleHasLegalEnding": true,
                "legalEndingsAreDifferent": false,
                "match": false,
                "input": "rubber meets the road",
                "inputProcessed": "rubber meets road",
                "wle": "RUBBER AB Science S.A. ",
                "wleProcessed": "rubber ab science",
                "source": "NER"
            },
            "countryMatch": {
                "blackListed": false,
                "blackListedStr": "",
                "blacklistedSource": "NONE",
                "match": null,
                "input": "",
                "inputProcessed": "",
                "wle": "PT",
                "wleProcessed": "PT",
                "source": "NER"
            },
            "addressMatch": {
                "matcherSource": "STRING",
                "comparisonOutput": null,
                "score": 0.0,
                "match": false,
                "input": null,
                "inputProcessed": null,
                "wle": null,
                "wleProcessed": null,
                "source": null
            },
            "dobMatch": {
                "match": null,
                "input": "",
                "inputProcessed": null,
                "wle": "",
                "wleProcessed": null,
                "source": null
            }
        }
    ]
}

Each section of the JSON is represented in the Drools file as factors or global objects and is used to formulate rules.

Data model for rule context

The following data model is available during rule evaluation.

Message

PaymentMessage message

Sample:

"message": {
    "id": "35166_resolve",
    "type": "PAYMENT_TRANSFER",
    "subtype": null,
    "content": null,
    "contentFormat": null,
    "payment": null,
    "customAttributes": null
  }

Object definition:

public class PaymentMessage {
    private String id;
    private MessageType type;
    private String subtype;
    private String content;
    private ContentFormat contentFormat;
    private PaymentInfo payment;
    private Map<String, String> customAttributes;
}

Field	Type	Always expected	Possible values
id	String	Yes	Message ID
type	Enum	No	SWF PAYMENT_TRANSFER ISO_20022
subtype	String	No	103
content	String	No	Original payment message or null
contentFormat	Enum	No	FUF NATIVE SWIFT_MT SWIFT_MX SWIFT_NPP SWIFT_ADK
payment	Object	No	Can be null
payment.direction	Enum	No	INCOMING OUTGOING
payment.sender	Object	No	Can be null
payment.sender.name	String	No	Sender name
payment.sender.type	EntityType Object	No	INDIVIDUAL ORGANIZATION NAME
payment.sender.bic	String	No	BIC ID
payment.sender.accountNumber	String	No	Sender's account
payment.sender.otherIdentifications	Map<String, String>	No	Map of other sender's ID (type or value)
payment.sender.address	String	No	Sender's address
payment.sender.country	String	No	Sender's country
payment.receiver	Object	No	Can be null
payment.receiver.name	String	No	Receiver's name
payment.receiver.type	EntityType Object	No	INDIVIDUAL ORGANIZATION NAME
payment.receiver.bic	String	No	BIC ID
payment.receiver.accountNumber	String	No	Receiver's account
payment.receiver.otherIdentifications	Map<String, String>	No	Map of other receiver's ID (type or value)
payment.receiver.address	String	No	Receiver's address
payment.receiver.country	String	No	Receiver's country
payment.amount	Double	No	For example, 200.25
payment.currency	String	No	For example, USD
customAttributes	Map<String, String>	No	Custom values that can be used in rules

Hit wrapper

A hit wrapper collects all hit information in one object:

public class HitWrapper {
    private PaymentMessageHit hit;
    private PaymentWatchListEntity wle;
    private IdMatch idMatch;
    private TypeMatch typeMatch;
    private NameMatch nameMatch;
    private CountryMatch countryMatch;
    private AddressMatch addressMatch;
    private DOBMatch dobMatch;
    private SecurityLookupData securityLookupData;
}

Hit

A hit is a complex object that contains:

• General hit information

• Input information: screened entity data

• Derived information: data received from Named Entity Recognition (NER) and LOOKUP

PaymentMessageHit hit

Sample:

"hit": {
    "id": "123",
    "tagContent": "/SE1350000000054910000011 \nWXYZSESS",
    "tagName": "50A",
    "tagType": "FREETEXT",
    "hitText": "Key",
    "hitStartIndex": null,
    "hitEndIndex": null,
    "paymentInput": {
      "type": null,
      "subType": null,
      "name": null,
      "dob": "01/01/2020",
      "address": null,
      "country": "Sweden",
      "city": null,
      "state": null,
      "zip": null,
      "codeMap": {
        "IBAN": "SE1350000000054910000011",
        "BIC": "WXYZSESS"
      }
    },
    "derived": {
      "id": "WXYZSESS",
      "idSource": "NER",
      "name": "Joe Doors",
      "nameConfirmed": null,
      "nameScore": null,
      "nameSource": "LOOKUP",
      "country": null,
      "countryConfirmed": null,
      "countrySource": null,
      "address": null,
      "addressConfirmed": null,
      "addressSource": null,
      "zip": null,
      "zipConfirmed": null,
      "zipSource": null,
      "type": "ID",
      "subType": "BIC",
      "typeConfirmed": null,
      "typeScore": null,
      "typeSource": null
    }
  }

Object definition:

public class PaymentMessageHit {
    private String id;
    private String tagContent;
    private String tagName;
    private TagType tagType;
    private String hitType;
    private Integer hitStartIndex;
    private Integer hitEndIndex;
    private String hitText;
    private PaymentInputEntity paymentInput;
    private PaymentDerivedData derived;
}

Field	Type	Always expected	Possible values
id	String	Yes	Unique hit ID
tagContent	String	Yes	Tag value
tagName	String	No	Tag name
tagType	Enum	Yes	NAME NAMEADDRESS ADDRESS FREETEXT
hitText	String	No	Can be null
hitStartIndex	Integer	No	Not used
hitEndIndex	Integer	No	Not used

Payment input object

A payment input object refers to screened input data (can be null).

Field	Type	Always expected	Possible values
paymentInput.id	String	No	Contains an ID value if the hit was on an ID.
paymentInput.type	Enum	No	INDIVIDUAL ORGANIZATION COUNTRY LOCATION VESSEL AIRCRAFT ID NAME
paymentInput.subType of ID	Enum	No	UUID IBAN BIC ISIN OTHER
paymentInput.name	String	No	Screened name
paymentInput.dob	String	No	Screened date of birth
paymentInput.address	String	No	Screened address
paymentInput.country	String	No	Screened country
paymentInput.city	String	No	Screened city
paymentInput.state	String	No	Screened state
paymentInput.zip	String	No	Screened postal code
paymentInput.codeMap	Map<String, String>	No	Map of collected IDs
paymentInput.locations	Object	No	Additional set of location data; can be null
paymentInput.locations.address	String	No	Address
paymentInput.locations.country	String	No	Country
paymentInput.locations.city	String	No	City
paymentInput.locations.state	String	No	State
paymentInput.locations.type	String	No	A free formatted value, for example, residence or business

Derived object

A derived object refers to data collected after processing.

Field	Type	Always expected	Possible values
derived.id	String	No	NER-detected value
derived.idSource	Enum	No	NER LOOKUP SCREENED
derived.name	String	No	NER-detected value
derived.nameConfirmed	String	No	Always false
derived.nameScore	Double	No	NER score for the name detected in free text
derived.nameSource	Enum	No	NER LOOKUP SCREENED
derived.country	String	No	Can come from parsing ID or lookup
derived.countryConfirmed	String	No	Set to true if lookup can confirm the country
derived.countrySource	Enum	No	NER LOOKUP SCREENED
derived.address	String	No	NER-detected value
derived.addressConfirmed	String	No	Set to true if lookup can confirm the address
derived.addressSource	Enum	No	NER LOOKUP SCREENED
derived.zip	String	No	Not used
derived.zipConfirmed	String	No	Always false
derived.zipSource	Enum	No	Not used
derived.type	Enum	Yes	INDIVIDUAL ORGANIZATION COUNTRY LOCATION VESSEL AIRCRAFT ID NAME NONENTITY ACCOUNT
derived.subType	String	No	UUID IBAN BIC ISIN OTHER
derived.typeConfirmed	String	No	Always false
derived.typeScore	Double	Yes	NER score for the detected type
derived.typeSource	Enum	Yes	NER LOOKUP SCREENED

WLE

A watchlist entity (WLE) refers to the sanctioned entity information.

PaymentWatchListEntity wle

Sample:

 "wle": {
        "id": null,
        "name": "Sanction Name Investment LLC",
        "primaryName": "CONSOLIDATED INVESTMENTS LLC",
        "aliases": null,
        "address": "6820 S. Harl Ave., Tempe, Ariz., 85283, U.S.",
        "locations": null,
        "country": "US",
        "city": null,
        "state": null,
        "zip": null,
        "type": "ORGANIZATION",
        "dob": null,
        "listType": null,
        "source": null,
        "sourceEntryId": "id_1",
        "sourceKeywords": null,
        "codeMap": null,
        "customAttributes": null
      },

Object definition:

public class PaymentWatchListEntity {
    private String id;
    private String name;
    private String primaryName;
    private List<AliasInfo> aliases;
    private String address;
    private List<Location> locations;
    private String country;
    private String city;
    private String state;
    private String zip;
    private EntityType type;
    private String dob;
    private String listType;
    private String source;
    private String sourceEntryId;
    private String sourceKeywords;
    private Map<String, String> codeMap;
    private Map<String, String> customAttributes;
}

Field	Type	Always expected	Possible values
id	String	Yes
type	EntityType Object	Yes	INDIVIDUAL ORGANIZATION COUNTRY LOCATION VESSEL AIRCRAFT ID NAME NONENTITY ACCOUNT
name	String	Yes	Sanctioned name or location
aliases	AliasInfo Object	No	AKA names
aliases.name	String	No	Alias name
aliases.type	Enum	No	STRONG WEAK NOT_AVAILABLE
address	String	No	WLE address
country	String	No	WLE country
city	String	No	WLE city
state	String	No	WLE state
zip	String	No	WLE postal code
dob	String	No	WLE date of birth
codeMap	Map<String, String>	No	WLE list of IDs
customAttributes	Map<String, String>	No	WLE list of custom values that can be used for adjudication
source	String	No	WLE sanctioned source like OFAC
listType	String	No	WLE listing type
sourceEntryId	String	No	WLE unique entry ID
sourceKeywords	String	No	WLE keywords
locations	List<Object>	No	WLE additional list of location information; can be null
locations.address	String	No	Address
locations.country	String	No	Country
locations.city	String	No	City
locations.state	String	No	State
locations.type	String	No	A free formatted value, for example, residence or business

Thresholds

You can define thresholds during the AI Agent configuration. They are also available in the model:

• dateMatchingThreshold: integer value in days

• nameMatchingThreshold: double value

Decision factors

idMatch

IdMatch idMatch

Sample:

"idMatch": {
  "match": false,
  "input": "WXYZSESS",
  "wle": "",
  "source": "NER",
  "inputProcessed": null,
  "wleProcessed": null
}

Object definition:

public class IdMatch {
    private Boolean match;
    private String input;
    private String inputProcessed;
    private String wle;
    private String wleProcessed;
    private SourceType source;
}

Field	Type	Always expected	Possible values
match	Boolean	No	true false null
input	String	No	Matched screened value
wle	String	No	Matched WLE value
inputProcessed	String	No	Processed screened value
wleProcessed	String	No	Processed WLE value
source	SourceType	No	NER LOOKUP SCREENED

typeMatch

TypeMatch typeMatch

Sample:

"typeMatch": {
  "match": false,
  "input": "John Doe",
  "wle": "Johnson LLC",
  "source": "NER",
  "inputProcessed": null,
  "wleProcessed": null,
  "inputType": "INDIVIDUAL",
  "inputTypeConfidenceScore":0.9,
  "wleType": "ORGANIZATION"
}

Object definition:

public class TypeMatch {
    private Boolean match;
    private String input;
    private String inputProcessed;
    private String wle;
    private String wleProcessed;
    private SourceType source;
    private EntityType inputType;
    private EntityType wleType;
    private Double inputTypeConfidenceScore;
    private List<EntityType> otherInputTypes
}

Field	Type	Always expected	Possible values
match	Boolean	Yes	true false null
input	String	Yes	Original screened value
wle	String	Yes	Original best matching WLE value
inputProcessed	String	Yes	Processed screened value
wleProcessed	String	Yes	Processed best matching WLE value
source	SourceType	Yes	NER LOOKUP SCREENED
inputType	EntityType	Yes	INDIVIDUAL ORGANIZATION COUNTRY LOCATION VESSEL AIRCRAFT ID NAME NONENTITY ACCOUNT
inputTypeConfidenceScore	Double	Yes	A value between 0 and 1 (probability) reflecting how confident the model is about the predicted type of the input entity
wleType	EntityType	Yes	INDIVIDUAL ORGANIZATION COUNTRY LOCATION VESSEL AIRCRAFT ID NAME NONENTITY ACCOUNT
otherInputTypes	List of EntityType	No	Possible additional input type: VESSEL (MARIA can be a person or a vessel name)

nameMatch

NameMatch nameMatch

Sample:

"nameMatch": {
        "score": 0.5593499999999999,
        "blackListed": false,
        "blackListedWordStr": "",
        "blacklistedSource": "NONE",
        "nameMatcherSource": "wf-name-matcher",
        "matchedWLEEntity": "PRIMARY_NAME",
        "inputHasLegalEnding": true,
        "wleHasLegalEnding": true,
        "legalEndingsAreDifferent": true,
        "match": false,
        "input": "INVESTMENT HOLDINGS INC",
        "inputProcessed": "investment holdings",
        "wle": "CONSOLIDATED INVESTMENTS LLC",
        "wleProcessed": "consolidated investments",
        "source": "NER"
      }

Object definition:

public class NameMatch {
    private Boolean match;
    private String input;
    private String inputProcessed;
    private String wle;
    private String wleProcessed;
    private SourceType source;
    private Double score;
    private Boolean blackListed;
    private String blackListedWordStr;
    private BlacklistedSource blacklistedSource;
    private String nameMatcherSource;
    private MatchedWLEEntity matchedWLEEntity;
    private Boolean inputHasLegalEnding;
    private Boolean wleHasLegalEnding;
    private Boolean legalEndingsAreDifferent;
    private Double screenedToWleNameScore;
    private Double screenedToWleAliasScore;
    private Double screenedToWlePrimaryNameScore;
    private String processedWleName;
    private String processedWlePrimaryName;
    private String processedWleAlias;
}

Field	Type	Always expected	Possible values
match	Boolean	Yes	true false null
input	String	Yes	Screened value
wle	String	Yes	WLE value
score	Double	Yes	Matching score between 0 and 1
blacklisted	Boolean	No	true false if a blacklisted keyword is found
blackListedWordStr	String	No	Blacklisted keyword value
blacklistedSource	BlacklistedSource Enum	No	ENTITY CONTENT COUNTRY NONE
inputProcessed	String	Yes	Processed input name
wleProcessed	String	Yes	Processed WLE name
source	SourceType Enum	Yes	NER LOOKUP SCREENED
inputHasLegalEnding	Boolean	No	true false null
wleHasLegalEnding	Boolean	No	true false null
legalEndingsAreDifferent	Boolean	No	true false null
nameMatcherSource	String	Yes	wf-name-matcher
matchedWLEEntity	MatchedWLEEntity Enum	Yes	PRIMARY_NAME WLE_NAME ALIAS
screenedToWleNameScore	Double	No	Matching score between 0 and 1
screenedToWleAliasScore	Double	No	Matching score between 0 and 1
screenedToWlePrimaryNameScore	Double	No	Matching score between 0 and 1
processedWleName	String	No	Processed WLE name
processedWlePrimaryName	String	No	Processed primary name
processedWleAlias	String	No	Processed best matching alias name

countryMatch

CountryMatch countryMatch

Sample:

"countryMatch": {
  "match": false,
  "input": "Roslagsgatan 10 \n113 51 Stockholm, Sweden",
  "wle": "123 Adams Street \n United States",
  "blacklisted": false,
  "source": "LOOKUP",
  "inputProcessed": "SE",
  "wleProcessed": "US",
},

Object definition:

public class CountryMatch {
    private Boolean match;
    private String input;
    private String inputProcessed;
    private String wle;
    private String wleProcessed;
    private SourceType source;
    private Boolean blackListed;
    private String blackListedStr;
    private BlacklistedSource blacklistedSource;
}

Field	Type	Always expected	Possible values
match	Boolean	Yes	true false null
input	String	No	Screened value
wle	String	No	WLE value
blacklisted	Boolean	No	true if a blacklisted country is found; otherwise, false
blacklistedSource	BlacklistedSource Enum	No	ENTITY CONTENT COUNTRY NONE
blackListedStr	String	No	Blacklisted country value
inputProcessed	String	No	Screened ISO2 country (can be multiple pipe-separated values)
wleProcessed	String	No	WLE ISO2 country (can be multiple pipe-separated values)
source	SourceType Enum	No	NER LOOKUP SCREENED

addressMatch

AddressMatch addressMatch

Sample:

addressMatch": {
        "matcherSource": "AVSERVICE",
        "comparisonOutput": {
          "house_number_match": true,
          "city_match": true,
          "state_match": true,
          "country_match": true,
          "postal_code_match": null,
          "road_match": true
        },
        "match": true,
        "input": "6820 S Harl Ave, Tempe, AZ 85283, USA",
        "inputProcessed": "6820 South Harl Avenue Tempe Arizona United States  ",
        "wle": "6820 S Harl Ave, Tempe, AZ 85283, USA",
        "wleProcessed": "6820 South Harl Avenue Tempe Arizona United States  ",
        "source": "SCREENED"
      }

Object definition:

public class AddressMatch extends ModelFeature {
private Boolean match;
    private String input;
    private String inputProcessed;
    private String wle;
    private String wleProcessed;
    private SourceType source;
    private AddressCompareSource matcherSource; 
    private ComparisonOutput comparisonOutput; 
    private double score; 
}

Field	Type	Always expected	Possible values
matcherSource	AddressCompareSource Enum	Yes	AVSERVICE GEOCODER STRING

ComparisonOutput contains details on which part of the address matched. Available in AVSERVICE only; can be null.

Field	Type	Always expected	Possible values
comparisonOutput.house_number_match	Boolean	No	true false null
comparisonOutput.city_match	Boolean	No	true false null
comparisonOutput.state_match	Boolean	No	true false null
comparisonOutput.country_match	Boolean	No	true false null
comparisonOutput.postal_code_match	Boolean	No	true false null
comparisonOutput.road_match	Boolean	No	true false null
match	Boolean	Yes	true if a full match; otherwise, false
input	String	No	Matched input value
inputProcessed	String	No	Processed matched input value
wle	String	No	Processed matched WLE value
wleProcessed	String	No	Processed matched WLE value
source	SourceType	No	NER LOOKUP SCREENED
score	Double	No	Value between 0.0 and 1.0

AVSERVICE indicates that the external address matching service was selected as the address matching source during the configuration. The addressMatch object is populated with values from the comparisonOutput object only when AVSERVICE is used, as shown in the table.

In addition to the match parameter that indicates whether the input address and the WLE address are an exact match, the score parameter is also available. It provides a fuzzy match score between the input address and the WLE address. For more information on how this score is calculated, refer to Perform address comparison.

dobMatch

DobMatch dobMatch

Sample:

"dobMatch": {
  "match": false,
  "input": "2000-01-01",
  "wle": "Jul 23 1998",
  "source": "SCREENED",
  "inputProcessed": "01/01/2000",
  "wleProcessed": "07/23/1988",
},

Object definition:

public class DOBMatch {
    private Boolean match;
    private String input;
    private String inputProcessed;
    private String wle;
    private String wleProcessed;
    private SourceType source;
}

Field	Type	Always expected	Possible values
match	Boolean	Yes	true false null
input	String	No	Screened value
wle	String	No	WLE value
inputProcessed	String	No	Normalized screened date to mm/dd/yyyy format
wleProcessed	String	No	Normalized WLE date to mm/dd/yyyy format
source	SourceType Enum	No	NER LOOKUP SCREENED

Security lookup data

Security lookup data refers to company information lookup by a security ID.

SecurityLookupData object definition

public class SecurityLookupData {
    private boolean executed;
    private String country;
    private String city;
    private String address;
    private String region;
    private String state;
    private String postalCode;
    private boolean shareHolderHighRiskIndicator;
    private boolean highRiskIndicator;
    private double totalShareholderOwnership;
    private String id;
    private String securityType;
    private String name;
}

Field	Type	Always expected	Possible values
executed	Boolean	Yes	true false
country	String	No	USA
shareHolderHighRiskIndicator	Boolean	No	true false
highRiskIndicator	Boolean	No	true false
totalShareholderOwnership	Double	No	49.5 (in %)
id	String	No	KW0EQ0601694
securityType	String	No	ISIN
name	String	No	Humansoft Holding Company K.S.C.P.
city	String	No	City
address	String	No	Address
region	String	No	Region
state	String	No	State
postalCode	String	No	Postal code