LACOM-TS Version 3.0. Die Kommunikation mit Hänel Leanlift und Rotomat Version 3.0. Readysoft GmbH NOTICE: MP12H, MP12D

Transkript

1 Die Kommunikation mit Hänel Leanlift und Rotomat Version 3.0 by READYSOFT GmbH NOTICE: MP12H, MP12D Readysoft GmbH

2 Table of contents 1 Einführung..3 2 Installation Einstellungen. 4 4 Automatisierung Kommandozeilen Programmierung Datenformate Feldbeschreibung aller möglichen Datenfelder Importdatei Aufträge Auftragsdatei CSV - Format Auftragsdatei XML - Format Importdatei Artikelbestand Artikelbestand XML - Format Exportdatei Bewegungen Geplante Bewegungen Ungeplante Bewegungen Format der Bewegungen Bewegungsdatei CSV - Format Bewegungsdatei XML - Format11 7 Anhang CSV Character Separated Values XML Extensible Markup Language Fachtermini Aufbau eines XML-Dokuments 14 Page 2

3 1. Einführung Willkommen bei READYSOFT LACOM-TS, dem Kommunikationsprogramm zwischen einem (PPS) Host-System und einer Hänel-MP-Steuerung. READYSOFT LACOM-TS hilft Ihnen bei der Übernahme, Verwaltung und Weitergabe von Kommissionierlisten (Picklisten), bei der Kommunikation mit einer MP-Steuerung und bei der Abholung, Verwaltung und Sicherung von Bewegungs- und Stammdaten aus der MP-Steuerung. Die Eingaben und die Steuerung des Systems erfolgen im Dialog mit dem Rechner. Dieses Büchlein ist so aufgebaut, daß es Ihnen die wichtigsten Funktionen von READYSOFT LACOM-TS anhand von Bildschirmausdrucken - sprich Hardcopieserklärt. 2. Installation LACOM-TS Desktop LACOM-TS hat keine spezielle Installationsroutine. Page 3

4 Kopieren Sie einfach das LACOM-TS-Verzeichnis von der CD auf die Festplatte Ihres Computers. LACOM-TS bringt alle Libraries (im Lib-Verzeichnis) und auch sein eigenes Java Runtime (im jre-verzeichnis) mit. Note: LACOM-TS läuft nur mit Java 1.5 oder Nachfolger. Bevor Sie LACOM-TS das erste mal starten, öffnen Sie ein DOS-Fenster und wechseln in das LACOM-TS-Verzeichnis (mit cd LACOMTS). Um LACOM-TS zu starten, geben Sie jetzt "LacomtsStart" ein. Danach sollte der LACOM-TS-Desktop erscheinen. Note: LACOM-TS Gesamtansicht Wenn Sie diesen Desktop nicht sehen, können Ihnen evtl. Hinweise auf der Dos-Konsole weiter helfen. 3. Einstellungen LACOM-TS kommuniziert mit dem Hänel Leanlift oder Rotomat über die serielle Schnittstelle. In der Schnittstelle können Sie eine von LACOM-TS erkannten COMx-Schnittstellen Page 4

5 auswählen. Diese Schnittstelle sollte mit dem Hänel Masterlift verbunden sein. Falls keine COMx-Schnittstellen angezeigt werden, beenden Sie LACOM-TS und aktivieren in Ihrem System mindestens eine serielle Schnittstelle. 4. Automatisierung LACOM-TS Kommunikation LACOM-TS kann die Übernahme von Hostaufträgen, Artikelspiegel und die Übergabe des Bewegungsjournals automatisieren. Page 5

6 LACOM-TS Automatisierung 5. Kommandozeilen Programmierung Hier die Liftlauf Kommandos im XML-Format. <?xml version="1.0"?> <LACOMTS-COMMANDS> <LACOMTS-LIFTLAUF> <L>2</L> <E>1</E> <T>8</T> <F>3</F> </LACOMTS-LIFTLAUF> <LACOMTS-LIFTLAUF> <L>2</L> <E>1</E> <T>7</T> <F>1</F> </LACOMTS-LIFTLAUF> <LACOMTS-OPTILAUF> <L>2</L> <E>1</E> </LACOMTS-OPTILAUF> <LACOMTS-TABLARWEGFAHREN> Page 6

