Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

✕

Shopify Anbindung

Einführung

Eine Shopify Verbindung, die mit dem Shopify Connector erstellt wurde, richtet den Zugriff auf Shopify ein. 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 klicken Sie auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen zur Identifizierung der Verbindung ein. Der Name muss für jede Shopify Verbindung eindeutig sein und darf keine Schrägstriche enthalten. / oder Doppelpunkte :. Dieser Name wird auch zur Identifizierung des Shopify Endpoint verwendet, 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 aus: Basisauthentifizierung oder Shopify Zugriffstoken. Wenn Sie eine private App verwenden, wählen Sie Basisauthentifizierung. Wenn Sie eine benutzerdefinierte App verwenden, die im Shopify Adminbereich erstellt wurde, wählen Sie Shopify Zugriffstoken.

  • API -Schlüssel: Wenn Basisauthentifizierung als Authentifizierungstyp ausgewählt wurde, geben Sie den API Schlüssel 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 das API Zugriffstoken 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, 2024-10 oder 2025-01. Abhängig von den von Shopify in der verwendeten API Version unterstützten API Endpoints können die bei der Aktivitätskonfiguration zur Auswahl stehenden Objekte und Unterobjekte variieren. Wenn Sie die API Version für eine Verbindung ändern, die bereits konfigurierte Aktivitäten hat, beachten Sie die zusätzlichen Hinweise unter Ändern der API Version 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 sie von Shopify nicht mehr gepflegt. Alle API Aufrufe, die diese Version anfordern, werden automatisch an die älteste aktuell unterstützte stabile Version weitergeleitet.

      Shopify kann bestimmte Endpoints verwerfen mit der Einführung einer neuen API Version. Daher müssen Sie möglicherweise Ihre Apps und Aktivitätskonfigurationen aufgrund geänderter oder eingestellter 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 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 Änderungen an einer bestehenden Zeile. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
      • Bearbeiten: Ermöglicht das Bearbeiten eines vorhandenen Key-Value Paar. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.

      • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.

      • Alles löschen: Löscht alle Zeilen aus der Tabelle.

      Wichtig

      Die Felder in der Tabelle „Anforderungsheader“ zeigen Folgendes an: 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 angegebenen Konfiguration zu überprüfen. Beim Testen der Verbindung wird die neueste Version des Connectors von den Agenten 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-Updates deaktivieren.

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

  • Änderungen verwerfen: Klicken Sie nach Änderungen an einer neuen oder bestehenden Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.

  • Löschen: Klicken Sie nach dem Öffnen einer bestehenden 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 aufgefordert, das Löschen der Verbindung zu bestätigen.

Ändern der API Version

Wenn eine Shopify Verbindung bereits konfigurierte Aktivitäten enthält, sind beim Ändern der ausgewählten API Version zusätzliche Aspekte zu beachten. Denn die in der Aktivitätskonfiguration verfügbaren Objekte und Unterobjekte hängen von den von Shopify in der verwendeten API Version unterstützten API Endpoints ab. Wenn die vorhandene Aktivitätskonfiguration API Endpoints verwendet, die in der zu wechselnden API Version 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 die Aktivitätskonfigurationsbildschirme, in denen ein Objekt oder Unterobjekt ausgewählt ist, und klicken Sie auf Aktualisieren. Beim Aktualisieren werden die aktuellen Objekt- und Unterobjektauswahllisten mit der in der Shopify Verbindung ausgewählten API Version abgerufen. Beachten Sie, dass Shopify Aufrufe nicht unterstützter API Versionen automatisch auf die nächstältere 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 sorgfältig 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 Vorgänge über die 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.

Die folgenden Aktivitätstypen sind verfügbar:

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

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

  • Erstellen: Erstellt Objektdaten in Shopify und ist zur Verwendung als Ziel in einer Operation vorgesehen.

  • Aktualisieren: Aktualisiert Objektdaten in Shopify und ist zur Verwendung als Ziel in einer Operation vorgesehen.

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