SHOP-Schnittstelle #

Die Schnittstelle besteht aus unterschiedlichen Programmen, die von EULANDA völlig unabhängig sind und direkt mit dem SQL-Server sowie dem SHOP-System kommunizieren. Bei einer Middle-Tier-Umgebung wird statt der direkten Kommunikation mit dem SHOP-System, über einen FTP-Server kommuniziert. Ein weiterer Server, der Kommunikations-Server, übernimmt indem Fall die Kommunikation zwischen SHOP-System und FTP-Server.

Die Schnittstellen-Programme lassen sich im ausgeloggten Zustand ausführen und in die Aufgabenplanung von Windows integrieren. Intervalle zur Übermittlung von Artikeländerungen, dem Abholen von Aufträgen oder dem Aktualisieren des Lagerbestands, sind hierdurch frei einstellbar.

Es handelt sich im Wesentlichen um die Programme „EUL.exe“, „NOP.exe“. Alle Programme werten dieselbe Konfigurationsdatei, nämlich „CONFIG.ini“, aus. Neben den beiden Basis-Programmen gibt es zur Integration eines Kommunikations-Servers und auch zu Servicezwecken weitere Programme, die optional sind.

Zu Verwaltung einer Mehrmandantenumgebung sollte die Schnittstelle wie im Kapitel „Installation“ beschrieben in den Ordner „C:\Shop“ installiert werden. Unterhalb dieses Ordners wird dann je ein Ordner für die einzelnen Mandanten angelegt und darin dann die Schnittstellen-Programme mit jeweils einer eigenen „CONFIG.ini“.

Mit dem Programm „KEY.exe“ lässt sich ein eindeutiger „MachineKey“, wie von NopCommerce und auch von Microsoft für den IIS (= Internet Information Server) empfohlen, erzeugen.

Der MachineKey wird zur Verschlüsselung der Session-ID, also einem Sitzungscode verwendet. Der Sitzungscode wird bei einem Neustart des Webservers neu ermittelt. Dies wirkt sich jedoch störend auf Besucher der Webseite aus und bewirkt, dass sich Benutzer unnötig oft neu anmelden müssen. Über einen festen MaschineKey ist es möglich, den SessionKey individuell zu verschlüsseln, jedoch diesen auch bei Server Neustarts beizubehalten.

Neben den Schnittstellenprogrammen besteht das Schnittstellensystem auch aus Erweiterungen für EULANDA selbst. Diese werden als Plug-In in EULANDA installiert und fügen neue Tabellen, Bildschirmmasken, Datenbanksichten, Kurzinfosysteme und eine erweitere Datenbanklogik hinzu.

Parameter über Konfigurationsdatei #

Die Konfigurationsdatei „CONFIG.ini“ steuert das Verhalten der einzelnen Schnittstellen-Programme. Sie kann mehrere Abschnitte für verschiedene Szenarien haben. Zusätzlich ist es möglich zu jedem Programm auch programmspezifische Parameter zu setzen.

Ein Hauptabschnitt „[DEFAULT]“ wird über eckige Klammern angegeben, enthält die übergreifenden Parameter. Die weiteren Abschnitte lauten ähnlich wie die Stapeldateien. Die Datei „JobProduct.bat“ wertet den Abschnitt „Product“ aus, die Datei „JobStock.bat“ den Abschnitt „STOCK“ usw. Zusätzlich können Abschnitte noch mit dem Programmnamen selbst erweitert werden, also z.B. „[STOCK_EUL]“. Dieser Abschnitt ist dann für die Stapeldatei „JobStock.bat“ relevant, aber nur für den Teil der von EUL.exe ausgeführt wird.

Die Stapeldateien enthalten in der Regel stets zwei Programmaufrufe. Im ersten Teil werden mit EUL.exe Artikel aus der EULANDA-Datenbank abgerufen und mit NOP.exe dann zum SHOP-Server übertragen.

[STOCK_EUL]
Export=1
ExportStock=1

