Zum Inhalt springen

Shopify-Connector für Jitterbit Integration Studio

Zusammenfassung

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

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

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

Tipp

Integrationsrezepte und Prozessvorlagen sind für diesen Connector über den Jitterbit Marketplace verfügbar.

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Shopify-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 Shopify-Verbindung und ihre Aktivitäten als Shopify-Endpunkt bezeichnet:

Shopify-Aktivitätstypen

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

  • Abfragen: Fragt bestimmte Objektdaten von Shopify ab und ist als Quelle in einem Vorgang gedacht.

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

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

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

Hinweis

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

Endpunkte, die mit diesem Connector erstellt wurden, sind in der Endpunktnutzungsberichterstattung enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der Shopify-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 Shopify-Connector verwendet die Shopify REST Admin API Version 2022-04, 2023-01, 2023-04, 2023-07, 2023-10, 2024-01, 2024-04, 2024-07, 2024-10, 2025-01, 2025-04 oder 2025-07, abhängig von der Auswahl in einer Shopify-Verbindung. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

Wichtig

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

Shopify kann bestimmte Endpunkte als veraltet erklären, wenn eine neue API-Version eingeführt wird. Daher müssen Sie möglicherweise Ihre Apps und Aktivitätskonfigurationen aufgrund geänderter oder eingestellter Funktionen anpassen.

Veraltete API-Versionen und Endpunkte werden im Änderungsprotokoll von Shopify bekannt gegeben, wo weitere Details und relevante Migrationsinformationen verfügbar sind.

Ratenlimits

Die Shopify REST Admin API setzt ein Limit von 40 Anfragen pro App und pro Store pro Minute durch. Dieses Kontingent wird mit einer Rate von 2 Anfragen pro Sekunde wieder aufgefüllt. Das Limit wird für Shopify Plus-Stores erhöht. Weitere Informationen zu den Ratenlimits finden Sie unter Shopify REST Admin API Ratenlimits.

Fehlerbehebung

Wenn Sie Probleme mit dem Shopify-Connector haben, werden die folgenden Schritte zur Fehlerbehebung 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 Organisationsrichtlinie Auto Connector Update 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 den Betrieb (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.shopify" 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 auf weitere Informationen überprüfen.

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