Shopify-Connector in Jitterbit Studio

Zusammenfassung

Der Shopify-Connector stellt den Zugriff auf Shopify her.

Der Shopify-Connector bietet eine Schnittstelle zur Erstellung einer Shopify-Verbindung, die die Grundlage für die Generierung von Instanzen von Shopify-Aktivitäten bildet. 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).

Hinweis

Integrationsrezepte und Prozessvorlagen sind über den Jitterbit Marketplace für diesen Connector 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 aus Shopify und ist als Ziel in einer Operation vorgesehen.

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.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten 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.

Dieser Connector unterstützt die 3-beinige OAuth 2.0-Authentifizierung für die Agentenversion 10.83 / 11.21 oder höher. Um die OAuth-Authentifizierung zu verwenden, sind zusätzliche Voraussetzungen erforderlich.

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

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 veralten lassen, 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 angekündigt, wo weitere Details und relevante Migrationsinformationen verfügbar sind.

Rate Limits

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 Rate Limits finden Sie unter Shopify REST Admin API Rate Limits.

Fehlersuche

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

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).
Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.
Aktivieren Sie das Debug-Logging für den Betrieb (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.
Wenn Sie private Agenten verwenden, können Sie das ausführliche Logging für den 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 Logging für Connectoren finden Sie unter Ausführliches Logging für Connectoren mit Jitterbit-Privatagenten.
Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.
Für zusätzliche Überlegungen zur Fehlersuche siehe Betriebsfehlerbehebung.