Skip to content

MagentoGetProducts - Magento

← Magento Add-On Übersicht

Dieser Step ruft Artikeldaten aus einem Magento System ab und liefert die abgerufenen Daten in einem Spreadsheet zurück. Man kann über Konfigurationsparameter einschränken, welche Artikel und welche Daten zurückgeliefert werden. Diese Einstellungen beeinflussen die Geschwindigkeit des Abrufs maßgeblich. Sie sollten daher versuchen nur die Parameter zu setzen, die sie auch wirklich benötigen. Je weniger Daten geholt werden desto schneller. 

Step Konfiguration:

Input Beschreibung
apiUser

Benutzername des API Nutzers, der in Magento (siehe Nutzer und Rollen anlegen)

Beispiel:API_nutzer1

apiKey

entspricht dem Passwort dieses Benutzers.

Beispiel: API_Pa$$wort123

apiWsdl

URL zur SOAP API Endpoints ihres Magento Shops.

Beispiel: http://meinmagentoshop.de/index.php/api/v2_soap

storeViewId Die ID des StoreViews in Magento, falls Daten für einen bestimmten Store abgerufen werden sollen.
Default: leer 
mode

Der Mode bestimmt wieviele Daten abgerufen werden.
Listing Only - Es wird eine einfache Liste abgerufen, die sehr wenige Spalten enthält, dafür aber sehr schnell abgerufen wird.

Include Details -In diesem Mode werden wesentlich mehr Artikeldetails abgerufen, in dem ein extra API Call pro Produkt gemacht wird. Dadurch wird der Abruf sehr viel langsamer.
type product_id sku name set category_ids category_paths short_description description price tax_class_id status visibility weight meta_description meta_keyword meta_title has_options options_container additional_attributes special_price special_from_date special_to_date gift_message_available custom_design custom_layout_update url_key url_path websites created_at updated_at add_attr_in_depth image0 image1 image2 

sku optional: durch Angabe einer SKU kann man den Abruf auf einen einzigen Artikel einschränken. Hilfreich beim Testen.
rootCategoryId Um Kategoriepfade korrekt abzurufen, muss die numerische ID der Root-Kategorie angegeben werden. Wenn leer, dann werden die Kategoriepfadnamen nicht korrekt dargestellt.
Beispiel: 3 
additionalAttributes

Komma separierte Angabe von Attributen, die mit abgerufen werden sollen. Standardmäßig liefert die Magento SOAP API nur einige Standard-Attribute ab.
Sollten sie neue Attribute angelegt haben und diese abrufen wollen, dann können diese hier angegeben werden.

Hinweis: Diese Option greift nur bei mode=IncludeDetails

Beispiel:in_depth, color

limitItems (optional)

Damit kann eingeschränkt werden wie viele Artikel abgerufen werden. Gerade während der Erstellung eines Flows ist es praktisch diesen Wert eher klein zu halten (z.B. 10), damit nur wenige Artikel abgerufen werden.

Default: 25 | Beispiel: 50

Beispiel Step Ausgabe (mode = Include Details)


Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name Datentyp Beschreibung Pflichtfeld Werte
account ACCOUNT Ihr Konto Ja
limitItems STRING Begrenzen Sie die Anzahl der abgerufenen Elemente. Nein
mode STRING ListingOnly - holt nur minimale Informationen. IncludeDetails - Enthält auch Produktdetails. Dies dauert viel länger und erfordert einen API-Aufruf pro Produkt. Ja
  • ListingOnly (schnell)
  • Details einbinden (langsam)
storeViewId STRING Der Code der Magento Store View (z.B. Standard, Französisch, Deutsch etc.). Standard: leer. Nein
sku STRING optional: Geben Sie die SKU ein, um ein einzelnes Element abzurufen. Nein
skuSpreadsheet SPREADSHEET Spreadsheet mit Artikel-Skus. Wenn ein SkuSpreadsheet verlinkt ist, werden alle anderen Filter ignoriert Nein
mapping STRING Die Mapping-Definition JSON String Nein
Folgende Felder sind zu konfigurieren:

Feld Datentyp Beschreibung Pflichtfeld Standardwert
sku SINGLE Nein
rootCategoryId STRING optional: Die numerische ID (z.B. 3) deiner Stamm-Kategorie. Dies ist notwendig, um die Namen der categoryIDs zu erhalten. Nein
additionalAttributes STRING optional: Eine kommagetrennte Liste von zusätzlichen Attributen, die für die Produkte abgerufen werden sollen (z.B.: in_depth,color). Funktioniert nur bei mode=IncludeDetails Nein

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name Datentyp Beschreibung Werte
products SPREADSHEET Ein SpreadsheetObjekt, das die Produkte enthält.
Folgende Felder sind im Output enthalten:

Feld Datentyp Beschreibung Standardwert
identifier SINGLE The identifier column to import Spreadsheet into a Datastore.
type SINGLE The Magento product type.
product_id SINGLE The Magento product_id.
sku SINGLE The Magento product sku.
name SINGLE The Magento product name.
set SINGLE The Magento product set.
category_ids MULTIPLEVALUE The Magento product category ids.
category_paths MULTIPLEVALUE The Magento product category ids.