Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

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.
 

Info

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.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:
 

Codeblock
languagehtml/xml
<?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>*.log,*.docref</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> <whitespace>
        <allowed>true</allowed>
   <maxSpace>50</maxSpace>
   <overflow>ALLOWTOCREATEBACKPAGE</overflow>
   <!--NOTALLOWED # standard  <partNameSet>
value -->
   <!--ALLOWTOCREATEBACKPAGE # create whitespace-content on empty backpages in case of duplex-printing -->
   <partSet>
      <part>
         <name>Rechnung</name>
         <description>Rechnung</description>
  <partName>RECHNUNG</partName>    </part>
      <part>
         <partName>ZAHLSCHEIN<<name>Dunning</partName>name>
          </partNameSet> <description>Dunning</description>
      </part>
   </partSet>
 </whitespace>
</package>
Info

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

Info

Die Paket-Beschreibungs-Datei ist Teil des ZIP-Import-Paketes. Bei der Analyse des ZIP-Import-Paketes wird dieses temporär entpackt und die auf die notwendigen 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 Nutze 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.

Warnung

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

...

 

Image Removed 3.2.5.1.1.1.1 Aufbau des ZIP-Import-Pakets | 3.2.5.1.1.1.3 Layout-Bereiche im Adobe XDP Image Removed

...

Column
width33%

 

Column
width33%
Panel
borderColor#FFAA00
bgColor#FFFEEF
borderWidth1px
borderStylesolid
Erweitern
titleVerwandte / Weiterführende Seiten...

Inhalt nach Stichwort
showLabelsfalse
max20
sorttitle
showSpacefalse
titleVerwandte Seiten
labels31

...

width33%

...