Auf dieser Seite erhalten Sie eine allgemeine Übersicht über die Datenzuordnung und die verschiedenen Möglichkeiten, die Datenzuordnung in Apigee Integration durchzuführen.
Unternehmensdaten können sich in verschiedenen Quellen und Formaten befinden, was die Integration in ein einheitliches Datenmodell oder eine Datenpipeline erschwert. Beim Datenabgleich werden Daten aus mehreren Quellen extrahiert und standardisiert, um eine Beziehung zwischen ihnen und den zugehörigen Zieldatenfeldern am Ziel herzustellen. Beispiele für die Verwendung von Datenabgleichen in einer Integration:
- Extrahieren von Feldern aus einer komplexen Datenstruktur wie einer JSON.
- Datenquelle dem Zielschema zuordnen.
- Daten durch Anfügen von Transformationsfunktionen transformieren.
- Generieren von Ausgabewerten und Speichern/Verwenden als Integrationsvariablen.
Mit der Apigee-Integration können Sie Datenabgleiche mithilfe der folgenden Aufgaben durchführen:
Aufgabe „Data Transformer-Script“
Die Aufgabe Data Transformer-Script ist eine auf Vorlagen basierende Datenabgleichsfunktion, die in der Apigee-Integration verfügbar ist. Mit der Jsonnet-Konfigurationssprache von Google werden Jsonnet-Vorlagen erstellt und bearbeitet, die die Zuordnungsbeziehungen für die angegebenen Quell- und Zielintegrationsvariablen in Ihrer Integration definieren.
Mit dem Data Transformer-Skript-Editor und den unterstützten Data Transformer-Funktionen können Sie eine benutzerdefinierte Datenzuordnungslogik schreiben, Variablenzuweisungen ausführen und Integrationsvariablen hinzufügen oder ändern.
Die folgende Abbildung zeigt das Beispiellayout für den Skript "Editor" von Data Transformer:
Informationen zum Hinzufügen und Konfigurieren der Aufgabe Data Transformer-Script finden Sie unter Aufgabe des Data Transformer-Scripts.
Aufgabe "Datenabgleich"
Die Aufgabe Datenabgleich ist ein Feature ohne Code ohne Code in Apigee Integration, das einen visuellen Canvas (Datenabgleichs-Editor) zur Ausführung von Datenzuweisungen und Zuordnungen in Ihren Integrationen bietet. Außerdem können Sie Ihre Daten mithilfe der unterstützten Zuordnungsfunktionen in aussagekräftige Variablen/Formate umwandeln, damit sie für die anderen Aufgaben oder Trigger in Ihrer Integration zugänglich sind.
Mit der Aufgabe Datenabgleich können Sie:
- Mit dem Datenabgleichs-Editor können Sie die Variablenzuordnung für einzelne oder verschachtelte Variablen visualisieren und definieren.
- Variablen von einem Datentyp in einen anderen umwandeln. Mit der Aufgabe Datenabgleich können Sie mehrere Abgleichsfunktionen (einschließlich verschachtelter Funktionen) anwenden, um die Variablendaten zu transformieren.
Datenabgleichseditor und Layout
Der Datenabgleichs-Editor bietet einen visuellen Canvas mit den folgenden Integrationselementen:
- Bereich Variablen: Zeigt die verschiedenen Variablentypen an, die für die Integration verfügbar sind:
- Eingaben. Eingabevariablen der Integration.
- Ausgaben. Ausgabevariablen der Integration.
- Lokale Variablen. Variablen, die im Bereich der Integration vorhanden sind.
Wenn keine Variablen aufgelistet sind, klicken Sie auf Hinzufügen +, um eine neue Variable zu konfigurieren.
Klicken Sie auf (Maximieren), um alle Variablen zu maximieren und die verfügbaren Unterfelder dieser Variable aufzurufen. Um nach einer Variablen oder einem Unterfeld aus der verfügbaren Variablenliste zu suchen, klicken Sie auf (Variablen suchen).Weitere Informationen zu Variablen in Apigee-Integrationen finden Sie unter Variablen in Apigee-Integrationen verwenden.
- Spalte Eingabe: Zeigt Zeilen mit Eingabezuordnung an, die die Quelle der Eingabe für die Datenzuordnung enthalten. Die Quelle kann ein Literalwert, eine Basisfunktion oder eine Eingabevariable mit Abgleichsfunktionen sein. Klicken Sie in einer Eingabezuordnungszeile auf Variable oder Wert, um eine Quelle hinzuzufügen.
- Spalte Ausgabe: Zeigt die Zeilen der Ausgabezuordnung mit den zugehörigen Zielvariablen für die jeweilige Eingabezuordnungszeile an. Zielvariablen können für die Zuordnung in nachfolgenden Eingabezeilen verwendet werden. Um eine Ausgabevariable zuzuweisen, können Sie entweder eine neue Variable erstellen oder eine vorhandene Ausgabevariable direkt aus der Spalte Variablen ziehen.
Abgleichsfunktionen
Die Aufgabe Datenabgleich bietet verschiedene vordefinierte Zuordnungsfunktionen, um die Zuordnungsdaten in Ihrer Integration zu transformieren und zu standardisieren. Eine Abgleichsfunktion kann einen oder mehrere Eingabeparameter haben, wobei jeder Parameter einen Literalwert, eine Variable oder eine Basisfunktion mit angewandten Abgleichsfunktionen enthalten kann. Sie können mehrere Abgleichsfunktionen für eine einzelne Eingabequelle verwenden, die einen Transformationsausdruck bilden.
Der Enddatentyp einer Eingabequelle basiert auf dem Rückgabetyp des Transformationsausdrucks, der in der jeweiligen Eingabezeile der Datenzuordnung definiert ist. Wenn im Rückgabetyp der Rückgabetyp der entsprechenden Zielvariable für die Ausgabe zurückgegeben wird, wird im Feld Datenabgleichs-Editor unter der Eingabezeile der entsprechenden Datenzuordnung ein Validierungsfehler angezeigt.
Ausdruck anpassen
Ein Transformationsausdruck ist eine Kombination aus mehreren Abgleichsfunktionen, die entweder nacheinander oder in einer verschachtelten Struktur verkettet sind. Mit dem Datenabgleichseditor können Sie Funktionen oder Funktionsparameter in einem definierten Transformationsausdruck einfach einfügen, ändern oder entfernen. Wenn der definierte Transformationsausdruck ungültig ist, wird im Datenabgleichseditor neben der jeweiligen Funktion oder dem Funktionsparameter, der den Fehler im Ausdruck verursacht, ein Validierungsfehler angezeigt. Um die vollständige Fehlermeldung zu sehen, bewegen Sie den Mauszeiger auf das Validierungsfehlersymbol .
Die folgende Abbildung zeigt einen Beispielabgleich mit Validierungsfehlern im Datenabgleichseditor:
Weitere Informationen zum Konfigurieren eines Abgleichs in einer Datenabgleichsaufgabe finden Sie unter Abgleich hinzufügen.
Informationen zu den unterstützten vordefinierten Abgleichsfunktionen in Apigee Integration finden Sie unter Unterstützte Datentypen und Abgleichsfunktionen.
Zuordnungsreihenfolge
Im Datenabgleichseditor angegebene Zuordnungen werden von oben nach unten ausgeführt. Im vorherigen Bild wirdNum1 beispielsweise in der ersten Zeile Num1ToInt zugeordnet, sodass Num1ToInt in den nachfolgenden Zeilen für den Abgleich verfügbar ist.