Aufgabe "Datenabgleich"

Mit der Aufgabe Datenabgleich können Sie Variablenzuweisungen in Ihrer Integration ausführen, Attribute von JSON-Objekten abrufen und festlegen sowie verschachtelte Transformationsfunktionen auf Werte anwenden. Die Variablen können Integrationsvariablen oder Aufgabenvariablen sein.

Sie können beispielsweise Werte aus der Integrationsvariablen X der Aufgabenvariablen Y oder aus der Aufgabenvariablen Y der Integrationsvariable X zuweisen. Weitere Informationen zu Variablen in Apigee-Integrationen finden Sie unter Variablen in Apigee-Integrationen verwenden.

Aufgabe "Datenabgleich" konfigurieren

Führen Sie die folgenden Schritte aus, um eine Aufgabe Datenabgleich zu konfigurieren:

  1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
  2. Klicken Sie auf Entwickeln > Integrationen.
  3. Wählen Sie eine vorhandene Integration aus oder erstellen Sie eine neue Integration, indem Sie auf Integration erstellen klicken.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus.
    3. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationsdesigner geöffnet.

  4. Klicken Sie in der Navigationsleiste Integrationsdesigner auf + Aufgabe/Trigger hinzufügen > Aufgaben, um die Liste der verfügbaren Aufgaben aufzurufen.
  5. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
  6. Klicken Sie auf das Element Datenabgleich des Designers, um den Konfigurationsbereich der Aufgabe Datenabgleich aufzurufen.
  7. Klicken Sie auf Datenabgleichseditor öffnen, um die Standardwerte der Aufgabe anzusehen und eine neue Zuordnung hinzuzufügen. Ausführliche Schritte zum Hinzufügen eines Abgleichs finden Sie unter Zuordnung hinzufügen.

    Weitere Informationen zum Datenzuordnungseditor-Layout finden Sie unter Datenzuordnung – Übersicht.

Zuordnung hinzufügen

Führen Sie die folgenden Schritte aus, um einen Abgleich hinzuzufügen:

  1. Klicken Sie im Konfigurationsbereich der Aufgabe "Datenabgleich" auf Datenabgleichseditor öffnen.
  2. Konfigurieren Sie die Zuordnung Eingabe:
    1. Ziehen Sie eine Variable oder ein untergeordnetes Feld aus der Liste Variablen in die Zeile Eingabe. Klicken Sie neben der Variablen in der Liste Variablen auf (Maximieren), um die verfügbaren Unterfelder einer Variablen aufzurufen.
    2. Alternativ können Sie in der Zeile Eingabe auf Variable oder Wert klicken und Folgendes tun:
      • Wählen Sie Variable aus, um eine vorhandene Variable zu suchen und zu verwenden. Klicken Sie zum Erstellen einer neuen Variablen auf + Neue Variable hinzufügen und geben Sie den Namen und den Datentyp der neuen Variablen ein.
      • Wählen Sie Wert aus, um einen Literalwert vom Typ string, integer, double oder Boolean einzugeben.
      • Wählen Sie Funktion aus, um eine Basisfunktion zu suchen und zu verwenden.

        Eine Basisfunktion wird zum Abrufen oder Generieren von Werten während der Ausführung einer Integration verwendet. Beispiel: Generieren einer zufälligen UUID oder Abrufen der aktuellen Integrationsregion. Informationen zu den unterstützten Basisfunktionen finden Sie unter Unterstützte Basisfunktionen.

      • Klicken Sie auf Speichern.
    3. Klicken Sie auf + (Funktion hinzufügen) für eine Eingabevariable, einen Wert oder eine Basisfunktion in der Zeile Eingabe, um eine Abgleichsfunktion aus der Liste der verfügbaren Abgleichsfunktionen hinzuzufügen. Eine Zuordnungsfunktion kann einen oder mehrere Parameter haben. Jeder Parameter kann außerdem einen Wert, eine Variable oder eine Basisfunktion gefolgt von einer Kette von Zuordnungsfunktionen haben.
      • Wenn Sie eine verschachtelte Funktion hinzufügen möchten, klicken Sie neben dem Parameter der Funktion auf + (Funktion hinzufügen). Wenn Sie die zuletzt hinzugefügte Funktion entfernen oder löschen möchten, klicken Sie auf (Vorherige Funktion löschen).
      • Wenn Sie eine Funktion zwischen einem Zuordnungsausdruck hinzufügen, entfernen oder ändern möchten, klicken Sie auf eine Funktion und wählen Sie Funktion hinzufügen, Funktion entfernen oder Funktion ändern aus dem Drop-down-Menü aus.

        • Weitere Informationen zu Abgleichsfunktionen finden Sie unter Abgleichsfunktionen.

        Informationen zu den unterstützten Abgleichsfunktionen finden Sie unter Unterstützte Datentypen und Abgleichsfunktionen.

      • Wenn Sie eine Variable innerhalb eines Zuordnungsausdrucks entfernen möchten, klicken Sie neben der Variablenzeile auf (Entfernen).
      • Zum Entfernen der gesamten Zeile Eingabe Klicken Sie in der Zeile auf (Löschen).
  3. Konfigurieren Sie die Zuordnung Ausgabe:
    1. Ziehen Sie eine Variable aus der Liste Variablen in die Zeile Ausgabe. Wenn die Variable nicht verfügbar ist, klicken Sie auf Neue erstellen, um den Namen und den Datentyp der neuen Variable zu konfigurieren. Optional können Sie auf die Ausgabevariable klicken und auswählen, ob diese Variable als Ausgabe der Integration oder als Eingabe für eine andere Integration verwendet werden soll.
    2. Klicken Sie zum Entfernen der Ausgabevariable auf (Löschen).
  4. (Optional) Klicken Sie zum Löschen einer Abgleichszeile auf (Diesen Abgleich löschen).
  5. Schließen Sie den Datenableichseditor, sobald die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

