Skip to main content

ExportDataPointMappingsNodeConfiguration

Namespace: Meshmakers.Octo.MeshAdapter.Nodes.Transform

Configuration for the ExportDataPointMappings node.

The node serialises the tenant's DataPointMapping entities into a portable document that survives tenant re-initialisation: instead of raw RtIds, every mapping endpoint carries a NATURAL identity — a configurable identity attribute per CK type (e.g. Loxone/Control → LoxoneUuid, MQTT/Topic → TopicPath) plus the entity name as fallback. RtIds are included as a hint for same-tenant round trips but are never required on import.

The counterpart ImportDataPointMappingsNodeConfiguration node resolves the identities back to entities and emits the standard GenerateDataPointMappings suggestion shape for the shared downstream persistence pipeline.

public record ExportDataPointMappingsNodeConfiguration : TargetPathNodeConfiguration, INodeConfiguration, IEquatable<NodeConfiguration>, ITargetPathNodeConfiguration, IEquatable<TargetPathNodeConfiguration>, IEquatable<ExportDataPointMappingsNodeConfiguration>

Inheritance Object → NodeConfiguration → TargetPathNodeConfiguration → ExportDataPointMappingsNodeConfiguration
Implements INodeConfiguration, IEquatable<NodeConfiguration>, ITargetPathNodeConfiguration, IEquatable<TargetPathNodeConfiguration>, IEquatable<ExportDataPointMappingsNodeConfiguration>

Properties​

MappingCkTypeId​

CkTypeId of the mapping entities to export.

public string MappingCkTypeId { get; set; }

Property Value​

String

MapsFromRoleId​

AssociationRoleId connecting a mapping to its source entity (outbound).

public string MapsFromRoleId { get; set; }

Property Value​

String

MapsToRoleId​

AssociationRoleId connecting a mapping to its target entity (outbound).

public string MapsToRoleId { get; set; }

Property Value​

String

IdentityAttributes​

Identity attribute per CK type: which attribute on an endpoint entity carries its stable natural key (e.g. Loxone/Control → LoxoneUuid, EnergyIQ types → GlobalId). Types without an entry export name-only identities (resolved by unique name on import).

public ICollection<EntityIdentityAttributeConfiguration> IdentityAttributes { get; set; }

Property Value​

ICollection<EntityIdentityAttributeConfiguration>

ExcludeNameRegex​

Optional regular expression: mappings whose Name matches are skipped. Use this to export only the MANUAL delta — rule-generated mappings follow the deterministic "ruleId|rtId|state" pattern (e.g. "^[\w-]+\|[0-9a-f]{24}\|") and are reproducible by re-running the generation pipeline, so they don't need to be part of the export.

public string ExcludeNameRegex { get; set; }

Property Value​

String

IncludeDisabled​

Whether disabled mappings are exported too. Default true — an export is a backup, and a deliberately disabled mapping is still configuration.

public bool IncludeDisabled { get; set; }

Property Value​

Boolean

TargetPath​

public string TargetPath { get; set; }

Property Value​

String

TargetValueWriteMode​

public TargetValueWriteModes TargetValueWriteMode { get; set; }

Property Value​

TargetValueWriteModes

TargetValueKind​

public ValueKinds TargetValueKind { get; set; }

Property Value​

ValueKinds

DocumentMode​

public DocumentModes DocumentMode { get; set; }

Property Value​

DocumentModes

Description​

public string Description { get; set; }

Property Value​

String

Constructors​

ExportDataPointMappingsNodeConfiguration()​

public ExportDataPointMappingsNodeConfiguration()