7 <L>2</L> <E>1</E> </LACOMTS-TABLARWEGFAHREN> <LACOMTS-LIFTLAUF> <L>2</L> <E>1</E> <T>1</T> <F>1</F> </LACOMTS-LIFTLAUF> </LACOMTS-COMMANDS> L=Liftnummer E=Entnahmestelle T=Tablarnummer F=Fachnummer O=Tiefenfachnummer Der Dateiname ist frei wählbar, muss aber mit der Extension ".xml" abgespeichert werden. Vorschlag: LIFTCOMMANDS.xml Vorgehensweise zur Erstellung der x:\dirname\liftcommands.xml Datei: 1. prüfen ob x:\dirname\liftcommands.xml vorhanden ist wenn vorhanden - weiter mit 1. sonst - weiter mit erstellen x:\dirname\liftcommands.xml 3. weiter mit Datenformate LACOM-TS kann folgende Daten mit einem Host-System austauschen: Import von Kommissionierlisten (Transportaufträge) Import von Artikelbeständen Export von Bewegungsdaten (durchgeführte Ein- Auslagerungen) LACOM-TS unterstützt zum Datenaustausch zwei Datenformate, die durch ihre entsprechende Dateierweiterung gekennzeichnet werden: *.csv Character Separated Values *.xml Extensible Markup Language 6.1. Feldbeschreibung aller möglichen Datenfelder Nachfolgend werden die Felder der Auftragsdatei beschrieben. Feldname Beschreibung mögliche Werte* min Feldlängen max K Auftragsnummer X 1 20 S Artikelnummer X 1 20 Page 7

8 N Artikelbezeichnung X 1 20 V Bewegungsart + = Einlagerung (Zulagerung) p = Einlagerung auf neuem Lagerplatz - = Auslagerung c = Auslagerung und der Lagerplatz wurde freigegeben + p - c 1 1 Q Menge N 1 8 L Liftnummer N 1 2 T Tablar N 1 3 F Fach N 1 3 O Tiefenfach N 1 2 Uxx Benutzerfelder U10-U25 frei benutzbar diese Felder werden im Bewegungsjournal wieder zurückgegeben. X 0 20 Hxx Benutzerfelder H10-H25 frei benutzbar Diese Felder werden durch Bedienereingaben am Lift gefüllt. X Alphanumerische Werte [A-Z 0-9,. : - ( ) /] N Numerische Werte [0-9] andere feste Werte X 0 20 Table 1: Felder der Auftragsdatei Table 2: * mögliche Werte Page 8

9 6.2. Importdatei Aufträge Auftragsdatei CSV - Format Die erste Zeile muss die Feldnamen enthalten. "K";"S";"V";"Q";"L";"T";"F";"O";"U10";"U11";U12; "267";" ";"-";"100";"1";"5";"8";"1";;; "267";" ";"+";"100";"1";"5";"8";"1";;; "249";" ";"+";"6000";"1";"1";"3";"1";"0001";"ST";"6000" Note: Die erste Zeile muss immer die Feldnamen enthalten. Die Feldnamen können mit oder ohne Hochkomma angeben werden. Beispiel: "K";"S";"V";"Q";"L";"T";"F";"O";"U10";"U11" mit Hochkomma K;S;V;Q;L;T;F;O;U10;U11 ohne Hochkomma Auftragsdatei XML - Format <?xml version="1.0" encoding="iso "?> <LACOMTS-AUFTRAG> <LACOMTS-AUFTRAG-POS> <K>267</K> <S> </S> <V>-</V> <Q>100</Q> <L>01</L> <T>05</T> <F>08</F> </LACOMTS-AUFTRAG-POS> <LACOMTS-AUFTRAG-POS> <K>267</K> <S> </S> <V>+</V> <Q>100</Q> <L>01</L> <T>05</T> <F>08</F> </LACOMTS-AUFTRAG-POS> <LACOMTS-AUFTRAG-POS> <K>249</K> <S> </S> <V>+</V> <Q>6000</Q> <L>01</L> <T>01</T> <F>03</F> <U10>0001</U10> <U11>ST</U11> <U12>6000</U12> </LACOMTS-AUFTRAG-POS> Page 9

