Zum Inhalt springen

API-Connector für Jitterbit Integration Studio

Zusammenfassung

Der API-Connector stellt eine Operation oder eine Gruppe von Operationen als konsumierbaren REST-Endpunkt zur Verfügung. Er kommt mit einer vorkonfigurierten Verbindung, die keine Verbindungs-Konfiguration erfordert, wie es für die meisten Harmony-Connectoren typisch ist. Diese Verbindung bietet Zugriff auf API-Aktivitäten, die, einmal konfiguriert, mit benutzerdefinierten APIs interagieren, die im Jitterbit API Manager konfiguriert sind.

Der API-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Für Informationen über die Beziehung zwischen API-Connector-Aktivitäten und API Manager APIs siehe diese Ressourcen:

Wichtig

Standardmäßig werden erfolgreiche API-Operationen (konfiguriert für benutzerdefinierte APIs oder OData-Dienste) nicht in den Betriebsprotokollen aufgeführt, es sei denn, eine dieser Einstellungen ist aktiviert:

  • Cloud-Agenten: Für API-Operationen auf einem Cloud-Agenten muss das Betriebs-Debug-Protokoll für die Operation aktiviert sein.
  • Private Agenten: Für API-Operationen auf einem privaten Agenten muss entweder das Betriebs-Debug-Protokoll für die Operation aktiviert sein oder EnableLogging=true im Abschnitt [APIoperation] der Konfigurationsdatei des privaten Agenten gesetzt werden.

  • Connector-Übersicht

    Dieser Connector ist dafür gedacht, in Verbindung mit einer API Manager benutzerdefinierten API verwendet zu werden, um eine Operation oder eine Gruppe von Operationen als konsumierbaren REST-Endpunkt bereitzustellen.

    Aktivitätstypen werden verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einer Operation bereitzustellen) oder Ziele (um Daten in einer Operation zu konsumieren) gedacht sind.

    Zusammen werden die vorkonfigurierte API-Verbindung und ihre Aktivitäten als API-Endpunkt bezeichnet:

    API-Aktivitätstypen

    • Anfrage: Diese Aktivität wird unter Verwendung eines JSON-, XML-, CSV- oder XSD-Schemas konfiguriert und ruft Daten ab, wenn sie von einer API Manager benutzerdefinierten API aufgerufen wird. Sie ist als Quelle gedacht, um Daten für eine Operation bereitzustellen.

    • Antwort: Diese Aktivität wird unter Verwendung eines JSON-, XML-, CSV- oder XSD-Schemas konfiguriert und gibt Daten an eine API Manager benutzerdefinierte API zurück. Sie ist als Ziel gedacht, um Daten in einer Operation zu konsumieren.

    • SOAP-Anfrage: Diese Aktivität wird unter Verwendung eines WSDL-Schemas konfiguriert und ruft Daten ab, wenn sie von einer API Manager benutzerdefinierten API aufgerufen wird. Sie ist als Quelle gedacht, um Daten für eine Operation bereitzustellen.

    • SOAP-Antwort: Diese Aktivität wird unter Verwendung eines WSDL-Schemas konfiguriert und gibt Daten an eine API Manager benutzerdefinierte API zurück. Sie ist als Ziel gedacht, um Daten in einer Operation zu konsumieren.

    Hinweis

    Dieser Connector ist ein nativer Integration Studio-Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an Connectors kommuniziert werden. Der Veröffentlichungszeitplan für native Integration Studio-Connectoren basiert auf dem Rhythmus der Webanwendungen des Harmony-Portals.

    API Jitterbit-Variablen

    Diese Jitterbit-Variablen sind speziell für die Verwendung mit API-Endpunkten vorgesehen:

    Fehlerbehebung

    Wenn Probleme mit dem API-Connector auftreten, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

    1. Stellen Sie sicher, dass die API-Verbindung erfolgreich ist, indem Sie die Test-Schaltfläche im Konfigurationsbildschirm verwenden. Wenn die Verbindung nicht erfolgreich ist, kann der zurückgegebene Fehler einen Hinweis auf das Problem geben.

    2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

    3. Aktivieren Sie das Debug-Protokoll für den Betrieb (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

    4. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.

    5. Für zusätzliche Überlegungen zur Fehlerbehebung siehe Fehlerbehebung bei Operationen.

    6. SOAP-Anforderung und SOAP-Antwortaktivitäten: Wenn Sie einen Vorgang bereitstellen, dessen SOAP-Anforderung oder SOAP-Antwort-Aktivität WSDL-Datei ersetzt wurde, kann dieser Fehler auftreten:

      Bereitstellung fehlgeschlagen - Client-Fehler: Es gibt keine hochgeladene Datei mit dem Client-Pfad ... Aktualisieren Sie auf Studio 8.4.0 oder höher und stellen Sie das Projekt erneut bereit.

      Um das Problem zu lösen, folgen Sie diesen Schritten:

      1. Öffnen Sie die Aktivität, bei der die WSDL-Datei ersetzt wurde.

      2. Wählen Sie im Schritt 1 die WSDL-Datei erneut aus, die für die Aktivität verwendet werden soll, und klicken Sie dann auf Weiter.

      3. Klicken Sie im Schritt 2 auf Fertigstellen.

      4. Stellen Sie den Vorgang bereit.