Molto Luce .

Allgemein

Dieses Dokument soll die Feinheiten und Abweichungen bei Molto Luce im Vergleich zur Standard-Magento-Schnittstelle aufzeigen.

Werden Entitäten wie Artikel, Kunden oder Aufträge behandelt, betreffen diese immer die Warenwirtschaft. Für Objekte aus Magento wird immer darauf hingewiesen, dass ein Kunde ein Magento-Kunde ist. Bei dem Term Produkt ist immer das Magento-Produkt gemeint.

Datentypen

Bei den verwendeten und angegebenen Datentypen handelt es sich um .NET-Datentypen aus der Version 4.0. Eine Beschreibung ist via MSDN (http://msdn.microsoft.com) verfügbar:

Schnittstelle

Bei der Schnittstelle handelt es sich um das Programm LC.Interfaces. Der Programmstart erfolgt entweder manuell oder automatisch via geplanter Aufgabe in Windows.

Parameter

Es können für einen automatischen Start der Schnittstelle bestimmte Parameter mitgegeben werden. Dadurch kann die Schnittstelle einfach über die geplanten Aufgaben von Windows gestartet werden.

Artikeldaten

Artikelexport

Ein Artikel wird vom Export berücksichtigt, wenn folgende Eigenschaften erfüllt sind:

• Aktiv

• Nicht gesperrt

• WebShop-Artikel

• Artikelnummer beginnt nicht mit 91 oder 99

• Statistik6 muss „JA" enthalten

Automatischer Export

Die Schnittstelle erfasst im laufenden Betrieb kontinuierlich (alle drei Minuten) die zuletzt geändert Artikel und exportiert diese. Dabei werden Artikel ausgeschlossen, welche zuletzt durch den Benutzer BATCH geändert wurden. Dies ist notwendig, da hier tausende Artikel pro Tag geändert werden und diese Artikel aber keine Änderungen der Stammdaten aufweisen.

Kann ein Artikel nicht exportiert werden wird ein Logbucheintrag erstellt. Wird der Prozess während des Exports abgebrochen, beginnt der Export beim nächsten Start mit demselben Änderungsdatum.

Manueller Export

Der Artikelexport kann auch manuell gestartet werden. Dabei gibt es mehrere Möglichkeiten, wie Artikel selektiert werden können. Durchgeführt wird der Export via Karteireiter Export Artikelstamm. Die Benutzeroberfläche ist in Abbildung 1 auf Seite unten dargestellt.

Als Einschränkung für die Selektion der Artikel wird im ersten Schritt immer die Where-Bedingung aus der Konfigurationsdatei verwendet. Für die weitere Einschränkung gibt es folgende drei Möglichkeiten, welche Absteigend nach ihrer Priorität aufgelistet werden:

• Artikelnummern: Befindet sich in der Liste mit der Bezeichnung Artikelnummern mindestens ein Eintrag, werden nur diese Artikel selektiert. Dabei wird auch der Benutzer der letzten Änderung nicht berücksichtigt. Handelt es sich bei einer Artikelnummer um eine Produktfamilie, werden alle Artikel dieser Produktfamilie exportiert.

• Datum: Wird im Feld Ab-Datum ein Datum eingetragen, werden nur Artikel berücksichtigt, welche ab diesem Datum zuletzt geändert wurden.

• Alle Artikel: Es gibt zur Where-Bedingung aus der Konfigurationsdatei keine weitere Einschränkung.
  

Gestartet wird der Export mit der Schaltfläche Export, welche weiter oben platziert ist. Die zu verwendeten Schaltflächen werden in nachfolgender Tabelle erläutert:

Handelt es sich bei den Einträgen in der Liste Artikelnummern um Produktfamilien, werden diese Exportiert, ohne dass die Bestandteile der Produktfamilie aktualisiert werden.

WebShop-Kennzeichen

Das WebShop-Kennzeichen wird für neue Artikel über einen Datenbank-Trigger gesetzt. Dabei wird der Wert auf 1 gesetzt, wenn im Feld STATISTIK6 in der Tabelle ARTIKELSTAMM_TEXTE der Wert JA eingetragen wird. Wird ein anderer Wert eingetragen, wird das WebShop-Kennzeichen auf 0 gesetzt.

CREATE OR REPLACE TRIGGER trg_show_net

AFTER INSERT OR UPDATE ON artikelstamm_texte

FOR EACH ROW

BEGIN

IF (NVL(:old.statistik6, '') != NVL(:new.statistik6, '')) THEN

IF (:new.statistik6 = 'JA') THEN

UPDATE artikelstamm SET show_net = 1 WHERE nummer = :new.nummer;

ELSE

UPDATE artikelstamm SET show_net = 0 WHERE nummer = :new.nummer;

END IF;

END IF;

END;

Kategorien

Die Zuordnung zur den entsprechenden Magento-Kategorien erfolgt im Wesentlichen über die Suchkategorie in der Warenwirtschaft. Bei den Kategorien in Magento ist für jede Kategorie ein entsprechender Schlüssel hinterlegt. In Abbildung 2 auf Seite 7 unten ist dargestellt, wie die Werte in Magento hinterlegt sind. Es handelt sich hier um das Feld Category ETIM Id und ist für jede Kategorie im Karteireite General definiert.

Der Aufbau des Schlüssels erfolgt nach dem Muster (Präfix)-(ETIM-Kategorie)-[Suffix]. Das Präfix kann dabei die Werte I (Innenleuchten), O (Außenleuchten) oder IO (Innen- und Außenleuchten) annehmen. Unterschieden wird das von der Schnittstelle durch die Wert der Schutzart. Dabei wird folgende Einteilung getroffen:

• <= IP43: Innenleuchte

• > IP43 und < IP54: Innen- und Außenleuchte

• = IP54: Außenleuchte

Bei der Auswahl der ETIM-Kategorie wird das Kürzel der Suchkategorie aus der Warenwirtschaft verwendet. Dabei wird überprüft, ob das Kürzel in einer vordefinierten Liste enthalten ist. Die Liste lautet wie folgt:

• 00062

• 00101

• 00301

• 00302

• 00300

• 00533

• 00758

• 01500

• 01743

• 01702

• 01716

• 01744

• 01957

• 02706

• 02707

• 02710

• 01716

• 02828

• 02892

Ist dies nicht der Fall wird der Wert ACCESSORY verwendet. Somit werden diese Artikel als Zubehör kategorisiert. Für die Kategorien der Liste oberhalb gibt es aber noch folgende Ausnahmen:

• EC002892 (Decken- und Wandleuchten):

  • Ist bei einem Artikel eine Deckenmontage angegeben (Kriterium EF021180), wird als Schlüssel (Präfix)-EF021180 verwendet.

  • Ist bei einem Artikel eine Wandmontage angegeben (Kriterium EF006644), wird als Schlüssel (Präfix)-EF006644 verwendet.

• EC001716 (Hallen-Reflektorleuchten): Hier ist das Präfix immer IO, da diese Leuchten eine hohe Schutzart aufweisen, aber eigentlich als Innenleuchten verwendet werden.

• EC001744 (Strahler, Scheinwerfer, Flutlichter): Bei Innenleuchten wird hier folgendermaßen unterschieden:

  • Ist bei einem Artikel eine Deckenmontage angegeben (Kriterium EF021180), wird als Schlüssel (Präfix)-EC001744-AUF verwendet.

  • Ist bei einem Artikel eine Schienenmontage angegeben (Kriterium EF009354), wird als Schlüssel (Präfix)-EC001744-SCH verwendet.

  • Ist bei einem Artikel weder Deckenmontage, noch Schienenmontage angegeben, wird der Artikel für beide Kategorien mit den Schlüsseln (Präfix)-EC001744-AUF und (Präfix)-EC001744-SCH exportiert.

• EC000533 (Lichtregelsystemkomponente): Es wird als Schlüssel immer (Präfix)-EC002710 verwendet.

• EC001500 (Trafo für NV-Lichtsystem/NV-Halogenlampe): Es wird als Schlüssel immer (Präfix)-EC002710 verwendet.

Bilder und Dokumente

Bei den Artikelbildern werden alle Einträge in der Tabelle BILDER verwendet, welche folgenden Eigenschaften aufweisen:

• Bildtyp = 1 (Artikelbild)

• Internet = 1

• Bildname ist vorhanden

Die Bilder werden nicht mit Magento synchronisiert, sondern direkt in Magento aus einer Bilddatenbank eingebunden. Durch die Schnittstelle werden aber die Dokumente übergeben, welche für jeden Artikel heruntergeladen werden können. Dies wird durch das Attribut ml_technical_documents realisiert (Steuerbar über die Konfigurationseinstellung ExportItemDocumentAttributeCode). Es enthält für jedes Dokument eine Zeile, welche nach folgendem Muster aufgebaut ist: Dateiname;Bezeichnung.

Für jeden Store-View wird das Attribut gesondert exportiert, da der Inhalt sprachabhängig ist. Endet der Dateiname mit Datenblatt1.pdf, wird diese Datei nur bei deutschsprachigen Store-Views exportiert (hard coded in der Schnittstelle).

Die Bezeichnung wird durch die Konfigurationseinstellung DocumentTranslations gebildet.

Darin wird für eine bestimmte Dateiendung und eine bestimmte Sprache eine Übersetzung angegeben. Jede Dateiendung wird in eine Zeile geschrieben, die Übersetzungen Folgen durch einen senkrechten Strich getrennt. Eine Übersetzung selbst besteht aus dem zweistelligen ISO-Wert der Sprache und der, durch ein Semikolon getrennten, Übersetzung. Der aktuelle Inhalt dieser Einstellung lautet wie folgt:

datenblatt1.pdf|de;Datenblatt

datenblatt1_e_eng.pdf|en;Datasheet

ma.pdf|de;Montageanleitung|en;Mounting instruction

.ltd|de;Photometrie|en;Photometry

.stp|de;3D File|en;3D File

.dxf|de;2D File|en;2D File

.uld|de;Dialux|en;Dialux

_b2.jpg|de;Skizze|en;Diagram

_b3.jpg|de;Lichtverteilungskurve|en;Light distribution

(MountingInstruction_Rev(\d)+[.]pdf)$|de;Montageanleitung|en;Mounting instruction

(Simple[.]idw_Rev(\d)+[.]pdf)$|de;2D File PDF|en;2D File PDF

Als Dateiendung kann auch ein regulärer Ausdruck (regular expression) verwendet werden. Wird zum Beispiel die Datei 57701MA.pdf exportiert, sieht der Eintrag im Attribut wie folgt aus:

• Deutsch: 57701MA.pdf;Montageanleitung

• Englisch: 57701MA.pdf;Mounting instruction

Kann keine Übersetzung aus der entsprechenden Konfigurationseinstellung gebildet werden, wird der Wert aus der Spalte BEMERKUNG1 aus der Tabelle BILDER verwendet. Ist hier ebenfalls kein Wert vorhanden, wird der Name des Dokuments aus Spalte BILDNAME verwendet.

Produktfamilien

Als Produktfamilien werden logische Gruppierungen von Artikeln bezeichnet. Die einzelnen Artikel einer Produktfamilie können sich durch Einzelheiten (z. B. Farbe) unterscheiden. Im Artikelstamm sind Produktfamilien durch das Feld Statistik7 (ARTIKELSTAMM_TEXTE.STATISTIK7) gekennzeichnet.

Darin ist der Name der Produktfamilie enthalten. Haben mehrere Artikel denselben Namen hinterlegt, gehören diese zu einer Produktfamilie.

In Magento wird eine Produktfamilie durch ein konfigurierbares Produkt dargestellt. Ein konfigurierbares Produkt wird als Typ configurable gekennzeichnet. Es enthält zusätzlich zu einem einfachen Produkt eine Liste mit Attributen und eine Liste mit Artikelnummern. Da sich die Attribute bei einer Produktfamilie ändern können, wird beim Exportieren ein vorhandenes konfigurierbares Produkt in Magento gelöscht und neu erstellt. Grund dafür ist, dass eine Aktualisierung mit abweichenden Attributen in Magento nicht möglich ist.

Löschen

Wird der Vorgabewert für eine Produktfamilie gelöscht, erfasst dies ein Datenbank-Trigger und erstellt einen Eintrag in der Tabelle MY$MOLTO_LOGBUCH. Mit folgender SQL-Abfrage können diese Einträge selektiert werden:

SELECT * FROM MY$MOLTO_LOGBUCH WHERE tabelle = 'VORGABEWERTE_USER' ORDER BY datum DESC

Preise

Die Preise werden nur für einen angemeldeten Kunden angezeigt. Dabei wird bei der Auswahl des Artikels in Magento ein POLLEX-Dienst aufgerufen, welcher für den angemeldeten Kunden den aktuellen Preis bereitstellt.

Für eine erfolgreiche Identifikation des Kunden durch den Dienst ist die POLLEX-Kundennummer oder die Magento-Kunden-Id erforderlich. Wird letztere verwendet, muss diese beim entsprechenden Kunden als Profilierungswert hinterlegt sein. Das betroffene Kriterium muss wie folgt lauten:

MAGENTO_CUSTOMER_ID.

Der Ablauf ist in der Abbildung oberhalb dargestellt: Wird die übergebene Kundennummer als Magento-Kunden-Id in der Profilierung nicht gefunden, wird überprüft, ob es sich um eine echte Kundennummer handelt. Ansonsten wird der Aufruf mit einer Ausnahme beendet. War die Selektion eines Kunden möglich, werden für jeden angeforderten Artikel die Artikeldaten, Preise und der verfügbare Lagerbestand selektiert.

Dienst-Methode

Die verwendete Methode MagentoGetItemDetails2 ist im Dienst LC.MiscService enthalten. Diese Methode gibt Informationen für eine Auflistung von Artikeln zurück. Die zurückgegebenen Informationen umfassen Preis- und Lagerbestandsdaten. Die Parameter müssen zumindest wie folgt befüllt werden:

• databasename: ML

• username: MAGENTO

• password: MAGENT$#

public MagentoItemDetail[ ] MagentoGetItemDetails2 ( string databasename, string servername, string username, string password, double customerNumber, string [] itemNumbers, decimal quantity )

Parameter

Rückgabewert

Der Rückgabewert ist eine Auflistung vom Typ MagentoItemDetail. Wurden keine Artikelinformationen gefunden, wird eine leere Liste zurückgegeben. Nachfolgend eine Auflistung der enthaltenen Eigenschaften des Typs MagentoItemDetail:

Lagerbestände

Der verfügbare Lagerbestand wird via Datenbank-Trigger an Magento übergeben. Dabei wird in der Tabelle MAGENTO_UDPATE ein Eintrag erzeugt, wenn sich die Spalten BESTAND oder OFF_AUFF in der Tabelle LAGERBESTAND geändert haben. Der Trigger löst nur für Artikel aus, welche folgende

Eigenschaften aufweisen:

• Aktiv

• Nicht gesperrt

• WebShop-Artikel

• Statistik6: JA

• Artikelnummer beginnt nicht mit 91 oder 99

Trigger

^{CREATE OR REPLACE TRIGGER trg_magento_stock}

^{AFTER INSERT OR UPDATE ON lagerbestand}

^{FOR EACH ROW}

^BEGIN

^{IF (NVL(:old.bestand, 0) != NVL(:new.bestand, 0) OR NVL(:old.off_auf, 0) != NVL(:new.off_auf, 0)) THEN}

^{INSERT INTO magento_update (exportiert, artikelnummer, ad, au, md, mu, typ, wert_num, wert, oe)}

^{SELECT DISTINCT 0, :new.artnr, SYSDATE, USER, null, '', 2, :new.lager, '', null}

^{FROM artikelstamm a, artikelstamm_texte t}

^{WHERE a.nummer = t.nummer AND a.artikelnummer = :new.artnr AND t.statistik6 = 'JA' AND a.aktiv = 1 AND NVL(a.gesperrt, 0) = 0 AND a.show_net = 1 AND a.artikelnummer NOT LIKE '91%' AND a.artikelnummer NOT LIKE '99%';}

^{END IF;}

^END;

Backend

Der Lagerbestand ist im Backend in der Artikelübersicht dargestellt

Artikelstatus

Wird ein Artikel aktiviert oder deaktiviert, erstellt ein Datenbank-Trigger einen Eintrag in der Tabelle MAGENTO_UPDATE. In der Spalte wird Typ 1 für das Aktivieren und Typ 4 für das Deaktivieren verwendet.

Beim Aktivieren und Deaktivieren wird für jeden Store-View eine Produktaktualisierung ausgeführt. Ein Artikel gilt dann als aktiv, wenn folgende Eigenschaften zutreffen:

• Aktiv

• Nicht gepserrt

• WebShop-Artikel

Fehlt eine der oben genannten Eigenschaften, wird der Artikel deaktiviert.

Trigger

^{CREATE OR REPLACE TRIGGER trg_magento_item_status}

^{AFTER UPDATE ON artikelstamm}

^{FOR EACH ROW}

^BEGIN

^{IF (NVL(:old.aktiv, 0) != NVL(:new.aktiv, 0) OR NVL(:old.show_net, '') != NVL(:new.show_net, '') OR NVL(:old.gesperrt, '') != NVL(:new.gesperrt, '')) THEN}

^{IF (:new.aktiv = 1 AND NVL(:new.gesperrt, 0) = 0 AND :new.show_net = 1) THEN}

^{INSERT INTO magento_update (exportiert, artikelnummer, ad, au, md, mu, typ, wert_num, wert, oe)}

^{VALUES (0, :new.artikelnummer, SYSDATE, USER, null, '', 1, :new.vk, '', null);}

^ELSE

^{INSERT INTO magento_update (exportiert, artikelnummer, ad, au, md, mu, typ, wert_num, wert, oe)}

^{VALUES (0, :new.artikelnummer, SYSDATE, USER, null, '', 4, :new.vk, '', null);}

^{END IF;}

^{END IF;}

^END;

Backend

Der Status wird im Backend unter Artikelinformationen General dargestellt:

Kundendaten

Es werde nur Ansprechpartner exportiert, welche einen Benutzernamen und ein Passwort hinterlegt haben. Der Benutzername spielt dabei keine Rolle, da als Zugangserkennung die E-Mal-Adresse verwendet wird. Für den erfolgreichen Export eines Ansprechpartners muss Folgendes gelten:

• Kunden aktiv

• E-Mail-Adresse vorhanden

• Benutzername vorhanden

• Passwort vorhanden

Die Magento-Kunden sind nach dem Erstellen durch den Export inaktiv. Diese werden dann manuell oder automatisch durch Magento aktiviert.

Auftragsdaten

Anhang

Backend

Das Backend von Magento wird unter folgender URL aufgerufen:

https://molto-dev.ebiz-solutions.at/shop/index.php/admin/ml_backend

Tabelle MAGENTO_UPDATE

Die Tabelle ist wie folgt aufgebaut:

Trigger