VerifiedImport Overview

VerifiedImport is a new event subtype that acts as a standardized pipeline (business service) for consuming entity data and orchestrates the update within Fenergo.

Some of the key differences between it and previous Legacy Event (MigrateEntity) are

1. Stateless Integrations - Calling system does not need to know an Entity's state in Fenergo. There is an option to provide a unique identifier (e.g. centralized MDM) if available to decide if entity should be created or updated.

2. Multiple Entities per event - VerifiedImport allows for multiple entities per message.

3. Lookups Resolver - Lookup values can be provided as value, id, or custom column from the reference list definition.

4. Message Simplicity - External Systems need only provide incoming datakey and value. Fenergo will use internal policy configuration to determine data types and validations

Verified Import Flow

The system will match each entity using the provided entityId or entityResolver, then create or update it accordingly. No journey will be triggered, and the data will be verified as part of the process.

Resolver Rules

All incoming Entities need to be resolved for uniqueness to determine if we should create a new record or update an existing record.

Data Domain	Uniqueness Rules
Entities	- The Fenergo Entity Id, or - A single datakey configured as a search indexable field in policy config. The field value must be unique across the tenant or else a duplicate entity error will occur

Mapping Data

VerifiedImport uses Policy Configuration in Fen-X to map the incoming data to datakeys defined in Policy. The Policy mapped via eventConfig.entityProcessingRules.categories. With it you can provide the Policy categories that will be used when Creating and Updating your entity.

VerifiedImport supports the following field data type:

• Text Field
• Text Area
• Number
• Date
• Data Group
• Select Dropdown
• Multiple Select Dropdown
• Legacy Linked Select Dropdown
• Legacy Linked Multiple Select Dropdown
• Linked Select Dropdown
• Linked Multiple Select Dropdown
• Rich Text Editor

Lookup Mapping

Lookup mapping applies to fields of types:

• Select Dropdown
• Multiple Select Dropdown
• Legacy Linked Select Dropdown
• Legacy Linked Multiple Select Dropdown
• Linked Select Dropdown
• Linked Multiple Select Dropdown

By default incoming values will be validated against the Reference List 'Value' column. Lookup mapping allows to configure the lookup to use a different column for mapping (e.g. Id, or custom column). This configuration is applied to all fields that use the lookup.

For example the below config will use values from MDMSystem column in reference list to resolve and validate value for the lookup Country

Lookup Mapping

            "lookupsMapping": [
              {
                "lookupName": "Country",
                "columnName": "MDMSystem"
              }
            ]

Processed Message

The processed message is produced after the import logic has been executed. It contains the status of the overall import as well as the result of importing individual entities.

The structure of the processed message is intended for human-readable investigations, debugging, and audit purposes only. It may evolve over time and is not guaranteed to be backward-compatible. Therefore, it should not be used for service-to-service integration or automated processing.

Error Handling

If the processing of any entity fails, the entire event will be marked as 'Failed'; otherwise, it will be 'Success'. The status of each individual entity can be checked in Event Details > Entities. Additional failure details, such as validation errors, are available in the Processed Message.

Aditional Information

Event Notifications

Because the feature is built on top of the Entity Migration - there are no entitydata:created event notifications triggered during the process. The only event notification triggered is after all of the entities are processes and is either eventingress:success or eventingress:failed based on the overall event processing status.