Generierung eines CIM Frachtbriefes im PDF-Format

Transkript

1 Generierung eines CIM Frachtbriefes im PDF-Format Abstract: Das Ziel ist es, innerhalb des CIS Print Projektes, ein CIM Frachtbrief Formular zu generieren, zu drucken und dies den Schnittstellen zur Verfügung zu stellen. Für das Formular-Layout wird XSL-FO eingesetzt. Mit Hilfe von XSLT, XPATH und einem Dokumentgenerator werden Sendungsdaten in den dafür vorgesehenen Feldern repräsentiert. Klasse.Nr Autoren: Betreuer: Experte: MAS Ahmed Hamza Spitalweg Murten Tel: Stephan Moser SBB Informatik Lindenhofstrasse Worblaufen stephan.mst.moser@sbb.ch Dr. Beatrice Amrhein Software-Schule Schweiz Wankdorffeldstrasse 102 CH-3014 Bern Tel.: beatrice.amrhein@bfh.ch Datum:

2 Zusammenfassung Einleitung Diese Diplomarbeit ist ein Teil des CIS Print Projektes, das zum Ziel hat, alle für SBB Cargo relevanten Beförderungsdaten in elektronischer Form zu generieren und zu drucken. Hauptdokument für einen Cargo Transport ist der so genannte CIM Frachtbrief, auf dem alle erfassten Sendungsdaten ersichtlich sind und der den Güterwagen begleitet. Dieses Dokument soll im CIS Print realisiert werden. Zielsetzung Das Ziel dieser Diplomarbeit ist es, der SBB Cargo und ihren Kunden die Möglichkeit zu geben, die CIM Frachtbriefe im Cargo Informationssystem (CIS Cargo), in dessen Internet Schnittstelle (CIS Online) und der CIS Client Schnittstelle elektronisch im PDF Format zu drucken. Realisierung In einem ersten Schritt wird das Layout vom CIM Frachtbrief Formular mit Hilfe von XSL-FO erstellt. Der zweite Schritt besteht daraus, einen Dokumentgenerator (Frachtbrief Generator) in Java zu schreiben. Dieser Generator muss die Spezifikation gemäss dem Geschäftsprozess der Sendungsabfertigung von SBB Cargo anwenden. Mit Hilfe von XSLT und XPATH werden die Beförderungsdaten in den dafür vorgesehenen Feldern des CIM Frachtbriefes repräsentiert. Schließlich sollen die Applikationen CIS Online und CIS Client erweitert werden, damit die Kunden von dort aus die CIM Frachtbriefe drucken können. Besprechung Die Ziele, die im Pflichtenheft definiert wurden, konnten vollumfänglich realisiert werden. Generierung eines CIM Frachtbriefes im PDF-Format Seite 2

3 Inhaltsverzeichnis 1. Vorbemerkungen Leserkreis Aufbau des Dokuments Glossar Ausgangslage Umfeld IST-Situation Anforderungen Projektziele Analyse CIM Frachtbrieflayout Frachtbriefgenerator CIS Print Umfeld Produkt Frachtbriefgenerator Aufruf des Frachtbriefdruckes aus der CIS Online Schnittstelle Use case Diagramm Benutzerkreise (Actors) Anwendungsfall Diagramm: Frachtbriefdruck Aufruf des Frachtbriefdruckes aus der CIS Client Schnittstelle Sequenz Diagramm Frachtbriefgenerator innerhalb CIS Print Frachtbriefdruckdaten CIM Frachtbriefdruckkriterien Frachtbriefdruckstatus Verkehrsart der Sendung Drucken Seite 2 des CIM Frachtbriefes Sprache CIM Frachtbrieffelder CIM Frachtbrieffelder und -Bedingungen Frachtbrieffelder ohne Sendungsdaten Spezielle Darstellung Felder 21, 24, Technische Attributliste des CIM Frachtbriefes Design & Implementierung CIM Frachtbrieflayout Allgemeines Die Style-Informationen Die frachtbrief-xsl.xsl Datei Die frachtbriefdaten-seite1 und 2.xsl Dateien Die pagemaster-xsl.xsl Die tablemaster.xsl Datei Implementierung und Testen mit Oxygen Frachtbriefgenerator Die Klasse (FrachtbriefDocGen.java) Die Methode generate() Die Methode createrootelement() Methode createfrachtbriefelement() Methode createfbseite1element() Methode createcimodercuvelement Stammdaten Die Utility Klassen...46 Generierung eines CIM Frachtbriefes im PDF-Format Seite 3

4 6.2.4 Objektbaum und Klassendiagramm Aufruf des Frachtbriefdruckes aus CIS Online Allgemeines CIS Online Überblick Klasse DocGenBefaService CIS Online Erweiterungen und Anpassungen Maske Suchkriterien Maske drucken / Korrekturen Testen Allgemeines Test Frachtbriefgenerator im CIS Print Vorgehen Input XML File (printbefa.xml) Testbeispiel Kleiner Auszug der getesteten Sendungen: Test Aufruf des Frachtbriefdruckes aus CIS Online Test Aufruf des Frachtbriefdruckes aus CIS Client...63 Anhang...64 A Muster CIM Frachtbriefformular Seite B Muster CIM Frachtbriefformular Seite C Quellenverzeichnis...66 Generierung eines CIM Frachtbriefes im PDF-Format Seite 4

5 Abbildungsverzeichnis Abbildung 1 : CIS Cargo und deren Schnittstellen...8 Abbildung 2 : BefaData...12 Abbildung 3 : Use case...14 Abbildung 4 : Sequenz Diagramm...17 Abbildung 5 : Seitenaufteilung...31 Abbildung 6 : Header...32 Abbildung 7 : Feldbeschreibung...33 Abbildung 8 : tablemaster...35 Abbildung 9 : Generierung eines Frachtbriefes im Oxygen...36 Abbildung 10 : die Klasse FrachtbriefDocGen...37 Abbildung 11 : Parameter der Methode createrootelement...39 Abbildung 12 : Objektbaum...39 Abbildung 13 : Klassendiagramm Frachtbriefgenerator...48 Abbildung 14 : Struts und Model 2 Prinzip...49 Abbildung 15 : Klassendiagramm DocGenBefa...50 Abbildung 16: Schematische Darstellung um den Frachtbrief zu drucken...52 Abbildung 17 : Maske Suchkriterien...53 Abbildung 18 : Maske drucken / Korrekturen...56 Abbildung 19 : CIS Client Sendungsdatenerfassung...61 Abbildung 20 : Sendung = Abbildung 21 : Frachtbriefdruck aus CIS Online...63 Generierung eines CIM Frachtbriefes im PDF-Format Seite 5

