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 mehrere,  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 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.

Abbildung C: Einbindung von Bibliotheken

ERFORDERLICHE RESSOURCEN können Sie 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.

Beispiel aus 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



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