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

Mit diesem Connector wird zunächst eine Cloud Datastore-Verbindung konfiguriert. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden sollen.

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

• Get Metrics: Ruft Nutzungsdaten für einen Status-Speicher oder Schlüsselspeicher in Cloud Datastore ab und ist zur Verwendung als Quelle in einem Vorgang vorgesehen.

• Create Storage: Erstellt einen neuen Status-Speicher oder Schlüsselspeicher in Cloud Datastore und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

• Delete Storage: Löscht einen Status-Speicher oder Schlüsselspeicher aus Cloud Datastore und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

• Query Items (veraltet): Liest Daten aus einem Status-Speicher oder Schlüsselspeicher in Cloud Datastore und ist zur Verwendung als Quelle in einem Vorgang vorgesehen.

  Warnung

  Die Aktivität Query Items (veraltet) ist veraltet und wird nicht mehr unterstützt. In einer zukünftigen Version wird diese Aktivität dauerhaft entfernt. Sie wurde in Release 11.47 durch die überarbeitete Query Items-Aktivität ersetzt, deren abgeflachte Antwortstruktur bewirkt, 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 Status-Speicher oder Schlüsselspeicher in Cloud Datastore ein und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

• Query Items: Liest Daten aus einem Status-Speicher oder Schlüsselspeicher in Cloud Datastore und ist zur Verwendung als Quelle in einem Vorgang vorgesehen.

• Update Items: Aktualisiert vorhandene Daten in einem Statuspeicher oder Schlüsselspeicher in Cloud Datastore und wird als Ziel in einem Vorgang verwendet.

• Delete Items: Löscht Daten aus einem Statuspeicher oder Schlüsselspeicher in Cloud Datastore und wird als Ziel in einem Vorgang verwendet.

Mit diesem Connector erstellte Endpunkte sind von der Endpunkt-Nutzungsberichte 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 Disable Auto Connector Update aussetzen](/de/management-console/organizations/#agent-management).

Für eine erfolgreiche Verbindung benötigen Sie ein Zugriffstoken für die Umgebung des Projekts, das in der Verwaltungskonsole auf der Seite Zugriffstokens generiert wird. Dessen Umfang muss auf Cloud Datastore eingestellt sein.

Fehlerbehebung

Wenn Sie Probleme mit dem Cloud Datastore-Connector haben, werden diese Schritte zur Fehlerbehebung empfohlen:

1. Klicken Sie in der Verbindungskonfiguration auf die Schaltfläche Test, um sicherzustellen, dass die Verbindung erfolgreich ist und um sicherzustellen, dass die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update verwendet wird](/de/management-console/organizations/#edit-organization-policies)).

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

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

4. Bei Verwendung von privaten Agenten können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag zur Datei logback.xml Ihres privaten Agenten hinzufügen:

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

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

5. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle für weitere Informationen überprüfen.

6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung für Vorgänge.

7. Für Probleme und Lösungen, die spezifisch für den Cloud Datastore-Connector gelten, lesen Sie das Handbuch Connector-Fehlerbehebung:

   • Die Aktivität „Query Items" gibt nicht alle übereinstimmenden Datensätze zurück, wenn nach mehreren Werten desselben Feldes gefiltert wird
   • Die Aktivität „Delete Items" meldet Erfolg, löscht den Datensatz aber nicht

Sehen Sie es in der Praxis

• Sitzungsstatus mit Cloud Datastore speichern und abrufen: Verwendung von Cloud Datastore zur Beibehaltung des Zustands über asynchrone Vorgänge hinweg.
• Bidirektionale Synchronisierung zwischen zwei Systemen einrichten: Verwendung von Cloud Datastore zum Nachverfolgen des Synchronisierungsstatus und zur Verhinderung zirkulärer Updates zwischen zwei Systemen.