6 1. Vorbemerkungen Die in diesem Dokument beschriebene Implementierung bzw. Generierung eines CIM Frachtbriefes (siehe Anhang A&B) und dessen Abruf von CIS Online und CIS Client wird im Rahmen einer Diplomarbeit für die Master Thesis an der Berner Fachhochschule realisiert. 1.1 Leserkreis Zu dem Leserkreis gehören folgende Personen: Experten, Betreuer, Mitarbeiter von SBB AG, Mitarbeiter von SBB Cargo AG. 1.2 Aufbau des Dokuments Der Diplombericht bezieht sich auf das Pflichtenheft. Das Dokument beschreibt die Ausgangslage und die Analyse sowie die Anforderungen in fachlicher und technischer Hinsicht für die Implementierung von einem CIM Frachtbrief. Danach beschreibt das Dokument die Realisierung (Design und Implementierung) des Frachtbrieflayouts, des Frachtbriefgenerators und deren Aufruf von der Schnittstelle CIS Online. Weiter wird erläutert, wie das System getestet wurde. Das Dokument beschreibt auch gewisse Bestandteile von CIS Print, welche für die Nachvollziehbarkeit der Arbeit notwendig sind. 1.3 Glossar CIM CIS Cargo CIS Online CIS Client CIS Print XML XSL XSLT XPATH XSL-FO Einheitliche Rechtsvorschriften für den Vertrag über die internationale Eisenbahnbeförderung von Gütern Cargo Informationssystem (Sendungsabfertigungssystem) Internet Schnittstelle zu CIS Cargo, welche den Kunden die Möglichkeit gibt, auf elektronischem Weg Daten mit SBB Cargo auszutauschen. Dezentraler Teil von CIS Cargo, welcher innerhalb der SBB benutzt wird. In Java geschriebene Standalone Applikation, welche zum Ziel hat, alle SBB Cargo relevante Dokumente elektronisch zu generieren. (Extensible Markup Language) ist eine Auszeichnungssprache zur Darstellung hierarchisch strukturierter Daten in Form von Textdateien. (Extensible Stylesheet Language) ist eine Familie von Sprachen zur Erzeugung von Layouts für XML-Dokumente. (XSL Transformation) ist die Sprache, um XML umzuwandeln. (XML Path Language) ist eine vom W3-Konsortium entwickelte Anfragesprache, um Teile eines XML-Dokumentes zu adressieren. (Extensible Stylesheet Language Formatting Objects) ist eine XML- Anwendung, die beschreibt, wie Text, Bilder, Linien und andere grafische Elemente auf einer Seite angeordnet werden. Generierung eines CIM Frachtbriefes im PDF-Format Seite 6

7 SVG FOP RAD Websphere (Scalable Vector Graphics) ist ein Standard zur Beschreibung zweidimensionaler Vektorgrafiken in der XML-Syntax. (Formatting Object Processor ) ist ein Druckformatierer, welcher XML- Dokumente gemäss einem XSL-FO Dokument in ein PDF-Dokument umwandelt. Rational Application Developer von IBM Produktlinie der Firma IBM, die unterschiedliche Software für Anwendungsintegration, Infrastruktur und eine integrierte Entwicklungsumgebung umfasst. RUP Abkürzung für Rational Unified Process, iterativer Softwareentwicklungsprozess. JAR Java Archive, gepackte Archivdatei ähnlich wie ZIP. MQ IMS Struts Servlet JSP CUV FBA NHM RID CIT UIC Plattformunabhängige Middleware-Software der Firma IBM. Informationssystem der Firma IBM. Es besteht aus den Komponenten IMS/DB (hierarchisches Datenbanksystem) und IMS/TM (Transaktionsmonitor frühere Bezeichnung: IMS/DC). Der IMS/TM kann auch ohne die IMS/DB eingesetzt werden. Er bietet Schnittstellen via MQSeries, TCP/IP und Java. Open-Source-Framework für die Präsentations- und Steuerungsschicht von Java-Webanwendungen. Als Servlets bezeichnet man Java-Klassen, deren Instanzen innerhalb eines J2EE Applicationservers Anfragen von Clients entgegennehmen und beantworten. JavaServer Pages, abgekürzt JSP, ist eine von Sun Microsystems entwickelte auf JHTML basierende Technik, die im Wesentlichen zur einfachen dynamischen Erzeugung von HTML- und XML-Ausgaben eines Webservers dient. Leerwagen Sendungen Frachtberechnungsabschnitt Das harmonisierte Güterverzeichnis (franz: Nomenclature harmonisée des marchandises NHM) ist ein System des Internationalen Eisenbahnverbandes zur einheitlichen Klassifizierung von Gütern im Eisenbahngüterverkehr. Regelung zur internationalen Beförderung gefährlicher Güter im Schienenverkehr bzw. Ordnung für die internationale Eisenbahnbeförderung gefährlicher Güter. Internationales Eisenbahntransportkomitee Internationaler Eisenbahnverband Generierung eines CIM Frachtbriefes im PDF-Format Seite 7

8 2. Ausgangslage 2.1 Umfeld Das Cargo Sendungsabfertigungssystem (CIS Cargo) ist das Kernprodukt für das Auftragsund Transportmanagement. Alle nationalen und internationalen Cargo Transporte werden durch dieses System gesteuert. Eine der Hauptaufgaben des Systems ist die zentrale Sendungsdatenerfassung. Um einen Beförderungsauftrag im CIS Cargo erfassen zu können, braucht die SBB Cargo von ihren Kunden die Beförderungsdaten (z.b. Absender, Empfänger, Ware, Lieferungsdatum, Versandbahnhof, Empfangsbahnhof). Um diese Daten an die SBB Cargo zu übermitteln, stehen dem Kunden mehrere Möglichkeiten zur Verfügung: Er kann die Daten via Fax an das Call Center der SBB Cargo schicken, wo ein Mitarbeiter sie manuell mit Hilfe von CIS Client (dezentraler Teil vom Sendungsabfertigungssystem) erfasst und bearbeitet. Er kann die Daten selber elektronisch via eine Internet Schnittstelle (CIS Online) erfassen und an CIS Cargo senden, wo sie dann teilweise von den SBB Cargo Mitarbeitern weiterverarbeitet werden. Ca. 35% der Sendungsdaten kommen via CIS Online. Er kann seine Daten via Edifact Schnittstelle (Business Business) an CIS Cargo senden. Abbildung 1 : CIS Cargo und deren Schnittstellen Generierung eines CIM Frachtbriefes im PDF-Format Seite 8

9 2.2 IST-Situation CIS Cargo ist ca. 20 Jahre alt und wurde in den Programmiersprachen Cobol, C sowie Cool:Gen geschrieben. Letztes Jahr wurde ein Projekt lanciert, um CIS Cargo zu erneuern. Das erste Teilprojekt ist das so genannte CIS Print. CIS Print ist zum aktuellen Zeitpunkt eine Java Standalone Applikation, welche die Voraussetzung bietet, mit möglichst geringem Aufwand einen Dokumenten-Generierungsservice zu bauen. Eine der ersten Aufgaben von CIS Print ist die Dokumentgenerierung. Hauptdokument für einen Cargo Transport ist der so genannte Frachtbrief (FBF), auf welchem die erfassten Sendungsdaten ersichtlich sind und der den Güterwagen begleitet. Die IST-Situation kann wie folgt zusammengefasst werden: Die momentan genutzte Möglichkeit, den CIM Frachtbrief im CIS Cargo zu drucken, ist veraltet und muss abgelöst werden. Die Möglichkeit, den CIM Frachtbrief elektronisch zu drucken, ist im CIS Print nicht realisiert. Zudem gibt es von der Schnittstelle CIS Online aus keine Möglichkeit den CIM Frachtbrief zu drucken. 2.3 Anforderungen Das CIM Frachtbrief Formular soll im CIS Print implementiert werden, um das veraltete Verfahren des Frachtbriefdrucks abzulösen. Es soll möglich sein, einen CIM Frachtbrief oder eine Liste von CIM Frachtbriefen zu drucken. Zusätzlich soll auch den Kunden der Internet Schnittstelle CIS Online und CIS Client, die Möglichkeit geboten werden, den CIM Frachtbrief mittels CIS Print zu drucken. Generierung eines CIM Frachtbriefes im PDF-Format Seite 9

