Magento2

Zweck

Das Magento 2 Flow Element dient als Brücke zwischen deinen Flows und deinem Magento 2 Online-Shop. Es ermöglicht dir, Aufgaben in Bezug auf Produkte, Bestellungen, Kunden und Lagerbestände zu automatisieren, ohne eine einzige Zeile Code schreiben zu müssen. Durch die Integration von Magento 2 in deine automatisierten Arbeitsabläufe kannst du Prozesse optimieren, den manuellen Aufwand reduzieren und die Datenkonsistenz in deinen Geschäftssystemen sicherstellen.

Wichtigste Vorteile & Anwendungsfälle:

1. Produktverwaltung: Automatisches Erstellen, Aktualisieren oder Löschen von Produkten in deinem Magento-Shop. Synchronisiere Produktinformationen wie Lagerbestände und Preise mit externen Warenwirtschaftssystemen oder ERPs.

2. Bestellabwicklung: Rufe neue Bestellungen ab, sobald sie eingehen, aktualisiere deren Status, erstelle Lieferungen oder löse Abrechnungsprozesse automatisch aus.

3. Kundendatensynchronisation: Halte Kundendaten zwischen Magento und deinem CRM synchron. Erstelle neue Kundenkonten oder aktualisiere bestehende aufgrund von Aktionen in anderen Systemen.

4. Bestandskontrolle: Aktualisiere Lagerbestände in Magento basierend auf Verkäufen aus anderen Kanälen oder Updates von deinem Lagerverwaltungssystem.

Authentifizierung

Diese Registerkarte konfiguriert die Anmeldeinformationen, die für die Verbindung mit der Magento 2 API erforderlich sind.

• URL: Die Basis-URL deines Magento 2-Shops.

• Token: Das Integrations-Token, das in deiner Magento 2-Verwaltungsoberfläche generiert wurde. Diese Option ist nur sichtbar, wenn der Typ auf Bearer eingestellt ist.

• Consumer Key: Der Consumer Key für die OAuth 1.0-Authentifizierung. Erscheint, wenn der Typ oAuthOne ist.

• Consumer Secret: Das Consumer Secret für die OAuth 1.0-Authentifizierung. Erscheint, wenn der Typ oAuthOne ist.

• Access Token: Das Access Token für die OAuth 1.0-Authentifizierung. Erscheint, wenn der Typ oAuthOne ist.

• Access Token Secret: Das Access Token Secret für die OAuth 1.0-Authentifizierung. Erscheint, wenn der Typ oAuthOne ist.

• Verbindung testen: Eine Schaltfläche, um zu überprüfen, ob die angegebenen Anmeldeinformationen korrekt sind und eine Verbindung zur Magento 2 API hergestellt werden kann.

Konfiguration

Dieser Abschnitt definiert die spezifische API-Anforderung, die du ausführen möchtest.

• Request: Eine Dropdown-Liste aller verfügbaren Magento 2 API-Aufrufe, gruppiert nach Kategorien (z. B. Products, Orders, Customers). Die Auswahl einer Anforderung aktualisiert das Eingabeformular dynamisch.

• Dateneingabe: Legt fest, wie Daten an die Anforderung übergeben werden. "Formular anzeigen" stellt dynamische Felder für die ausgewählte Anforderung bereit, während "Output-Variable" es dir ermöglicht, ein vollständiges JSON-Objekt aus einem vorherigen Schritt zu übergeben.

Eingabe

Die verfügbaren Eingabefelder hängen von der im Reiter „Konfiguration“ ausgewählten Anforderung und dem Modus Dateneingabe ab.

• Daten: Dieses Feld erscheint, wenn Dateneingabe auf Output-Variable eingestellt ist. Es akzeptiert ein JSON-Objekt oder eine Variable, die die JSON-Nutzlast für die Anforderung enthält. Wenn Dateneingabe auf Formular anzeigen eingestellt ist, wird diese Registerkarte durch spezifische Felder ersetzt, die für die gewählte Anforderung relevant sind. Zum Beispiel würdest du für Products\GetV1Products Felder für Suchkriterien sehen.

Eingabe-Erwartungen:

1

Formulareingabe (Formular anzeigen)

