Dieses Entwicklungstool (Java-Package) setzt sich im wesentlichen aus 5 Bereichen (Package) zusammen. 3 Definitionsbereiche und 2 Funktionsbereiche. Die Definitionsbereiche beschreiben den Aufbau und die Struktur einer EDIFACT-Nachricht. Die Funktionsbereiche steuern und verarbeiten die EDIFACT-Nachricht bzw. die EDIFACT-Daten.

• edifact.datenelemente.*
• Dieses Datenelementverzeichnis enthält eine Aufstellung einiger Datenelemente, die in den Segmenten der EDIFACT-Nachrichtentypen vorkommen können, die bis einschließlich Juli 2001 veröffentlicht wurden. Für codierte Datenelemente sind die entsprechenden Codewerte einzutragen. Jedes Datenelement ist mit folgenden Informationen versehen: Definition, Name und Beschreibung. Ein Datenelement ist der Grundbaustein, der eine Information darstellt. Es ist vergleichbar mit einem Datenfeld. Die Datenelemente stehen innerhalb eines Segmentes immer in einer fest definierten Reihenfolge. Anhand ihrer Position im Segment können sie identifiziert werden.
• edifact.gruppen.*
• Die Datenelementgruppe ist eine Zusammenfassung von Datenelementen mit Informationen, die in einem sachlichen oder logischen Zusammenhang stehen. Die Datenelemente und Datenelementgruppen stehen innerhalb eines Segmentes immer in einer fest definierten Reihenfolge. Anhand ihrer Position im Segment können sie identifiziert werden.


• edifact.segmente.*
• Das Segment ist die Zusammenfassung von logisch zusammenhängenden Datenelementen und/oder Datenelementgruppen. Es ist vergleichbar mit einem Datensatz. Die Segmente stehen innerhalb einer Nachricht immer in der im Nachrichtenaufbau-Diagramm definierten Reihenfolge. Jedes Segment wird durch einen Segment-Bezeichner identifiziert. Es werden Nutzdaten-Segmente und Service-Segmente unterschieden. Die Nutzdaten-Segmente enthalten alle Informationen des Geschäftsvorgangs. Die Service-Segmente dienen als Nutzdatenrahmen der Identifikation und Strukturierung der Übertragungsdatei.
• edifact.funktionen.*
• EDIFACT-Daten einlesen. Die Klasse EDIDataReader liest EDI-Daten entweder als Datei oder als InputStream ein und gibt als Ergebnis ein Vector mit den Segmenten und Feldinhalten zurück. Struktur des Ergebis: Vector(Segmente)->Vector(Feldinhalt;Nr. Datenelement;Nr. Gruppendatenelement). Folgende Parameter können an die Klasse übergeben werden:
  • ohne: Ein Datei-Öffnen Dialog wird angezeigt. Eine EDI-Datei kann manuell ausgewählt werden.
  • Dateiname der EDI-Datei: Die EDI-Datei wird eingelesen und an die Verarbeitung übergeben.
  • InputStream: EDI-Daten werden als Stream an die Klasse übergeben und an die Verarbeitung weitergeleitet.
• EDIFACT-Daten schreiben. Mit der Klasse EDIDataWriter kann eine Datei geöffnet werden, indem der Dateiname als String-Parameter StringEDIData übergeben wird. Falls StringEDIData eine bereits vorhandene Datei bezeichnet, wird sie geöffnet und ihr bisheriger Inhalt gelöscht, andernfalls wird eine neue Datei mit diesem Namen angelegt. Sukzessive Aufrufe von outputEDIRecord(String StringEDIData) schreibt weitere Segmente in diese Datei.
• EDIFACT-Segment komprimieren. Die Klasse CompressSegment() ist Bestandteil der Segmentdefinitionen und wird hier nicht weiter beschrieben.
• EDIFACT-Segment dekomprimieren. Die Klasse DeCompressSegment() ist Bestandteil des EDIDataReader und wird hier nicht weiter beschrieben.
• edifact.funktionen.xml.*
• XML-Daten generieren. Die Klasse GenerateEdiToXml generiert EDIFACT-Strukturen/Daten in XML-Strukturen/Daten.
  • setXmlFileForEDIKeys(String xmlfile): Dateiname der XML-Datei mit den EDI/XML Umschlüsselungen
  • changeEdiToXml(Vector ediRecords): Generiert die XML-Daten aus dem EDI-Vector (Siehe bitte EDIDataReader)
  • org.w3c.dom.Document getXmlDocument(): Gibt die generierten XML-Daten als DOM Document zurück.
