Zum Inhalt springen

VTEX-Connector für Jitterbit Studio

Zusammenfassung

Der VTEX-Connector stellt den Zugriff auf VTEX her.

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

Der VTEX-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 VTEX-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 VTEX-Verbindung und ihre Aktivitäten als VTEX-Endpunkt bezeichnet:

VTEX-Aktivitätstypen

  • Lesen: Ruft Objektdaten von VTEX ab und ist als Quelle in einem Vorgang gedacht.

  • Upsert: Aktualisiert vorhandene Objektdaten oder erstellt neue Objektdaten in VTEX und ist als Ziel in einem Vorgang gedacht.

  • Erstellen: Erstellt Objektdaten in VTEX und ist als Ziel in einem Vorgang gedacht.

  • Aktualisieren: Aktualisiert Objektdaten in VTEX und ist als Ziel in einem Vorgang gedacht.

  • Löschen: Löscht Objektdaten von VTEX und ist als Ziel in einem Vorgang gedacht.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Mit diesem Connector erstellte Endpunkte sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

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

Der VTEX-Connector verwendet die VTEX REST API. Konsultieren Sie die API-Dokumentation für Informationen zu den Schema-Knoten und -Feldern.

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 nutzen zu können, sind die folgenden Rollen erforderlich:

ID Rollenname
44029 ADM VOLLE
1129 Admin - Nur Startseite
14033 Admin CRM
14716 Admin Dynamischer Speicher
15885 Admin Geschenkliste
18053 Admin Portal
20980 Admin SuperV2 (Katalog - Vollzugriff)
23429 Admin Template Render
5226 Abrechnung
51 Logistik - Vollzugriff
46 OMS - Vollzugriff
1 Eigentümer (Admin Super)
33577 Zahlung - Administrator

Einschränkungen

VTEX API-Einschränkungen

Der VTEX-Connector hat diese Probleme aufgrund von Einschränkungen in der VTEX REST API:

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

VTEX Connector-Einschränkungen

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

Fehlersuche

Wenn Sie Probleme mit dem VTEX-Connector haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

  1. Klicken Sie auf die Test-Schaltfläche in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisation Richtlinie Auto Connector Update deaktivieren).

    Hinweis

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

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

  3. Aktivieren Sie das Debug-Protokoll für die Operation (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 Connector-Verbose-Logging 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.vtex" level="DEBUG"/>

Für weitere Informationen zum ausführlichen Protokollieren von Verbindern siehe Ausführliches Protokollieren für Connectoren mit Jitterbit-Privatagenten.

  1. Wenn Sie Privatagenten verwenden, können Sie die Agentenprotokolle für weitere Informationen überprüfen.

  2. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Operationen.