Aufbau der Paket-Beschreibungs-Datei

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)
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 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 definiert 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="5.0g" name="A4LOGO" description="Einzelblatt weiss mit Logo"/>
     <material width="210mm" height=297mm" thickness="0.8mm" weight="7.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>
      <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

Seitenhierarchie

Aufbau der Paket-Beschreibungs-Datei