Das Element zeigt ein benutzerfreundliches Formular mit Feldern an, die den Parametern des ausgewählten API-Aufrufs entsprechen. Bei Listen-Endpunkten enthält dies oft searchCriteria-Felder zum Filtern, Sortieren und Paginieren von Ergebnissen (z. B. Page size, Current page). Bei Endpunkten, die Daten erstellen oder aktualisieren, enthält das Formular Felder für die Datennutzlast (z. B. Produktdetails).

2

JSON-Eingabe (Output-Variable)

Das Element erwartet ein einzelnes JSON-Objekt im Feld Daten. Die Struktur dieses Objekts muss den Anforderungen des von dir aufgerufenen Magento 2 API-Endpunkts entsprechen.

Ausgabe

Die Ausgabe des Elements ist immer ein JSON-Objekt, das in der Response-Variable platziert wird.

• Struktur: Die Struktur des Ausgabe-JSON wird durch den aufgerufenen Magento 2 API-Endpunkt bestimmt.

• Daten-Wrapper: Wenn die direkte API-Antwort kein JSON-Array ist, wird sie zur Konsistenz in einen data-Schlüssel eingeschlossen.

• Neuladen der Konfiguration: Die Ausgabe enthält auch ein config-Objekt, das alle neugeladenen Konfigurationsfelder enthält, was in fortgeschrittenen Szenarien nützlich sein kann.

Beispiel-Ausgabe (für Products\GetV1Products?searchCriteria[pageSize]=1):

{
  "response": {
    "items": [
      {
        "id": 1,
        "sku": "24-MB01",
        "name": "Joust Duffle Bag",
        "attribute_set_id": 15,
        "price": 34,
        "status": 1,
        "visibility": 4,
        "type_id": "simple"
        ...
      }
    ],
    "search_criteria": {
      "page_size": 1
    },
    "total_count": 2045,
    "config": { ... }
  }
}

Fehlerbehandlung

• Explizite Fehlerbehandlung: Wenn aktiviert, ermöglicht dies die benutzerdefinierte Behandlung bestimmter HTTP-Statuscodes oder Fehlermeldungen, sodass du unterschiedliche Pfade in deinem Flow für verschiedene Fehler erstellen kannst.

• Fehler Nachricht: Eine Standard-Fehlermeldung, die verwendet wird, wenn eine Ausnahme auftritt und keine spezifische Behandlung konfiguriert ist.

• Fehler: Definiere spezifische Fehlerbehandlungsszenarien. Du kannst eine oder mehrere Magento-Ausnahmen unter einem benutzerdefinierten Label gruppieren, um den Flow entsprechend zu steuern.

Eingabe-/Ausgabe-Erwartungen (Kurzzusammenfassung)

• Eingabe: Formularbasierte Felder oder ein einzelnes JSON-Objekt (Output-Variable), abhängig vom Dateneingabe-Modus.

• Ausgabe: Immer ein JSON-Objekt in der Response-Variable, ggf. mit data-Wrapper und config-Objekt.

Praktische Anwendungshinweise

1

Dynamische Formulare

Die leistungsstärkste Funktion dieses Elements ist seine Fähigkeit, Eingabeformulare dynamisch basierend auf der ausgewählten Anforderung zu generieren. Nutze dies, indem du die verfügbaren Anforderungen erkundest, um den vollen Umfang dessen zu verstehen, was automatisiert werden kann.

2

Filtern und Paginierung

Wenn du Anforderungen verwendest, die eine Liste von Elementen abrufen (z. B. Products\GetV1Products, Orders\GetV1Orders), verwende die searchCriteria-Parameter, um die benötigten Daten effizient zu finden. Du kannst nach Feldwerten filtern (Field, Value, Condition type), die Sortierreihenfolge festlegen (Sorting field, Sorting direction) und die Anzahl der Ergebnisse pro Seite steuern (Page size).

3

Klare Fehlermeldungen

Magento kann detaillierte Fehlermeldungen zurückgeben. Wenn eine Anforderung fehlschlägt, erfasst der Konnektor diese Meldungen. Er ersetzt automatisch Platzhalter wie %1 in der Fehlerbeschreibung durch die spezifischen Parameter aus der Magento-Antwort und liefert so eine klare und handlungsrelevante Fehlermeldung.