[STOCK_NOP]
Import=1
ImportStock=1=1

Parameter über Kommandozeilen #

Parameter, die in der Konfigurationsdatei möglich sind, können auch über die Kommandozeile eingegeben werden. Bei gleichen Parametern hat die Kommandozeile Vorrang. Hierdurch lassen sich beispielsweise verschiedene Jobs mit denselben Programmen aber unterschiedlichem Verhalten definieren. Tagsüber könnte beispielsweise im 10-Minuten Zyklus nach geänderten Artikeln in EULANDA gesucht und diese zum SHOP übertragen werden, nachts hingegen könnte dasselbe Programm über einen anderen Parameter stets alle Artikel an den SHOP übertragen.

Die Kommandozeile muss mit einem Profilnamen beginnen, der den zuständigen Abschnitt in der „CONFIG.ini“-Datei angibt. Hier gilt natürlich, dass wenn ein Abschnittsname mit einem Unterstrich und Programmname vorhanden ist, dieser vorrangig ist.

Jeder Parameter besteht aus einem Namen und einem Wert. Während in der „CONFIG.ini“-Datei diese mit einem Gleichheitszeichen verbunden sind, ist das bei der Kommandozeile so nicht möglich. Hier ist der Parametername immer mit einem vorangestellten Minuszeichen anzugeben. Außerdem muss immer der Profilname angegeben werden.

EUL.exe -Profile Product -Forget 1

In diesem Bespiel ist der Profilname „Product“ und der Parameter „Forget“ hat den Wert „1“.

Parameter Beschreibung #

Die Parameternamen sind teilweise in verschiedenen Programmen wie „EUL.exe“ oder auch in „NOP.exe“ möglich. Sie haben zwar eine ähnliche aber im Detail doch andere Funktion, auf die in der folgenden Tabelle hingewiesen wird. Parameter, die in allen Bereichen eingesetzt werden können, haben in der „Gültigkeitsspalte“ einen Stern „*“ stehen. Hierzu zählen beispielsweise die Einstellungen für das E-Mail-System.

Besonderheiten #

Die Wahl der Parameternamen ist nie einfach und im Laufe der Entwicklung ergeben sich neue Aufgaben für den ursprünglichen Wert.

Parameter mit dem Textteil „Folder“ im Namen sind Ordner, die als Basis für weitere Verzeichnisse verwendet werden. Hierüber lässt sich also ein zentraler Ordner definieren, wobei der Zielordner anhand anderer Werte intern errechnet wird. Die echten Ordner enden im Namen auf “Dir”.

Parameternamen mit „Filemask“ im Namen werden zunächst intern umformatiert und ergeben erst während der Laufzeit echte Dateinamen. Hierbei werden Großbuchstaben in Werte umgesetzt, wie z.B. „YYYY“ in die aktuelle Jahreszahl oder UID in eine zufällige Zahlenkombination „DED4288B-9BFD-4251-A0B2-D0792DC06CF8“.

Die Namen der Parameter erfolgen immer in Englisch und immer in der Einzahl. Wird der Parameter in der folgenden Tabelle in mehreren Zeilen dargestellt, so liegt dies nur am Umbruch und der limitierten Darstellung in dieser Dokumentation, er besteht immer aus einem Wort ohne Leerzeichen.

Dateien und Programme der Schnittstelle #

Die Schnittstelle besteht aus verschiedenen Dateien, Programmen und Stapeldateien (= Batchdateien). Letztere sind Textdateien, die eine einfache Ablauflogik enthalten. Jede Stapeldatei stellt sicher, dass sie nicht ein weiteres Mal aufgerufen werden kann, ohne dass eine eventuell zuvor gestartete noch nicht beendet wurde.

Geregelt wird dies über eine Steuerdatei, die denselben Namen wie die Stapeldatei hat, jedoch mit der Endung „.true“ oder „.false“. Ist die Datei noch in der Ausführung, so existiert eine Steuerdatei mit „.true“, im anderen Fall mit „.false“.