10 3. Projektziele Das Ziel des Projektes (Diplomarbeit) ist: den CIM Frachtbrief auf der neuen CIS Print Javaplattform zu generieren. Dazu gehören: - Design und Layout des CIM Frachtbriefes, - Frachtbriefgenerator programmieren. den CIS Online Kunden die Möglichkeit zu geben, aufgrund der erfassten Beförderungsdaten Frachtbriefe zu drucken. Mit Hilfe von Masken ist es im CIS Online möglich aufgrund einiger Kriterien Beförderungsdaten zu suchen und das dazugehörige Suchresultat darzustellen. Aber damit der Kunde einen ausgewählten Frachtbrief drucken kann, müssen auch: - die Maske für die Darstellung der Suchresultate, welche den Kunden zur Auswahl zur Verfügung steht, für die CIM Frachtbriefgenerierung erweitert werden; - alle nötigen Klassen realisiert oder erweitert werden, damit der Aufruf von CIS Print für die CIM Frachtbriefgenerierung möglich wird. den CIS Kunden die Möglichkeit zu geben, auf der neuen Plattform die Frachtbriefe zu drucken. Allerdings gehört hier die Implementierung der Maske für die Eingabe der Suchkriterien und ihre Darstellung nicht zum Projektziel. Generierung eines CIM Frachtbriefes im PDF-Format Seite 10

11 4. Analyse In diesem Kapitel wird eine kurze Übersicht über das CIM Frachtbrieflayout, den Frachtbriefgenerator, den Aufruf des Frachtbriefdruckes aus der CIS Online Schnittstelle und die definierten Use-Cases beschrieben. Es soll einen kurzen Einstieg in das Thema ermöglichen. 4.1 CIM Frachtbrieflayout Ein CIM Frachtbrief ist ein Formular, das kommerzielle Beförderungsdaten für den internationalen Güterverkehr enthält und dessen Layout den Richtlinien des Internationalen Eisenbahntransportkomitees (CIT) entspricht. Ein CIM Frachtbrief besteht aus 2 Seiten. Beide Seiten sind in ca. 100 Feldern eingeteilt, die ihrerseits nach logischen Zusammenhängen (Geschäftprozesse) gruppiert sind (z. B. Versanddaten, Empfangsdaten, Finanzdaten, FBA ). Jedes Feld ist nummeriert und einige davon sind zweisprachig (Französisch und Deutsch) beschriftet (siehe Anhang A&B). Ausführliche Informationen zum CIM Frachtbrief finden sich im Dokument Handbuch CIM- Frachtbrief (GLV-CIM) unter folgendem Link: Die zusätzlichen CIM-Frachtbrief-Dokumente Frankaturrechnung Teile 1-3 Frankaturrechnung Seite 2 Teile 1-3 Wagenliste sind nicht Bestandteil dieser Diplomarbeit. Bei den CIM Frachtbriefausdrucken sollen folgende Punkte gemäss CIT beachtet werden: Druckfarbe: grün oder schwarz Inhalt: erfasste Beförderungsdaten und - Vermerk «Originalausdruck des elektronischen Frachtbriefs mit gleicher Beweiskraft wie der Papier-Frachtbrief JJJJ-MM-TT (Ausdruckdatum) ausgestellt durch (Beförderer)», - Vermerk «Kopie», falls wegen Beschädigung oder Verlust des Originalausdrucks ein zusätzlicher Ausdruck erstellt werden muss. Format und Darstellung (Layout): so wenig Abweichungen vom Muster wie möglich. Um dieses Ziel zu erreichen wird das Layout des CIM Frachtbriefes mit Hilfe von XSL-FO realisiert, da XSL-FO das visuelle Layout-Modell definiert und mit Hilfe von einem Transformations-Tool (FOP) in PDF transformiert. Meist wird XSL-FO nicht direkt geschrieben. Stattdessen wird ein XSLT Stylesheet geschrieben, wo Formatierungsanweisungen und Daten in eine FO-Datei zusammengebracht werden. Daher sind Kenntnisse von XSLT und XPath nötig, um geeignete Umwandlungen im FO-Format zu schreiben. XSL-FO ermöglicht, das Layout millimetergenau zu definieren und besitzt Elemente, die Textblöcke mit verschiedenen Schriftarten in mehreren Grössen und Dicken auf den Seiten, Grafiken und horizontalen Linien und anderem repräsentieren. Generierung eines CIM Frachtbriefes im PDF-Format Seite 11

12 4.2 Frachtbriefgenerator CIS Print Umfeld Die Rahmenbedingungen für die Implementierung des CIM Frachtbriefes sind durch CIS Print vorgegeben. CIS Print bietet eine Umgebung, um einerseits Dokumente zu generieren und andererseits die erfassten Beförderungsdaten aus der Datenbank zu holen. Diese Daten werden aus dem JMS Message in Java Objekte (Klassen) übertragen, die die folgende Struktur darstellen: Abbildung 2 : BefaData Es ist zu beachten, dass diese Java-Klassen wiederum Unterklassen beinhalten (bspw. Absender, Empfänger, Ware). Zudem stellen diese Klassen alle für den Zugriff auf die Beförderungsdaten benötigten Methoden zur Verfügung Produkt Frachtbriefgenerator Der Frachtbriefgenerator soll mit Hilfe von den oben definierten Klassen bzw. Objekten und deren Methoden, die CIM Frachtbrief relevanten Daten (Absendercode, Firmennummer, Strasse, Empfängername, Warencode, Wagennummer, usw.) extrahieren, Frachtbriefkriterien prüfen, Frachtbrieffeldkriterien prüfen und die nötigen Stammdaten aus der Oracle Datenbank via Toplink holen. Dann soll er sie als Array Objekt aufbauen und als Objekt (Stream) der Klasse javax.activation.datasource an CIS Print zurückgeben. Die Zwischenschritte werden somit als Stream gespeichert und verwaltet. 4.3 Aufruf des Frachtbriefdruckes aus der CIS Online Schnittstelle Nach der Erstellung und dem Testen vom Frachtbriefgenerator in CIS Print, wird ein JAR File (Frachtbriefgenerator, XSL Dateien, CIS Print Klassen, alle nötige Bibliotheken und usw.) auf CIS Print erstellt und in den Applikationsserver von CIS Online exportiert. Generierung eines CIM Frachtbriefes im PDF-Format Seite 12

13 Damit man für den Frachtbriefdruck dieses JAR File im CIS Online benutzen kann, werden Anpassungen und Erweiterungen in dieser Schnittstelle (JSP Seiten, Javaklassen und Programme) durchgeführt: die Maske für die Resultatdarstellungen (Liste der TransportID s) der Suchkriterien erweitern, die Klasse DocGenBefa benutzen: diese Klasse dient als Input für CIS Print. Sie muss alle notwendigen Informationen enthalten, damit die Generierung durchgeführt werden kann, ein Servlet implementieren, um die Resultate (PDF Stream) vom CIS Print entgegenzunehmen und an den Browser zu senden. 4.4 Use case Diagramm Die Use cases beschreiben, wie aus der Benutzersicht das Drucken der CIM Frachtbriefe funktioniert Benutzerkreise (Actors) Es gibt aus Benutzersicht verschiedene Benutzerrollen. In den nachfolgend aufgeführten Use cases wird auf diesen Rollen Bezug genommen. Actor Kunde (Bsp. Migros) SBB Mitarbeiter Host Beschreibung Kunde, der einen Frachtbrief drucken möchte SBB Mitarbeiter, der einen Frachtbrief drucken möchte Beförderungsdaten werden auf dem Host gespeichert und geholt. Generierung eines CIM Frachtbriefes im PDF-Format Seite 13

14 4.4.2 Anwendungsfall Diagramm: Frachtbriefdruck Dieses Use case beschreibt die Interaktion zwischen Akteuren (Kunde, SBB Mitarbeiter und Host) und dem betrachteten System (CIS Online, CIS Client). CIS Online oder CIS Client URL eingeben UserId und Password eingeben Drucken / Korrekturren wählern Kunde (Migros) oder SBB Mitarbeiter Suchkriterien eingeben Kriterien prüfen <<include>> Host liste der TransportID's liefern CIS Print Frachtbrief generieren <<include>> Frachtbrief drucken Abbildung 3 : Use case Hier wird nur das für den Frachtbriefdruck relevante Use case beschrieben: Use case 1.1 : Suchkriterien eingeben Der SBB Mitarbeiter oder der Kunde geben auf der Maske die Suchkriterien ein. Name Suchkriterien eingeben Nummer 1.1 Beteiligte Akteure Kunde oder SBB Mitarbeiter Vorbedingungen Beförderungsdaten müssen erfasst sein Eingehende Daten Suchkriterien (Beispiel Datum, Wagennummer ) Ergebnis Suchkriterien sind OK oder Fehlermeldung Ablauf: Nr. Akteur Was 1 Kunde, SBB Mitarbeiter Suchmaske starten 2 Kunde, SBB Mitarbeiter Suchkriterien eingeben 3 Kunde, SBB Mitarbeiter abrufen Generierung eines CIM Frachtbriefes im PDF-Format Seite 14

