Sie sind hier: Labs Shopware 3 Dokumentation API-Import Funktionen Zurück zur Übersicht

API-Import Funktionen

Dieser Artikel ist noch nicht für Shopware 3.5 geprüft bzw. freigegeben.

Shopware Labs

Der Bereich Shopware Labs ist die Plattform für alle Entwickler. Hier findet man technische Dokumentationen und zahlreiche Tipps und Tricks rund um das Thema Programmieren. In dieser Rubrik stellen außerdem die Entwickler der shopware AG neue und experimentelle Lösungsansätze vor. Neue Funktionen, die in dieser Rubrik bereitgestellt werden, sind teilweise auch für zukünftige Releases geplant. Die Funktionen können dann ohne Programmierkenntnisse zukünftig direkt im Shopware Backend konfiguriert werden oder werden über Plugins bereitgestellt. Informationen über neue, geplante Funktionen finden Sie in unserer Roadmap.

Bitte beachten Sie, dass die hier bereitgestellten Lösungsansätze nicht offiziell supportet werden und nur eingebaut werden sollten, sofern Sie über das entsprechende, technische Wissen verfügen.

1 Kommentare

Inhaltsverzeichnis

1 API-Import Funktionen
1.1 Informationen
1.2 Methoden der Klassen
1.2.1 sArticle
1.2.2 sArticleAttributeGroup
1.2.3 sArticleTranslation
1.2.4 sArticleCategories
1.2.5 sArticleCategory
1.2.6 sArticleConfigurator
1.2.7 sArticleCrossSelling
1.2.8 sArticleDownload
1.2.9 sArticleImage
1.2.10 sArticleImages
1.2.11 sArticleLink
1.2.12 sArticlePrice
1.2.13 sArticlePrices
1.2.14 sArticleSimilar
1.2.15 sArticleStock
1.2.16 sCategory
1.2.17 sCustomer
1.2.18 sDeactivateArticle
1.2.19 sOrder
1.2.20 sRepairArticleCategories
1.2.21 sSupplier
1.2.22 sTranslation
1.3 Hilfsmethoden
1.3.1 sReadDir
1.3.2 sValFloat
1.3.3 sValDescription
1.3.4 sResizePicture
1.4 Getter
1.4.1 sGetArticleByAttribute
1.4.2 sGetArticledetailsID
1.4.3 sGetArticledetailsIDsByAttribute
1.4.4 sGetArticleID
1.4.5 sGetArticleNumbers
1.4.6 sGetCountryID
1.4.7 sGetMainArticleID
1.5 Setter
1.5.1 sSetAttribute
1.6 Deleter
1.6.1 sDeleteAllArticles
1.6.2 sDeleteAllCategories
1.6.3 sDeleteAllFiles
1.6.4 sDeleteArticle
1.6.5 sDeleteArticleAttributeGroup
1.6.6 sDeleteArticleAttributeGroupValues
1.6.7 sDeleteArticleCache
1.6.8 sDeleteArticleConfigurator
1.6.9 sDeleteArticleCrossSelling
1.6.10 sDeleteArticleDownloads
1.6.11 sDeleteArticleImages
1.6.12 sDeleteArticleLinks
1.6.13 sDeleteArticleSimilar
1.6.14 sDeleteCache
1.6.15 sDeleteCategories
1.6.16 sDeleteEmptyCategories
1.6.17 sDeleteOtherArticleImages
1.6.18 sDeleteOtherArticlesCategories
1.6.19 sDeleteOtherCategories
1.6.20 sDeleteTranslation

API-Import Funktionen

Informationen

Mit den API Import-Funktionen haben Sie die Möglichkeit Artikel, Kunden und Bestellungen via CSV oder XML in die shopware Datenbank zu importieren.

Datei: engine/connector/api/import/shopware.php

Klassenname: sShopwareImport

Einbindung:

require_once('../../api.php');

$api = new sAPI();

$import = &$api->import->shopware;

Methoden der Klassen

sArticle

function sArticle (array $article, array $config = array())

Erklärung	Importieren von Artikel-Stammdaten
Parameter $article	Notwendige Felder: varchar ["name"] Artikel-Bezeichnung varchar ["ordernumber"] Artikel-Bestellnummer varchar ["supplier"] Herstellername oder int ["supplierID"] ID des Herstellers (s_articles_supplier.id) oder int ["articleID"] ID des Artikels (beim Update) Verknüpfung von Varianten: Wenn Sie einen der folgenden Werte übergeben, wird der Artikel mit einem bestehenden Artikel verknüpft, also als Variante zugeordnet. (Eindimensional) optional char ["mainID"] > ID des Hauptartikels (s_articles.id) optional char ["maindetailsID"] > DetailsID des Hauptartikels (s_articles_details.id) optional char ["mainnumber"] > Artikelnummer des Hauptartikels (s_articles_details.ordernumber) Optionale Felder: optional date ["releasedate"] > YYYY-MM-DD Erscheinungsdatum optional varchar ["shippingtime"] Lieferzeit in Tagen optional text ["description"] Kurzbeschreibung optional text ["description_long"] Langbeschreibung optional text ["keywords"] Schlagwörter optional double ["referenceunit"] Referenzmenge (z.B. 1.00) optional float ["purchaseunit"] Tatsächlich verkaufte Menge (z.B. 0.75) optional integer ["supplierID"] ID des Herstellers > s_articles_supplier optional integer ["unitID"] Mengeneinheit > s_core_units optional integer ["taxID"] MwSt.-Satz 1 > 19, 2 > 7 > s_core_tax optional integer ["filtergroupID"] Zugeordnete Eigenschaftsgruppe > s_filter optional integer ["pricegroupID"] Zugeordnete Preisgruppe > s_core_pricegroups optional integer ["maxpurchase"] Maximale Bestellmenge optional integer ["purchasesteps"] Stückzahl Staffelung z.B. 5 (5,10,15,20) optional integer ["minpurchase"] Mindestbestellmenge optional integer ["topseller"] Auszeichnung als Highlight optional integer ["shippingfree"] Versandkostenfrei optional integer ["laststock"] Abverkaufsfunktion 1/0 optional integer ["pricegroupActive"] Preisgruppen-Rabatte anwenden 1/0 optional varchar ["suppliernumber"] EAN/Herstellnummer optional varchar ["additionaltext"] Varianten-Bezeichnung optional float ["weight"] Gewicht optional integer ["active"] Aktiv 1/0 optional integer ["articledetailsID"] Nur für Update des Artikels optional integer ["articleID"] Nur für Update des Artikels optional integer ["pseudosales"] Pseudo-Verkäufe / Topseller optional integer ["added"] Hinzugefügt am (Format:YYYY-MM-DD) optional integer ["changed"] Zuletzt bearbeitet am (Format:YYYY-MM-DD) Optionale Felder der Tabelle s_articles_details optional integer ["ordernumber"] Bestellnummer optional integer ["additionaltext"] Varianten-Freitext optional integer ["instock"] Aktueller Lagerbestand optional integer ["stockmin"] Mindestlagerbestand optional integer ["position"] Position (für Varianten) optional float ["weight"] Gewicht Optionale Felder der Tabelle s_articles_attributes optional float ["articledetailsID"] Artikeldetail ID (s_articles_details.id) optional array ["attr"] oder optional string ["attr1"],…,["attr20"] Artikel-Attribute s_articles_attributes
Parameter $config	Erweiterte Konfiguration: optional bool ["update"] false = Artikel wird nicht aktualisiert, wenn schon vorhanden
Rückgabe	Assoziatives Array
Werte	articleID ID des Artikels > s_articles.id articledetailsID ID des Sub-Artikels > s_articles_details.id articleattributesID Artikel-Attribute ID > s_articles_attributes.id kind Art des Artikels 1=Hauptartikel; 2=Variante > s_articles_details.kind supplierID Hersteller ID > s_articles_supplier.id tax MwSt-Satz > s_core_tax.tax taxID MwSt-Satz ID > s_core_tax.id

