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

Funktionstests

In diesem Dokument werden Funktionstests in Application Integration beschrieben. Außerdem erfahren Sie, wie Sie Funktionstests für Ihre Integrationen erstellen und verwalten. Durch das Testen des Integrationsablaufs kannst du prüfen, ob die Integration wie vorgesehen funktioniert.

Überblick

Mit funktionalen Tests können Sie mehrere Tests für Ihre komplexen Integrationen erstellen und ausführen, die Google Cloud-Dienste und andere Geschäftsanwendungen verbinden und verwalten. Durch das Testen des Integrationsablaufs kannst du prüfen, ob die Integration wie vorgesehen funktioniert. Sie können Ihre Integration mit verschiedenen Eingabevariablen testen, um die Fehler im Integrationsablauf zu identifizieren.

Konfigurationen testen

Mit Application Integration kannst du mehrere Testläufe für deine Integration hinzufügen. Bei Triggern können Sie die Eingabewerte in einem Testfall konfigurieren. Für Tasks können Sie die folgenden Testkonfigurationen aktualisieren:

Simulierter Strategietyp:Es gibt drei Optionen, die Sie für Ihre Aufgabe festlegen können:
- Beispiel:Mit dieser Strategie können Sie die Aufgabe ausführen und Assertions für die Aufgabe hinzufügen.
- Mock-Ausführung:Mit dieser Strategie können Sie simulieren, ob Ihre Aufgabe erfolgreich ausgeführt oder fehlgeschlagen ist.
- Simulierte Ausgabe:Mit dieser Strategie können Sie die Ausgabe der Aufgaben für den nächsten Knoten in der Integration simulieren.
Assertion type (Assertion-Typ): Sie können für eine ausgewählte Aufgabe in einem Test mehrere Assertions hinzufügen. Es gibt verschiedene Assertion-Typen:
- Assertausführung:Mit diesem Assertion-Typ können Sie prüfen, ob die Task erfolgreich ausgeführt wurde.
- Assert-Parameter:Mit diesem Assertion-Typ können Sie den Parameter auswählen, den Sie bestätigen möchten, und einen Wert für den Vergleich angeben.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Application Integration Editor (roles/integrations.integrationEditor) für das Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Erstellen und Verwalten von Funktionstests benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Prüfen Sie, ob Sie eine Integration erstellt haben.

Funktionstest erstellen

Wählen Sie eine der folgenden Optionen aus, um einen Funktionstest zu erstellen:

Console

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zur Seite „Application Integration“
Klicken Sie im Navigationsmenü auf Integrations (Integrationen).
Die Seite Integrationen wird angezeigt. Dort sind alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.
Wählen Sie eine vorhandene Integration aus, für die Sie einen Test erstellen möchten.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie auf das Menü „Aktionen“ more_vert und dann auf Funktionstest erstellen. Führen Sie im Bereich Funktionstest erstellen die folgenden Schritte aus:
1. Wählen Sie in der Liste Trigger einen Trigger aus.
2. Geben Sie in das Feld Testname einen Namen für den Test ein.
3. Geben Sie in das Feld Beschreibung eine Beschreibung für den Test ein.
4. Klicken Sie auf Erstellen.
  Auf der Seite des Integrationseditors wird im Designer-Canvas der Modus Funktionaler Testmodus:an angezeigt. In der folgenden Abbildung wird der Bereich Funktionstest erstellen angezeigt:
  
  Hinweis:Du kannst deine Integration im Modus für Funktionstests nicht bearbeiten.
Konfigurieren Sie die Testkonfiguration für den Trigger und die Aufgaben.

API

Verwende die Methode CreateTestCase, um einen Testlauf für eine Integrationsversion hochzuladen:

    curl -v -s -X POST
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer $(gcloud auth print-access-token) \
        -d 'TEST_CASE_JSON' \
        'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/PROJECT_LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION/testCases'

