Was ist ein Mapping-Dokument?

Ein Mapping-Dokument ist eine strukturierte Tabelle, die die Zuordnung von Datenfeldern zwischen zwei oder mehr Systemen dokumentiert. Sie beschreibt, welches Feld in System A welchem Feld in System B entspricht, welche Transformationen dabei notwendig sind und welche Regeln gelten, wenn Felder nicht direkt übersetzbar sind.

Es ist ein Planungs- und Referenzdokument: Es entsteht vor der Entwicklung einer Schnittstelle und dient nach der Implementierung als dauerhafte Dokumentation.

Was gehört in ein Mapping-Dokument?

Eine typische Zeile in einem Mapping-Dokument enthält: Feldname im Quellsystem, Feldname im Zielsystem, Datentyp im Quellsystem, Datentyp im Zielsystem, Transformationsregel (falls nötig), Pflichtfeld ja/nein, Standardwert (falls kein Quellwert vorhanden), und Bemerkungen zu Sonderfällen.

Ein einfaches Beispiel für einen Ausschnitt aus einem Shop-ERP-Mapping:

Quellfeld (Shop)	Zielfeld (ERP)	Typ Quelle	Typ Ziel	Transformation
lineItems.price	OrderItem.unitPrice	String “19,99 €“	Decimal 19.99	Währungszeichen entfernen, Komma zu Punkt
customer.email	Customer.emailAddress	String	String	Direktübertragung
shippingAddress	DeliveryAddress.*	Combined String	Separate Felder	Aufteilen nach Straße, Nr, PLZ, Ort

Warum ist das Mapping-Dokument vor der Implementierung Pflicht?

Ohne Mapping-Dokument beginnen Entwickler basierend auf Annahmen zu entwickeln. Diese Annahmen sind oft falsch, weil die genaue Feldstruktur des Zielsystems erst im Detail betrachtet wird, wenn bereits Code geschrieben ist. Das Ergebnis: aufwändige Nacharbeiten und Bugs in der Produktion.

Mit Mapping-Dokument gibt es klare Anforderungen. Alle Beteiligten (Projektmanager, Entwickler, fachliche Ansprechpartner beider Systeme) können das Mapping prüfen und abnehmen, bevor die Arbeit beginnt.

Das Mapping-Dokument ist auch die Grundlage für Testfälle: Für jede Transformationsregel werden Testdaten definiert, die das erwartete Ergebnis beschreiben.

Mapping-Dokument nach Go-Live

Nach der Implementierung dient das Mapping-Dokument als Wartungsreferenz. Wenn Monate später jemand wissen muss, warum ein bestimmtes Feld so übertragen wird, wie es übertragen wird, steht die Antwort im Mapping-Dokument.

Wenn eines der Systeme ein Update bekommt und Feldnamen oder -strukturen sich ändern, zeigt das Mapping-Dokument sofort, welche Teile der Integration betroffen sind.

Wir erstellen Mapping-Dokumente als Standard-Deliverable bei allen Automation-Projekten, ERP-Integrationen und E-Commerce-Schnittstellen. Beim Termin zeigen wir dir, wie so ein Dokument in der Praxis aussieht und welche Informationen du dafür vorbereiten müsstest.