JSON Template Business Key

The business key element path is identified by an OpIdentifier property having ''opKey'' as value. It indicates that the element contains the unique business key of the entity.

The ''opKey'' is not enough, the MDE must know where to store/find the business key of the entity. You must declare another items with the same path as the one specified for ''opKey'':

Note

This indicates the the business key element is identified by the property ''MTR_ID'' in the Master Data Upload file and that the business key value resides in the property SerialNumber of the source object

Important

The business key differs from the Data Hub Id

  • Data Hub automatically sets the entity Id upon entity creation

    • it is immutable
    • it is guaranteed to be unique per entity type (site, source, ...)
    • it is never recycled for another entity of the same type, even if the original entity is deleted

  • the end user freely chooses the business key

    • it is mutable, meaning that Data Hub does not prevent the modification of the business key of an existing entity
    • it does not guarantees that the business key is unique across entity types, it is upon the producer of the Master Data Upload File to ensure the uniqueness. If more than one entity have the same business key, only one entity (the first one in a non-deterministic way) will be considered by Data Hub or MDE