• petools.*
• Systemdatum lesen. Die Methode getdatum() der Klasse EDITools liest das Systemdatum ein und gibt das Datum im Format JJMMTT wieder zurück. Das gelesene Datum kann dann in die entspr. EDIFACT-Felder übertragen werden.
• Systemzeit lesen. Die Methode getzeit() der Klasse EDITools liest die Systemzeit ein und gibt die Uhrzeit im Format HHMM wieder zurück. Die gelesene Uhrzeit kann dann in die entspr. EDIFACT-Felder übertragen werden.
• Referenznummer vergeben. Die Methode getReferenzNummer() der Klasse EDITools generiert eine eindeutige Referenznummer. Das Generieren einer Referenznummer wird nur benötigt, wenn keine eigenen Referenznummern gebildet werden können. Eine eindeutige Referenznummern wird z.B. im UNB-Segment - Feld 0020 - Datenaustauschreferenz - benötigt. Die Datenaustauschreferenz wird vom Sender der Übertragungsdatei generiert und dient der eindeutigen Identifikation jeder Übertragungsdatei.
• saptools.*
Mit dieser Funktion kann aus einer Idoc-Beschreibung ein SQL-Script generiert werden. Die IDOC-Beschreibung kann mit der Transaktion WE60 (unkonvertiert) exportiert werden. Als Ergebnis wird eine SQL-Statement-Datei erzeugt/generiert. Dieses Statement auf der Zieldatenbank ausgeführt, erstellt die entspr. Datenbanktabellen um EDI-Daten in IDOC-Strukturen abzulegen. Wird kein Parameter mitgegeben, wird ein Datei-Oeffnen-Dialog gestartet. Hier kann dann die aus SAP exportierte IDOC-Beschreibung ausgewählt werden.

Kurzbeispiele

Beispiel: EDIDataReader(Param) // Segmentvector anlegen. public Vector SegmentInhalt = new Vector(); // initialisieren SegmentInhalt.clear(); // Reader ohne Parameter erzeugen. Öffnen Dialog wird angezeigt EDIDataReader Rec = new EDIDataReader(); // Alle EDI-Segment lesen SegmentInhalt = Rec.getEDIRecords(); Im Panel() anzeigen. Siehe EDIViewer -> makeTree(SegmentInhalt); private DefaultMutableTreeNode makeTree(Vector EDIDataVector) { DefaultMutableTreeNode t = new DefaultMutableTreeNode("EDI Daten"); for ( Enumeration DataVector = EDIDataVector.elements(); DataVector.hasMoreElements() ; ) { fieldElements = (Vector)DataVector.nextElement(); for ( Enumeration FieldVector = fieldElements.elements(); FieldVector.hasMoreElements() ; ) { FieldID Field = (FieldID)FieldVector.nextElement(); if (Field.getValue().equals("UNA")) { kopfSegment = new DefaultMutableTreeNode(setzeCounter()+ "Trennzeichen-Vorgabe"); t.add(kopfSegment); } if (Field.getValue().equals("UNB")) { kopfSegment = new DefaultMutableTreeNode(setzeCounter()+ "nutzdaten-kopfSegment"); t.add(kopfSegment); } if (Field.getValue().equals("UNH")) { kopfSegment = new DefaultMutableTreeNode(setzeCounter()+ "nutzdaten"); t.add(kopfSegment); } if (Field.getValue().equals("UNZ")) { kopfSegment = new DefaultMutableTreeNode(setzeCounter()+ "nutzdaten-Endesegment"); t.add(kopfSegment); } if ((Field.getDE() == 0) && (Field.getGDE() == 0)) { nutzdaten = new DefaultMutableTreeNode(setzeCounter()+ Field.getValue()+" : "+getString(Field.getValue())); } if (!(Field.getDE() == 0) || !(Field.getGDE() == 0)) { datenSegment = new DefaultMutableTreeNode(setzeCounter()+ "I: <"+Field.getValue()+"> "+ "DE #: <"+Field.getDE()+"> "+ "GD #: <"+Field.getGDE()+">"); nutzdaten.add(datenSegment); } kopfSegment.add(nutzdaten); } // For } // For return t; }

