Zum Inhalt springen

Shopify-Verbindung

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 Instanzen von Shopify-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer Shopify-Verbindung

Eine neue Shopify-Verbindung wird mit dem Shopify-Connector von einem dieser Standorte erstellt:

Eine vorhandene Shopify-Verbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer Shopify-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Shopify-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Shopify-Verbindung einzigartig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Shopify-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

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

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

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

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

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

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

    • Proxy-Einstellungen verwenden (nur privater Agent): Wenn Sie einen privaten Agenten verwenden, kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agenten zu verwenden.

    • API-Version: Wählen Sie die Version der Shopify REST Admin API aus, eine der 2022-04 (Standard), 2023-01, 2023-04, 2023-07, 2023-10, 2024-01, 2024-04, 2024-07, 2024-10, 2025-01, 2025-04 oder 2025-07. Je nach den von Shopify in der verwendeten API-Version unterstützten API-Endpunkten 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, beachten Sie die zusätzlichen Überlegungen in Ändern der API-Version unten.

      Wichtig

      Shopify veröffentlicht alle drei Monate eine neue API-Version und pflegt jede veröffentlichte Version 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 auf die älteste derzeit unterstützte stabile Version umgeleitet.

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

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

    • Anforderungsheader: Verwenden Sie diese Tabelle, um Schlüssel-Wert-Paare hinzuzufügen, die mit jeder Aktivitätsanforderung gesendet werden. Jeder Wert, der zur Tabelle hinzugefügt wird, ist im Anforderungsschema jeder Aktivität enthalten.

      • Hinzufügen: Fügt der Tabelle eine Zeile hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
      • Einreichen: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar beim Überfahren einer Zeile im Bearbeitungsmodus.
      • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer bestehenden Zeile. Sichtbar beim Überfahren einer Zeile im Bearbeitungsmodus.
      • Bearbeiten: Ermöglicht das Bearbeiten eines bestehenden Schlüssel-Wert-Paares. Sichtbar beim Überfahren einer bestehenden Zeile.
      • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar beim Überfahren einer bestehenden Zeile.
      • Alle löschen: Löscht alle Zeilen aus der Tabelle.

      Wichtig

      Felder in der Tabelle Anforderungsheader zeigen das Symbol für Variablen nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 betragen.

      Felder in der Anforderungsheader-Tabelle unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.

  • Test: Klicken Sie, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Ändern der API-Version

Wenn eine Shopify-Verbindung bereits konfigurierte Aktivitäten hat, gibt es zusätzliche Überlegungen, die bei der Änderung der ausgewählten API-Version zu berücksichtigen sind. Das liegt daran, dass die Objekte und Unterobjekte, die zur Auswahl in der Aktivitätskonfiguration verfügbar sind, von den API-Endpunkten abhängen, die von Shopify in der verwendeten API-Version unterstützt werden. Wenn die bestehende Aktivitätskonfiguration API-Endpunkte verwendet, die in der API-Version, zu der Sie wechseln, nicht unterstützt werden, werden diese Aktivitäten fehlschlagen, es sei denn, sie werden neu konfiguriert.

Um dies zu verhindern, befolgen Sie diese Schritte:

  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. Bei der Aktualisierung werden die aktuellen Listen der Objekt- und Unterobjektauswahl mithilfe der in der Shopify-Verbindung ausgewählten API-Version abgerufen. Beachten Sie, dass Shopify automatisch Aufrufe nicht unterstützter API-Versionen an 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 bei der Aktualisierung ändern. Achten Sie genau darauf, dass alle geänderten Auswahlen wie beabsichtigt sind.

  3. Wählen Sie das geeignete Objekt und Unterobjekt aus, die von der aufgerufenen API-Version unterstützt werden.

  4. Bereitstellen von Operationen unter Verwendung der Verbindung und Aktivitäten.

Nächste Schritte

Nachdem eine Shopify-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einer Operation bereitzustellen) oder als Ziele (um Daten in einer Operation zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Designkomponentenpalette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

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

  • Abfragen: Abfragt Objektdaten von Shopify und ist als Quelle in einer Operation vorgesehen.

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

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

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