15 Use case 1.2 : Kriterien prüfen Die eingegebenen Kriterien werden gemäss Stammdaten geprüft und dienen als Grundlage für die Suche in den Beförderungsdaten. Name Nummer 1.2 Beteiligte Akteure Vorbedingungen Eingehende Daten Ergebnis Ablauf: Kriterien prüfen Vorheriger Anwendungsfall Suchkriterien eingeben, Host Suchkriterien sind eingegeben Suchkriterien (Beispiel Datum, Wagennummer ) Suchkriterien sind OK oder Fehlermeldung Nr. Akteur Was 1 Use case Suchkriterien eingeben Liefert Suchkriterien 2 Host Liefert Daten 3 Suchkriterien werden geprüft Use case 1.3 : Liste der TransportID s liefern Der Host liefert die Liste der TransportID s, nachdem die Kriterien überprüft wurden. Name Liste der TransportID s liefern Nummer 1.3 Beteiligte Akteure Host, Kunde Vorbedingungen Die Frachtbriefkriterien müssen überprüft werden Eingehende Daten Suchkriterien Ergebnis Eine Liste von Beförderungsidentifikationen (Transport-ID) Ausgehende Daten - Ablauf: Nr. Akteur Was 1 Host Liste der TransportID s liefern 2 Kunde Bekommt liste der TransportID s Use case 1.4 : Frachtbrief drucken Der SBB Mitarbeiter oder der Kunde drucken je nach ihrem Bedarf der Liste der TransportID s. Name Nummer 1.4 Beteiligte Akteure Vorbedingungen Eingehende Daten Ergebnis Ausgehende Daten - Ablauf: Frachtbriefe drucken SBB Mitarbeiter oder Kunde, Host Liste der TransportID s ist markiert Liste der TransportID s Frachtbriefe werden gedruckt (CIS Print wird aufgerufen) Nr. Akteur Was 1 SBB- Mitarbeiter oder Kunden 2 SBB- Mitarbeiter oder Kunden Gewünschte TransprotID wählen Frachtbriefe drucken lassen (CIS Print abrufen) Generierung eines CIM Frachtbriefes im PDF-Format Seite 15

16 Use case 1.5 : CIS Print Frachtbriefgenerieren Name CIS Print Frachtbrief generieren Nummer 1.5 Beteiligte Akteure Vorheriger Anwendungsfall Frachtbrief drucken. Vorbedingungen Eingehende Daten Eine Liste von Beförderungsidentifikationen (Transport-ID) von CIS Client oder ein Objekt von CIS Online Ergebnis CIM Frachtbrief als PDF File Ausgehende Daten - Ablauf: Nr. Akteur Was 1 Host Liefert Inputdaten. 2 Daten extrahieren 3 Feldkriterien prüfen 4 Kunde Erhält PDF Datei 4.5 Aufruf des Frachtbriefdruckes aus der CIS Client Schnittstelle Für diese Schnittstelle wird ein JAR File (Frachtbriefgenerator, XSL Dateien, CIS Print Klassen, alle nötigen Bibliotheken, usw.) von CIS Print erstellt und in den Citrixserver von CIS Client exportiert. Mit Hilfe dieses JAR Files können die Benutzer von CIS Client Frachtbriefe drucken. Wie die Kommunikation zwischen CIS Client und CIS Print auf dem Citrixserver gemacht wird, ist nicht Teil der Diplomarbeit. Hier wurde auf die Darstellung von Use cases verzichtet, da sie ähnlich wie die Use cases der Schnittstelle CIS Online sind. Generierung eines CIM Frachtbriefes im PDF-Format Seite 16

17 4.6 Sequenz Diagramm Frachtbriefgenerator innerhalb CIS Print Im folgenden Diagramm ist die Generierung eines Frachtbriefes innerhalb CIS Print aus technischer Sicht aufgezeigt. sd Interaction Component User DocGenBefaService DocGen(FrachtbriefDocGen) Apache FOP Stammdaten Befadata (Host) 1: * 1.1: getdocgenbefaservice getdocgenbefaservice 1.2: generate 1.2.1: * getbeförderungsdaten * getbeförderungsdaten 1.2.2: generate : Sendungsdaten extrahieren : Frachtbriefkriterien prüfen : * Frachtbrieffeld generieren : * Stammdaten lesen * Stammdaten lesen : * create fragments : transform transform generate generate Abbildung 4 : Sequenz Diagramm 1) DocGenBefaService wird benutzt, um den gewünschten Dokumentengenerator zu erstellen. 2) Die Methode generate() abrufen. Als Argument bekommt die Methode generate() die Liste der Sendungsidentifikationen, welche gedruckt werden müssen. 3) Gewünschte Beförderungsdaten aufgrund der Sendungsidentifikation auf dem Host holen. 4) Frachtbriefkriterien prüfen 5) Frachtbrieffeldkriterien prüfen 6) Nötige Stammdaten auf der Oracle Datenbank holen. 7) Fragmente erstellen. 8) Mit Hilfe von XSLT Processor und XSL-FO Processor den PDF File erstellen. Generierung eines CIM Frachtbriefes im PDF-Format Seite 17

18 5. Frachtbriefdruckdaten 5.1 CIM Frachtbriefdruckkriterien Frachtbriefdruckstatus Mit Hilfe des Attributes Frachtbriefdruckstatus DruckStat/fbf kann man bestimmen, ob ein originales Frachtbriefformular oder eine Kopie davon gedruckt wird. Im Frachtbriefgenerator wird das Attribut von der Klasse GlobalDaten/DruckStat/Cbf extrahiert. Wenn der Frachtbriefdruckstatus = null ist, wird für diese Sendung der originale Frachtbrief nur einmal gedruckt. Danach muss der Status von null auf 01 auf der Datenbank aktualisiert werden. Wenn der Frachtbriefdruckstatus = 01 ist, wurde für diese Sendung bereits der originale CIM-Frachtbrief gedruckt. Nur eine Kopie wird gedruckt. Es ist kein Update nötig. Wenn Frachtbriefdruckstatus = 09 ist, wird für diese Sendung kein CIM-Frachtbrief gedruckt Verkehrsart der Sendung Mit Hilfe des Attributes Verkehrsart (verkart) wird die Verkehrsart der Sendung (Export, Import und Transit) festgestellt. Das Attribute verkart wird im Frachtbriefgenerator aus der Klasse GlobalDaten extrahiert. Folgende Bedingungen müssen beachtet werden: Für Exportsendungen (Verkart = 5) werden 3 Exemplare des CIM Frachtbriefes pro Sendung gedruckt. Für Import- und Transitsendungen (Verkart = 5 oder 7) werden 5 Exemplare des CIM Frachtbriefes pro Sendung gedruckt. Für Binnenverkehr (Verkart = 1) wird keinen CIM Frachtbrief gedruckt Drucken Seite 2 des CIM Frachtbriefes In dem Frachtbriefgenerator werden die Attribute von den Klassen KommDaten/Cfb/Cgb extrahiert. Seite 2 wird nach folgenden Bedingungen gedruckt: Die Sendung hat mehr als 3 Frachtberechnungsabschnitte (FBA) Die Sendung hat zusätzliche Gebühren Die Inhalte der Attribute fbabetrufb (Betrag aus einem FBA / Frachtbetrag Unfranko) und fbabetrffb (Betrag aus einem FBA / Frachtbetrag Franko) müssen > 0 sein Sprache Für den Druck sind die Sprachen Deutsch und Französisch möglich. Die Formulare sind vom Internationalen Eisenbahntransportkomitee (CIT) zweisprachig vorgegeben. Generierung eines CIM Frachtbriefes im PDF-Format Seite 18

