Diese Seite wurde von der Cloud Translation API übersetzt.

Informationen zu den unterstützten Connectors für Application Integration.

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 Application Integration finden Sie unter Variablen in Application Integration verwenden.

Aufgabe "Datenabgleich" konfigurieren

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

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zu „Application Integration“
Klicken Sie im Navigationsmenü auf Integrationen.
Die Seite Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, die im Google Cloud-Projekt verfügbar sind.
Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.
Wenn Sie eine neue Integration erstellen, gehen Sie so vor:
1. Geben Sie im Bereich Integration erstellen einen Namen und eine Beschreibung ein.
2. Wählen Sie eine Region für die Integration aus.
  Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ändern oder aktualisieren.
  Hinweis:Die Option zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrationsverwaltung für die ausgewählte Region aktiviert haben.
4. Klicken Sie auf Erstellen.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgaben, um eine Liste der verfügbaren Aufgaben und Verbindungen aufzurufen.
Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
Klicken Sie auf das Element Datenabgleich des Designers, um den Konfigurationsbereich der Aufgabe Datenabgleich aufzurufen.
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:

Klicken Sie im Konfigurationsbereich der Aufgabe "Datenabgleich" auf Datenabgleichseditor öffnen.
Konfigurieren Sie die Zuordnung Eingabe:
Eingabe: Die Quelle der Datenzuordnungseingabe. Die Quelle kann ein Literalwert, eine Basisfunktion oder eine Eingabevariable mit Abgleichsfunktionen sein.
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.
  - 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).
Konfigurieren Sie die Zuordnung Ausgabe:
Ausgabe: Zielvariable für die Datenzuordnungsausgabe. Zielvariablen können für die Zuordnung in nachfolgenden Eingabezeilen verwendet werden.
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. Wenn Sie die Ausgabevariable entfernen möchten, klicken Sie auf (Löschen).
(Optional) Klicken Sie zum Löschen einer Abgleichszeile auf (Diesen Abgleich löschen).
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

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 Application 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"
      }
    }
  }
}

Application 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
    }
  }
}

Application Integration erkennt sowohl dbId 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
    }
  }
}

Application 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.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.