Wird ein neues Binär-Paket (ZIP-Binär-Paket) über Administrator-Client (Console) in das R-S importiert, so wird im Unterverzeichnis etc nach einer XML-Datei mit dem Namen rs_binary_configuration.xml gesucht. Diese XML-Datei beschreibt den Inhalt und den Aufbau des ZIP-Binär-Paketes genauer und ermöglicht eine inhaltliche Prüfung.

In der Paket-Beschreibungs-Datei sind u.a. folgende Informationen abgelegt:

  • Name des Output-Management-Produktes/Scriptes (nachfolgend Programm genannt), als Referenz aus dem Transaktions-Formulars.

  • Genaue Programm-Version.

  • Die Plattform, für die das Programm gültig ist.

  • Eine Information, ob das Binär-Paket mit dem Produktions-Paket bei der Verarbeitung gemischt (MERGED) werden kann oder ob mit einer Referenz des Binär-Paketes (SHARED) gearbeitet werden muss.

  • Eine Kurz-Beschreibung zum Programm.

  • Die plattformspezifische Aufrufzeile des Programmes.

  • Die Kommandozeilen-Parameter beim Aufruf des Programmes.


Die Paket-Beschreibungs-Datei rs_binary_configuration.xml wird mit einem geeigneten XML-Editor durch den Administrator des R-S manuell erstellt.


Ab der Version 1.7.1000 wird nur noch der Import von Binär-Paketen mit der API-Version 0.0.02 unterstützt.


Die in der Paket-Beschreibungs-Datei verwendeten reservierten Variablen bedeuten:

  • ${inputdata}   -  Verzeichnis und Dateiname der Dokument-Datei, welche aufbereitet werden soll.

  • ${bin}   -  Verzeichnis, in welchem das Binär-Paket bei der Dokument-Aufbereitung abgelegt wird.

  • ${prod}   -  Verzeichnis, in welchem das Produktions-Paket bei der Dokument-Aufbereitung abgelegt wird.

  • ${home}   -  temporäres Verzeichnis, in welchem die Ergebnisse der Dokument-Aufbereitung abgelegt werden.

 

Beispiel einer Paket-Beschreibungs-Datei in der API-Version 0.0.02 (ab Version 1.7.1000) für das Output-Management-Programm ReportWriter:

<?pte APIVersion="0.0.02"?>
<binary>
 <name>ReportWriter</name>
 <version>5.7.1000</version>
 <platform>Windows</platform>
 <supported-runtime-environments>
    <environment>MERGED</environment>
    <environment>SHARED</environment>
 </supported-runtime-environments>
 <description>ReportWriter 5.7.1000 fuer Windows</description>
 <cmd>${bin}/bin/reportw</cmd>
 <args>${inputdata} ${prod}/etc/reportw.tci -awp ${home} -aip ${prod}/etc -afp ${prod}/forms -afp ${prod}/rw -alp ${prod}/logos -all process.log -vol -rsp XML ${params} -sno XXXXXX</args>
</binary>


Beispiel einer Paket-Beschreibungs-Datei in der API-Version 0.0.01 (bis Version 1.7.1000) für das Output-Management-Programm ReportWriter:

<?pte APIVersion="0.0.01"?>
<binary>
 <name>ReportWriter</name>
 <version>5.7.1000</version>
 <platform>Windows</platform>
 <description>ReportWriter 5.7.1000 fuer Windows</description>
 <cmd>${home}/bin/reportw</cmd>
 <args>${inputdata} ${home}/etc/reportw.tci -awp ${home} -aip ${home}/etc -afp ${home}/forms -afp ${home}/rw -alp ${home}/logos -all process.log -vol -rsp XML ${params} -sno XXXXXX</args>
</binary>


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_binary_configuration.xml

Die Verwaltung der Binär-Pakete wie der Import oder die Auflistung verfügbarer Binär-Pakete, findet über den Administrator-Client (Console) statt.

  • Keine Stichwörter