Zum Inhalt springen

Shopify Anbindung

Einführung

Eine Shopify Verbindung, die mit dem Shopify Connector erstellt wurde, ermöglicht den Zugriff auf Shopify. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Shopify-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Erstellen oder Bearbeiten einer Shopify Verbindung

Eine neue Shopify Verbindung wird mithilfe des Shopify Connectors von einem dieser Standorte aus erstellt:

Eine bestehende Shopify Verbindung kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Shopify Verbindung

Jedes Benutzeroberflächenelement des Shopify Verbindungskonfigurationsbildschirms wird unten beschrieben.

Shopify Verbindungskonfiguration

Tipp

Felder mit einem Unterstützung variabler Symbole durch globale Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Shopify-Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :. Dieser Name wird auch verwendet, um den Shopify Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

  • Shopname: Geben Sie den Namen des Shopify-Shops ein.

  • Authentifizierungstyp: Wählen Sie den Authentifizierungstyp, entweder Basisauthentifizierung oder Shopify-Zugriffstoken. Wenn Sie eine private App verwenden, wählen Sie Basisauthentifizierung. Wenn Sie eine benutzerdefinierte App verwenden, die im Shopify Admin erstellt wurde, wählen Sie Shopify Zugriffstoken.

  • API Schlüssel: Wenn Basisauthentifizierung als Authentifizierungstyp ausgewählt wurde, geben Sie den API Schlüssel ein für die Shopify Instanz.

  • Passwort: Wenn Basisauthentifizierung als Authentifizierungstyp ausgewählt wurde, geben Sie das Passwort für die Shopify Instanz.

  • API Zugriffstoken: Wenn Shopify Zugriffstoken als Authentifizierungstyp ausgewählt wurde, geben Sie den API Zugriffstoken ein für die Shopify Instanz.

  • Optionale Einstellungen: Klicken Sie hier, um zusätzliche Einstellungen zu erweitern:

    • Proxy-Einstellungen verwenden (nur Privater Agent): Bei Verwendung eines privaten Agenten kann diese Einstellung ausgewählt werden, um Proxy-Einstellungen des privaten Agenten zu verwenden.

    • API Version: Wählen Sie die Shopify REST Admin API Version, eine von 2022-04 (Standard), 2023-01, 2023-04, 2023-07, 2023-10, 2024-01, 2024-04, 2024-07 oder 2024-10. Abhängig von den von Shopify in der verwendeten API Version unterstützten API Endpoints können die Objekte und Unterobjekte, die während der Aktivitätskonfiguration zur Auswahl stehen, variieren. Wenn Sie die API -Version für eine Verbindung ändern, die bereits konfigurierte Aktivitäten hat, finden Sie weitere Hinweise unter API Version ändern unten.

      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 veralten lassen 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.

    • Anforderungsheader: Verwenden Sie diese Tabelle, um beliebige Schlüssel-Wert-Paare hinzuzufügen, die mit jeder Aktivitätsanforderung gesendet werden sollen. Jeder der Tabelle hinzugefügte Wert wird in das Schema jeder Aktivität aufgenommen.

      • Hinzufügen: Fügt der Tabelle eine Zeile hinzu. Geben Sie für jede Eigenschaft ein Key-Value Paar ein.
      • Senden: Speichert das Key-Value Paar in der Tabelle. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
      • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
      • Bearbeiten: Ermöglicht Ihnen, ein vorhandenes Key-Value Paar zu bearbeiten. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
      • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn der Mauszeiger über eine vorhandene Zeile fährt.
      • Alles löschen: Löscht alle Zeilen aus der Tabelle.

      Wichtig

      Felder in der Tabelle Anforderungsheader zeigen die Variablensymbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein..

  • Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Ändern der API Version

Wenn eine Shopify-Verbindung bereits konfigurierte Aktivitäten hat, müssen beim Ändern der ausgewählten API Version zusätzliche Überlegungen berücksichtigt werden. Das liegt daran, dass die in der Aktivitätskonfiguration zur Auswahl stehenden Objekte und Unterobjekte von den von Shopify in der verwendeten API Version unterstützten API Endpoints abhängen. Wenn die vorhandene Aktivitätskonfiguration API Endpoints verwendet, die in der API Version, zu der Sie wechseln, nicht unterstützt werden, schlagen diese Aktivitäten fehl, sofern sie nicht neu konfiguriert werden.

Um dies zu verhindern, führen Sie die folgenden Schritte aus:

  1. Ändern Sie die API Version in der Shopify-Verbindung.

  2. Öffnen Sie jeden Aktivitätskonfigurationsbildschirm, in dem ein Objekt oder Unterobjekt ausgewählt ist, und klicken Sie auf Aktualisieren. Beim Aktualisieren werden die aktuellen Objekt- und Unterobjektauswahllisten mithilfe der in der Shopify-Verbindung ausgewählten API Version abgerufen. Beachten Sie, dass Shopify Aufrufe nicht unterstützter API Versionen automatisch an die nächstälteste unterstützte Version umleitet.

    Wichtig

    Wenn das ausgewählte Objekt oder Unterobjekt in der aufgerufenen API Version nicht unterstützt wird, kann sich die Auswahl beim Aktualisieren ändern. Achten Sie genau darauf, dass alle geänderten Auswahlen wie beabsichtigt sind.

  3. Wählen Sie das entsprechende Objekt und Unterobjekt aus, das von der aufgerufenen API Version unterstützt wird.

  4. Neu bereitstellen Operationen unter Verwendung der Verbindung und Aktivitäten.

Nächste Schritte

Nachdem eine Shopify-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

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

  • Abfrage: Fragt 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.