Bibliotheken

Definition

Eine Bibliothek ist eine Sammlung von Ressourcen, die Sie in eine Schema-Version einbinden können.

Anstatt Ressourcen lokal in der Schema-Version anzulegen, können Sie benötigte Ressourcen in Bibliotheken speichern

und diese Bibliotheken dann in Ihre Schema-Version einbinden. Die Ressourcen der Bibliothek stehen dann im Schema zur Verfügung.

Die Verwendung von Bibliotheken bietet einige Vorteile, unter anderem:

Besseren Überblick über Ressourcen durch Aufteilung in einzelne, thematisch geordnete Bibliotheken.

Wiederverwendung von Ressourcen, da diese nur einmal zentral in einer Bibliothek angelegt werden müssen.

Wird eine neue Ressource angelegt, steht sie sofort in allen Schema-Versionen, die die Bibliothek nutzen, zur Verfügung.

Ressourcen müssen nicht in jeder Schema-Version aktualisiert werden, sondern nur zentral in der Bibliothek.

Inhalt und Aufbau von Bibliotheken

Abbildung A: (Mögliche) Inhalte einer Bibliothek

Eine Bibliothek kann alle R-S Ressourcen enthalten. Bibliotheks-Ressourcen können im Schema normal verwendet werden.

In Bibliotheken gibt es jedoch neben den sogenannten INHALTS-WERTEN (den in der Bibliothek definierten Ressourcen)

auch ERFORDERLICHE RESSOURCEN:

Abbildung B: Erforderliche Ressourcen

Erforderliche Ressourcen

ERFORDERLICHE RESSOURCEN sind in einer Bibliothek festgelegte, erwartete Ressourcen. Beim Erstellen einer ERFORDERLICHEN RESSOURCE

geben Sie einen Namen an. Die Bibliothek erwartet dann bei Einbindung in eine Schema-Version eine Ressource mit diesem Namen.

Die Ressource kann aus dem Transaktions-Formular, dem Schema oder einer anderen, in die Schema-Version eingebundenen Bibliothek stammen.

ERFORDERLICHE-RESSOURCEN sind nötig, damit Sie in einer Bibliothek flexibel die Inhalts-Werte, also die Ressourcen die später im Schema nutzbar sind,

gestalten können. Da Bibliotheken unabhängig von Formularen und Schemas sind, weiß eine Bibliothek nicht,

welche Ressourcen später im Schema zur Verfügung stehen werden. Dies geben Sie der Bibliothek mit ERFORDERLICHEN RESSOURCEN zu verstehen.

ERFORDERLICHE RESSOURCEN können Sie dann innerhalb der Bibliothek wie ganz normale Ressource benutzen, z.B. in einer EVAL-Anweisung:

${Name_der_erforderlichen_Ressource}

Bei der späteren Einbindung in das Schema wird in dem Ausdruck dann die Ressource eingesetzt, die im Schema vorhanden ist und den gleichen Namen hat.

Da der Ausdruck ungültig werden würde, wenn keine Ressource mit diesem Namen im Schema existiert, müssen alle ERFORDERLICHEN RESSOURCEN vorhanden sein.

Andernfalls verursacht die eingebundene Bibliothek bei der Dokumenterstellung einen Fehler und bricht den Prozess ab.

Abbildung C: Einbindung von Bibliotheken im R-S Workflow

**Beispiel (Abb. C):**

Im Transaktions-Formular definierte Datenstromvariablen:

Version 1.0: DS.LANG

Version 2.0: DS.LANG und DS.CUST

Schema-Version 1.0 und 2.0 implementieren Formular 1.0, die Version 3.0 das Formular 2.0.

Außerdem definieren die Schema-Versionen noch eigene Ressourcen:

Version 1.0: -

Version 2.0: Logo

Version 3.0: Preis und Logo

Ist die Ressource erforderlich?

Ressource	Bibliothek A	Bibliothek B	Bibliothek C
DS.LANG	Nein	Ja	Ja
DS.CUST	Nein	Nein	Ja
Preis	Nein	Nein	Ja
Logo	Ja	Nein	Ja

Sind die Bibliotheken A, B und C einbindbar in die jeweiligen Schema-Versionen?

	A	B	C
1.0
2.0
3.0

Fonts

Im R-S werden die Fonts (und ihre Ausprägungen), die ein Schema verwenden darf, im Transaktions-Formular festgelegt.

Implementiert ein Schema das Transaktions-Formular, so hat es nur Zugriff auf die ihm erlaubten Fonts. Da Bibliotheken, wie bereits erwähnt,

unabhängig von Formularen und Schemas sind, weiß eine Bibliothek nicht, auf welche Fonts sie nach der Einbindung in eine Schema-Version beschränkt ist.

Sie können daher in einem Arbeitsbereich Fonts registrieren, um allen Bibliotheken in diesem Arbeitsbereich,

analog wie bei den ERFORDERLICHEN RESSOURCEN, mitzuteilen, welche Fonts sie erwarten kann.

Öffnen Sie dazu den Administrator-Client mit folgendem Befehl (Hier lernen Sie, wie man mit dem Adminstrator-Client arbeitet):

adminclient -listFonts [Arbeitsbereich]

z.B.: -listFonts MeinArbeitsbereich

Ihnen werden jetzt alle Fonts, die im Arbeitsbereich registriert sind, angezeigt:

Abbildung D: Administrator-Client -listFonts

Um einen Font hinzuzufügen (oder einen bestehenden Eintrag zu ändern), benutzen Sie folgenden Befehl:

-createFont <Name> <Beschreibung> <Arbeitsbereich> <regular(y/n)> <bold(y/n)> <italic(y/n)> <bold-italic(y/n)>

z.B.: -createFont Arial NoDescription MeinArbeitsbereich y n y n

Dadurch geben Sie allen Bibliotheken im Arbeitsbereich zu verstehen, dass die Schriftart Arial verwendet werden darf,

allerdings nicht fett und nicht fettkursiv. Die neue Schriftart ist damit im Arbeitsbereich registriert und kann in Bibliotheken verwendet werden: