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 und entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet 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.

Konfiguration der Shopify-Verbindung

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine offene eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um eine Liste der vorhandenen Variablen anzuzeigen, aus der Sie auswählen können.

  • 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 bestimmte 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-Admin 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 Shopify REST Admin API-Version 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 an die älteste derzeit unterstützte stabile Version weitergeleitet.

      Shopify kann bestimmte Endpunkte als veraltet erklären, 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 bekannt gegeben, 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 der 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, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
      • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer bestehenden Zeile. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
      • Bearbeiten: Ermöglicht das Bearbeiten eines vorhandenen Schlüssel-Wert-Paares. 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.
      • Alle löschen: Löscht alle Zeilen aus der Tabelle.

      Wichtig

      Felder in der Tabelle Anforderungsheader zeigen das Variablen-Icon 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.