Xeku.DataMirror 0.0.0.7

dotnet add package Xeku.DataMirror --version 0.0.0.7
                    
NuGet\Install-Package Xeku.DataMirror -Version 0.0.0.7
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Xeku.DataMirror" Version="0.0.0.7" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Xeku.DataMirror" Version="0.0.0.7" />
                    
Directory.Packages.props
<PackageReference Include="Xeku.DataMirror" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Xeku.DataMirror --version 0.0.0.7
                    
#r "nuget: Xeku.DataMirror, 0.0.0.7"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Xeku.DataMirror@0.0.0.7
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Xeku.DataMirror&version=0.0.0.7
                    
Install as a Cake Addin
#tool nuget:?package=Xeku.DataMirror&version=0.0.0.7
                    
Install as a Cake Tool

Xeku.DataMirror

A DevExpress XAF module for receiving and processing mirrored data from webhooks. Works as the destination for Xeku.Triggers.

繁體中文文檔

Features

  • MirroredObject Base: Custom XPO class allowing external Oid assignment for PK synchronization.
  • Protection Attribute: [MirroredObjectProtection] controls read-only state in UI/API.
  • Dynamic Type Mapping: Source-to-local type mappings configured via XAF UI.
  • Auto-Hide Actions: Automatically hides New/Delete actions for protected mirrored objects.
  • Upsert Support: Automatically creates objects on Modified events if missing.

Architecture

sequenceDiagram
    participant Source as Xeku.Triggers (Source)
    participant Receiver as DataMirror Controller
    participant Service as Mirror Service
    participant DB as Local Database

    Source->>Receiver: Webhook (JSON Payload)
    Receiver->>Service: Process Payload
    Service->>DB: Resolve Type Mapping
    Service->>DB: Upsert/Delete Object
    Service-->>Receiver: Result
    Receiver-->>Source: 200 OK / Error

Installation

1. NuGet Package

dotnet add package Xeku.DataMirror

2. Register Module

RequiredModuleTypes.Add(typeof(Xeku.DataMirror.DataMirrorModule));

Usage

Creating a Mirrored Object

[MirroredObjectProtection(true)] // Read-only
public class SyncedCustomer : MirroredObject
{
    public SyncedCustomer(Session session) : base(session) { }
    // ... Properties
}

Type Mapping Configuration

Navigate to Configuration > Mirror Type Mapping to link source type names to local classes.

AI Agent Integration

Suggested Context

  • Sync Integrity: Mirroring depends on Oid consistency. Never modify Oids manually.
  • Permission Mapping: Use [MirroredObjectProtection] instead of XAF security for hard physical read-only requirements.

Common Tasks

  • "How do I map a source type 'OldSystem.Customer' to 'SyncedCustomer'?"
  • "Check sync logs for objects that failed to mirror yesterday."

License

MIT License

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Xeku.DataMirror:

Package Downloads
Xeku.DataMirror.WebApi

Web API extensions for Xeku.DataMirror with write protection for mirrored objects.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.0.0.7 114 1/28/2026
0.0.0.6 105 1/21/2026
0.0.0.5 110 1/15/2026
0.0.0.4 116 1/13/2026
0.0.0.3 114 1/9/2026
0.0.0.2 125 1/8/2026