Code-Beispiel:

 
//Beispiel > Mindestangaben (nur Pflichtfelder)
$article_data = array(
	"name" => "Name des Artikels",
	"ordernumber" => "IM1234",
	"supplier" => "Hersteller XY");
 
$import->sArticle($article_data);
 
//Beispiel > Artikel anlegen, aber nicht aktualisieren wenn bereits vorhanden
$article_data = array(
	"name" => "Name des Artikels",
	"ordernumber" => "IM1234",
	"supplier" => "Hersteller XY");
 
$import->sArticle($article_data, array("update", false));

Rückgabe:

Array
(
    [articledetailsID] => 5083
    [articleID] => 5026
    [articleattributesID] => 5231
    [kind] => 1
    [supplierID] => 126
    [tax] => 7
    [taxID] => 4
)

sArticleAttributeGroup

function sArticleAttributeGroup (array $article)

Erklärung	Setzt die Eigenschaftsgruppe eines Artikels
Parameter $article	Notwendige Felder: int ["articleID"] ID des Artikels > s_articles.id oder int ["articledetailsID"] Artikeldetail ID > s_articles_details.id oder string ["ordernumber"] Bestellnummer des Artikels Optionale Felder: optional int ["attributegroupID"] > ID der Eigenschaftsgruppe (s_filter.id) [Wenn dieser Parameter nicht übergeben wird, wird die Eigenschaftszuordnung entfernt] optional array ["values"] > Werte des Hauptshops optional array ["values_{iso}"] > Werte des ensprechenden Subshops ({iso} wird durch den ISO-Code ersetzt bspw. en)
Rückgabe	Assoziatives Array
Werte

Code-Beispiel:

 
$import->sArticleAttributeGroup(
	array(
		"articleID"=>5028, 
		"attributegroupID"=>2,
		"values"=> array(
			1=>"Wert 1",
			2=>"Wert 2"
		),
		"values_en"=> array(
			1=>"Value 1",
			2=>"Value 2"
		)
	)
);

sArticleTranslation

function sArticleTranslation (array $article)

Erklärung	Übersetzt einen Artikel für verschiedene Subshops
Parameter $article	Notwendige Felder: int ["articleID"] ID des Artikels > s_articles.id oder int ["articledetailsID"] Artikeldetail ID > s_articles_details.id oder string ["ordernumber"] Bestellnummer des Artikels Bei Hauptartikeln (s_articles_details.kind = 1) können die Felder name, keywords, description , description_long und additionaltext übersetzt werden. Bei Varianten steht lediglich das Feld 'additionaltext' zur Verfügung. Diese werden im Format {Feldbezeichnung}_{Sprach-ISO} übergeben. Alle verfügbaren Sprach-ISOs können aus der Tabelle s_core_multilanguage entnommen werden. optional int ["name_{Sprach-ISO}"] > Artikelbezeichnung optional int ["keywords_{Sprach-ISO}"] > Meta-Keywords des Artikels optional int ["description_{Sprach-ISO}"] > Kurzbeschreibung des Artikels optional int ["description_long_{Sprach-ISO}"] > Beschreibung des Artikels optional int ["additionaltext_{Sprach-ISO}"] > Variantenbezeichnung des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Setzt die Übersetzungen für den englischen Subshop (Hauptartikel)
$import-> sArticleTranslation(array(
	"articleID"=>5028,
	"name_en"=>"Articlename",
	"keywords_en"=>"Articlekeywords EN",
	"description_en"=>"Description EN",
	"additionaltext_en"=>"Default-variant"
));
 
//Setzt die Übersetzungen für den englischen Subshop (Variante)
$import-> sArticleTranslation(array(
	"ordernumber"=>SW74623,
	"additionaltext_en"=>"Variant 1"
));

sArticleCategories

function sArticleCategories (string/int/array $article, array $categoryIDs)

Erklärung	Ordnet einem Artikel mehrere Kategorien zu
Parameter $article	Bestellnnummer als String oder ArtikelID als Integer (s_articles.id) oder Assoziatives Array optional int ["articleID"] ID des Artikels > s_articles.id oder optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id oder optional string ["ordernumber"] Bestellnummer des Artikels
Parameter $categoryID	Array der KategorieIDs (s_categories.id)
Rückgabe	array
Werte	Ids der zuletzt eingefügten Zuordnungen (s_articles_categories.id)

Code-Beispiel:

 
//Beispiel 1
//Ordnet dem Artikel mit der ArtikelID (s_articles.id) 293 den Kategorien 4 bis 6 zu
$import->sArticleCategories (293, array(4, 5, 6));
 
//Beispiel 2
//Ordnet dem Artikel mit der ArtikeldetailID (s_articles_details.id) 293 den Kategorien 4 bis 6 zu
$import->sArticleCategories (array("articledetailsID"=>293), array(4, 5, 6));

Rückgabebeispiel:

Array
(
    [0] => 20328
    [1] => 20329
    [2] => 20330
    [3] => 20331
    [4] => 20332
    [5] => 20333
    [6] => 20334
    [7] => 20335
    [8] => 20336
    [9] => 20337
    [10] => 20338
    [11] => 20339
)

sArticleCategory

function sArticleCategory (int $articleID, int $categoryID)