19 5.2 CIM Frachtbrieffelder Die Sendungsdaten von CIS Cargo werden in den dafür vorgesehenen Feldern des Frachtbriefes gedruckt. Sind in CIS in den entsprechenden Eingabefeldern keine Daten vorhanden, erfolgt kein Druck in dem entsprechenden Frachtbrieffeld. Generierung eines CIM Frachtbriefes im PDF-Format Seite 19

20 5.2.1 CIM Frachtbrieffelder und -Bedingungen Die detaillierten Informationen zu den Attributen sind im Kapitel beschrieben. Feldnr Name Datenfeld Extraktion aus der KlasseBefaData 1 Absender Klasse: GlobalDaten/Kunde Attribute: kuname, kunamezus, strasse, plz und ort, telnr, faxnr, mwstnr Klasse: GlobalDaten/Befaid Attribute: befanr 2 Absender Code Klasse: GlobalDaten/Kunde Attribute: firmnr und firmfil Bemerkungen und Feldbedingungen Unterschrift: Wenn Beförderungsauftragsnummer > 0 ist, dann Beförderungsauftragsnummer drucken. Sonst ---> Text Deutsch : «gemäss Beförderungsauftrag des Kunden» Text Französisch : «Selon l ordre de transport du client» 3 Code Frachtzahler Versand Klasse: KommDaten/Kunde Attribute: firmnr und firmfil 4 Empfänger Klasse: GlobalDaten/Kunde Attribute: kuname, kunamezus, strasse, plz und ort, telnr, faxnr, mwstnr 5 Empfänger Code Klasse: GlobalDaten/Kunde Attribute: firmnr und firmfil 6 Code Frachtzahler Empfang Klasse: KommDaten/Kunde Attribute: firmnr und firmfil 7 Absender-Erklärungen Klasse: GlobalDaten/Kunde/ErkAbs Attribute: Code und Text Max 3 Zeilen ( Bei den Codes 14 und 15 wird immer auf die Wagenliste verwiesen und die Detaildaten werden auf der Wagenliste gedruckt ) Generierung eines CIM Frachtbriefes im PDF-Format Seite 20

21 8 Absenderreferenz Klasse: GlobalDaten/Kunde Attribute: referenz auf der 4. Zeile wird wenn vorhanden die Verladebewilligung mit Fixtext: 16 Andere Erklärungen: Verladebew. 16 Autres déclarations: N d autorisa. gedruckt 9 Beilagen zum Frachtbrief Klasse: KommDaten/Beilfbf Attribute: Code und Text 10 Ablieferungsort Klasse: KommDaten/LadeEntlade/Leo/Kunde Attribute: Plz und Ort Wenn nicht Klasse: GlobalDaten/Bhf Attribute: Lastellet_EM Ort des Empfängers (Entladeort) in Verbindung mit der Klasse LEO Wenn nicht vorhanden Text Ladestelle Empfang Klasse: GlobalDaten/Bhf/BhfBase Attribute: uicbahn (Name von stammdaten) und bhfnr 11 Code Ablieferungsort Klasse: KommDaten/LadeEntlade/Leo/Kunde Attribute: Plz 12 Code Empfangsbahnhof Klasse: GlobalDaten/Bhf/BhfBase Attribute: uicbahn und bhfnr Auf Zeile 2 Bahnhofname des Empfangsbahnhofs und Land PLZ des Empfängers (Entladeort) in Verbindung mit der Klasse LEO Wenn nicht vorhanden Ladestelle Empfang 13 Kommerzielle Bedingungen 14 Nummer Tarif / Kundenabkommen Klasse: KommDaten/Komm2/kommbed Attribute: code und ergtext Klasse: KommDaten/Komm1/TarifnrAbs Attribute: tarifnr1 und tarifnr2 Vom Absender verlangter Tarif Vertragsart ab Tarifstammdaten in der Tabelle TTAF (ab FGT; 1 = ZF/Abkommen, 2 = Tarif) Generierung eines CIM Frachtbriefes im PDF-Format Seite 21

22 15 Vermerke für den Empfänger Klasse: GlobalDaten/Kunde Attribute: vermerk 16 Übernahmeort Klasse: KommDaten/LadeEntlade/Leo/Kunde Attribute: Plz und Ort Wenn nicht Klasse: GlobalDaten/Bhf Attribute: Lastellet_VS Ort des Absenders (Ladeort) in Verbindung mit der Klasse LEO Wenn nicht vorhanden Text Ladestelle Versand Klasse: GlobalDaten/Bhf/BhfBase Attribute: uicbahn (Name von stammdaten) und bhfnr Auf Zeile 3 Bahnhofname des Versandbahnhofes Übernahme Datum / Zeit Klasse: KommDaten/LadeEntlade/Leo/LehZeit Attribute: datumlehab und ZeitLehAb Format MM-TT-HH 17 Code des Übernahmeortes Klasse: KommDaten/LadeEntlade/Leo/Kunde Attribute: Plz PLZ des Absenders (Lade Ort) in Verbindung mit der Klasse LEO Wenn nicht vorhanden Code Ladestelle Versand Auf Zeile 3 Bahnhofname(Bahnhofname) des Versandbahnhofes 18 Wagennummer Klasse: Wagen Attribute: wagnr Wagennummer Ist eine Wagenliste nötig Text Gemäss Wagenliste gedruckt 19 Transitfakturierung Gedruckt wird der Wert von Stammdaten Tabelle TPP329 mit der Subtnr(Subtabellennummer) = Zahlung der Kosten Klasse: KommDaten/Komm1 Attribute: frankc Klasse: KommDaten/Komm1 Attribute: incoterm Das Kreuz Franko wird für alle Frankaturen gemacht welche eine (Teil)- Strecke franko haben Generierung eines CIM Frachtbriefes im PDF-Format Seite 22

23 Klasse: KommDaten/Komm1/bhfFK Attribute: bhfnr 21 Warendaten Klasse: Waren Attribute: warsh, warbez, warname, warmasseemw Bahnhofname des BHF_FK Siehe Kapitel (5.2.3) Spezielle Darstellung Felder 21, 24, Aussergewöhnliche Sendung Klasse: WagenDaten Attribute: Plomben Klasse: WagenDaten/wgLm Attribute: anzahl, code, text Klasse: Wagen Attribute: befgen Das Checkbox wird mit X ankreuzt, wenn das Attribut befgen nicht leer ist 23 RID Klasse: Ware/Rid Das Checkbox wird mit X ankreuzt, wenn min. 1 Ware/Wagen/Container RID(Gefahrgutcode) hat 24 Warencode Klasse: Waren Attribute: warsh Siehe Kapitel (5.2.3) Spezielle Darstellung Felder 21, 24, Masse Klasse: Waren Attribute: warmasseemw Siehe Kapitel (5.2.3) Spezielle Darstellung Felder 21, 24, Wert des Gutes Klasse: KommDaten/Komm2/wertgut Attribute: code und ergtext 27 Interesse an der Lieferung Klasse: KommDaten/Komm2/wertgut Attribute: betrag und waehr 28 Nachnahme wird nicht angezeigt 29 Ort und Datum der Ausstellung Klasse: GlobalDaten/Er Attribute: datum oder Klasse: GlobalDaten/abg Attribute: datum Ort ab Stammdaten Tabelle PP329 Subtnr Gedruckt wird: Ort, TT.MM.JJJJ Generierung eines CIM Frachtbriefes im PDF-Format Seite 23

