Cloud Datastore-Connector

Zusammenfassung

Der Cloud Datastore-Connector stellt Zugriff auf Jitterbit Cloud Datastore bereit.

Der Cloud Datastore-Connector bietet eine Schnittstelle zum Erstellen einer Cloud Datastore-Verbindung, die Grundlage für die Generierung von Cloud Datastore-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit Cloud Datastore.

Der Cloud Datastore-Connector wird über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Cloud Datastore-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte Cloud Datastore-Verbindung und ihre Aktivitäten als Cloud Datastore-Endpunkt bezeichnet:

• Get Metrics: Ruft Nutzungsdaten für einen Statuspeicher oder Schlüsselspeicher in Cloud Datastore ab und soll als Quelle in einem Vorgang verwendet werden.

• Create Storage: Erstellt einen neuen Statuspeicher oder Schlüsselspeicher in Cloud Datastore und soll als Ziel in einem Vorgang verwendet werden.

• Delete Storage: Löscht einen Statuspeicher oder Schlüsselspeicher aus Cloud Datastore und soll als Ziel in einem Vorgang verwendet werden.

• Query Items (Deprecated): Liest Daten aus einem Statuspeicher oder Schlüsselspeicher in Cloud Datastore und soll als Quelle in einem Vorgang verwendet werden.

  Warnung

  Die Aktivität Query Items (Deprecated) ist veraltet und wird nicht mehr unterstützt. In einer zukünftigen Version wird diese Aktivität dauerhaft entfernt. Sie wurde in der Version 11.47 durch die neu gestaltete Aktivität Query Items ersetzt, deren vereinfachte Antwortstruktur dafür sorgt, dass die einzelnen Felder, die Sie auf der Seite Cloud Datastore der Management Console definieren, direkt auf der obersten Ebene der Antwort zurückgegeben werden.

• Insert Items: Fügt neue Daten in einen Statuspeicher oder Schlüsselspeicher in Cloud Datastore ein und soll als Ziel in einem Vorgang verwendet werden.

• Query Items: Liest Daten aus einem Statuspeicher oder Schlüsselspeicher in Cloud Datastore und soll als Quelle in einem Vorgang verwendet werden.

• Elemente aktualisieren: Aktualisiert vorhandene Daten in einem Statuspeicher oder Schlüsselspeicher innerhalb von Cloud Datastore und ist als Ziel in einer Operation vorgesehen.

• Elemente löschen: Löscht Daten aus einem Statuspeicher oder Schlüsselspeicher in Cloud Datastore und ist als Ziel in einer Operation vorgesehen.

Mit diesem Connector erstellte Endpunkte sind von der Endpunkt-Nutzungsberichterstellung und von der Lizenzanzahl ausgeschlossen.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren aussetzen.

Für eine erfolgreiche Verbindung benötigen Sie ein Zugriffstoken für die Umgebung Ihres Projekts, das auf der Seite Zugriffstokens der Management Console generiert wird. Der Umfang muss auf Cloud Datastore eingestellt sein.

Fehlerbehebung

Wenn Probleme mit dem Cloud Datastore Connector auftreten, werden diese Schritte zur Fehlerbehebung empfohlen:

1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren verwendet wird).

2. Überprüfen Sie die Operationsprotokolle auf alle während der Ausführung der Operation geschriebenen Informationen.

3. Aktivieren Sie das Debug-Logging für Operationen (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 das ausführliche Logging für Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten einfügen:

   <logger name="org.jitterbit.connector.clouddatastore" level="DEBUG"/>
   

   Weitere Informationen zum ausführlichen Logging für Connectors finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agenten.

5. Wenn Sie private Agenten verwenden, können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.

7. Informationen zu Problemen und Lösungen, die speziell für den Cloud Datastore Connector gelten, finden Sie im Leitfaden Fehlerbehebung für Connectors:

   • Die Aktivität „Elemente löschen" meldet Erfolg, löscht aber den Datensatz nicht

Praktische Anwendung

• Sitzungsstatus mit Cloud Datastore speichern und abrufen: Verwendung von Cloud Datastore zur Beibehaltung des Status über asynchrone Operationen hinweg.
• Bidirektionale Synchronisierung zwischen zwei Systemen einrichten: Verwendung von Cloud Datastore zur Verfolgung des Synchronisierungsstatus und zur Verhinderung von zirkulären Aktualisierungen zwischen zwei Systemen.