Detect all fields of the given datatype(s) in an entity's schema.

Array of matching fields with their id and schema definition.

Detect the first field of the given datatype(s) in an entity's schema.

Scans the schema for a field whose dataType matches one of the provided strings and returns its property name.

Subclasses typically override this without the extra dataTypes parameter, forwarding their own relevant datatype identifiers.

The field name of the first matching field, or undefined if none is found.

Export columns for a field using this datatype.

Each returned column contributes a CSV header and its own value resolver. The returned keySuffix is appended to the field id to form the exported column key.

The default implementation returns a single column with the raw field value. Readable formatting can be applied by callers during CSV transformation. Override this to provide custom or additional columns (e.g. entity references can add a human-readable name column alongside the ID column).

Mango conditions matching documents whose fieldId references the given entity id, used to query related entities instead of loading a whole entity type (see EntityRelationsService.loadAllLinkingToEntity).

The conditions are matched against the database format, so only the datatype that writes that format can build them - which is why this lives here rather than in the calling service. Return every shape the value may have been stored in rather than branching on schemaField.isArray: existing documents may have been written while the field had the other setting (see FilterService and EntityFilter).

The caller treats these as candidates only and still post-filters in memory, so matching too much is harmless - matching too little silently loses references.

     cannot be expressed as a query, which makes the caller load the whole type.
     Never return an empty array: `{$or: []}` matches nothing.

the conditions to OR together, or undefined if this datatype's stored format cannot be expressed as a query, which makes the caller load the whole type. Never return an empty array: {$or: []} matches nothing.

The function used to map values from the import data to values in the entities to be created. to share information across processing of multiple columns and rows.

Map all columns mapped to one target field to the value(s) stored there.

ImportService calls this once per target field per row with every column mapped to that field. The default handles trimming and array splitting and delegates each individual value to importMapFunction. Datatypes that need to consider several columns together (e.g. matching an entity by more than one property) override this.

(isArray=true), or undefined if nothing was mapped

the value to store: a single value (isArray=false) or array (isArray=true), or undefined if nothing was mapped

Return the (potentially adjusted) schema field for this datatype.

Called when schema fields are set up (e.g. from config), allowing the datatype to normalize or fill in required settings.

Override this in a subclass to enforce constraints (e.g. always setting isArray: true).

The schema field to use (default: unchanged)

Return a comparable primitive for sorting this field's value in a list column. Return undefined to fall through to the default sort logic. Override this in datatypes that store arrays or complex objects where the raw value cannot be sorted meaningfully.

Whether this datatype allows multiple values to be mapped to the same entity field during import.

A component to be rendered inline to configure the import transformation (e.g. defining a format or value mapping).

The component receives inputs: col, rawData, entityType, otherColumnMappings, additionalSettings, onColumnMappingChange

A dialog component in which the import transformation is configured (see MappingDialogData for the data it receives).

Datatypes that require such a dialog get it opened automatically as soon as the user maps a column to one of their fields, so that the suggested settings are reviewed and confirmed rather than silently skipped.

Validators that every value of this datatype has to pass in entity forms, in addition to the validators configured for the field.

The default component how this datatype should be displayed in lists and forms.

The edit component has to be a registered component. Components that are registered contain the DynamicComponent decorator