Liest das R-S beim Import eines Transaktions-Formulars das ZIP-Import-Paket, so wird im Unterverzeichnis etc nach einer
XML-Datei mit dem Namen rs_package_configuration.xml gesucht.
Diese XML-Datei beschreibt den Inhalt und den Aufbau des ZIP-Import-Paketes genauer und ermöglicht eine inhaltliche Prüfung.
In der Paket-Beschreibungs-Datei sind u.a. folgende Informationen abgelegt:
- Name des Transaktions-Formulars.
- Informationen zum Aufruf der Laufzeitumgebung zur Generierung von Dokumenten auf der Basis dieses Transaktions-Formulars (pro Betriebssystem).
- Den Dateinamen des Transaktions-Formulars von Adobe (welches nach LayoutBereichen analysiert wird).
- Materialinformationen zu den verwendeten Papieren des Transaktionsformulars.
- Hintergrundbilder für die Anzeige der Seiten des Transaktions-Formulars im R-S.
- Referenzen auf Testdaten, welche dem Nutzer des R-S für Dokumentvorschau angeboten werden
- Namen von Variablen aus dem Datenstrom des Transaktions-Formulars auf welche der R-S Nutzer zugreifen darf und exemplarische Werte dazu.
- Definitionen ob logische Beileger genutzt werden und ob diese auf dem Papier des Transaktions-Formular gedruckt werden müssen.
- Definitionen ob physikalische Beileger genutzt werden können.
- Definition ob logische/physikalische Beileger ggf. einen Sprung im Porto verursachen können.
- Definitionen ob WhiteSpace-Bereiche auf den Dokumenten genutzt werden können.
- Wie viel Platz maximal auf den Seiten für Werbung zur Verfügung steht.
- Auf welchen Teilen das Transaktions-Formulars WhiteSpace platziert werden kann.
Die Paket-Beschreibungs-Datei rs_package_configuration.xml wird mit einem geeigneten XML-Editor durch den Designer des Transaktions-Formulars manuell erstellt.
Beispiel einer Paket-Beschreibungs-Datei:
<?xml version="1.0" encoding="UTF-8"?> <?pte APIVersion="0.0.02"?> <package type="transaction" name="V-0002" description="fly-ticket invoices 01.01.2011" version="1.1"> <configurationSet> <runtimeEnvironments> <runtimeEnvironment platform="Windows"> <program name="OMS-ReportWriter" version="5.6.*"></program> <cmdLine>-alp ${home}/my_special_logos</cmdLine> <programResult> <log>process.log</log> <preview>*.pdf</preview> <result type="ReturnCode">0</result> </programResult> </runtimeEnvironment> <runtimeEnvironment platform="Linux"> <program name="OMS-ReportWriter" version="5.6.1014"></program> <cmdLine>-alp ${home}/my_special_logos</cmdLine> <programResult> <log>process.log</log> <preview>*.pdf</preview> <result type="ReturnCode">0</result> </programResult> </runtimeEnvironment> </runtimeEnvironments> <transactionForm>${home}/forms/M-0044-V-0002.xdp</transactionForm> <transactionFormMaterials> <material width="210mm" height=297mm" thickness="0.5mm" weight="1.2g" name="A4LOGO" description="Einzelblatt weiss mit Logo"/> <material width="210mm" height=297mm" thickness="0.8mm" weight="3.6g" name="ZSPAPER" description="Einzelblatt Zahlschein u. Perforation"/> </transactionFormMaterials> <transactionFormPageBackgrounds> <transactionFormPageBackground pageName="ErsteSeite">${home}/backgrounds/firstpage.gif</transactionFormPageBackground> <transactionFormPageBackground pageName="Folgeseiten">${home}/backgrounds/nextpage.gif</transactionFormPageBackground> </transactionFormPageBackgrounds> <fontDef> <location>${home}/etc/fonts.ini</location> </fontDef> <testDataSet> <testData> <name>Fly-Testabrechnung</name> <description>5 Dokumente in allen Varianten</description> <value>${home}/testdata/fly.xml</value> </testData> </testDataSet> <inputVariableSet> <inputVariable> <name>PARTNER_ID</name> <description>System-ID des Werbe-Partners.</description> <values> <value> <name>RYANA</name> <description>ID for Airline Ryan Air</description> </value> <value> <name>LH</name> <description>ID for Lufthansa</description> </value> <value> <name>FLYDBA</name> <description>ID for DBA</description> </value> </values> </inputVariable> <inputVariable> <name>NL_KEY</name> <description>System-ID der Länderniederlassung. Werte: '01 - Deutschland' '02 - Österreich'</description> </inputVariable> <inputVariable> <name>SUM_VALUE</name> <description>Rechnungs-Gesamtsumme</description> </inputVariable> </inputVariableSet> </configurationSet> <supplement> <logicalSupplement> <allowed>true</allowed> <useOnlyTransactionFormPaper>true</useOnlyTransactionFormPaper> </logicalSupplement> <physicalSupplement> <allowed>true</allowed> </physicalSupplement> </supplement> <shipment> <postage> <optionalSupplementCanExceedPostage>true</optionalSupplementCanExceedPostage> </postage> </shipment> <whitespace> <allowed>true</allowed> <partNameSet> <partName>RECHNUNG</partName> <partName>ZAHLSCHEIN</partName> </partNameSet> </whitespace> </package>
Bei fehlerhafter XML-Syntax oder fehlerhaft definierten Objekt-Referenzen bricht der Import des Paketes im R-S mit Fehlermeldungen ab.
Download einer Muster-Paket-Beschreibungs-Datei: rs_package_configuration.xml
3.2.5.1.1.1.1 Aufbau des ZIP-Import-Pakets | 3.2.5.1.1.1.3 Layout-Bereiche im Adobe XDP