Wird beispielsweise die Stapeldatei „JobProduct.bat“ gestartet, so wird in der Ablauflogik der Stapeldatei sofort dafür gesorgt, dass eine „JobProduct.true“ angelegt wird, gab es die jedoch schon, dann bedeutet es, dass die Stapeldatei noch in der Ausführung ist und damit wird der neue Aufruf sofort beendet.

Zusätzlich senden Stapeldateien bei einem Fehler eine E-Mail an den Administrator, wobei nachts im Zeitraum von 2-5 Uhr keine E-Mails versendet werden. In dieser Zeit können lang andauernde Aufgaben oder auch Datensicherungen durchgeführt werden.

Stapeldateien sorgen auch dafür, dass die Übertragungsdateien abgearbeitet werden. Wird ein PC mitten in der Übertragung heruntergefahren, so wird beim Neustart des PCs die Stapeldatei „JobAfterBoot.bat“ aufgerufen. Diese sorgt dafür, dass alle Steuerdateien zurück auf „.false“ gesetzt werden.

Jede Stapeldatei prüft stets ob es noch nicht vollständig verarbeitete Dateien im Ordner „Running“ gibt und verschiebt diese nach „Pending“.

Erst wenn eine Datei vollständig übertragen wurde, wird diese nach „Finished“ verschoben.

Im Fehlerfalle wird eine E-Mailbenachrichtigung versendet.

Installationsdateien #

Wurde die Schnittstelle manuell installiert, so sind möglicherweise noch temporäre Dateien, die für den Betrieb der Schnittstelle unerheblich sind, im Programmordner. Dies sind Config.ini.txt, alle *.sql Dateien sowie alle xml-Dateien. Diese können entfernt werden, da diese nicht mehr benötigt werden.

Programm CFG.exe #

Dieses Programm erlaubt es Aufgaben in der Aufgaben-Verwaltung anzulegen. Es ist inzwischen überholt, da die Aufgaben direkt durch das SETUP.exe angelegt werden.

Datei CONFIG.ini #

Alle Programme und Stapeldateien werten die Konfigurationsdatei „CONFIG.ini“ aus. In dieser Textdatei sind alle wichtigen Parameter wie Pfade und Einstellungen enthalten, die die Schnittstelle individuell einstellbar machen. Die Bedeutung der einzelnen Parameter wurde im vorhergehenden Kapitel beschrieben.

Programm EUL.exe #

Über das Programm „EUL.exe“ werden alle Daten mit dem EULANDA-SQL-Server ausgetauscht. Eine direkte Kommunikation mit „EULANDA.exe“ erfolgt nicht, sodass EULANDA für die Nutzung der SHOP-Schnittstelle nicht aktiv sein muss.

Das Programm „EUL.exe“ fragt den SQL-Server ab, ob geänderte Artikel- oder Lagerbewegungen vorliegen und exportiert diese in eine XML-Datei. Diese wird dann im Unterordner NopCommerce/Outbox/Pending gespeichert. Umgekehrt wertet das Programm auch ankommende XML-Dateien aus, die im Ordner NopCommerce/Inbox/Pending liegen und erzeugt Aufträge in der EULANDA-Datenbank. Über verschiedene Optionen kann ein Auftrag automatisch gebucht und weiterverarbeitet werden.

Ist der optionale EULANDA-Druckserver vorhanden, so können auch Dokumente wie Auftragsbestätigung, Lieferdokumente oder Rechnungen ausgedruckt oder als E-Mail versendet werden. Der EULANDA-Druckserver ist ein Hintergrundprozess in einer EULANDA-Farm.

Je nachdem ob Daten ankommen oder versendet werden sollen, muss „EUL.exe“ mit entsprechenden Parametern aufgerufen werden. Die Aufrufe selbst werden über Stapeldateien durchgeführt und können in die Windows-Aufgabenplanung integriert werden.