Erklärung	Ordnet einem Artikel eine Kategorie zu
Parameter $articleID	ID des Artikels > s_articles.id
Parameter $categoryID	ID der Kategorie > s_categories.id
Rückgabe	array
Werte	Id der zuletzt eingefügten Zuordnung (s_articles_categories.id)

Code-Beispiel:

 
//Ordnet dem Artikel mit der ArtikelID (s_articles.id) 293 der Kategorie 4 zu
$import->sArticleCategory (293, 4);

Rückgabebeispiel:

Array
(
    [0] => 20341
)

sArticleConfigurator

function sArticleConfigurator (int $articleID, array $article_configurator)

Erklärung	Legt die Konfiguratoreinstellungen eines Artikels fest. Beim Aufruf dieser Methode, werden zuvor übermittelte Datensätze gelöscht. (Aufruf der Methohde sDeleteArticleConfigurator)
Parameter $article	Bestellnnummer als String oder ArtikelID als Integer (s_articles.id) oder Assoziatives Array optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Parameter $article_configurator	Notwendige und optionale Felder: optional array ["groups"] Konfiguratorgruppen string ["name"] Gruppenname string ["description"] Gruppenbeschreibung int ["position"] Gruppenposition array ["values"] Artikelkonfigurationen int ["ordernumber"] Bestellnummer optional int ["standard"] 1=Standardartikel; ansonsten 0 (default: 0) optional int ["active"] 1=aktiv; 0=inaktiv (default: 0) optional int ["instock"] Lagerbestand (default: 0) array ["prices"] Preisangaben string ["customergroup"] = Kundengruppe (default: "EK") float ["price"] = Preis der Variante optional array ["attr"] Artikelattribute string [1]…[20] => Optionname oder string ["optionX"]=> ["optionname"], ["groupX"]=>["groupname"]) [X=1-20]
Rückgabe	void

Code-Beispiel:

 
$article_configurator = array("values" => array(
    array (
     "standard"=>1,
     "active"=>1,
     "instock"=>1,
     "ordernumber"=>"test123",
     "group1" => "farbe",
     "option1" => "grün",
     "group2" => "größe",
     "option2" => "l",
     "prices" => array(array("pricegroup"=>"H","net_price"=>10.10),array("pricegroup"=>"EK","net_price"=>10.10)),
     //...
    ), 
    array (
     "active"=>1,
     "instock"=>1,
     "ordernumber"=>"test124",
     "group1" => "farbe",
     "option1" => "blau",
     "group2" => "größe",
     "option2" => "xl", 
     "prices" => array(array("pricegroup"=>"H","net_price"=>10.10)),
    )
  )
 );
$import->sArticleConfigurator (array("articleID"=>5028), $article_configurator);

sArticleCrossSelling

function sArticleCrossSelling (string/int/array $article, array $relatedarticleIDs)

Erklärung	Ordnet einem Artikel einen oder mehrere Cross-Selling-Artikel zu (Zubehör-Artikel)
Parameter $article	Bestellnnummer als String oder ArtikelID als Integer (s_articles.id) oder Assoziatives Array optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Parameter $relatedarticleIDs	Array der Zubehörbestellnummern
Rückgabe	bool
Werte	true=erfolgreich; false=fehlgeschlagen

Code-Beispiel:

 
//Artikel mit den Bestellnummern SW2827 und SW2820 dem Artikel 5028 (s_articles.id)
//als Zubehör-Artikel hinzufügen 
$import->sArticleCrossSelling(5028, array("SW2827", "SW2820"));

sArticleDownload

function sArticleDownload (array $article_download)

Erklärung	Verwaltung von Downloadartikeln
Parameter $article_download	Notwendige und optionale Felder: string/int/array ["articleID"] Bestellnnummer als String oder ArtikelID als Integer (s_articles.id) oder Assoziatives Array optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels string ["name"] Downloadname string ["description"] Downloadbeschreibung optional int ["unlink"] 1=Stoppt die Methode, wenn die Datei schon vorhanden ist; 0=keine Überprüfung
Rückgabe	int
Werte	Id des zuletzt eingefügten Downloads (s_articles_downloads.id)

Code-Beispiel:

 
$import->sArticleDownload (array("articleID" => 54, 
				"name"=>"testdatei",
				"description" => "Download-Datei",
				"unlink"=>1));

sArticleImage

Hinweis: Die Bilder werden in der Tabelle s_articles_img gespeichert

function sArticleImage (array $article_image)

Erklärung	Kopiert das Bild auf den Server, erzeugt die notwendigen Thumbnails und erstellt die Datenbank-Einträge in s_articles_img
Parameter $article_image	Array mit den Daten des Bildes int ["articleID"] ID des Artikels string ["image"] Pfad zum Bild (HTTP-Link oder Datei-Pfad) optional int ["position"] Position des Bildes optional string ["description"] Beschreibung des Bildes optional int ["main"] Hauptbild des Artikels 1\|0
Rückgabe	bool
Werte	true = erfolgreich; false = fehlgeschlagen

Code-Beispiel:

 
//Bild für den Artikel (s_articles.id = 5028) hochladen
$image = array("articleID"=>5028,"image"=>"/pfad/zum/bild/test.jpg");
$import->sArticleImage($image);

oder Remote-Bild laden:

 
//Bild für den Artikel (s_articles.id = 5028) hochladen
$image = array("articleID"=>5028,"image"=>$api->load("http://www.test.de/test.jpg"));
$import->sArticleImage($image);

sArticleImages

Hinweis: Die Bilder werden in der Tabelle s_articles_img gespeichert

function sArticleImages (string/int $article, array $images)

Erklärung	Importiert mehrere Bilder in einem Step (Ruft intern sArticleImage auf)
Parameter $article	Eindeutige Zuordnung des Artikels zu dem Bilder importiert werden sollen string Artikel-Bestellnummer > s_articles_details.ordernumber int Artikel-ID > s_articles.id
Parameter $images	Array mit den zu importierenden Bildern string ["image"] Pfad zum Bild (HTTP-Link oder Datei-Pfad) optional int ["position"] Position des Bildes optional string ["description"] Beschreibung des Bildes optional int ["main"] Hauptbild des Artikels 1\|0
Rückgabe	bool
Werte	true = erfolgreich; false = fehlgeschlagen

Code-Beispiel:

 
//Bilder für den Artikel (s_articles.id = 5028) hochladen
$images = array(
	array("image"=>"http://www.myserver.de/test1.jpg"),
	array("image"=>"http://www.myserver.de/test2.jpg")
	);
$import->sArticleImages(5028,$images);

sArticleLink

function sArticleLink (array $article_link)

