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. 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
- ergänzende 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)
- 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 elektronische 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 elektronische/physikalische Beileger eine 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 plaziert werden kann
+ ob WhiteSpace im Duplex-Druck auch auf leeren Rückseiten defineirt 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 generator="ProfiForms_Config_Engine_0_0_0002" 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> <transactionFormPageBackgrounds> <transactionFormPageBackground pageName="ErsteSeite">${home}/backgrounds/firstpage.gif</transactionFormPageBackground> <transactionFormPageBackground pageName="Folgeseiten">${home}/backgrounds/nextpage.gif</transactionFormPageBackground> </transactionFormPageBackgrounds> <fontDef> <location>${home}/fonts/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> <whitespaceCanExceedPostage>false</whitespaceCanExceedPostage> </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