10 </LACOMTS-AUFTRAG> 6.3. Importdatei Artikelbestand Artikelbestand XML - Format <?xml version="1.0"?> <LACOMTS-ARTIKEL> <ARTIKEL> <S>111</S> <N/> <L>1</L> <T>1</T> <F>2</F> <I>1</I> <B>1000</B> <R>0</R> <G>101</G> <ZDAT> :11: </ZDAT> </ARTIKEL> <ARTIKEL> <S>12345</S> <N/> <L>1</L> <T>3</T> <F>3</F> <O>3</O> <I>1</I> <B>1000</B> <R>0</R> <G>101</G> <ZDAT> :48: </ZDAT> </ARTIKEL> <ARTIKEL> <S> </S> <N/> <L>1</L> <T>5</T> <F>8</F> <I>1</I> <B>100</B> <R>0</R> <G>101</G> <ZDAT> :42: </ZDAT> </ARTIKEL> <ARTIKEL> <S> </S> <N/> <L>1</L> <T>1</T> <F>3</F> <I>1</I> <B>24000</B> <R>0</R> Page 10

11 <G>101</G> <ZDAT> :44: </ZDAT> </ARTIKEL> </LACOMTS-ARTIKEL> 6.4. Exportdatei Bewegungen Geplante Bewegungen Geplante Bewegungen entstehen durch das Abarbeiten von Kommisionierlisten am LeanLift oder Rotomat. Das K-Feld enthält dann die Auftragsnummer Ungeplante Bewegungen Ungeplante Bewegungen entstehen durch das Ein- und Auslagern von Artikeln am LeanLift oder Rotomat. Das K-Feld enthält dann keine Auftragsnummer Format der Bewegungen Die Felder U01 bis U09 werden im Bewegungsjournal mit folgenden Werten gefüllt: U01 Auftragsnummer, wie im K-Feld U02 Datum der Bewegung. Format: JJJJMMTT U03 Uhrzeit der Bewegung. Format: HHMMSS U04 reserviert U05 reserviert U06 reserviert U07 reserviert U08 reserviert U09 reserviert Bewegungsdatei CSV - Format Die erste Zeile enthält immer die Feldnamen. S;K;V;Q;G;W;L;T;F;O;U01 U25;H01 H25 " ";"267";"-";100;101;3;1;5;8;1;"267";" ";"100438";;;;;;;;;;;;;;;;;;;;; " ";"267";"+";100;101;3;1;5;8;1;"267";" ";"100444";;;;;;;;;;;;;;;;;;;;; " ";"249";"+";6000;101;3;1;1;3;1;"249";" ";"100506";;;;;;;"0001";"ST";" Bewegungsdatei XML - Format <?xml version="1.0"?> <LACOMTS-BEWEGUNGEN> <BEWEGUNG> <S> </S> Page 11

12 <K>267</K> <V>-</V> <Q>100</Q> <G>101</G> <W>3</W> <L>1</L> <T>5</T> <F>8</F> <U01>267</U01> <U02> </U02> <U03>104242</U03> <U04/> <U25/> <H01/> <H25/> </BEWEGUNG> <BEWEGUNG> <S> </S> <K>267</K> <V>+</V> <Q>100</Q> <G>101</G> <W>3</W> <L>1</L> <T>5</T> <F>8</F> <U01>267</U01> <U02> </U02> <U03>104247</U03> <U04/> <U25/> <H01/> <H25/> </BEWEGUNG> <BEWEGUNG> <S> </S> <K>249</K> <V>+</V> <Q>6000</Q> <G>101</G> <W>3</W> <L>1</L> <T>1</T> <F>3</F> <U01>249</U01> <U02> </U02> <U03>104305</U03> <U04/> <U05/> <U06/> <U07/> <U08/> Page 12