Erklärung	Ordnet einem Artikel einen Links zu
Parameter $article_link	string/int/array ["articleID"] Bestellnnummer als String oder ArtikelID als Integer (s_articles.id) oder Assoziatives Array optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels string ["link"] Link-URL string ["description"] Link-Beschreibung optional string ["target"] Art der Verlinkung (default: "_blank")
Rückgabe	int
Werte	Id der zuletzt eingefügten Link-Information (s_articles_information.id)

Code-Beispiel:

 
$import->sArticleLink (array(
	"articleID" => "SW_287364", 
	"link"=>"http://www.meinedomain.de/info",
	"description"=>"Link zur Info-Seite"	
));

sArticlePrice

function sArticlePrice (array $price)

Erklärung	Legt den Preis eines Artikels fest. Hierbei werden Kundengruppen, sowie Netto- und Bruttopreise berücksichtigt.
Parameter $price	Notwendige und optionale Felder: float ["price"] Preis des Artikels optional string ["pricegroup"] Kundengruppe (default: "EK") optional float ["pseudoprice"] „Unverbindliche Preisempfehlung“ optional float ["baseprice"] Einkaufspreis optional float ["percent"] Prozentualer Rabatt vom Artikelpreis (Feld price) optional int ["from"] Preisstaffelung, minimale Stückzahl optional float ["tax"] Mehrwertsteuersatz Zusätzlich muss einer der folgenden Schlüssel übergeben werden: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	int
Werte	Id des zuletzt eingefügten Preises > s_articles_prices.id

Code-Beispiel:

 
$price= array("ordernumber"=>"SW_72638", "price"=>7.90, "pricegroup"=>"H", "from"=>1, "tax"=>19);
$import->sArticlePrice ($price);

sArticlePrices

function sArticlePrices (array $article, array $prices)

Erklärung	Legt mehrere Preise eines Artikels fest. Hierbei werden Kundengruppen, sowie Netto- und Bruttopreise berücksichtigt.
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Parameter $prices	Notwendige und optionale Felder: float ["price"] Preis des Artikels optional string ["pricegroup"] Kundengruppe (default: "EK") optional float ["pseudoprice"] „Unverbindliche Preisempfehlung“ optional float ["baseprice"] Einkaufspreis optional float ["percent"] Prozentualer Rabatt vom Artikelpreis (Feld price) optional int ["from"] Preisstaffelung, minimale Stückzahl optional float ["tax"] Mehrwertsteuersatz
Rückgabe	bool
Werte	true = erfolgreich; false = fehlgeschlagen

Code-Beispiel:

 
$article = array("ordernumber"=>"SW_72638");
$prices = array(
	array("price"=>10, "pseudoprice"=>14.99, "from"=>1, "tax"=>19),
	array("price"=>7.40, "from"=>10, "tax"=>19),
	array("price"=>7.90, "pricegroup"=>"H", "from"=>1, "tax"=>19),
	array("price"=>4.90, "pricegroup"=>"H", "from"=>10, "tax"=>19)
);
$import->sArticlePrices ($article, $prices);

sArticleSimilar

function sArticleSimilar (string/int/array $article, array $relatedarticleIDs)

Erklärung	Ordnet einem Artikel einen oder mehrere Cross-Selling-Artikel zu (Ähnliche Artikel)
Parameter $article	Bestellnnummer als String oder ArtikelID als Integer (s_articles.id) oder Assoziatives Array optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Parameter $relatedarticleIDs	Bestellnummern der Artikel, die als "Ähnliche Artikel" hinzugefügt werden sollen
Rückgabe	bool
Werte	true=erfolgreich; false=fehlgeschlagen

Code-Beispiel:

 
//Artikel mit den Bestellnummern SW2827 und SW2820 dem Artikel 5028 (s_articles.id)
//als Ähnliche-Artikel hinzufügen
$import->sArticleSimilar (array("articleID"=>5028), array("SW2827", "SW2820"));

sArticleStock

function sArticleStock (array $article_stock)

Erklärung	Aktualisiert die Lagerbestände
Parameter $article_stock	Notwendige und optionale Felder: int ["instock"] Lagerbestand optional int ["stockmin"] Lager-Mindestbestand optional int ["active"] Definiert ob Artikel de-/aktiv ist optional int ["shippingtime"] Lieferzeit (in Tagen) optional int ["laststock"] Abverkauf-Funktion (1=aktiv; 0=inaktiv) Zusätzlich muss einer der folgenden Schlüssel übergeben werden: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	true=erfolgreich; false=fehlgeschlagen

Code-Beispiel:

 
$import->sArticleStock (array("articleID" => 8237, "instock"=>55, "stockmin"=>100));

sCategory

function sCategory (array $category)

Erklärung	Importiert und gleicht eine Kategorie ab
Parameter $category	Notwendige und optionale Felder: string ["description"] oder int ["id"] Beschreibung bzw. die ID der Kategorie optional int ["parent"] Eltern-ID der aktuellen Kategorie optional string ["metakeywords"] Keyword(s) der Kategorie optional string ["cmsheadline"] ‘Headline‘ für CMS optional int ["active"] Bestimmt, ob Kategorie de-/aktiv ist optional string ["template"] Darstellungs-Template der Kategorie optional int ["position"] Darstellungsposition, an der sich die Kategorie befindet optional int ["updateID"] Kategorie ID die aktualisiert werden soll. (s_categories.id)
Rückgabe	int
Werte	Id der importierten/abgeglichenden Kategorie (s_categories.id)

Code-Beispiel:

 
// from csv:
$article_data["categorie_1"] = 'EinzelküchenschränkeSerie Rapido 50er Tiefe'
 
// Main category is extract by the database table s_category
$maincategory = 3;    
$currentcategory = $maincategory;    
foreach (explode("",$article_data["categorie_1"]) as $category)
{	
     $currentcategory = $import->sCategory(array("description"=>$category,"parent"=>$currentcategory));
}
//Result: s_categories
//3     1     Deutsch                     0
//1000  3     Einzelküchen                1
//1001  1000  schränke                    2
//1002  1001  Serie Rapido 50er Tiefe     3

Code-Beispiel 2:

 
$maincategory = $import->sCategory(array("description"=>"Deutsch"));
$article = array("articleID"=>123,"category_1"=>"Spiele", "category_2"=>"PS3", "category_3"=>"Action");
 
//Kategoriebaum einlesen: 
$currentcategory = $maincategory;
for ($i=1;!empty($article["category_$i"]);$i++)
{
	$currentcategory = $import->sCategory( 
	array(
	"description"=>$article["category_$i"],
	"parent"=>$currentcategory
	      )
	);
}

sCustomer

function sCustomer (array $customer)

