VTEX-Connector in Jitterbit Studio

Zusammenfassung

Der VTEX-Connector stellt den Zugriff auf VTEX her.

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

Der VTEX-Connector wird über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Design-Komponentenpalette aufgerufen (siehe Design component palette).

Connector-Übersicht

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

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

• Read: Ruft Objektdaten aus VTEX ab und soll als Quelle in einem Vorgang verwendet werden.

• Upsert: Aktualisiert vorhandene Objektdaten oder erstellt neue Objektdaten in VTEX und soll als Ziel in einem Vorgang verwendet werden.

• Create: Erstellt Objektdaten in VTEX und soll als Ziel in einem Vorgang verwendet werden.

• Update: Aktualisiert Objektdaten in VTEX und soll als Ziel in einem Vorgang verwendet werden.

• Delete: Löscht Objektdaten aus VTEX und soll als Ziel in einem Vorgang verwendet werden.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung 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 Disable Auto Connector Update ausgesetzt werden.

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

Ein VTEX-Anwendungsschlüssel und ein Anwendungstoken sind erforderlich, um eine VTEX-Verbindung zu konfigurieren.

Für eine erfolgreiche VTEX-Verbindung muss das Zugriffsprofil des Anwendungstokens den License Manager-Client mit Zugriff auf die Ressource Get account by identifier (Schlüssel Get_Account_By_Identifier) enthalten.

Um alle VTEX-Aktivitäten und -Objekte zu verwenden, sind die folgenden Rollen erforderlich:

Einschränkungen

VTEX API-Einschränkungen

Der VTEX-Connector weist aufgrund von Einschränkungen in der VTEX REST API folgende Probleme auf:

• Die VTEX-Aktivität Read kann keine benutzerdefinierten Preise aus dem Objekt Price Simulation abrufen.

VTEX-Connector-Einschränkungen

Das VTEX-Objekt Offer Management unterstützt derzeit nicht die API-Operationen Close interaction und create log. Diese API-Operationen werden über den Harmony HTTP-Connector unterstützt.

Fehlerbehebung

Bei Problemen mit dem VTEX-Connector werden folgende 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 Disable Auto Connector Update verwendet wird).

   Hinweis

   Wenn die Fehlermeldung You don't have permission to access this resource angezeigt wird, stellen Sie sicher, dass das Zugriffsprofil des Anwendungstokens die Funktion License Manager mit Zugriff auf die Ressource Get account by identifier enthält.

2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

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

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

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

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

5. Bei Verwendung von privaten Agents 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 VTEX-Connector gelten, finden Sie im Leitfaden Connector-Fehlerbehebung:

   • Verbindungstest schlägt fehl mit „You don't have permission to access this resource"