EUL.exe -Profile Product

In diesem Beispiel werden alle Parameter aus der Konfigurations-Datei „CONFIG.ini“ des Abschnitts „DEFAULT“ und zusätzlich die des vollqualifizierten Abschnitts „PRODUCT_EUL“ ausgewertet. Hier würde ein Der Abschnitt „PRODCT_EUL“ enthält in der Konfigurationsdatei folgende Einträge:

[PRODUCT_EUL]
Export=1
ExportProduct=1
ExportCategory=1

Es wird also ein Export der Produkte und Merkmale veranlasst und als XML-Datei in den Ordner „NopCommerce/Outbox/Pending“ exportiert. Der Ordner „NopComerce“ befindet sich unterhalb des Mandanten-Ordners der SHOP-Schnittstelle

Damit diese wenigen Kommandozeilenparameter ausreichen, werden in der Konfigurationsdatei weitere Informationen hinterlegt. Dies sind Dinge wie Name der Ausgabedatei, Verzeichnis der Ausgabedatei sowie Einträge, ob alle oder nur geänderte Artikel exportiert werden sollen. Diese Basisparameter befinden sich im Abschnitt „DEFAULT“ der Konfigurationsdatei.

Die Parameter IMPORT oder EXPORT beziehen sich immer auf das Schnittstellenprogramm. Der Parameter IMPORT bedeutet für das Programm EUL.exe, dass Daten aus XML-Dateien in die EULANDA-Datenbank eingelesen werden sollen. Der Parameter EXPORT bezogen auf EUL.EXE hingegen bedeutet, dass Daten aus der EULANDA-Datenbank ausgegeben werden sollen und bewirkt somit eine Speicherung der XML-Datei. Für das Programm NOP.exe würde IMPORT hingegen bedeuten, dass eine XML-Datei gelesen und an den SHOP übertragen werden soll.

Die XML-Dateien werden im Falle des Exports, von anderen Programmen weiterverarbeitet. Liegen Daten zum Einlesen vor, so wurden diese entsprechend von anderen Programmen erzeugt.

Programm FTP.exe #

Dieses Programm ist optional und teilt den normalen Direkt- Prozess auf in Unterprozesse auf, so dass diese von physikalisch verschiedenen Servern übernommen werden können.

Die standardmäßige Kommunikation besteht aus der nacheinander Ausführung von „EUL.exe“ und „NOP.exe“ auf demselben System. Dies ist in der Regel der EULANDA-Server mit der SQL-Datenbank. Die Kommunikation zum SHOP-System erfolgt über Odata und das http- bzw. https-Protokoll. Das Protokoll hat systembedingt ein schlechtes Verhältnis zwischen Nutzdaten und Protokollinformationen. Zusätzlich ist die Kommunikation zum SHOP-System rechenintensiv.

Abhilfe schafft hier das optionale Programm FTP.exe. Über „FTP.exe“ besteht die Möglichkeit die von „EUL.exe“ erzeugten XML-Daten sowie die Bilder direkt auf einen FTP-Server zu übertragen. Die Kommunikation über das FTP-Protokoll ist schlank und erfolgt sehr effizient. Mit dem Nachteil, dass die Verarbeitung der Daten dann asynchron erfolgt.

„FTP.exe“ spiegelt ebenso alle Bilder aus dem DMS-System (= Dokumentensystem) auf den FTP-Server. Auf dem FTP-Server gibt es dann eine ähnliche Dateistruktur wie auf dem lokalen Server.

Anstelle des Programm-Duos EUL.exe und NOP.exe arbeitet stattdessen auf der lokalen Seite EUL.exe mit FTP.exe.

Neben dem Hochladen von Bildern kümmert sich das Programm auch um das Abholen von Aufträgen.

Auf einem System im Rechenzentrum wird dann ein anderes DUO ausgeführt, nämlich FTP.exe mit NOP.exe.

