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 und exemplarische Werte dazu.
    Hinweis: Diese Variablen werden im R-S als sogenannte DS-Variablen angeboten, welche R-S Nutzer zum Beispiel in Texten als Platzhalter oder bei Regeln als Suchwert verwenden können. Aber auch ohne explizite Deklaration der DS-Variablen in der Paket-Beschreibungs-Datei kann mit dieser Syntax/Notation auf globale Datenelemente des Datenstroms zugegriffen werden.  
  • 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:

<?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="ReportWriter" version="5.6.*"></program>     
         <cmdLine>-alp ${home}/my_special_logos</cmdLine>     
         <programResult>                
             <log>*.log,*.docref</log>                
             <preview>*.pdf</preview>                
             <result type="ReturnCode">0</result>     
         </programResult>   
     </runtimeEnvironment>   
     <runtimeEnvironment platform="Linux">     
         <program name="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>
   <maxSpace>50</maxSpace>
   <overflow>ALLOWTOCREATEBACKPAGE</overflow>
   <!--NOTALLOWED # standard value -->
   <!--ALLOWTOCREATEBACKPAGE # create whitespace-content on empty backpages in case of duplex-printing -->
   <partSet>
      <part>
         <name>Rechnung</name>
         <description>Rechnung</description>
      </part>
      <part>
         <name>Dunning</name>
         <description>Dunning</description>
      </part>
   </partSet>
 </whitespace>
</package>

Bei fehlerhafter XML-Syntax oder fehlerhaft definierten Objekt-Referenzen bricht der Import des Paketes im R-S mit Fehlermeldungen ab.

Die Paket-Beschreibungs-Datei ist Teil des ZIP-Import-Paketes. Bei der Analyse des ZIP-Import-Paketes wird dieses temporär entpackt und auf notwendige Bestandteile untersucht. Zur Untersuchung zählen u.a. die Analyse der Fonts, die mitgegebenen Testdaten etc. Um die Position dieser Informationen im Import-Paket variabel zu halten, können Pfade angegeben werden, in welchen das R-S bei der Analyse des Import-Paketes die entsprechenden Informationen findet. Der erste Teil des Pfades ist immer variabel/dynamisch und hängt von den technischen Installationsbedingungen des R-S ab.

Damit die Nutzer des R-S mit diesen technischen Informationen nicht konfrontiert werden müssen, wird eine Variable $home verwendet, welche den tatsächlichen Pfad des Import-Paketes nach dem Entpacken des ZIP-Import-Paketes beschreibt. Verwenden Sie $home immer direkt vor den Angabe von relativen Pfaden zu Dateien/Ressourcen aus dem Import-Paket.

Input-Variablen (DS.*) werden NICHT durch das Redaktions-System auf Korrektheit geprüft! Ist zum Beispiel eine DS-Variable falsch geschrieben, so wird dies erst durch die Output Management Produkte geprüft, welche die Variablen bei der Dokument-Generierung nutzen (Late Binding). So können diese Art von Fehlern erst bei der Ausführung der Preview-Funktion im Redaktions-System evaluiert werden.


Download einer Muster-Paket-Beschreibungs-Datei: rs_package_configuration.xml