Zum Inhalt springen

Shopify-Connector für Jitterbit 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) verwendet werden sollen.

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 vorgesehen.

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

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

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

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

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 in einer Shopify-Verbindung ausgewählte Version der Shopify REST Admin API. Je nach den von Shopify in der verwendeten API-Version unterstützten API-Endpunkten können die verfügbaren Objekte und Unterobjekte variieren. 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 veraltet ist, 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 mit der Einführung einer neuen API-Version als veraltet erklären. 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 angekündigt, wo weitere Details und relevante Migrationsinformationen verfügbar sind.

Ratenlimits

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

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 des Connectors finden Sie unter Ausführliches Protokollieren für Connectoren, 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.