Erklärung	Legt User an bzw. gleicht vorhandene ab. Hierbei werden Liefer-/ und Rechnungsadresse, sowie Newsletter-Einträge berücksichtigt. Wenn lediglich die eMail-Adresse des Kunden übergeben wird und diese noch nicht vorhanden ist, wird der User neu angelegt. Kann anhand der userID bzw. eMail-Adresse der Kunde ausfindig gemacht werden, so findet eine Aktualisierung statt.
Parameter $category	Notwendige und optionale Felder: string ["email"] eMail-Adresse optional string ["md5_password"] Kundenpasswort (bereits md5 verschlüsselt) optional string ["password"] Kundenpasswort optional string ["customergroup"] Kundengruppe optional string ["validation"] H = Händlerregistrierung optional string ["language"] Sprach ISO optional string ["referer"] Referer-URL (Herkunft des Kunden) optional int ["active"] 1=aktiv; 0=inaktiv optional string ["accountmode"] 0=normal; 1=Schnellbestellung (ohne Account) optional int ["newsletter"] 1=Newsletter abboniert; ansonsten 0 optional int["paymentID"] ID der Standardzahlungsart (s_core_paymentmeans.id) optional string ["paymentpreset"] Zahlungsart die dem Kunden trotz aktivem Riskmanagement zur Verfügung steht (s_core_paymentmeans.id) optional int ["subshopID"] Subshopzuordnung (s_core_multilanguage.id) optional string ["userID"] UserID (s_user.id) optional string ["firstlogin"] Erster Login (Format: DATE) optional string ["lastlogin"] Letzter Login (Format: DATETIME) optional int ["customernumber"] Kundennummer optional int ["birthday"] Geburtsdatum (Format: DATE) optional string ["billing_company"] Firma (Rechnungsadresse) optional string ["billing_department"] Abteilung (Rechnungsadresse) optional string ["billing_salutation"] Anrede (Herr="mr"; Frau="ms"; Firma="company") (Rechnungsadresse) optional string ["billing_firstname"] Vorname (Rechnungsadresse) optional string ["billing_lastname"] Nachname (Rechnungsadresse) optional string ["billing_street"] Straße (Rechnungsadresse) optional string ["billing_streetnumber"] Hausnummer (Rechnungsadresse) optional string ["billing_zipcode"] Postleitzahl (Rechnungsadresse) optional string ["billing_city"] Stadt (Rechnungsadresse) optional string ["phone"] Telefonnummer (Rechnungsadresse) optional string ["fax"] Faxnummer (Rechnungsadresse) optional string ["ustid"] Umsatzsteuer ID (Rechnungsadresse) optional int ["billing_countryID"] Land (s_core_countries.id) (Rechnungsadresse) optional string ["billing_text1"] Freitextfeld (Rechnungsadresse) optional string ["billing_text2"] Freitextfeld (Rechnungsadresse) optional string ["billing_text3"] Freitextfeld (Rechnungsadresse) optional string ["billing_text4"] Freitextfeld (Rechnungsadresse) optional string ["billing_text5"] Freitextfeld (Rechnungsadresse) optional string ["billing_text6"] Freitextfeld (Rechnungsadresse) optional string string ["shipping_company"] Firma (Lieferadresse) optional string ["shipping_department"] Abteilung (Lieferadresse) optional string ["shipping_salutation"] Anrede (Herr="mr"; Frau="ms"; Firma="company") (Lieferadresse) optional string ["shipping_firstname"] Vorname (Lieferadresse) optional string ["shipping_lastname"] Nachname (Lieferadresse) optional string ["shipping_street"] Straße (Lieferadresse) optional string ["shipping_streetnumber"] Hausnummer (Lieferadresse) optional string ["shipping_zipcode"] Postleitzahl (Lieferadresse) optional string ["shipping_city"] Stadt (Lieferadresse) optional int ["shipping_countryID"] Land (s_core_countries.id) (Lieferadresse) optional string ["shipping_text1"] Freitextfeld (Lieferadresse) optional string ["shipping_text2"] Freitextfeld (Lieferadresse) optional string ["shipping_text3"] Freitextfeld (Lieferadresse) optional string ["shipping_text4"] Freitextfeld (Lieferadresse) optional string ["shipping_text5"] Freitextfeld (Lieferadresse) optional string ["shipping_text6"] Freitextfeld (Lieferadresse)
Rückgabe	array
Werte	["userID"] s_userID ["customernumber"] Kundennummer ["password"] Aktuelles Passwort

sDeactivateArticle

function sDeactivateArticle (array $article)

Erklärung	Deaktiviert einen Artikel
Parameter $article	Es muss einer der folgenden Schlüssel übergeben werden: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	int
Werte	Id des zuletzt deaktiviertem Artikels (s_articles_details.id)

Code-Beispiel:

 
$import->sDeactivateArticle (array("articleID" => 562));

sOrder

function sOrder (array $order)

Erklärung	Aktualisiert eine oder mehrere Bestellungen
Parameter $order	Zu aktualisierende Bestellungen definieren: int ["orderID"] Übergabe einer OrderID (s_order.id) oder array ["orderIDs"] Übergabe mehrerer OrderIDs (s_order.id) oder string ["ordernumber"] Übergabe der Bestellnummer (s_order.ordernumber) Optionale Felder: optional int ["statusID"] Status ID optional int ["clearedID"] Lösch ID optional int ["trackingID"] Verfolgungs ID optional int ["transactionID"] Transaktions ID optional string ["comment"] Kommentar des Käufers optional date ["cleareddate"] Löschdatum
Rückgabe	bool
Werte	true=erfolgreich; false=fehlgeschlagen

Code-Beispiel:

 
//Aktualisierung über die OrderID
$orderData = array(
	"orderID"=>234,
	"statusID"=>3,
	"comment"=>"Neuer Kommentar"
);
 
//Aktualisierung über mehrere OrderIDs
$orderData = array(
	"orderIDs"=>array(234, 514, 251),
	"statusID"=>3,
	"comment"=>"Neuer Kommentar"
);
 
//Aktualisierung über die Bestellnummer
$orderData = array(
	"ordernumber"=>"SW_82618",
	"statusID"=>3,
	"comment"=>"Neuer Kommentar"
);
 
$import->sOrder ($orderData);

sRepairArticleCategories

function sRepairArticleCategories ()

Erklärung	Repariert die Artikel-Kategorie-Zuordnung, auf der Basis des Inhalts.
Rückgabe	void

Code-Beispiel:

 
//Speichert alle Kategorien temporär, leert die Tabelle s_articles_categories und erstellt sie erneut
$import->sRepairArticleCategories ();

sSupplier

function sSupplier (array $supplier)