Beispiel: EDIDataWriter(String EDIFileName) UNA una = new UNA(); // Trennzeichen-Vorgabe DTM dtm = new DTM(); // Datum anlegen // EDIDataWriter anlegen und öffnen. EDIDataWriter EDIDatei = new EDIDataWriter(EDIDateiName); // Felder des Datum-Segmentes dtm.setC507_2005("137"); dtm.setC507_2380(Zeile.substring(135,139)+ // JJJJ Zeile.substring(132,134)+ // MM Zeile.substring(129,131)); // TT dtm.setC507_2379("102"); // Segment in die Ausgabe schreiben. EDIDatei.OutputEDIRecord(dtm.getCompressSegment(una)); // Ausgabe schliessen. EDIDatei.CloseEDIRecord();

Beispiel: Referenznummer vergeben public EDITools EDIRef = new EDITools(); // Rechnungslistennummer und Rechnungslistendatum rff.setC506_1153("ABO"); if (TextFieldReliNr.getText().equals("")) { rff.setC506_1154(EDIRef.getReferenzNummer()); } else { rff.setC506_1154(TextFieldReliNr.getText()); } EDIDatei.OutputEDIRecord(rff.getCompressSegment(una)); dtm.setC507_2005("171"); dtm.setC507_2380(Zeile.substring(135,139)+ // JJJJ Zeile.substring(132,134)+ // MM Zeile.substring(129,131)); // TT dtm.setC507_2379("102"); EDIDatei.OutputEDIRecord(dtm.getCompressSegment(una));

Beispiel: Datum und Uhrzeit vergeben. public EDITools EDIRef = new EDITools(); unb.setS001_0001("UNOA"); unb.setS001_0002("3"); unb.setS002_0004(Zeile.substring(34,47).trim()); // ILN-Sender unb.setS002_0007("14"); unb.setS003_0010(Zeile.substring(20,33).trim()); // ILN-Empfänger unb.setS003_0007("14"); unb.setS004_0017(EDIRef.getDatum()); unb.setS004_0019(EDIRef.getZeit());

Beispiel: EDI-Daten in XML-Daten umwandeln. // EDIFACT-Datei einlesen. ediRecords.clear(); // EDIFACT-Daten einlesen. EDIDataReader Rec = new EDIDataReader(); ediRecords = Rec.getEDIRecords(); // EDIFACT-Dokument in ein XML-Dokument konvertieren GenerateEdiToXml gex = new GenerateEdiToXml(); // Übersetzungsdatei laden. // Wird keine Übersetzungsdatei geladen, werden Standardwerte geladen. Siehe Doku gex.setXmlFileForEDIKeys("editoxml.xml"); gex.setDebug(true); // EDIFACT-Inhalt übersetzen. gex.changeEdiToXml(ediRecords); // XML-Dokument in die Ausgabe schreiben. OutputFormat format = new OutputFormat( gex.getXmlDocument() ); //Serialize DOM StringWriter stringOut = new StringWriter(); //Writer will be a String XMLSerializer serial = new XMLSerializer( stringOut, format ); serial.asDOMSerializer(); // As a DOM Serializer serial.serialize( gex.getXmlDocument().getDocumentElement() ); // Ausgabe der XML-Datei System.out.println( "EdiToXml = " + stringOut.toString() );

Beispiel: EDI-Tags in XML-Tags umschlüsseln. < ?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?> < EDItoXML > < BGM name="beginning_of_message_details"> < BGM_1_0 name="document_message_name_coded"> < BGM_2_0 name="document_message_number"> < BGM_3_0 name="message_function_coded"> < /BGM> < UNH name="message_header_details"> < UNH_1_0 name="message_reference_number"> < UNH_2_0 name="message_type_identifier"> < UNH_2_1 name="message_type_version_number"> < UNH_2_2 name="message_type_release_number"> < UNH_2_3 name="controlling_agency"> < UNH_2_4 name="association_assigned_code"> < /UNH> < /EDItoXML>

Beispiel: Datenbanktabellen aus Idoc-Beschreibung erstellen. /** * @param args the command line arguments */ public static void main (String args[]) { CreateIDOCTables sapidoc = new CreateIDOCTables("orders05.txt"); }