Für dieses Szenario ist es empfehlenswert den FTP-Server in örtlicher Nähe des SHOP-Servers zu betreiben. Auf diesem oder auch einem dritten Server würde FTP.exe und NOP.exe installiert und auf dem EULANDA-Server wie bereits erwähnt das Pärchen EUL.exe mit FTP.exe.

Stapeldatei JobAfterBoot.bat #

Die Stapeldatei Afterboot stellt sicher, dass nach einem Neustart des PCs alle Steuerdateien auf .false stehen. Auf diese Weise ist sichergestellt, neue Prozesse auch wirklich starten, ohne dass sie durch eine liegengebliebene Datei „.true“ blockiert werden.

Stapeldatei JobCleanup.bat #

Diese Steuerdatei löscht Protokolldateien (.log) und Übertragungsdateien (.xml), die älter als 7 Tage sind.

Bei der automatischen Installation wird diese Stapeldatei so eingebunden, dass dies einmal am Tag geprüft wird.

Stapeldatei JobOrder.bat #

Dese Stapeldatei prüft, ob im Shop neue noch nicht abgeholte Aufträge vorhanden sind und lädt diese ggf. herunter. Die Daten werden als „order*.xml“ in den Ordner „NopCommerce/Inbox/Pending“ gespeichert und anschließend von dort in EULANDA eingelesen. Nachdem dies abgeschlossen ist, wird die Datei in den Ordner „NopCommerce/Inbox/Finished“ verschoben.

Stapeldatei JobPicture.bat #

Diese Stapeldatei scannt das komplette DMS nach neuen Bildern, wobei nur nach dem ersten Bild pro Artikel gesucht wird. Dies ist das Bild mit „-1“ am Ende des Namens. Wird ein neues Bild gefunden, so kopiert dieser Job das Bild in den Artikelstamm von EULANDA.

Dieses Modul ist also auch ohne SHOP sehr praktisch, denn man muss nun nur noch das erste Bild im DMS ändern und automatisch wird auch das Bild in der Artikelanzeige aktualisiert. Natürlich etwas zeitversetzt. Wir empfehlen das Intervall hier auf 1x am Tag zu setzen, da der Scan einige Minuten Zeit in Anspruch nimmt und auch die Festplatte stark in Anspruch genommen wird.

Stapeldatei JobPrice.bat #

Diese Stapeldatei exportiert Preisänderungen aus EULANDA und aktualisiert damit die Artikelpreise in SHOP:

Das System aktualisiert standardmäßig nur Änderungen am Verkaufspreis des EULANDA-Artikels. Möchten Sie auch Änderungen an Preislisten oder den Einkaufspreisen berücksichtigen, so kann hier über eine kundenspezifische Erweiterung auch dies erfolgen. Sprechen Sie hier einfach den Vertrieb an.

Stapeldatei JobProduct.bat #

Diese Stapeldatei überträgt komplette Artikel inkl. Bilder, Merkmalbaum, Lagerbestand, Texten und Preisen an das SHOP-System. Normalerweise werden nur geänderte Artikel übertragen. Wird aber der Parameter „Forget=1“ mit übergeben, dann werden alle Artikel erneut übertragen.

Bei den Bildern wird jedoch in jedem Fall noch einmal optimiert. Zu jedem bereits übertragenen Bild wird in einer MD5-Textdatei der Bildname und die Prüfsumme von bereits übertragenen Bildern gespeichert. Soll erneut derselbe Bildname übertragen werden, so wird immer nachgeschaut, ob das Bild nicht schon im SHOP ist. Auf diese Weise sind auch bei gesetztem Forget-Parameter die Übertragungszeiten erträglich.

Stapeldatei JobSisulizer.bat #

Diese Stapeldatei schreibt den Artikelstamm in eine XML-Übergabedatei, die vom Übersetzungsprogramm Sisulizer leicht verarbeitet werden kann. Es wird hierbei nur die Stammsprache „Deutsch“ exportiert. Der oder die Übersetzer können dann mithilfe des Programms Sisulizer diese Datei einlesen und in jede beliebige Sprache übersetzen. Hierbei unterstützt Sisulizer auch verschiedene Systeme zur Maschinenübersetzung.