Ersetzen Sie TEST_CASE_JSON durch den Text Ihres Testlaufs:

    '{"display_name":"TEST_CASE_NAME", "workflow_id":"INTEGRATION_VERSION", "trigger_id":"TRIGGER_ID"}'

Die folgenden Felder im Text des Testlaufs sind Pflichtfelder:

TEST_CASE_NAME: der Name des Testlaufs
INTEGRATION_VERSION: die Version deiner Integration
TRIGGER_ID: die ID des API-Triggers in Ihrer Integration

Testkonfigurationen für Trigger konfigurieren

So konfigurieren Sie die Testkonfigurationen für den Trigger:

Rufen Sie in der Google Cloud Console die Seite Integrationen auf.
Zur Integration
Wählen Sie eine vorhandene Integration mit einem Funktionstest aus.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie auf das Menü „Aktionen“ more_vert und dann auf Funktionstest ansehen.
Auf der Seite des Integrationseditors wird im Designer-Canvas der Modus Funktionaler Testmodus:an angezeigt. Die folgende Abbildung zeigt den Bereich Test configuration (Konfiguration testen) für den Trigger:
Klicken Sie auf der Seite des Integrationseditors auf den Trigger, um den Bereich für die Triggerkonfiguration zu öffnen. Gehen Sie dann so vor:
- Wenn Sie Eingabevariablen für die Integration haben, werden diese auf dem Tab Testkonfiguration angezeigt. Die Werte, die Sie in die Variablen eingeben, werden automatisch gespeichert.
- Klicken Sie auf den Tab Triggereigenschaften, um die Triggerattribute aufzurufen.

Testkonfigurationen für Aufgaben konfigurieren

So konfigurieren Sie die Testattribute für die Integrationsaufgabe:

Rufen Sie in der Google Cloud Console die Seite Integrationen auf.
Zur Integration
Wählen Sie eine vorhandene Integration mit einem Funktionstest aus.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie auf das Menü „Aktionen“ more_vert und dann auf Funktionstest ansehen.
Auf der Seite des Integrationseditors wird im Designer-Canvas der Modus Funktionaler Testmodus:an angezeigt.
Klicken Sie auf der Seite des Integrationseditors auf die Aufgabe, um den Bereich für die Testkonfiguration zu öffnen. Die folgende Abbildung zeigt den Bereich Testkonfiguration für die Aufgabe:

Führen Sie auf dem Tab Testkonfiguration die folgenden Schritte aus:
1. Wählen Sie unter Mock-Strategietyp eine der folgenden Strategien aus:
  - Wenn Sie Kein Modell auswählen, wird Ihre Aufgabe gemäß der Aufgabenvorlage vom Hauptworkflow ausgeführt. Standardmäßig wird für Aufgaben der Strategietyp Kein Mock ausgewählt.
  - Wenn Sie Mock‐Ausführung auswählen, müssen Sie für Mock‐Ausführungsstatus eine der folgenden Optionen auswählen:
    - Überspringen
    - Fehler
  - Wenn Sie Mock Output auswählen, müssen Sie unter Task Output list die Ausgabe der Aufgaben für den nächsten Knoten in der Integration bereitstellen.
2. Führen Sie im Abschnitt Assertion-Strategie die folgenden Schritte aus:
  1. Wählen Sie im Feld Assertion type (Assertion-Typ) eine der folgenden Optionen aus:
    - Wenn Sie Ausführungsstatus festlegen auswählen, wählen Sie für Auszuführender Ausführungsstatus eine der folgenden Optionen aus:
      - Erfolg
      - Fehler
      - Nicht ausgeführt
    - Wenn Sie Parameter bestätigen auswählen, gehen Sie so vor:
      1. Wählen Sie unter Zu bestätigende Parameter aus, ob Sie Parameter einschließlich Eingabe- und Ausgabeparameter bestätigen möchten.
      2. Wählen Sie den Operator aus, um den bestätigten Parameter mit dem eingegebenen Wert zu vergleichen. Die Vorgänge zum Vergleichen des bestätigten Parameters können einer der folgenden sein:
        
        Ist gleich
        
        Ungleich
        
        Enthält
      3. Geben Sie in das Feld Wert den Wert ein, mit dem der Parameter verglichen werden soll.
  2. Optional: Klicken Sie auf + Assertion hinzufügen, um weitere Assertions hinzuzufügen.

