Shopify-Connector in Jitterbit Studio

Zusammenfassung

Der Shopify-Connector stellt Zugriff auf Shopify her.

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

Man greift auf den Shopify-Connector über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten zu (siehe Palette der Designkomponenten).

Connector-Übersicht

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

• Lesen: Ruft alle Objektdaten aus Shopify ab und soll als Quelle in einem Vorgang verwendet werden.

• Abfrage: Fragt angegebene Objektdaten aus Shopify ab und soll als Quelle in einem Vorgang verwendet werden.

• Erstellen: Erstellt Objektdaten in Shopify und soll als Ziel in einem Vorgang verwendet werden.

• Aktualisieren: Aktualisiert Objektdaten in Shopify und soll als Ziel in einem Vorgang verwendet werden.

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

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf die 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.

Dieser Connector unterstützt die 3-beinige OAuth-2.0-Authentifizierung für Agent-Version 10.83 / 11.21 oder später. Zur Verwendung der OAuth-Authentifizierung sind zusätzliche Voraussetzungen erforderlich.

Der Shopify-Connector verwendet die Shopify REST Admin API-Version, die in einer Shopify-Verbindung ausgewählt wird. Je nach den von Shopify in der verwendeten API-Version unterstützten API-Endpunkten können die verfügbaren Objekte und Unterobjekte variieren. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Shopify kann bestimmte Endpoints mit der Einführung einer neuen API-Version als veraltet kennzeichnen. Daher müssen Sie möglicherweise Ihre Apps und Aktivitätskonfigurationen aufgrund von geänderten oder eingestellten Funktionen anpassen.

Veraltete API-Versionen und Endpoints werden im Shopify-Änderungsprotokoll angekündigt, wo weitere Details und relevante Migrationsinformationen verfügbar sind.

Rate Limits

Die Shopify REST Admin API erzwingt ein Rate Limit von 40 Anfragen pro App pro Store pro Minute. Diese Zuteilung wird mit einer Rate von 2 Anfragen pro Sekunde aufgefüllt. Das Rate Limit ist für Shopify Plus Stores erhöht. Weitere Informationen zum Rate Limit finden Sie unter Shopify REST Admin API Rate Limits.

Fehlerbehebung

Wenn Sie Probleme mit dem Shopify-Connector haben, 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 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. Wenn Sie private Agents verwenden, können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agents einfügen:

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

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

5. Wenn Sie private Agents verwenden, 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 Shopify-Connector gelten, finden Sie im Leitfaden Connector-Fehlerbehebung:

   • Shopify: Aktivitätsobjektauswahlen können sich nach einer API-Versionsaktualisierung ändern