Chroma-Connector für Jitterbit Integration Studio

Zusammenfassung

Der Chroma-Connector ermöglicht den Zugriff auf Chroma.

Der Chroma-Connector bietet eine Schnittstelle zur Erstellung einer Chroma-Verbindung, die als Grundlage für die Generierung von Instanzen von Chroma-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Chroma.

Der Chroma-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Chroma-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

Zusammen werden eine spezifische 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 gedacht.

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

• Datensätze upsertieren: Aktualisiert vorhandene Datensätze oder erstellt neue Datensätze in einer Chroma-Sammlung und ist als Ziel in einem Vorgang gedacht.

Voraussetzungen und unterstützte API-Versionen

Wenn Sie einen API-Schlüssel verwenden, um eine Chroma-Verbindung zu erstellen, stellen Sie sicher, dass jeder Schlüssel, der für die Verbindung verwendet werden soll, über ausreichende Berechtigungen verfügt, um auf alle Datenbanken zuzugreifen, die für Ihre Implementierung erforderlich sind. Tokens sind mit dem Chroma Mandanten und nicht mit einem bestimmten Benutzer verknüpft.

API-Schlüssel sind im Abschnitt API-Schlüssel des Dashboards Ihrer Chroma-Instanz konfigurierbar:

Wenn Sie Benutzeranmeldeinformationen (Basis-Authentifizierung) verwenden, um eine Chroma-Verbindung zu erstellen, stellen Sie sicher, dass der zugehörige Benutzer über ausreichende Berechtigungen verfügt, um auf alle Datenbanken zuzugreifen, die für Ihre Implementierung erforderlich sind.

Der Chroma-Connector erfordert die Verwendung einer Agenten-Version 10.1 oder höher. Diese Agenten-Versionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

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

Fehlersuche

Wenn Sie Probleme mit dem Chroma-Connector haben, werden die folgenden Schritte zur Fehlersuche 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 (es sei denn, Sie verwenden die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren).

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 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 Protokollieren des Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

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

   Weitere Informationen zum ausführlichen Protokollieren von Connectors finden Sie unter Ausführliches Protokollieren für Connectors, die Jitterbit private Agenten verwenden.

5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen, um weitere Informationen zu erhalten.