Easy Relations

Defining an easy relation

An easy relation definition can be created in easytypes.json manifest file. The manifest allows to define the following for an easy relation:

Code of the easy relation
Localized name of easy relation
Super type of the easy relation
Deployment information for many-to-many easy relation
- Deployment table name
- Deployment type code
- Props table name
The Source Element
- Qualifier for the source element
- Localized name for the source element
- Type of the source element
- cardinality of the source element.
- Collection type of the source element

Example definition for a new easy relation

{
    "code" : "EasyItem2CustomerRel",
    "deployment" : {
        "table" : "easyitems2custrel",
        "typecode" : "25001"
    },
    "sourceElement" : {
        "qualifier" : "easyitems",
        "name" : [
            {
                "lang": "en",
                "value": "Easy Items"
            }
        ],
        "type" : "EasyItem",
        "cardinality": "many",
        "collectiontype": "set"
    },
    "targetElement" : {
        "qualifier" : "customers",
        "name" : [
            {
                "lang": "en",
                "value": "Customers"
            }
        ],
        "type" : "Customer",
        "cardinality" : "many",
        "collectiontype" : "set"
    }
}

1:m or n:1 relations

It is advised to define the attribute in the item type for such scenarios at one side and a dynamic attribute with attribute handler to query the items belonging to the other side.

Limitations with Easy Relations

While the Easy relations can be defined at runtime, following points must be of the consideration while creating the Easy relations:

Cleanup of the Easy relations is not supported as part of uninstall process for an easy extension.
Existing standard or easy relations cannot be modified.

Last modified: 18 August 2025