Ist die Übersetzung fertig oder auch teilweise fertig, dann kann Sisulizer die übersetzten Sprachen ebenfalls als XML-Datei exportieren und dieser Stapel übernimmt dann die Ergebnisdateien und liest diese in den Artikelstamm und dort in die jeweiligen Sprachabschnitte ein.

Sisulizer ist in der Lage Änderungen am Originaltext zu erkennen, so dass der Übersetzer seine Sprachen auch sinnvoll pflegen kann.

Neben Sisulizer unterstützt EULANDA Software auch direkt einen Maschinenübersetzer. Die Abrechnung erfolgt hier über eine Kombination aus Monatspauschale und Buchstabenpauschale.

Stapeldatei JobStatus.bat #

Diese Stapeldatei ruft Statuswerte aus verschiedenen EULANDA-Warteschlangen ab. Aktuell werden Zahlungseingänge „PAID“, Rechnungserstellung „INV“ und Trackinginfo „TRK“ unterstützt. Immer wenn ein solches Ereignis in EULANDA auftritt, wird über diese Stapeldatei eine kleine kompakte XML-Datei erzeugt und anschließend werden diese Werte im SHOP eingepflegt. Bei einem Zahlungseingang in EULANDA (bei Vorkasse oder Abholort) wird dies auch im SHOP registriert. Sobald eine Rechnung in EULANDA erzeugt wird, wird der Auftrag im SHOP abgeschlossen. Wird eine Trackingnummer von einem angeschlossenen Versandsystem in EULANDA registriert, so wird ebenfalls ein Ereignis ausgelöst, welches dann die Übertragung der Sendungsnummern veranlasst. Verfügt der SHOP über das AMAUON oder eBay-Plug-in der Firma Nop4You, so wird die Tracking-Information von deren Plug-in weiterverarbeitet, und beispielsweise an Amazon übermittelt.

Stapeldatei JobStock.bat #

Lageränderungen werden in einem speziellen Ereignis an das SHOP-System übermittelt. Die Stapeldatei exportiert zum einen den Lagerbestand über EUL.exe und liest dann diese Werte über NOP.exe in das SHOP-System ein.

Programm KEY.exe #

Über dieses Programm lassen sich verschiedene Schlüssel berechnen und anzeigen. Zusätzlich wird das Ergebnis auf die Zwischenablage kopiert, so dass es direkt in die Anwendung übernommen werden kann.

MaschineKey #

Der Hersteller NopCommerce sowie Microsoft empfehlen dringend einen MaschineKey in der web.config Datei einzufügen. Diese Datei liegt in der Root des Webservers. Ein entsprechendes Kapitel befindet sich in dieser Dokumentation. Das Programm ist aus Sicherheitsgründen mit einem Zertifikat von EULANDA Software GmbH versehen und benötigt beim Start erweiterte Berechtigungen, da es auf eine Instanz von „Powershell“ zugreifen muss, um den MaschineKey berechnen zu können.

Der zufällige Schlüssel wird komplett formatiert erzeugt, indem das Programm mit entsprechenden Parametern aufgerufen wird.

KEY.exe -MachineKey 1

Als Antwort erhält man an der Kommandozeile die Ausgabe eines MaschineKey inkl. der XML-Formatierung.

OdataKey #

Neben dem MachineKey lässt sich auch der Kommunikations-Schlüssel mit dem Odata-Interface erzeugen. Hierzu sind insgesamt vier Parameter notwendig.

KEY.exe -OdataKey 1 -PrivateKey abc -PublicKey xyz -Email abc@def

Die letzten drei Parameter erhält man nach der Einrichtung der Odata-Schnittstelle aus dem NopCommerce-Shop. Nach Aufruf erhält man einen AuthInfo-Key, der direkt in die Config.ini-Datei eingeben wird.

