CIB job technischer Leitfaden (DE)

12. Allgemeine Beispiele

Lizenzschlüssel hinterlegen
Formulare und Textbausteine ablegen
Pfadangaben hinterlegen
Formulare und Textbausteine im Auftrag mitliefern

Lizenzschlüssel hinterlegen

Die Lizenzschlüssel für die CIB docgen Module wird sinnvoller weise in der CIB job-Konfigurationsdatei hinterlegt. Fügen Sie in die jobconfig.xml für alle verwendeten Kommando Einträge (einschließlich für CIB job) die Properties „LicenseCompany“ und „LicenseKey“ hinzu. Beachten Sie, dass die Lizenz nur als gültige Lizenz gewertet wird, wenn Sie die Lizenz für CIB job und CIB format angeben. Eine Lizenzangabe von CIB job oder CIB format ist nicht ausreichend.

Beispielkonfigurationsdatei:

<?xml version="1.0"
encoding="ISO-8859-1"?>
<!--
   CIB job XML Schema 1.2 für CIB job ab Version 1.4.x.
 
<Comod>
   <!-- Defaulteinstellungen die für alle Jobs und Commands gültig sind, sofern
          nicht im Job bzw. Step selbst überschrieben -->
   <defaults>
          <properties command="format">
                 <property name="LicenseCompany">MyCompany</property>
                 <property name="LicenseKey">abcd-efgh-12345678</property>
          </properties>
   </defaults>
</Comod>


Zusätzliche Informationen zur CIB job-Konfigurationsdatei finden Sie in dem Abschnitt Konfigurationseinstellungen.


Formulare und Textbausteine ablegen

In der Auftragsdatei verweisen Sie mit zwei Einstellungen auf das Verzeichnis, in dem die vorbereiteten Formulare und Textbausteine liegen: Bei der Angabe des Wurzeldokuments (CIB merge: „-i“, CIB pdf toolbox/merge: „InputFilename“) und bei CIB merge auch noch mit dem Textbausteinverzeichnis („-a“).

Die Angabe des Textbaustein-Verzeichnis ist erforderlich, damit Textbausteine und Bilder gefunden werden, die aus der Eingabedatei mit {includetext} oder {includepicture} angesprochen werden. Dies wird im Fall der CIB pdf toolbox/merge nicht benötigt, da aus einem PDF-Fomular keine anderen Dokumente aufgerufen werden können.

Beispielauftragsdatei (Ausschnitt):

<step name="merge1" command="merge">
   <properties>
          <!-- Hier den Bezug zum Textbausteinverzeichnis
                 herstellen: -->
          <property name="-a">..\templates\</property>
          <!-- Hier das Wurzeldokument angeben: -->
          <property name="-i">..\templates\LBS.rtf</property>
          <property name="-h">XML:$(inline)</property>
          <property name="-d">/root/LBS-Daten</property>
          <property name="-s"/>
   </properties>
</step>

In diesem Beispiel sind die Pfade relativ zum Arbeitsverzeichnis angegeben.

Siehe auch:

Entwurf von Auftragsdateien


Pfadangaben hinterlegen

Wie bereits im vorherigen Abschnitt beschrieben, kann in einer Auftragsdatei über bestimmte Einstellungen das Verzeichnis, in dem die zu verwendenden Formulare und Textbausteine liegen, festgelegt werden. Für eine zentrale Verwaltung dieser Einstellungen empfiehlt es sich, diese in der jobconfig.xml vorzunehmen. Das hat den Vorteil, dass man für alle Auftragsdateien die Einstellungen an nur einer Stelle vornehmen muss. Fügen Sie daher für alle verwendeten Kommando Einträge die entsprechenden Properties hinzu.

Beispielkonfigurationsdatei:

<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
   CIB job XML Schema 1.1 für CIB job ab Version 1.4.x.
 
<Comod>
   <!-- Defaulteinstellungen die für alle Jobs und Commands gültig sind, sofern
          nicht im Job bzw. Step selbst überschrieben -->
   <defaults>
          <properties command="merge">
                 <property name="LicenseCompany">MyCompany</property>
                 <property name="LicenseKey">abcd-efgh-12345678</property>
                 <property name="-a">..\test-templates\</property>
          </properties>
   </defaults>
</Comod>

Zusätzliche Informationen zur CIB job-Konfigurationsdatei finden Sie in dem Abschnitt Konfigurationseinstellungen.


Formulare und Textbausteine im Auftrag mitliefern

Ihre für CIB merge und CIB pdf toolbox/merge vorbereiteten Formulare und Textbausteine können in den meisten Fällen auch in den Auftrag eingebettet werden. Verwenden Sie hierzu das Kommando „mem“ beziehungsweise im speziellen Fall von CIB merge die Einstellung --directory-set=Name. Sie finden Beispiele hierzu im Unterverzeichnis jobs.