13 <U09/> <U10>0001</U10> <U11>ST</U11> <U12>6000</U12> <U13/> <U25/> <H01/> <H25/> </BEWEGUNG> </LACOMTS-BEWEGUNGEN> 7. Anhang 7.1. CSV Character Separated Values Eine CSV-Datei ist eine Text-Datei, die tabellarisch strukturierte Daten enthält und vorrangig zum Datenaustausch verwendet wird. Das Kürzel CSV steht dabei für Character Separated Values oder Comma Separated Values, weil die einzelnen Werte durch ein spezielles Trennzeichen - in vielen Fällen das Komma - getrennt werden. Ein offizieller Standard für das Dateiformat existiert nicht. Kommt das Trennzeichen in den Datenelementen vor, so müssen vor und hinter dem Element doppelte Hochkommata (") stehen. Ist ein Hochkomma selbst Teil des Datenelements, so wird es verdoppelt. Das Trennzeichen muss nicht das Komma sein, auch Semikolon, Doppelpunkt, Tabulator und andere Zeichen sind üblich. Einzelne Datensätze werden in der Regel durch einen Zeilenumbruch (bei Windows: CR LF = carriage return, line feed; bei Unix: nur LF; bei Mac OS: nur CR) getrennt. In der ersten Zeile stehen oft die Feldnamen. Das CSV-Format ist unabhängig von Zeichencodierung, Byte-Reihenfolge und Zeilenumbruchszeichen. Beispiel: Inhalt einer CSV-Datei (hier mit Semikolon als Trennzeichen) Stunde;Montag;Dienstag;Mittwoch;Donnerstag;Freitag 1;Mathe;Deutsch;Englisch;Mathe;Kunst 2;Sport;Französisch;Geschichte;Sport;Geschichte 3;Sport;"Religion ev;kath";kunst;deutsch;kunst In diesem Beispiel werden die Hochkommata verwendet, um das Semikolon zwischen ev und kath in der letzten Zeile als Text zu kennzeichnen. Das 3. Element dieser Zeile würde nach einem Import also Religion ev;kath lauten. Beim Import einer solchen Texttabelle in eine Tabellenkalkulation o.ä. muss immer angegeben werden, ob die erste Zeile die Feldnamen enthält (hier: ja), welches das Feldtrennzeichen ist (hier: Semikolon), und wie die Datensätze untereinander getrennt sind (hier: CR LF). Page 13

14 Anderes Beispiel: ID Kundennummer Name Vorname Anrede Mustermann Karl Herr Mustermann Sabine Frau Mustersen Jens Pater CSV-Dateien tragen auch oft die Dateiendung.txt statt.csv und können auch in jedem Texteditor erstellt und bearbeitet werden. Das CSV-Dateiformat wird oft benutzt, um Daten zwischen unterschiedlichen Computerprogrammen auszutauschen (es ist also ein Austauschformat). Die Verwendung des Formates in den von Microsoft Excel verwendeten Formen hat sich als Pseudostandard etabliert. Für neuere Anwendungen wird XML verwendet. Dieser Text wurde von übernommen XML Extensible Markup Language Die Extensible Markup Language, abgekürzt XML, ist ein Standard zur Erstellung strukturierter, maschinen- und menschenlesbarer Dateien. XML definiert dabei den grundsätzlichen Aufbau solcher Dateien. Für die konkreten Anwendungsfälle müssen die Details des Dateiaufbaus jedoch weiter spezifiziert werden. XML ist damit ein Standard zur Definition von beliebigen, in ihrer Grundstruktur jedoch stark verwandter Auszeichnungssprachen. XML ist eine vereinfachte Teilmenge von SGML. Die Namen der einzelnen Strukturelemente für eine bestimmte Auszeichnungssprache lassen sich frei wählen, diese Auszeichnungssprachen können dabei alle möglichen Daten beschreiben, als prominentestes Beispiel Text, aber auch Grafiken oder abstraktes Wissen. Ein Grundgedanke hinter XML ist es, Daten und ihre Repräsentation zu trennen Fachtermini Ein XML-Dokument ist wohlgeformt, d.h. es hält sämtliche Regeln für XML ein (was z. B. Verschachtelungen von Elementen betrifft). Programme, die XML-Daten verarbeiten, nennt man XML-Parser. Soll XML für den Datenaustausch verwendet werden, ist es von Vorteil, wenn das Format mittels einer Dokumenttypdefinition (DTD) oder einem XML-Schema definiert ist. Ein XML-Dokument, welches das durch eine Dokumenttypdefinition oder ein XML Schema beschriebene Format einhält, heißt gültig Aufbau eines XML-Dokuments Beispiel einer XML-Datei <?xml version="1.0"?> <enzyklopaedie> Page 14

15 <eintrag> <stichwort>genf </stichwort> <eintragstext>genf ist der Sitz von</eintragstext> </eintrag> </enzyklopaedie> Dieser Text wurde teilweise von übernommen. Page 15