Der vollständige Datenabgleich kann, wie in der folgenden Abbildung dargestellt, im Konfigurationsbereich für die Aufgabe Datenabgleich angezeigt werden:

Abbildung mit Datenabgleichseditor Abbildung mit Datenabgleichseditor

Unterstützte Datentypen und Abgleichsfunktionen

Apigee Integration unterstützt die folgenden Datentypen für Variablen in der Aufgabe Datenabgleich:

  • String und String-Array
  • Ganzzahl und Ganzzahl-Array
  • Double und Double-Array
  • Boolesch und boolesches Array
  • JSON
In der folgenden Tabelle sind die Funktionen für den Datenabgleich aufgeführt, die für jeden Datentyp verfügbar sind.
Datentyp Unterstützte Abgleichsfunktionen
Boolesch AND, EQUALS, NAND, NOR, NOT, OR, TO_JSON, TO_STRING, XNOR, XOR
Boolesches Array APPEND, APPEND_ALL, CONTAINS, FILTER, FOR_EACH, GET, REMOVE, REMOVE_AT, SET, SIZE, TO_JSON, TO_SET
Double ADD, DIVIDE, CEIL, EQUALS, EXPONENT, GREATER_THAN, GREATER_THAN_EQUAL_TO, FLOOR, LESS_THAN, LESS_THAN_EQUAL_TO, MOD, MULTIPLY, ROUND, SUBTRACT, TO_JSON, TO_STRING
Double-Array APPEND, APPEND_ALL, AVG, CONTAINS, FILTER, FOR_EACH, GET, MAX, MIN, REMOVE, REMOVE_AT, SET, SIZE, SUM, TO_JSON, TO_SET
Ganzzahl ADD, DIVIDE, EPOCH_TO_HUMAN_READABLE_TIME, EQUALS, EXPONENT, GREATER_THAN, GREATER_THAN_EQUAL_TO, LESS_THAN, LESS_THAN_EQUAL_TO, MOD, MULTIPLY, SUBTRACT, TO_DOUBLE, TO_JSON, TO_STRING
Ganzzahl-Array APPEND, APPEND_ALL, AVG, CONTAINS, FILTER, FOR_EACH, GET, MAX, MIN, REMOVE, REMOVE_AT, SET, SIZE, SUM, TO_JSON, TO_SET
JSON APPEND_ELEMENT, FLATTEN, FILTER, FOR_EACH, GET_ELEMENT, GET_PROPERTY, MERGE, REMOVE_PROPERTY, RESOLVE_TEMPLATE, SET_PROPERTY, SIZE, TO_BOOLEAN, TO_BOOLEAN_ARRAY, TO_DOUBLE, TO_DOUBLE_ARRAY, TO_INT, TO_INT_ARRAY, TO_STRING, TO_STRING_ARRAY
String CONCAT, CONTAINS, DECODE_BASE64_STRING, EQUALS, EQUALS_IGNORE_CASE, LENGTH, REPLACE_ALL, RESOLVE_TEMPLATE, SPLIT, SUBSTRING, TO_BASE_64, TO_BOOLEAN, TO_DOUBLE, TO_INT, TO_JSON, TO_LOWERCASE, TO_UPPERCASE
String-Array APPEND, APPEND_ALL, CONTAINS, FILTER, FOR_EACH, GET, REMOVE, REMOVE_AT, SET, SIZE, TO_JSON, TO_SET
Weitere Informationen zu den einzelnen Datenabgleichsfunktionen finden Sie unter Referenz zu Datenabgleichsfunktionen.

Unterstützte Basisfunktionen