24 30 CIM - Fbf / Wagenbrief CUV CUV wird angekreuzt für LEERWAGEN und wenn alle NHM der Waren/Container auf Stammdaten Tabelle PP329 Subtnr vorhanden sind. Sonst immer CIM 48 Überprüfung Klasse: KommDaten/Ueberpruef Attribute: EVU und Text 49 Frankaturcode Klasse: KommDaten/Komm1 Attribute: frankc Klasse: KommDaten/Komm1/gebcFK Attribute: gebc (1-5) Klasse: KommDaten/Komm1/bhfFK Attribute: uicbahn und bhrnr 50 Leitungswege Klasse: GlobalDaten/uicLw/Uiclc Attribute: uicleit,uicleitt Gedruckt werden die Leitungswege inkl. Text in der erfassten Reihenfolge. 51 Zollbehandlung Klasse: KommDaten/Zoll Attribute: zollort Klasse: KommDaten/Zoll/BhfBase Attribute: uicbahn, bhfnr 52 Frankaturrechnung Klasse: KommDaten/Komm2 Attribute: frkrech 53 Nachnahmebegleitschein Klasse: KommDaten/ Attribute: Nummer und Text Wenn frkrech = E ist, wird Checkbox angekreuzt Wird nicht angezeigt 54 Tatbestandsaufnahme Klasse: KommDaten/ Tatbestand Attribute: Code und Text Generierung eines CIM Frachtbriefes im PDF-Format Seite 24

25 55 Lieferfristverlängerung Klasse: KommDaten/Lieferfrist Attribute: Code und Text Max. 2 Zeilen werden gezeigt 56 Erklärungen des Beförderers Klasse: KommDaten/ErklBefoe Attribute: EVU und Text Max. 4 Zeilen werden gezeigt 57 Andere Beförderer Klasse: GlobalDaten/Sdnid Attribute: evuwv und Text von Stammdaten Mit dem vertraglichen Beförderer werden auf Stammdaten Tabelle TTAFF die Angaben für Feld 57 gelesen. Gedruckt wird: EVU-Text für Bahnhofname_ SA Bahnhofname TSE und FlagBef 58 a) Vertraglicher Beförderer Unterschrift Stammdaten (Stempel KSC Fribourg) Wenn vertraglicher Beförderer in der Stammdaten Tabelle TTAUFB = 2185 ist, wird Stempel KSC von der Stammdatentabelle TPP329 mit Subtabellennummer gedruckt. als Unterschrift wird die TransportID gedruckt. Wenn Flag VGVV = TRUE und es sich nicht um eine reine CUV - Sendung handelt, wird ein Kreuz gemacht und die EVU-VFF gedruckt. 58 b) Vereinfachtes Eisenbahnversandverfahr en + Code Hauptverpflichteter 59 Ankunftsdatum Klasse: GlobalDaten/est Attribute: datum sonst Nur der EVU-Text des VFF wird gedruckt. Dieses Feld wird nur gedruckt wenn es sich nicht um einen CUV handelt. 62 Sendungs-Identifikation Klasse: GlobalDaten/sdgid Attribute: sdgnr, evuwv Klasse: GlobalDaten/sdgid/bhfWv Attribute: uicbahn, bhfnr 70 FBA Anfang/Ende Klasse: KommDaten/fba/bhfFa Attribute: Uicbahn, bhfnr Klasse: KommDaten/fba/bhfFe Attribute: Uicbahn, bhfnr Generierung eines CIM Frachtbriefes im PDF-Format Seite 25

26 71 Leitungswegcode Klasse: KommDaten/fba/leitcTar Attribute: leitctar 72 NHM-Code Klasse: Waren Attribute: warsh (wird berechnet) Gedruckt wird die NHM der schwersten Ware oder die NHM der schwersten Ladeeinheit (Gewicht Ladeeinheit inkl. Waren) 73 Waehrung Klasse: KommDaten/Cfb/waehrFba Attribute: waerhrcd 74 Frachtplichtige Masse Klasse: Waren/ Attribute: warmassefmw (wird berechnet) Total Warenmasse frachtpflichtig 75 Tarif / Kundenabkommen Klasse: KommDaten/Cfb/tarifnrFba Attribute: tarifnr1, tarifnr2 79 Gebühren Klasse: KommDaten/Cfb/Cgb Attribute: gebbetrfba (1-5) Klasse: KommDaten/Cfb/Cgb/gebcFba Attribute: gebc 80 Nachnahme Übertrag aus Feld 28 (wird nicht angezeigt) 81 Fba Betrag Franko Klasse: KommDaten/Cfb Attribute: fbabetrffb 82 Fba Betrag Unfranko Klasse: KommDaten/Cfb Attribute: fbabetrufb 84 Gebühren Betrag Franko Klasse: KommDaten/Cfb/Cgb/gebcFba Attribute: fbabetrfgb 85 Gebühren Betrag Franko Klasse: KommDaten/Cfb/Cgb/gebcFba Attribute: fbabetrugb Generierung eines CIM Frachtbriefes im PDF-Format Seite 26

27 5.2.2 Frachtbrieffelder ohne Sendungsdaten In folgenden Frachtbrieffeldern werden keine Daten gedruckt: Feld Inhalt Bemerkung 40 Code 41 Code 42 Code 43 Code 44 Code 45 Code 46 Code 47 Code 76 Km/Zone 77 Zuschläge/Kürzungen 78 Frachtsatz 83 Kurs Franko 86 Kurs überwiesen 87 FBA in Erhebungswährung zu Lasten des Absenders 88 FBA in Tarifwährung zu Lasten des Absenders 89 FBA in Erhebungswährung zu Lasten des Empfängers 90 FBA in Tarifwährung zu Lasten des Empfängers 91 Übertrag von Ergänzungsblättern Franko 92 Übertrag von Ergänzungsblättern überwiesen 93 Gesamtbetrag der bei Abgang zu erhebenden Beträge 94 Gesamtbetrag der bei Ankunft zu erhebenden Beträge 99 Zollvermerke Spezielle Darstellung Felder 21, 24, 25 Im Feld 21 erscheint der Text gemäss Wagenliste unter folgenden Bedingungen: wenn mehr als ein Wagen erfasst ist ODER wenn mehr als eine Ware ( ohne NHM ) erfasst ist ODER wenn ein RID pro Ware erfasst ist ODER wenn es Ladeeinheiten auf der Sendung hat ODER wenn Wagendecken oder Mehrweg-Gurten auf der Sendung sind. Das Feld 24 bleibt leer und im Feld 25 erscheint das effektive Gewicht der Ware. Feld 21 (Auf dem Frachtbriefformular) Feld 24 Feld 25 Gemäss Wagenliste WARMASSE_EWS Sonst müssen in den Feldern 21, 24, 25 alle Angaben erscheinen: Warenbezeichnung gem. Kunde oder Text NHM, Gewicht, Tauschgeräte, Plomben, immatrikulierte Lademittel im Zusammenhang mit Masse. Feld 21 Feld 24 Feld 25 WARBEZ_CR oder WARNAME, Wagennummer (nur bei CUV) (wenn NHM erfasst:) NHM-Text von drucken Plomben: WAGENPLOMBEN Tauschgeräte: X Paletten / X Rahmen / X Deckel WARSH_CR WARMASSE_EMW (wenn :) WARMASSE_ EMW von Generierung eines CIM Frachtbriefes im PDF-Format Seite 27