Erklärung	Erweitert die Hersteller-Tabelle um $supplier, falls dieser nicht bereits angelegt wurde.
Parameter $supplier	string ["supplier"] Herstellername optional string ["link"] URL des Herstellers optional string ["image"] Bild des Herstellers (Pfad: ./images/supplier)
Rückgabe	int
Werte	Id des zuletzt erstelltem Herstellers (s_articles_supplier.id)

Code-Beispiel:

 
$import->sSupplier (array(
	"supplier" => "HerstellerName", 
	"link" => "http://www.herstellerName.de", 
	"image" => "HerstellerName.jpg"));

sTranslation

Hinweis: Wenn der Parameter $data nicht gesetzt wird, werden die relevanten Übersetzungen entfernt.

function sTranslation (string $type, int $objectkey, string $language, array $data)

Erklärung	Diese Methode übersetzt verschiedene Elemente in der Datenbank wie Artikel, Varianten, Links, Downloads
Parameter $type	Element Typ
Parameter $objectkey	Unique ID, auf die sich der Typ bezieht (s_core_translations.objectkey)
Parameter $language	ISO Länderkürzel
Parameter $data	Übersetzungsdaten (sind abhängig vom Element Typ) Schlüsselabweichungen des Arrays $data in Abhängigkeit des Typs $type == "article" Übersetzung von Artikeln string ["name"] Artikelname string ["description"] Artikelbeschreibung (kurz) string ["description_long"] Artikelbeschreibung (lang) string ["additionaltext"] Variantenbezeichnung string ["keywords"] Keywords string ["attr1"]...["attr1"] Artikelattribute $type == "variant" Übersetzung von Variantenartikeln string ["additionaltext"] Variantenbezeichnung string ["attr1"]...["attr1"] Artikelattribute $type == "link" Übersetzung von Links string ["linkname"] Linkbezeichnung string ["description"] Linkbeschreibung $type == "download" Übersetzung von Downloads string ["downloadname"] Downloadname string ["description"] Downloadbeschreibung
Rückgabe	int
Werte	Id der zuletzt erstellten / bearbeiteten Übersetzung (s_core_translations.id)

Code-Beispiel:

 
$type = "article";
$key=358;
$language = "en"
$data = array (
"name"       => "Testartikel",
"description"=> "Artikelbeschreibung..",
"additionaltext" => "Standardartikel"
 
…);
 
$import->sTranslation($type, $key, $language, $data);

Hilfsmethoden

sReadDir

function sReadDir (string $dir)

Erklärung	Gibt rekursiv die Dateien des Verzeichnisses $dir aus
Parameter $dir	Pfad, dessen Inhalt zurückgegeben werden soll
Rückgabe	array
Werte	Inhalt des Verzeichnisses

Code-Beispiel:

 
$files = $import->sReadDir ("../images");

Rückgabebeispiel:

Array
(
    [0] => image.2.jpg
    [2] => image.3.jpg
    [3] => image.1.jpg
)

sValFloat

function sValFloat (string $value)

Erklärung	Konvertiert $value in eine Fließkommazahl und ersetzt dabei, falls vorhanden, das Komma (,) durch einen Punkt (.)
Parameter $value	Zu konvertierende Zahl
Rückgabe	float
Werte	Konvertierter float

Code-Beispiel:

 
$import->sValFloat ("25,84 EUR");

Rückgabe:

25.84

sValDescription

function sValDescription (string $description)

Erklärung	Bereinigt den übergebenen Wert von Sonderzeichen
Parameter $description	Zeichenkette, die bereinigt werden soll
Rückgabe	string
Werte	Bereinigte Zeichenkette

sResizePicture

function sResizePicture (resource $image, array $size, integer $new_width, integer $new_height, string $newfile)

Erklärung	Bild-Konvertierungsfunktion zur Generierung der Artikelbilder – Thumbnails Berücksichtigt zusätzlich die Höhe des Bildes bzw. das Verhältnis zwischen Höhe und Breite um auch "Hochkant-Bilder" passend skalieren zu können (feste Höhe)
Parameter $image	Resource von imagecreatefromjpeg
Parameter $size	Array, das von getimagesize generiert wurde
Parameter $new_width	Neuer Wert der Bild -Breite für das zu generierende Thumbnails
Parameter $new_height	Neuer Wert der Bild-Höhe für das zu generierende Thumbnails
Parameter $newfile	Pfad und Bild-Name mit Extension, von dem die Thumbnails generiert werden sollen
Rückgabe	void

Getter

sGetArticleByAttribute

function sGetArticleByAttribute (array $attr)

Erklärung	Gibt die Artikel ID (s_articles.id), sowie die Artikeldetail ID (s_articles_details.id) anhand Attribut-Suchekreterien zurück
Parameter $attr	Abzugleichende Attribute optional mixed ["attr1"] Wert des ersten Attributs optional mixed ["attr2"] Wert des zweiten Attributs optional mixed ["attr3"] Wert des dritten Attributs ...
Rückgabe	array
Werte	Artikel und Artikeldetail ID

Code-Beispiel:

 
$import->sGetArticleByAttribute (array("attr1"=>"823742", "attr15"=>"DT"));

Rückgabe:

Array
(
    [articleID] => 3
    [articledetailsID] => 3
)

sGetArticledetailsID

function sGetArticledetailsID (array $article)

Erklärung	Gibt die Artikeldetail ID durch Übergabe der ArtikelID bzw. Bestellnummer zurück
Parameter $article	Geben Sie einen der folgenden Schlüssel an optional int ["articleID"] Artikel ID (s_articles.id) optional string ["ordernumber"] Bestellnummer ...
Rückgabe	int
Werte	Artikeldetail ID

Code-Beispiel:

 
$import->sGetArticledetailsID (array("ordernumber"=>"SW_3268"));

Rückgabe:

sGetArticledetailsIDsByAttribute

function sGetArticledetailsIDsByAttribute (array $attr)

Erklärung	Gibt die Artikeldetail ID (s_articles_details.id) anhand Attribut-Suchekreterien zurück
Parameter $attr	Abzugleichende Attribute optional mixed ["attr1"] Wert des ersten Attributs optional mixed ["attr2"] Wert des zweiten Attributs optional mixed ["attr3"] Wert des dritten Attributs ...
Rückgabe	array
Werte	Artikeldetail ID

Code-Beispiel:

 
$import->sGetArticledetailsIDsByAttribute (array("attr1"=>"823742", "attr15"=>"DT"));

Rückgabe:

Array
(
    [0] => 3
)

sGetArticleID

function sGetArticleID (string/integer/array $article)

Erklärung	Gibt die Artikeld ID (s_articles.id) anhand der Bestellnummer bzw. Artikeldetail ID zurück
Parameter $article	Suchkreterien Bestellnnummer als String oder ArtikelID als Integer (s_articles.id) oder Assoziatives Array optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	int
Werte	Artikel ID (s_articles.id)

