Stellen Sie sich verschiedene Anwendungen vor, die zusammenarbeiten müssen, aber sie sind wie Puzzleteile, die zusammenpassen müssen. Hier kommt das Data Mapping ins Spiel. Es ist wie ein cleverer Dolmetscher, der dafür sorgt, dass diese Anwendungen einander verstehen, auch wenn sie unter der Oberfläche unterschiedliche “Sprachen” sprechen. Dieser Beitrag nimmt Sie mit auf eine Entdeckungsreise durch die Welt des Datenmappings. Wir sehen uns an, was es genau ist, wie Entwickler es verwenden und wie APIcenter dabei hilft. Wir sehen uns auch an, welche Arten von Anwendungen mit APIcenter zusammenarbeiten können und wie Sie das Datenmapping an die spezifischen Anforderungen Ihres Projekts anpassen können. Kurz gesagt, ein Blick hinter die Kulissen der Verknüpfung von Anwendungen!
Datenzuordnung bei Anwendungslinks
Datenmapping wird häufig bei Verbindungen zwischen Anwendungen verwendet. Der Grund dafür ist, dass zwei verschiedene Anwendungen von zwei verschiedenen Entwicklern geschrieben wurden. Das führt dazu, dass zwei Anwendungen zwar gleich aussehen, aber unter Wasser völlig unterschiedlich geschrieben sein können. Dadurch entsteht eine große Lücke, wenn Sie versuchen, diese Anwendungen miteinander zu verknüpfen. Um dieses Problem zu lösen, muss ein Entwickler, der die Integration erstellt, Beziehungen zwischen den Informationen der beiden Anwendungen herstellen. Das ist nicht besonders schwierig, aber wenn Sie dies für mehr als 60+ Anwendungen tun müssen, wird es zu einer unmöglichen Aufgabe. In diesem Beitrag erklären wir Ihnen, was Datenmapping ist, wie es verwendet wird, wie APIcenter damit umgeht, welche Arten von APIcenter unterstützt werden und wie Sie das Datenmapping anpassen können, um es besser an Ihren Arbeitsprozess anzupassen.
Quelle-Ziel-Zuordnung
Bei APIcenter nehmen wir immer unsere eigene Perspektive ein, wenn wir einen Datenfluss (Flow) entwerfen. Das bedeutet, dass wir stets zwei Seiten betrachten. Auf der einen Seite haben wir die ‘Get’-Seite (GET), auf der die Informationen abgerufen werden. Auf der anderen Seite haben wir die ‘Sende’-Seite (SEND), die Informationen empfängt. Um dieses Konzept zu verdeutlichen, nehmen wir als Beispiel einen Webshop auf der Empfangsseite und eine Buchhaltungsanwendung auf der Sendeseite. Die Beispiele in diesem Beitrag verwenden diese beiden Seiten, um die Prinzipien der Quell- und Zielzuordnung zu veranschaulichen.
Punkt-Notation
Die Punktnotation ist eine Technik in Programmiersprachen, die Daten übersichtlich und zugänglich macht. Sie ermöglicht es Anwendern, ohne tiefgreifende Programmierkenntnisse durch komplexe Datenstrukturen zu navigieren. Bei APIcenter verwenden wir die Punktnotation, um Datenstrukturen sowohl der Quellanwendung als auch der Zielanwendung verständlich zu machen. [Naam van het object][Naam van het attribuut] Ein Standardformat der Punktnotation ist wie folgt aufgebaut: . Wenn wir zum Beispiel den Namen (name) eines Kunden (customer) abrufen wollen, notieren wir ihn als: customer.name. Diese Methode erlaubt es uns auch, mehrere Ebenen tief zu gehen. Wenn ein Kunde zum Beispiel eine Adresse (Adresse) mit einer Straße (Straße) hat, wird dies notiert als: kunde.adresse.straße. Darüber hinaus können Informationen mehrere Objekte umfassen. Ein anschauliches Beispiel ist, wenn ein Kunde mehrere Kontakte (Kontakte) hat, was durch einen Doppelpunkt (:) dargestellt wird. Zum Beispiel: kunde.kontakte:name. Der Doppelpunkt deutet an, dass das Attribut ‘Name’ 0, 1 oder mehrfach vorkommen kann.
Daten-Mapping-Typen in APIcenter
APIcenter verwendet drei Arten der Datenzuordnung: ‘ direkt‘, ‘ additiv‘, ‘ transformativ‘ In den folgenden Beispielen werden Informationen aus einem Webshop abgerufen und an ein Buchhaltungssystem gesendet.
D irekt Bei dieser Art des Datenmappings werden die Daten direkt miteinander in Beziehung gesetzt. Als Beispiel haben wir hier ein Produkt mit einem Namen:
Bereich Webshop | Bereich Buchhaltung |
Produktname | ProduktTitel |
Bei diesem Typ werdenzusätzlicheInformationen in andere Felder kopiert, um der Buchhaltungsanwendung zusätzliche Informationen zu liefern. Zum Beispiel, wenn die Lieferadresse des Kunden fehlt:
Bereich Webshop | Bereich Buchhaltung |
BillingStreet | BillingStreet |
BillingPostalCode | BillingPostalCode |
BillingCountry | BillingCountry |
ShippingStreet | |
ShippingPostalCode | |
VersandLand |
Dies geschieht, um der Seite, die die Daten sendet, so viele Informationen wie möglich zu geben. Auch wenn diese Informationen letztendlich nicht verwendet werden.
TransformativHier werden Informationen hinzugefügt, abgezogen oder allgemein geändert. Zum Beispiel, wenn die Preise auf einer Bestellung nicht übereinstimmen (inklusive oder exklusive Steuern):
Bereich Webshop | Bereich Buchhaltung |
GesamtpreisInklusiveSteuer | |
GesamtpreisOhneSteuer | |
GesamtSteuer |
In der obigen Datenzuordnung wird deutlich, dass die Felder nicht direkt nebeneinander liegen, was zu Problemen führen kann, wenn Webshop-Informationen direkt an die Buchhaltung weitergegeben werden. APIcenter überwindet dieses Problem jedoch, indem es den exklusiven Steuerpreis anhand des inklusiven Steuerpreises und des Steuerbetrags berechnet. So können wertvolle Informationen für die Buchhaltung generiert werden, auch wenn bestimmte Daten im Webshop nicht ohne weiteres verfügbar sind. Dieser Ansatz stellt sicher, dass die Integration reibungslos verläuft, ohne Probleme in der Buchhaltung zu verursachen.
Datenzuordnung bei APIcenter: Ein einzigartiger Ansatz
Bei APIcenter verfolgen wir einen besonderen Ansatz für das Mapping von Daten. Anstatt einzelne Anwendungen individuell zuzuordnen, bezieht APIcenter alle Anwendungsfelder auf sein eigenes Datenmodell. (Ein Datenmodell ist eine strukturierte Darstellung einer Entität, z. B. eines Produkts oder eines Kunden). Im Falle des Webshops, aus dem die Informationen stammen, sieht die Datenzuordnung so aus. APIcenter ist bestrebt, so viele Felder wie möglich mit unserem Datenmodell zu verbinden. Dieser Ansatz stellt sicher, dass der anderen Anwendung, in diesem Fall der Buchhaltung, ein umfassender Satz von Informationen zur Verfügung steht. Durch diese Methodik stellt APIcenter sicher, dass eine Fülle relevanter Daten für die nahtlose Integration mit anderen Anwendungen zur Verfügung steht.
WebShop-Feld | APIcenter-Feld |
Produktname | Name |
GesamtPreisInklusiveSteuer | GesamtpreisEinschl.Preis |
TotalExclPreis | |
TotalTax | GesamtSteuerBetrag |
Für die Buchhaltung, an die die Informationen gesendet werden, kann die Datenzuordnung wie folgt aussehen. Hier werden nur die Informationen ausgewählt, die benötigt werden.
APIcenter-Feld | Feld “Buchhaltung |
Name | ProduktTitel |
TotalInclPreis | |
GesamtPreisOhneSteuer | GesamtPreisOhneSteuer |
TotalTaxAmount |
Nachdem der Kunde (oder Partner) ausgewählt hat, welche 2 Anwendungen er möchte, werden die 3 Datenmodelle zusammengeführt. Diese können dann von APIcenter verwendet werden, um Informationen abzurufen und weiterzuleiten. Dies sieht dann wie folgt aus:
Feld Webshop | Feld APIcenter | Feld Buchhaltung |
Produktname | Name | ProduktTitel |
GesamtPreisInklusiveSteuer | GesamtpreisEinschl.Preis | |
GesamtpreisOhneSteuer | GesamtPreisOhneSteuer | |
TotalTax | GesamtSteuerBetrag |
Anpassungen der Datenzuordnung bei APIcenter: Flexibilität für Ihren Arbeitsprozess
Als Benutzer von APIcenter haben Sie die Möglichkeit, Anpassungen an der Datenzuordnung Ihres Datenflusses vorzunehmen. Obwohl APIcenter sich bemüht, beide Seiten der Verknüpfung so gut wie möglich auszufüllen, kann es sein, dass einige Felder nicht nahtlos in unser standardisiertes Datenmodell passen. Außerdem können in der Kundenumgebung benutzerdefinierte Felder erstellt worden sein, die APIcenter möglicherweise nicht identifizieren konnte. In solchen Situationen bieten wir die Möglichkeit, die zusammengeführten Datenzuordnungen auf einer Flow-by-Flow-Basis zu ändern. Ein konkretes Beispiel hierfür ist, wenn ein Kunde es vorzieht, dass der Titel eines Produkts mit dem Feld ‘ProductDescription’ anstelle von ‘Name’ verknüpft wird. Eine mögliche Änderung der Datenzuordnung würde wie folgt aussehen:
Webshop-Feld | Feld APIcenter | Feld Buchhaltung |
Produktname | Name | ProduktBeschreibung |
Um den Anpassungsprozess zu erleichtern, haben wir alle möglichen (Standard-)Feldnamen hinzugefügt, die wir kennen oder finden konnten. Wenn Sie mit der Eingabe in das Eingabefeld beginnen, sucht APIcenter automatisch nach möglichen Feldern, die relevant sein könnten.
Benutzerdefinierte Anwendungsfelder
Bei benutzerdefinierten Feldern, die möglicherweise in der Anwendung des Kunden eingestellt sind, wissen wir nicht automatisch von ihrer Existenz. Wenn Ihnen jedoch der Programmiername eines solchen benutzerdefinierten Feldes bekannt ist (möglicherweise in der Anwendung sichtbar), können Sie es ganz einfach zum Daten-Mapping hinzufügen.
Benutzerdefinierte/freie Felder
Für Felder, die im Standardmodell von APIcenter keinen Platz haben, führen wir‘benutzerdefinierte Felder‘ (Custom Fields) ein. In diesem Abschnitt können Sie beliebige Felder auf beiden Seiten hinzufügen. Dies kann folgendermaßen aussehen:
Webshop-Feld | Feld APIcenter | Feld Buchhaltung |
BenutzerdefiniertesFeld1 | CustomFields.freeStringField0 | BenutzerdefiniertesFeld2 |
CustomFields.freeStringField9 | ||
CustomFields.freeValueField0 | ||
CustomFields.freeValueField9 |
Beachten Sie, dass wir zwei Arten von freien Feldern anbieten: ‘String’ für Felder mit Text und ‘Wert’ für numerische Felder. Dies gibt Ihnen die Freiheit, die Datenzuordnung anzupassen und eine nahtlose Integration zu erreichen, die Ihren speziellen Anforderungen entspricht.
Fazit
Für APIcenter ist das Datenmapping ein sehr wichtiger Teil des Gesamtprozesses. Der Prozess des Datenmappings ermöglicht es uns, dass mehrere Anwendungen reibungslos miteinander kommunizieren. Da die Felder miteinander verknüpft sind, wird das Ergebnis nach einer Einrichtung immer das gleiche sein. Das schafft Stabilität, reduziert Fehler und gibt Zeit für wichtigere Aufgaben frei.