Chroma-Connector für Jitterbit Studio

Zusammenfassung

Der Chroma-Connector stellt Zugriff auf Chroma bereit.

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

Der Chroma-Connector wird über die Registerkarte Projektendpunkte und Connectoren der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Chroma-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 Chroma-Verbindung und ihre Aktivitäten als Chroma-Endpunkt bezeichnet:

• Datensätze löschen: Löscht Datensätze aus einer Chroma-Sammlung und ist als Ziel in einem Vorgang vorgesehen.

• Datensätze suchen: Ruft Datensätze aus einer Chroma-Sammlung ab und ist als Quelle in einem Vorgang vorgesehen.

• Datensätze aktualisieren oder einfügen: Aktualisiert vorhandene Datensätze oder erstellt neue Datensätze in einer Chroma-Sammlung und ist als Ziel in einem Vorgang vorgesehen.

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

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 diese Updates mit der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren ausgesetzt werden.

Wenn ein API-Schlüssel zum Erstellen einer Chroma-Verbindung verwendet wird, stellen Sie sicher, dass jeder Schlüssel, der mit der Verbindung verwendet werden soll, über ausreichende Berechtigungen für den Zugriff auf alle für die Implementierung erforderlichen Datenbanken verfügt. Token sind dem Chroma-Mandanten zugeordnet und nicht einem bestimmten Benutzer.

API-Schlüssel können im Abschnitt API-Schlüssel des Dashboards der Chroma-Instanz konfiguriert werden:

Wenn Benutzeranmeldedaten (Standardauthentifizierung) zum Erstellen einer Chroma-Verbindung verwendet werden, stellen Sie sicher, dass der zugeordnete Benutzer über ausreichende Berechtigungen für den Zugriff auf alle für die Implementierung erforderlichen Datenbanken verfügt.

Der Chroma-Connector verwendet die Chroma REST API. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Fehlerbehebung

Wenn Probleme mit dem Chroma-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 Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren verwendet wird).

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

3. Aktivieren Sie das Betriebsdebug-Logging (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 logback.xml-Datei Ihres privaten Agenten hinzufügen:

   <logger name="org.jitterbit.connector.chroma" 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 auf weitere Informationen überprüfen.

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