Code-Beispiel:

 
//Bespiel Bestellnummer
$import->sGetArticleID ("SW_7826482");
 
//Bespiel Artikeldetail ID
$import->sGetArticleID (array("articledetailsID"=>72));

Rückgabe:

sGetArticleNumbers

function sGetArticleNumbers (array $article)

Erklärung	Gibt die Artikel und Artikeldetail ID, sowie die Bestellnummer durch Übergabe einer dieser Werte zurück
Parameter $article	Geben Sie einen der folgenden Schlüssel an optional int ["articleID"] Artikel ID (s_articles.id) optional int ["articledetailsID"] Artikeldetail ID (s_articles_details.id) optional string ["ordernumber"] Bestellnummer
Rückgabe	array
Werte	Artikel und Artikeldetail ID, sowie die Bestellnummer

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sGetArticleNumbers(array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sGetArticleNumbers(array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sGetArticleNumbers(array("ordernumber"=>"SW1184_5977"));

Rückgabe:

Array
(
    [articledetailsID] => 5
    [ordernumber] => SW1184_5977
    [articleID] => 2
)

sGetCountryID

function sGetCountryID (array $country)

Erklärung	Liest die ID eines Landes anhand eines Suchmusters aus
Parameter $country	Geben Sie einen der folgenden Schlüssel an optional string ["name"] Name des Landes (s_core_countries.countryname) optional string ["iso"] ISO-Kürzel des Landes (s_core_countries.countryiso) optional string ["en"] Englische Bezeichnung des Landes (s_core_countries.countryen)
Rückgabe	int
Werte	ID des Landes (s_core_countries.id)

Code-Beispiel:

 
//Beispiel Landesname
$import->sGetCountryID(array("name"=>"deutschland"));
 
//Beispiel ISO-Kürzel
$import->sGetCountryID(array("iso"=>"de"));
 
//Beispiel Englische Bezeichnung
$import->sGetCountryID(array("en"=>"germany"));

Rückgabe:

sGetMainArticleID

function sGetMainArticleID (array $article)

Erklärung	Gibt die Artikeldetail ID des Hauptartikels anhand der Artikel oder Artikeldetail ID bzw. der Bestellnummer zurück
Parameter $article	Geben Sie einen der folgenden Schlüssel an optional int ["articleID"] Artikel ID (s_articles.id) optional int ["articledetailsID"] Artikeldetail ID (s_articles_details.id) optional string ["ordernumber"] Bestellnummer
Rückgabe	int
Werte	Artikel ID des Hauptartikels

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sGetMainArticleID (array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sGetMainArticleID (array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sGetMainArticleID (array("ordernumber"=>"SW1184_5977"));

Rückgabe:

Setter

sSetAttribute

function sSetAttribute (array $article, array $attr)

Erklärung	Trägt die Attribute aus dem Feld $attr des Artikels $article in die Datenbank Tabelle s_articles_attributes ein.
Parameter $article	Geben Sie einen der folgenden Schlüssel an optional int ["articleID"] Artikel ID (s_articles.id) optional int ["articledetailsID"] Artikeldetail ID (s_articles_details.id) optional string ["ordernumber"] Bestellnummer
Parameter $attr	optional mixed ["attr1"] Neuer Wert des ersten Attributs optional mixed ["attr2"] Neuer Wert des zweiten Attributs optional mixed ["attr3"] Neuer Wert des dritten Attributs ...
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sSetAttribute (array("articleID"=>2),
			array("attr1"=>"value1", "attr11"=>"value11"));
 
//Beispiel Artikeldetail ID
$import->sGetMainArticleID (array("articledetailsID"=>5),
			array("attr1"=>"value1", "attr11"=>"value11"));
 
//Beispiel Bestellnummer
$import->sGetMainArticleID (array("ordernumber"=>"SW1184_5977"),
			array("attr1"=>"value1", "attr11"=>"value11"));

Deleter

sDeleteAllArticles

function sDeleteAllArticles ()

Erklärung	Löscht alle Artikel
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
$import->sDeleteAllArticles ();

sDeleteAllCategories

function sDeleteAllCategories()

Erklärung	Löscht alle Kategorien
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
$import->sDeleteAllCategories();

sDeleteAllFiles

function sDeleteAllFiles (string $dir, bool $rek=false)

Erklärung	Löscht alle Dateien eines Verzeichnisses
Parameter $dir	Verzeichnispfad
Parameter $rek	Gibt an, ob rekursiv gelöscht werden soll (mit Unterverzeichnissen)
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
$import->sDeleteAllFiles ("../images", true);

sDeleteArticle

function sDeleteArticle (array $article)

Erklärung	Löscht einen Artikel
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteArticle (array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sDeleteArticle (array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sDeleteArticle (array("ordernumber"=>"SW1184_5977"));

sDeleteArticleAttributeGroup

function sDeleteArticleAttributeGroup (array $article)

Erklärung	Löscht die Eigenschaftszuordnung eines Artikels
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteArticleAttributeGroup (array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sDeleteArticleAttributeGroup (array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sDeleteArticleAttributeGroup (array("ordernumber"=>"SW1184_5977"));

sDeleteArticleAttributeGroupValues

function sDeleteArticleAttributeGroupValues (array $article)

Erklärung	Löscht alle Artikeleigenschaften eines Artikels
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteArticleAttributeGroupValues (array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sDeleteArticleAttributeGroupValues (array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sDeleteArticleAttributeGroupValues (array("ordernumber"=>"SW1184_5977"));

sDeleteArticleCache

function sDeleteArticleCache ()

Erklärung	Löscht alle Cachedateien der Artikel
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
$import->sDeleteArticleCache ();

sDeleteArticleConfigurator

function sDeleteArticleConfigurator(array $article)

Erklärung	Löscht mehrdimensionale Varianten eines Artikels
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteArticleConfigurator(array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sDeleteArticleConfigurator(array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sDeleteArticleConfigurator(array("ordernumber"=>"SW1184_5977"));

sDeleteArticleCrossSelling

function sDeleteArticleCrossSelling (array $article)

Erklärung	Löscht alle bestehenden Cross-Selling Zuordnungen eines Artikels (Zubehör-Artikel)
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteArticleCrossSelling(array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sDeleteArticleCrossSelling(array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sDeleteArticleCrossSelling(array("ordernumber"=>"SW1184_5977"));

sDeleteArticleDownloads

function sDeleteArticleDownloads (array $article)

Erklärung	Löscht alle bestehenden Downloads eines Artikels
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteArticleDownloads (array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sDeleteArticleDownloads (array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sDeleteArticleDownloads (array("ordernumber"=>"SW1184_5977"));

sDeleteArticleImages

function sDeleteArticleImages (array $article)

Erklärung	Löscht alle bestehenden Bildzuordnungen eines Artikels und entfernt die Bilddateien
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteArticleImages (array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sDeleteArticleImages (array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sDeleteArticleImages (array("ordernumber"=>"SW1184_5977"));

sDeleteArticleLinks

function sDeleteArticleLinks (array $article)

Erklärung	Löscht alle bestehenden Links eines Artikels (s_articles_information)
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteArticleLinks (array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sDeleteArticleLinks (array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sDeleteArticleLinks (array("ordernumber"=>"SW1184_5977"));

sDeleteArticleSimilar

function sDeleteArticleSimilar (array $article)

Erklärung	Löscht alle bestehenden Cross-Selling Zuordnungen eines Artikels (Ähnliche Artikel)
Parameter $article	Geben Sie einen der folgenden Schlüssel an: optional int ["articleID"] ID des Artikels > s_articles.id optional int ["articledetailsID"] Artikeldetail ID > s_articles_details.id optional string ["ordernumber"] Bestellnummer des Artikels
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteArticleSimilar (array("articleID"=>2));
 
//Beispiel Artikeldetail ID
$import->sDeleteArticleSimilar (array("articledetailsID"=>5));
 
//Beispiel Bestellnummer
$import->sDeleteArticleSimilar (array("ordernumber"=>"SW1184_5977"));

sDeleteCache

function sDeleteCache()

Erklärung	Löscht alle Cachedateien
Rückgabe	void

Code-Beispiel:

 
//Beispiel Artikel ID
$import->sDeleteCache();

sDeleteCategories

function sDeleteCategories (array $categories)

Erklärung	Löscht eine oder mehrere Kategorien
Parameter $categories	Array mit Kategorie IDs (s_articles_categories.id)
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Entfernen der Kategorie 53
$import->sDeleteCategories (array(53));
 
//Entfernen der Kategorien 3, 4 und 23
$import->sDeleteCategories (array(4, 23, 3));

sDeleteEmptyCategories

function sDeleteEmptyCategories ()

Erklärung	Entfernt Kategorien denen kein Artikel zugewiesen ist
Rückgabe	void

Code-Beispiel:

 
$import->sDeleteEmptyCategories ();

sDeleteOtherArticleImages

function sDeleteOtherArticleImages (int $articleID, array $images)

Erklärung	Löscht alle Bilder eines Artikels, die NICHT in $images aufgelistet sind.
Parameter $articleID	Artikel ID (s_articles.id)
Parameter $images	Array der Image IDs (s_articles_img.id)
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Entfernen ALLE ANDEREN Bilder des Artikel
$import->sDeleteOtherArticleImages (52, array(34, 36)));

sDeleteOtherArticlesCategories

function sDeleteOtherArticlesCategories (int $articleID, array $categoryIDs)

Erklärung	Löscht alle Kategorie-Zuordnungen eines Artikels, die NICHT in $categoryIDs aufgelistet sind.
Parameter $articleID	Artikel ID (s_articles.id)
Parameter $categoryIDs	Array der Kategorie IDs (s_articles_categories.id)
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Entfernen ALLE ANDEREN Kategorien des Artikel
$import->sDeleteOtherArticlesCategories (52, array(3, 17)));

sDeleteOtherCategories

function sDeleteOtherCategories (array $categoryIDs)

Erklärung	Löscht alle Kategorien, die NICHT in $categoryIDs aufgelistet sind.
Parameter $categoryIDs	Array der Kategorie IDs (s_categories.id)
Rückgabe	bool
Werte	1=erfolgreich; 0=fehlgeschlagen

Code-Beispiel:

 
//Entfernen ALLE ANDEREN Kategorien
$import->sDeleteOtherCategories (array(23, 17)));

sDeleteTranslation

function sDeleteTranslation (string $type, string $objectkey, string $language)

Erklärung	Löscht vorhandene Übersetzungen
Verweis	Zum Löschen von Übersetzungen kann die Methode sTranslation verwendet werden. Lassen Sie hierfür den Parameter $data aus.

Artikel bewerten

Kommentare: (1)

John Doe

22. October 2011 - 16:32 Uhr

Problem importing releasedate as Y-m-d string (AdoDB/Enlight)

While importing the releasedate with sArticle in SW 3.5.5 I got unexpected results providing a Y-m-d string. Solved this by using the UNIX timestamp instead of the Y-m-d string. Problem is obviously related to the handling of the releasedate with DBDate in AdoDB (Enlight).

Artikel kommentieren

Lieferzeit ca. 5 Tage

€ 1,00

Preise inkl. gesetzlicher
MwSt. zzgl. Versandkosten*

€ 1,00

Preise inkl. gesetzlicher
MwSt. + Versandkosten*

API-Import Funktionen

Inhaltsverzeichnis

API-Import Funktionen

Informationen

Methoden der Klassen

sArticle

sArticleAttributeGroup

sArticleTranslation

sArticleCategories

sArticleCategory

sArticleConfigurator

sArticleCrossSelling

sArticleDownload

sArticleImage

sArticleImages

sArticleLink

sArticlePrice

sArticlePrices

sArticleSimilar

sArticleStock

sCategory

sCustomer

sDeactivateArticle

sOrder

sRepairArticleCategories

sSupplier

sTranslation

Hilfsmethoden

sReadDir

sValFloat

sValDescription

sResizePicture

Getter

sGetArticleByAttribute

sGetArticledetailsID

sGetArticledetailsIDsByAttribute

sGetArticleID

sGetArticleNumbers

sGetCountryID

sGetMainArticleID

Setter

sSetAttribute

Deleter

sDeleteAllArticles

sDeleteAllCategories

sDeleteAllFiles

sDeleteArticle

sDeleteArticleAttributeGroup

sDeleteArticleAttributeGroupValues

sDeleteArticleCache

sDeleteArticleConfigurator

sDeleteArticleCrossSelling

sDeleteArticleDownloads

sDeleteArticleImages

sDeleteArticleLinks

sDeleteArticleSimilar

sDeleteCache

sDeleteCategories

sDeleteEmptyCategories

sDeleteOtherArticleImages

sDeleteOtherArticlesCategories

sDeleteOtherCategories

sDeleteTranslation

Artikel bewerten

Kommentare: (1)

Problem importing releasedate as Y-m-d string (AdoDB/Enlight)

Artikel kommentieren

Weitere interessante Artikel:

Die Klasse sSystem

Die Klasse sSearch

Absicherung Zugriff

Der Shopware Newsletter

Connect