28 5.2.4 Technische Attributliste des CIM Frachtbriefes Attribut-Name Feldtyp N(Nummerisch) AN(Alphanummeris ch) Feldlänge Feldbezeichnung firmnr abs N 6 Firmen-Nummer / Absender firmfil abs N 2 Filialcode zu Firmen-Nr. kuname AN 30 Kundenname / alle Kundenarten (Rolle der FIRMNR) strasse AN 30 Strasse plz AN 10 Postleitzahl / alle Kundenarten (Rollen der FIRMNR) adressat AN 30 Adressat des Kunden nur Kundenart ABS und EMP (Rollen der FIRMNR) kontakt tel AN 30 Telefonnummer des Verladers mwst nr AN 50 Mwst-Nr Kunde referenz abs AN 13 Referenz / Absender befanr N 9 Beförderungsauftragsnummer firmnr fzv N 6 Firmen-Nummer / Frachtzahler Empfang firmfil fzv N 2 Filialcode zu Firmen-Nr. firmnr emp N 6 Firmen-Nummer / Empfänger firmfil emp N 2 Filialcode zu Firmen-Nr. strasse AN 30 Strasse plz AN 10 Postleitzahl / alle Kundenarten (Rollen der FIRMNR) adressat AN 30 Adressat des Kunden nur Kundenart ABS und EMP (Rollen der FIRMNR) firmnr fze N 6 Firmen-Nummer / Frachtzahler Empfang firmfil fze N 2 Filialcode zu Firmen-Nr. erklaer abs AN 100 Erklärung / Absender fbf begleit1 AN 40 Frachtbriefbegleitpapiere 1-3 fbf begleit2 AN 40 Frachtbriefbegleitpapiere 1-3 fbf begleit3 AN 40 Frachtbriefbegleitpapiere 1-3 beilad AN 1 Beilad-Sendung lastellt em AN 12 Text der Ladestelle / Entladestelle im Empfang lastelle em N 4 Code der Ladestelle / Entladestelle im Empfang uicbahn em N 2 Landnummer der UIC-Bahn / Empfangsbahnhof bhfnr em N 6 Bahnhofnummer / Empfangs-Bahnhof kommres bez VAR 50 Bezeichnung der kommerziellen Reserve tarufnr abs N 6 Tarifnummer / vom Absender verlangt TARIFNR1 (N4) und TARIFNR2 (N2) vermerk emp AN 100 Vermerk / für den Empfänger lastelle vs N 4 Code der Ladestelle / Ladestelle auf Versandbahnhof lastellt vs AN 12 Text der Ladestelle / Ladestelle auf Versandbahnhof Generierung eines CIM Frachtbriefes im PDF-Format Seite 28

29 wagnr AN 12 Wagennummer uicbahn vs N 2 Landnummer der UIC-Bahn / Versand uicbahn em N 2 Landnummer der UIC-Bahn / Empfangsbahnhof gebc fk1-5 N 2 Gebühren-Code / Zusatz zu Frankaturvorschr. frank AN 1 frankc N 4 Frankaturcode Zeigt an, ob eine Gebühr franko oder unfranko ist. befpspez spb AN 20 Aussergewöhnliche Sendung warsh cr N 8 Waren-Identifikation nach SH / Sendung warbez cr AN 100 Warenbezeichnung (vom Kunden) / Sendungsbezogen warmasse emw N 7 Masse der Ware / Effektivmasse der Ware pro Sendung warmasse ewt N 7 Masse der Ware / Effektivmasse der Ware pro Wagen laufnr rid N 4 Laufnummer / fortlaufende Nummerierung der RID-Angaben pro Ware sdgbetr waw N 10.2 Sendungs-Betrag / Warenwert sdgbetr nn N 10.2 Sendungs-Betrag / Nachnahme sdgbetr int N 10.2 Sendungs-Betrag / Interesse an der Lieferung waehrcd il N 3 Währungscode / Interesse an der Lieferung datum abg DATE 10 gewünschtes Abgangsdatum datum er DATE 10 Datum / Erstellungsdatum Sendung frankc N 4 Frankaturcode gebc fba N 2 Gebühren-Code / Einzelgebühren eines FBA gebc fk1-5 N 2 Gebühren-Code / Zusatz zu Frankaturvorschr. uicbahn fk N 2 Landnummer der UIC-Bahn / Franko Grenze bhfname fk AN 25 Bahnhofname / Franko bis Grenze leist code N 2 Leistungscode zoll ort AN 30 Zu verzollen in bhfnr zoll N 6 Bahnhofnummer Verzollung uicbahn zoll N 2 Landnummer Zollstelle frkrech AN 1 Überwachung Frankaturrechnung datum rfr AN 10 Rückkunftsdatum Frankaturrechnung datum est AN 10 Datum / Empfangsbestätigung sdgnr cim N 9 Sendungsnummergenerierung. Sendungsnummer CIM uicbahn vs N 2 Landnummer der UIC-Bahn / Versand bhfnr vs N 6 Bahnhofnummer / Versand evu vs N 4 EVU in Sendungsident Generierung eines CIM Frachtbriefes im PDF-Format Seite 29

30 uicbahn fa N 2 Landnummer der UIC-Bahn / FBA-Anfang bhfnr fa N 6 Bahnhofnummer / FBA-Anfang uicbahn fe N 2 Landnummer der UIC-Bahn / FBA-Ende bhfnr fe N 6 Bahnhofnummer / FBA-Ende leitctar N 3 Leitungscode Tarif waehrcd fba N 3 Währungscode+G3236 / FBA tarifnr fba N 6 gebbetr fba N 10 Gebührenbetrag / FBA Tarifnummer / in einem FBA angewendet 2 Felder auf dem PC : TARIFNR1 (N4) und TARIFNR2 (N2) gebc fba N 2 Gebühren-Code / Einzelgebühren eines FBA fbabetr ffb N 10 Betrag aus einem FBA / Frachtbetrag Franko fbabetr fgb N 10 Betrag aus einem FBA / Gebührenbetrag Franko fbabetr ufb N 10 Betrag aus einem FBA / Frachtbetrag Unfranko fbabetr ugb N 10 Betrag aus einem FBA / Gebührenbetrag Unfranko Generierung eines CIM Frachtbriefes im PDF-Format Seite 30

31 6. Design & Implementierung 6.1 CIM Frachtbrieflayout Allgemeines Das CIM Frachtbrieflayout wurde wie erwähnt mit Hilfe von XSL-FO realisiert. Es besteht aus zwei A4 (210mm X 297mm) Seiten: Seite 1 (Hauptseite) ist in die Bereiche region-before und region-body aufgeteilt. Seite 2 besteht nur aus einem region-body. Beide Seiten haben einen Seitenrand (margin) von 1 cm. 21 cm x 29.7 cm 21 cm x 29.7 cm Abbildung 5 : Seitenaufteilung <fo:layout-master-set> <fo:simple-page-master master-name= A4-erste page-width= 210mm page-height= 297mm margin= 10mm > <fo:region-body margin-top= 1.2cm /> <fo:region-before extent= 1.2cm /> </fo:simple-page-master> <fo:simple-page-master master-name= A4-zweite page-width= 210mm page-height= 297mm margin= 10mm > <fo:region-body/> </fo:simple-page-master> <fo:page-sequence-master master-name= ersteseite > <fo:single-page-master-reference master-reference= A4-erste /> </fo:page-sequence-master> <fo:page-sequence-master master-name= zweiteseite > <fo:single-page-master-reference master-reference= A4-zweite /> </fo:page-sequence-master> </fo:layout-master-set> Generierung eines CIM Frachtbriefes im PDF-Format Seite 31