In der aktuellen Schnittstelle wird die Funktion des OdataKey nicht mehr benötigt, da in der Konfigurations-Datei die drei Werte „Public-Key, „Private-Key“ und „Email-Key“ direkt eingetragen werden können. Alle anderen Keys werden von der Schnittstelle berechnet.

Programm NOP.exe #

Über das Programm „NOP.exe“ werden XML-Dateien, die zuvor von „EUL.exe“ erzeugt wurden, an das SHOP-System übertragen. Hierbei werden je nach Einstellung der Konfigurationsdatei auch Bilder übertragen.

Die Übertragung von Bildern ist sehr bandbreitenintensiv, weshalb vor dem Hochladen eines Bildes immer geprüft wird, ob sich der Bildinhalt seit der letzten Übertragung verändert hat. Dies erfolgt über eine MD5-Prüfsumme die vor jeder Übertragung durch „NOP.exe“ ermittelt wird. In der lokalen MD5-Textdatei sind alle Bildpfade mit ihren Prüfsummen gespeichert. Stimmt die neu errechnete Prüfsumme nicht mit der gespeicherten überein, so wird das Bild neu übertragen.

Das Programm „NOP.exe“ wird ebenfalls über Parameter gesteuert. Entweder werden Artikel, Kataloginformationen, Adressen oder Lagerzahlen an den SHOP übertragen oder Aufträge und Adressen vom SHOP abgeholt.

Der Parameter IMPORT oder EXPORT bezieht sich immer auf das Programm „NOP.exe“. In dem Fall bedeutet „IMPORT“, dass Daten aus einer XML-Datei an den SHOP übertragen werden, EXPORT hingegen, dass Daten aus dem SHOP abgerufen und als XML-Datei gespeichert werden.

Programm PIC.exe #

Das Programm „PIC.exe“ erlaubt verschiedene Operationen mit Bildern. Über den Parameter „-Profile Picture“ wird das DMS (= Dokumentensystem) angesprochen werden, welches in der Konfigurationsdatei „Config.ini“ im Abschnitt „DEFAULT“ hinterlegt ist. Die Anweisung, ob es sich um einen Import oder Export handelt, wird aus dem Abschnitt „PICTURE“ ausgelesen. Alle Artikelbilder des DMS, die mit „ARTNUMMER-1.jpg“ enden, werden in die EULANDA-SQL-Datenbank übernommen.

PIC.exe -Profile Picture

Das DMS ist so aufgebaut, dass unter dem Ordner „DMS\Artikel\ARTNUMMER“ ein Unterordner mit der Artikelnummer angelegt ist. Darin können beliebige Dokumente enthalten sein. Die Bilddatei muss „.jpg“ lauten und der Name der Bilddatei mit der Artikelnummer identisch sein, gefolgt von „-1“. Lautet die Artikelnummer beispielsweise „4711“ so muss das Hauptbild in dem Dokumentenordner entsprechend „4711-1.jpg“ heißen. Wird dieses im Ordner „DMS\Artikel\4711“ gefunden, so importiert PIC.exe das Bild komprimiert in den SQL-Server. Hierbei wird es automatisch auf maximal 650x650 Bildpunkte gebracht und die Anlage eines Vorschaubildes erfolgt ebenfalls.

Im Gegensatz zum Import innerhalb EULANDA selbst, werden Bilder hier komprimiert gespeichert, EULANDA selbst kann Bilder nur unkomprimiert als BMP speichern. Durch PIC kann die Datenbankgröße von mehreren Gigabytes schnell auf wenige Gigabytes schrumpfen.

Neben dem Import unterstützt „PIC.exe“ auch einen Export der Bilder. Der Parameter ist entsprechend „-Profile Picture -ImportPicture 0 -ExportPicture 1“.

PIC.exe -Profile Picture -ImportPicture 0 -ExportPicture 1