Zum Inhalt springen

Shopify Connector für Jitterbit Integration Studio

Zusammenfassung

Der Shopify Connector stellt den Zugriff auf Shopify her.

Der Shopify Connector bietet eine Schnittstelle zum Erstellen einer Shopify Verbindung, der Grundlage zum Generieren von Instanzen von Shopify-Aktivitäten. Sobald diese Aktivitäten konfiguriert sind, interagieren sie über die Verbindung mit Shopify.

Der Zugriff auf den Shopify Konnektor erfolgt über die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).

Connector-Übersicht

Dieser Connector wird verwendet, um zunächst eine Shopify Verbindung zu konfigurieren. Mit dieser Verbindung verknüpfte Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Operation) oder Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden sollen.

Eine bestimmte Shopify Verbindung und ihre Aktivitäten werden zusammen als Shopify Endpoint bezeichnet:

Shopify Aktivitätstypen

  • Lesen: Ruft alle Objektdaten von Shopify ab und ist zur Verwendung als Quelle in einem Operation vorgesehen.

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

  • Erstellen: Erstellt Objektdaten in Shopify und soll als Ziel in einer Operation verwendet werden.

  • Aktualisieren: Aktualisiert Objektdaten in Shopify und soll als Ziel in einer Operation verwendet werden.

  • Löschen: Löscht Objektdaten aus Shopify und ist zur Verwendung als Ziel in einer Operation vorgesehen.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit verweisen kann, wenn Änderungen an mit dem Connector SDK erstellten Connectoren kommuniziert werden.

Voraussetzungen und unterstützte API Versionen

Der Shopify Connector erfordert die Verwendung eines Agenten der Version 10.1 oder höher. Diese Agentversionen laden bei Bedarf automatisch die neueste Version des Connectors herunter.

Der Shopify Konnektor verwendet die Shopify REST Admin API Version 2022-04, 2023-01, 2023-04, 2023-07, 2023-10, 2024-01, 2024-04, 2024-07 oder 2024-10, abhängig von der Auswahl in einer Shopify Verbindung. Informationen zu den Schema und -feldern finden Sie in der API -Dokumentation.

Wichtig

Shopify veröffentlicht eine neue API Version alle drei Monate und pflegt jede Release-Version mindestens zwölf Monate lang. Sobald eine API Version veraltet ist, wird Shopify diese Version nicht mehr pflegen und alle API Aufrufe, die diese Version anfordern, werden automatisch an die älteste stabile Version weitergeleitet, die derzeit unterstützt wird.

Shopify kann bestimmte Endpoints verwerfen mit der Einführung einer neuen API Version. Infolgedessen müssen Sie möglicherweise Ihre Apps und Aktivitätskonfigurationen aufgrund geänderter oder nicht mehr verfügbarer Funktionen ändern.

Veraltete API Versionen und Endpoints werden im Änderungsprotokoll von Shopify angekündigt, wo weitere Einzelheiten und alle relevanten Migrationsinformationen verfügbar sind.

Ratenbegrenzungen

Die Shopify REST Admin API erzwingt eine Ratenbegrenzung von 40 Anfragen pro App und Store pro Minute. Dieses Kontingent wird mit einer Rate von 2 Anfragen pro Sekunde aufgefüllt. Die Ratenbegrenzung wird für Shopify Plus-Stores erhöht. Weitere Informationen zur Ratenbegrenzung finden Sie unter Ratenbegrenzungen der Shopify REST Admin API.

Fehlerbehebung

Wenn Sie Probleme mit dem Shopify Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie in der Verbindungskonfiguration auf die Schaltfläche Test, 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 Operation für alle Informationen, die während der Ausführung der Operation geschrieben werden.

  3. Aktivieren Sie die debuggen für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie Connector Verbose Logging aktivieren für diesen Connector unter Verwendung dieses spezifischen Konfigurationseintrags mit Loggername und -ebene:

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

  5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen für weitere Informationen.

  6. Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Vorgängen.