Funktionstest ausführen

So führen Sie einen Funktionstest durch:

Rufen Sie in der Google Cloud Console die Seite Integrationen auf.
Zur Integration
Wählen Sie die Integration aus, für die Sie den Funktionstest ausführen möchten.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie auf das Menü „Aktionen“ more_vert und dann auf Funktionstest ansehen.
Auf der Seite des Integrationseditors wird im Designer-Canvas der Modus Funktionaler Testmodus:an angezeigt.
Wähle aus der Liste Test den Testlauf aus, den du ausführen möchtest.
Klicken Sie auf Testen. Die Seite Test Integration (Integration testen) wird angezeigt. Gehen Sie dann so vor:
1. Geben Sie auf der Seite Test Integration (Einbindung testen) die Ausführungszeit ein.
2. Klicken Sie auf Integration testen.
  Sie können Logs für Ihre Funktionstests aufrufen. Klicken Sie auf Logs aufrufen, um die Ausführungslogs des Testlaufs zu prüfen und aufzurufen.

Testläufe herunterladen

So lädst du einen Testlauf für eine Integrationsversion herunter:

Verwenden Sie die Methode listTestCase, um Testläufe aufzulisten und die TEST_CASE_ID abzurufen:

  curl -v -s
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $(gcloud auth print-access-token) \
      'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/PROJECT_LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION/testCases'

Kopiere in der Antwort die TEST_CASE_ID deines Testlaufs, den du herunterladen möchtest.

Verwenden Sie die Methode GetTestCase, um einen Testlauf herunterzuladen:

  curl -v -s
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $(gcloud auth print-access-token) \
      'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/PROJECT_LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION/testCases/TEST_CASE_ID'

Ersetzen Sie TEST_CASE_ID durch die ID Ihres Testlaufs, die Sie im vorherigen Schritt kopiert haben.

Testausführungen auflisten

Auf der Seite Logs finden Sie eine Liste der Testausführungen. Führen Sie dazu die folgenden Schritte aus:

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zur Seite „Application Integration“
Klicken Sie im Navigationsmenü auf Logs.
Fügen Sie im Feld Filter einen Filter für den Integrationsnamen im folgenden Format hinzu:
Integration name:INTEGRATION_NAME:TEST_CASE_NAME.

Ersetzen Sie Folgendes:
- INTEGRATION_NAME: der Name der Integration, die Funktionstests enthält.
- TEST_CASE_NAME: Der Name des Testlaufs, für den Sie die Testausführungen auflisten möchten.

Funktionstest löschen

So rufen Sie einen Funktionstest auf:

Rufen Sie in der Google Cloud Console die Seite Integrationen auf.
Zur Integration
Wählen Sie eine vorhandene Integration aus, für die Sie einen Test erstellen möchten.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie auf das Menü „Aktionen“ more_vert und dann auf Funktionstest ansehen.
Auf der Seite des Integrationseditors wird im Designer-Canvas der Modus Funktionaler Testmodus:an angezeigt.
Wähle aus der Liste Test den Testlauf aus, den du löschen möchtest.
Klicken Sie auf Löschen.

Preise

Für die Verwaltung von Funktionstests fallen keine zusätzlichen Kosten an. Weitere Informationen zu Preisen finden Sie unter Application Integration – Preise.

Beschränkungen

Funktionstests unterliegen den folgenden Einschränkungen:

Testläufe werden beim Klonen einer Integration nicht geklont. Du musst Testläufe für verschiedene Integrationsversionen manuell erstellen.
Sie können keine Assertions zu Triggern für Ausgabevariablen hinzufügen. Zur Umgehung dieses Problems können Sie Assertions zur letzten für Ausgabevariablen ausgeführten Aufgabe hinzufügen.