In der folgenden Tabelle sind die verfügbaren Funktionen für die Datenzuordnung aufgeführt:
Datentyp Unterstützte Basisfunktionen
Ganzzahl NOW_IN_MILLIS
Ganzzahl-Array INT_LIST
String GENERATE_UUID, GET_EXECUTION_ID, GET_INTEGRATION_NAME, GET_INTEGRATION_REGION, GET_PROJECT_ID
Weitere Informationen zu den einzelnen Datenabgleichsfunktionen finden Sie unter Referenz zu Datenabgleichsfunktionen.

Best Practices

Die Aufgabe Datenabgleich kann eine leistungsstarke Möglichkeit sein, Schlüsselvariablen zu transformieren und an verschiedene Aufgaben in der Integration zu übergeben. Hier sind einige Tipps, die Sie bei der Erstellung der Integration beachten sollten:

  • Zuordnungen werden von oben nach unten ausgeführt. Das heißt, wenn die Eingabevariable A in der ersten Zeile einer Ausgabevariable B zugeordnet ist, steht die Variable B in den nachfolgenden Zeilen für den Abgleich zur Verfügung.
  • In jeder Zeile muss der Datentyp der Zeile Eingabe mit dem Datentyp der Zeile Ausgabe übereinstimmen. Verwenden Sie zum Umwandeln von Typen Transformationsfunktionen wie TO_STRING, TO_INT usw.
  • Es gibt keine Einschränkungen im Hinblick auf die Länge der Transformationsverkettung. Allerdings kann das Debuggen großer verketteter Transformationen schwierig sein. Wir empfehlen, Eingabetransformationen lesbar zu halten und komplexe Transformationen auf mehrere Zeilen aufzuteilen.
  • Wenn eine Zuordnung einen Fallback-Wert erfordert, legen Sie einen Fallback-Wert für den Abgleich fest. Wenn Sie keinen Fallback-Wert angeben, gibt der Abgleich einen Fehler zurück, wenn der Eingabewert oder die Transformation null zurückgibt.
  • Achten Sie beim Löschen einer Variable darauf, dass Sie alle Zuordnungen löschen, in denen sie enthalten ist.

Informationen zu den Nutzungslimits für die Aufgabe Datenabgleich finden Sie unter Nutzungslimits.

Hinweise

Bei JSON-Variablen interpretiert Apigee Integration das untergeordnete Attribut der Variable in den folgenden Fällen als JSON-Typ, wenn ein JSON-Schema verwendet wird:

  • Wenn der Typ des untergeordneten Attributs „null” angibt, Beispiel: 
    {
  "properties": {
    "PersonID": {
      "type": [
        "double",
        "null"
      ],
      "readOnly": false
    }
  }
}
  • Wenn der Typ des untergeordneten Attributs mehrere Datentypen angibt. Beispiel: 
    {
  "properties": {
    "PersonID": {
      "type": [
        "integer",
        "string",
        "number"
      ],
      "readOnly": false
    }
  }
}

In diesen Fällen müssen Sie die untergeordneten Variablen mithilfe der Datenzuordnungsfunktionen explizit in den gewünschten Typ konvertieren.

Die folgenden Beispiele veranschaulichen die verschiedenen Arten von Attributdeklarationen und zeigen, wie Sie mit den Datenzuordnungsfunktionen den gewünschten Typ abrufen:

Beispiel 1

{
  "type": "object",
  "properties": {
    "dbIntegers": {
      "type": "array",
      "items": {
        "type": [
          "integer",
          "null"
        ]
      }
    },
    "dbBooleans": {
      "type": [
        "array"
      ],
      "items": {
        "type": "boolean"
      }
    }
  }
}
Apigee Integration interpretiert dbIntegers als JSON-Typ und dbBooleans als BOOLEAN_ARRAY-Typ.

So konvertieren Sie dbIntegers: 

dbIntegers.TO_INT_ARRAY()

Beispiel 2

{
  "type": "object",
  "properties": {
    "dbId": {
      "type": [
        "number",
        "null"
      ],
      "readOnly": false
    },
    "dbStatus": {
      "type": [
        "boolean",
        "null"
      ],
      "readOnly": false
    }
  }
}
 Apigee Integration erkennt sowohldbId als auch dbStatus als JSON-Typen, aber dbId ist ein Parameter, der einen einzelnen doppelten Wert oder einen Nullwert annehmen kann, und dbStatus ist ein Parameter, der einen einzelnen Boolean-Wert oder ein Nullwert annehmen kann.

So konvertieren Sie dbId und dbStatus: 

dbId.TO_DOUBLE()
 
dbStatus.TO_BOOLEAN()

Beispiel 3

{
  "type": "object",
  "properties": {
    "dbString": {
      "type": [
        "string"
      ],
      "readOnly": false
    }
  }
}
 Apigee Integration erkennt dbString als Stringtyp..

Fehlerbehebungsstrategie

Eine Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt. Informationen zur Verwendung einer Fehlerbehandlungsstrategie und zu den verschiedenen Arten von Fehlerbehandlungsstrategien finden Sie unter Strategien zur Fehlerbehebung.