32 Region-before Mit Hilfe des Elements <fo:static-content> wurde das Region-before realisiert. Abbildung 6 : Header <fo:static-content flow-name= xsl-region-before > <fo:block> Hier kommen noch folgende Elemente: Das Element Container für die feste Positionierung (<fo:block-container> </fo:block-container>) Externes Bild (Kreis) und dazugehörige Nummer Statischer Text Rechteck (Border des Elementes Container) Ein Text, ob das Frachtbrief Original oder Kopie ist </fo:block> </fo:static-content> Region Body Das Region body ist der Hauptbereich der Seite und besteht aus zahlreichen <fo:block> und <fo:block-container> sowie aus anderen Elementen des XSL-FO, die für den CIM Frachtbrief nötig sind. Die Elemente des Region-Bodys werden im nächsten Kapitel beschrieben Die Style-Informationen Wie bei der Analyse erwähnt wurde, wurde XSL-FO nicht direkt geschrieben. Stattdessen wurde ein XSLT Stylesheet geschrieben, in dem Formatierungsanweisungen und Daten in einer FO-Datei zusammengebracht werden. Dann werden mit Hilfe von XSLT und XPATH die Daten in den dafür vorgesehenen Feldern des CIM Frachtbriefes positioniert. Die Style-Informationen bestehen aus folgenden Dateien: frachtbriefe-xsl.xsl frachtbriefdaten_seite1.xsl frachtbriefdaten_seite2.xsl pagemaster.xsl tablemaster.xsl Um unterschiedliche Sprachen zu unterstützen, erstellten wir noch eine XML-Datei (NLS.xml). Diese Datei wird dann mit Hilfe einer XSLT Funktion (dokument($srcval) eingelesen. Die Stylesheets wurden im CIS Print Projekt gespeichert und nur den Entwicklern zur Verfügung gestellt. Generierung eines CIM Frachtbriefes im PDF-Format Seite 32

33 Die frachtbrief-xsl.xsl Datei Es handelt sich um die Hauptseite, die die statische Struktur des CIM Frachtbriefes definiert. Diese Datei beschreibt die folgenden Objekte: Frachtbrieffelder Die Felder vom CIM Frachtbrief werden mit dem XSL-FO Element <fo:block-container> realisiert und an beliebiger Stelle auf der Seite positioniert. Beispiel: <fo:block-container position= absolute top= 8mm left= 70mm width= 29.5mm height= 5mm border-left= 0.7pt solid # border-top= none border-right= none border-bottom= 0.7pt solid # >.. </fo:block-container> Linien (Rahmen) Die Linien wurden als border Attribute des Elements <fo:block-container> dargestellt. (s. vorheriges Beispiel). Kreise und dazugehörige Nummern Die Kreise (leer, grün gefüllt) stehen als Bilder von Typ png - rond vert plein.png - rond vert.png - rond vert pleinrectangle.png zur Verfügung. Sie wurden mit Hilfe vom Photoshop-Programm erstellt und werden in XSL- FO integriert. Abbildung 7 : Feldbeschreibung Statischer Text (LabelText) Für die Feldbeschreibung des Frachtbriefes wurden keine separaten XML Dateien definiert; die Feldbeschreibung wurde direkt mit dem Element <fo:block> in den dafür vorgesehenen Platz geschrieben. Beispiel: <!-- Feld 7 ErklaerungsAbsender --> <fo:block-container position= absolute top= 8mm left= 99.7mm width= 85.7mm height= 22.5mm border-left= none border-top= none border-right= 2pt solid # border-bottom= 0.7pt solid # overflow= hidden > <!-- Kreis 7 Bild--> <fo:block-container> <fo:block> <fo:external-graphic src= rond-vert-plein.png /> Generierung eines CIM Frachtbriefes im PDF-Format Seite 33

34 </fo:block> </fo:block-container> <!-- Kreis 7 Nummer--> <fo:block-container xsl:use-attribute-sets= circle-1nr-white > <fo:block>7</fo:block> </fo:block-container> <!--Feld 7 statische Feldbeschreibung--> <fo:block-container xsl:use-attribute-sets= label-positionierung > <fo:block xsl:use-attribute-sets=»fix-text»>déclarations del\ \expéditeur</fo:block> <fo:block xsl:use-attribute-sets= fix-text >Erklärungen desabsenders</fo:block> </fo:block-container> <!-- *************************************************************** --> </fo:block-container> Die frachtbriefdaten-seite1 und 2.xsl Dateien Die Stylesheet Informationen bezüglich der Anbindung der dynamischen Daten werden separat in diesen Dateien gespeichert. Beispiel: <!--Feld 3 Frachtzahler Versand (KommDaten_KundeFrv)--> <fo:block-container position= absolute top= 14mm left= 74mm width= 29.5mm height= 5mm > <fo:block xsl:use-attribute-sets= dynamic-text-nummeric > <fo:inline> <xsl:value-of select= FirmnrFzv /> </fo:inline> <fo:inline> <xsl:value-of select= FirmfilFzv /> </fo:inline> </fo:block> </fo:block-container> Die pagemaster-xsl.xsl Die pagemaster.xsl Datei beinhaltet die gemeinsamen Attributlisten für die verschiedenen Text-Bereiche und ermöglicht so die Erstellung eines konsistenten Layouts: - Fixer LabelText <xsl:attribute-set name= fix-text > <xsl:attribute name= font-family >Arial</xsl:attribute> <xsl:attribute name= font-size >4.5pt</xsl:attribute> <xsl:attribute name= font-weight >bold</xsl:attribute> <!-- Pantone 348U (grün) --> Generierung eines CIM Frachtbriefes im PDF-Format Seite 34

35 <xsl:attribute name= color >#008751</xsl:attribute> </xsl:attribute-set> - Dynamischer Text (Daten) <xsl:attribute-set name= dynamic-text > <xsl:attribute name= font-family >Arial, Helvetica, Courier</xsl:attribute> <xsl:attribute name=»font-size»>7pt</xsl:attribute> <xsl:attribute name= font-weight >normal</xsl:attribute> <xsl:attribute name= line-height >8pt</xsl:attribute> <xsl:attribute name= padding >0.5mm</xsl:attribute> <xsl:attribute name= text-align >start</xsl:attribute> </xsl:attribute-set> Die tablemaster.xsl Datei Die gemeinsamen Tabellen-Strukturen werden auch in einer separaten Datei (tablemaster.xsl) gespeichert. Beispiel: Abbildung 8 : tablemaster <xsl:template name= layout_table52_54 > <fo:table table-layout= fixed > <!--Frankaturrechnung--> <fo:table-column column-width= proportional-column-width(42.5) /> <fo:table-column column-width= proportional-column-width(29.5) /> <fo:table-column column-width= proportional-column-width(13.5) /> <fo:table-body> <fo:table-row height= 5.8mm > <fo:table-cell border-left= none border-top= none border-right= 0.7pt solid # border-bottom= 0.7pt solid # > <fo:block></fo:block> </fo:table-cell> Generierung eines CIM Frachtbriefes im PDF-Format Seite 35

36 <fo:table-cell border-left= none border-top= none border-right= none border-bottom= 0.7pt solid # > <fo:block></fo:block> </fo:table-cell> <fo:table-cell border-left= 0.7pt solid # border-top= none border-right= none border-bottom= 0.7pt solid # > <fo:block></fo:block> </fo:table-cell> </fo:table-row> </fo:table-body> </fo:table> </xsl:template> Implementierung und Testen mit Oxygen Für die Erstellung und das Testen des Layouts wird das Tool Oxygen verwendet. Wenn die Tests erfolgreich verlaufen, wird das erstellte Layout im CIS Print integriert und gespeichert. Um in Oxygen testen zu können, wird eine statische XML Datei (frachtbrief.xml) für die Frachtbriefdaten erstellt. Abbildung 9 : Generierung eines Frachtbriefes im Oxygen Ein Zipfile (Frachtbrief_Oxygen.zip) mit allen Dateien, die in dem Tool Oxygen getestet wurden, wird als Beilage zu diesem Bericht zur Verfügung gestellt. Generierung eines CIM Frachtbriefes im PDF-Format Seite 36