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
- 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)
- 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 Benutzer zugreifen darf
- Definitionen ob elektronische/physikalische Beileger genutzt werden und diese ggf. einen Sprung im Porto verursachen können
- Definitionen ob WhiteSpace-Bereiche auf den Dokumenten genutzt werden
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.01"?> <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.???">${home}/bin/reportw.exe</program> <cmdLine>${testData} ${home}\etc\reportw.tci -awp ${home} -aip ${home}/etc -afp ${home}/forms -afp ${home}/rw -aap ${home}/running/archive_in -alp ${home}/logos -all process.log -vol -rsp XML -sno ?????????????????</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.???">${home}/bin/linux/reportw</program> <cmdLine>${testData} ${home}/etc/reportw.tci -awp ${home} -aip ${home}/etc -afp ${home}/forms -afp ${home}/rw -aap ${home}/running/archive_in -alp ${home}/logos -all process.log -vol -rsp XML -sno ??????????????????</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> <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. Werte: 'LH', 'RYANA', 'FLYDBA'</description> </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> </whitespace> </package>
Hinweis
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