Nuclos generic implementation: generic business objects (GBO), mapping, generic rules, wrapper class, getGenericBusinessObject.

Language: Deutsch · English

Generic implementation

One rule for many business objects: abstract commonalities in generic business objects instead of instanceof chains.

On this page

Why a generic implementation?

The generic implementation enables rules that apply to several business objects alike – e.g. sequential numbers or net/gross totals for quote, order, delivery note and invoice. Instead of instanceof chains you abstract commonalities in a generic business object (GBO).

Previously each type had to be checked individually in a rule:

final Modifiable<?> bo = context.getBusinessObject(Modifiable.class);
if (bo instanceof Geschaeftspartner) { ... }
else if (bo instanceof Angebot)      { ... }
else if (bo instanceof Auftrag)      { ... }

Menu: Configuration → Rule sets → Generic implementation

Configuration

A BO marked as generic (checkbox in the BO wizard) is required. Then the mapping is maintained:

Generic business object – the BO defined as GBO.
Implementing business object – the concrete BO.
Attributes – mapping GBO ↔ BO. Mandatory GBO attributes must be mapped (the BO attribute itself need not be mandatory).

Low-Code und Werkzeuge > Generische Implementierung > generischeImplementierung01.JPG

Mapping of the generic implementation.

Terms

Term	Meaning
GenericBusinessobject (GBO)	abstracts commonalities of several BOs
Wrapper class	generated class mapping GBO attributes to a BO
Implementing BO	concrete BO mapped to a GBO
Generic rule	rule that works with GBOs

Aspects

A GBO can be mapped to any number of BOs and vice versa; mappings belong to the same Nuclet.
Access in the rule context via getGenericBusinessObject(GBOClass); GBOs may have reference fields to other GBOs.
GBOs are only supported by parts of the API (no QueryProvider/StatemodelProvider).
Generic rules are attached manually to an implementing BO; if the context BO type does not match, a runtime error occurs.

Related pages

Server-side rules

Server rules.

Open →

Business object

Mark as GBO.

Open →