Mapping

Der Datenaustausch zwischen Business Central (BC) und Customer Engagement (CE / Dataverse) läuft vollständig über die DataBridge. Sie besteht aus zwei Konfigurationsebenen:

• Job — wann und unter welcher Bedingung etwas übertragen wird (Zeitplan, Filter, Reihenfolge, Watermark, Quell-/Zielverbindung)
• Mapping — was übertragen wird (Feldzuordnung Quelle → Ziel inkl. Key-Auflösung und Transformationen)

Aktuell sind 38 Jobs mit 38 Mappings und insgesamt 290 Feldzuordnungen konfiguriert. Zu jedem Job gehört genau ein Mapping.

Übersicht — welche Daten werden ausgetauscht?

Auf oberster Ebene lassen sich die Daten in vier Gruppen einteilen:

flowchart LR
  subgraph BC["Business Central"]
    direction TB
    BC1["Stammdaten<br/>Länder · Sprachen · Anreden<br/>Verkäufer · Positionen · Rabattgruppen"]
    BC2["Produkte<br/>Verkaufschancen-Elemente"]
    BC3["Belege<br/>Angebote · Angebotspositionen<br/>Kalkulationselemente"]
    BC4["Abonnements<br/>Serviceobjekte · Servicevereinbarungen"]
    BC5["Geschäftspartner<br/>Firmen · Kontakte"]
    BC6["Verkaufschancen"]
  end

  subgraph CE["Customer Engagement"]
    direction TB
    CE1["Wertelisten<br/>wysa_country · wysa_language · …"]
    CE2["Produkte<br/>product"]
    CE3["Angebote<br/>quote · quotedetail"]
    CE4["Abonnements<br/>wysa_bcserviceobject(commitment)"]
    CE5["Firma / Kontakt<br/>account · contact"]
    CE6["Verkaufschance<br/>opportunity · opportunityproduct"]
  end

  BC1 -->|Referenzdaten| CE1
  BC2 -->|Produkte| CE2
  BC3 -->|Angebote & Preise| CE3
  BC4 -->|Abo-Bestand| CE4
  BC5 <-->|in beide Richtungen| CE5
  CE6 -->|nur CE → BC| BC6

Daraus ergeben sich vier grundsätzliche Muster:

Der Detailfluss inklusive Response-Jobs und Löschverarbeitung steht unter Datenfluss.

Vollständige Liste der Mappings

Sortiert nach der Ausführungsreihenfolge (Order) des zugehörigen Jobs. „Felder" = Anzahl der Feldzuordnungen, „Ops" = davon mit Transformation (Lookup, OptionSet, Concat, …).

Stammdaten und Produkte (BC → CE)

Geschäftspartner und Verkaufschancen (CE → BC, mit Response)

Geschäftspartner (BC → CE)

Abonnements (BC → CE)

Angebote (BC → CE)

Löschungen (BC → CE, Quelle immer das Änderungsprotokoll acdlogentries)

Detailseiten

Die Detailseiten sind nach Datenbereich gegliedert, nicht nach Job. Jeder Bereich hat eine Übersichtsseite mit dem Gesamtbild und darunter je eine Seite pro Schritt.

Grundlage aller Belegketten sind die Stammdaten — die Wertelisten aus Business Central, aus denen die Belege ihre Verknüpfungen bilden:

Vollständig dokumentiert sind bisher Firma und Kontakt:

Das Angebot läuft ausschließlich von Business Central nach Customer Engagement und schließt damit den Kreis zur Verkaufschance:

Das Abonnement ist ein eigenständiger Bereich, ebenfalls nur von Business Central nach Customer Engagement:

Eine rein technische, tabellarische Sicht auf alle Jobs in Ausführungsreihenfolge bietet die Sektion Technisches Mapping.

Damit sind alle aktiven Mappings der Integration dokumentiert.

Die Verkaufschance weicht vom Muster ab — sie läuft nur in eine Richtung und hat eine zweite Kette für die Positionen:

Aufbau einer Detailseite

Jede Schrittseite ist zweigeteilt: zuerst die fachliche Sicht, danach die technische.

1. Steckbrief — Richtung, Takt, Betroffene, technische Zuordnung
2. Was passiert hier? — der Vorgang in Prosa
3. Welche Felder? — Feldtabelle mit Anzeigenamen beider Systeme
4. Worauf zu achten ist — fachliche Besonderheiten und Stolperfallen
5. Technische Details — aufklappbar: Job-Konfiguration, Key-Auflösung, technische Feldnamen, Transformationen als JSON

Wer die Lösung anwendet, liest die ersten vier Punkte. Wer sie wartet oder erweitert, klappt den fünften auf.

Die technischen Grundlagen (Jobs, Konnektoren, Transformationen) stehen in der DataBridge-Dokumentation.