Document reference type

The Referenced entity (referencedEntity) field can optionally be assigned a reference for an entity type (using a Combobox).

• If an entity type is selected, then this is binding for the Search being carried out for target objects to assign an existing document.
  
  

• If no entity type is selected, the document to be referenced must specify an entity type in the ‘Referenced entity’ (referencedEntity) field at runtime to which the Search defined in the following parameter is applicable.

The Reference search (referenceSearch) field defines a Search for the relevant entity type, in which the text value in the ‘Reference’ (reference) field of the document to be referenced can be accessed via the reference Variable.

The screenshot on the right shows the Search for the only predefined Document reference type 'Entity ID' (ENTITY_ID), which contains a Field restriction as the only Where condition in which the Variable reference is matched with the 'ID' field of an undefined entity type (no Referenced entity selected).

If the string provided by the document to be referenced as a ‘reference’ (reference) at runtime matches the number sequence of an ‘ID’ (id) for an instance of the entity type also to be provided, then a document that refers to this Document reference type is automatically assigned to the relevant entity when it is saved.