Inhaltsfilter 

Verwendung

Mit Inhaltsfiltern transformieren Sie Inhalt, Layout oder Format von Dokumenten, wenn sie zur Anzeige angefordert werden. Beispielsweise kann ein XML-Dokument zur Anzeige im Browser in eine HTML-Datei oder zur Anzeige auf einem Handheld-Gerät in eine WML-Datei transformiert werden. Entsprechend kann der Inhalt einer Datei für verschiedene Zwecke und Zielgruppen in verschiedenen Formaten dargestellt werden. Dieselben Informationen können als Nachrichtenspalte, Business-Report oder Textdatei verteilt werden.

 

Integration

Im Allgemeinen verwenden Inhaltsfilter, die Format- und Layouttransformationen durchführen, die Publishing-Pipeline. Jedoch sind auch andere Inhaltsfilter möglich, die die Publishing-Pipeline nicht verwenden, z.B. ein Inhaltsfilter, der einen Copyright-Vermerk zu Dokumenten hinzufügt.

Die im CM bereitgestellten Inhaltsfilter sind Lesefilter, d.h., sie transformieren den Inhalt von Ressourcen von einem Speicherformat in ein Anzeigeformat für den Browser. Die Publishing-Pipeline kann jedoch auch in der umgekehrten Richtung arbeiten und Schreibfilter auf Eingabedaten des Benutzers anwenden, um diese Daten in einem anderen Format zu speichern.

 

Voraussetzungen

●      Die Publishing-Pipeline ist entsprechend konfiguriert.

●      Es sind XSL- und CSS-Stylesheets vorhanden, die von den Inhaltsfiltern angewendet werden sollen. Je nach Layout- und Formatanforderungen können Sie vordefinierte Stylesheets verwenden, die vom CM bereitgestellt werden. Sie können diese Stylesheets ändern oder neue erstellen.

 

Funktionsumfang

Wenn eine Ressource zur Anzeige angefordert wird, prüft das CM, ob Inhaltsfilter für diesen Ressourcentyp registriert sind. Wenn ja, wird die Ressource an einen Filtermanager übergeben, der dafür zuständig ist, den Transformationsvorgang in Gang zu setzen und den richtigen Filter anzuwenden.

 

Filtermanager

Das CM bietet derzeit drei Filtermanager für verschiedene Typen von Dokumenttransformationen.

 

●      Der XSLT-Filtermanager transformiert ein XML-Dokument anhand von Anweisungen in einem XSL-Stylesheet, das in einer Filterdefinition angegeben ist. Die Ausgabedaten dieser Transformation können an ein Formatierungsprogramm übergeben werden, das das Dokument im gewünschten Anzeigeformat rendert. Das zu verwendende Formatierungsprogramm ist ebenfalls in der Filterdefinition angegeben.
Mit verschiedenen Stylesheets und Formatierungsprogrammen kann dieser Filtermanager XML-Dokumente in folgenden Anzeigeformaten rendern: HTML, XHTML, WML, PLAIN, VRML und SVG-XML.

 

●      Der HMTL-Filtermanager transformiert Layout und Format eines HTML-Dokuments durch Anwendung eines Cascading Stylesheet (CSS). Das Stylesheet muss in einer Filterdefinition angegeben sein. Der Filtermanager kann auch ein Base-Tag und einen URL-Handler liefern.

 

●      Der HTML-Stylesheet-Filtermanager ist ein HTML-Filtermanager ohne Base-Tag und URL-Handler-Eigenschaften.

 

In der folgenden Tabelle werden die Parameter von Inhaltsfiltern aufgeführt, die Sie in der Konfiguration angeben können. Je nach Klasse des Filtermanagers sind manche Parameter nicht relevant.

Parameter von Inhaltsfiltern

Parameter	Filter-manager	Beschreibung
Name	alle	Name des Filters
Extensions	alle	Angabe der Dateinamenserweiterung der Ressourcen, auf die der Filter angewendet werden soll Wenn Sie das Eingabefeld leer lassen, wird der Filter auf jede Erweiterung angewendet.
MIME Types	alle	Angabe des MIME-Typs der Ressourcen, auf die der Filter angewendet werden soll Wenn Sie das Eingabefeld leer lassen, wird der Filter auf jeden MIME-Typ angewendet.
Paths	alle	Angabe eines Pfades oder eines Pfadmusters, auf dessen Inhalte der Filter angewendet werden soll Wenn Sie das Eingabefeld leer lassen, wird der Filter auf jeden Pfad angewendet. Weitere Informationen finden Sie unter Verwendung von Platzhaltern.
Resource Type	alle	Angabe des Ressourcen-Typs, auf den der Filter angewendet werden soll
Repositories	alle	Auswahl der Repositories, auf deren Inhalte der Filter angewendet werden soll
Priority	alle	Angabe der Priorität des Filters Wenn mehrere Filter auf eine Ressource anwendbar sind, bestimmt die Priorität die Reihenfolge ihrer Anwendung. Der Wert 1 gibt die höchste Priorität, der Wert 99 die niedrigste Priorität an.
Stylesheet	HTML, XSLT	Angabe des vom Filter zu verwendenden Stylesheets
Base Tag	HTML	Angabe eines HTML-Base-Tag, das in der HTML-Ausgabedatei eingefügt wird Ein Base-Tag gibt die Basis-URL an, von der alle relativen Links im Dokument abgeleitet werden.
Base URL	HTML	Angabe einer Bais-URL, die in Kombination mit dem Parameter URL Handler Class genutzt wird Der URL-Handler kann die Basis-URL dazu verwenden, URLs im HTML-Dokument zu modifizieren.
URL Handler Class	HTML	Angabe der Java-Klasse, die den URL-Handler implementiert, der zum Ändern von URLs im HTML_Dokument verwendet wird Ein solcher Handler könnte z.B. geschrieben werden, um in einer HTML-Datei relative URLs durch absolute URLs zu ersetzen. Der URL-Handler muss die Schnittstelle com.sapportals.wcm.service.pipeline.processor.html.IHtmlUrlHandler implementieren.
Mime Type	XSLT	Angabe des MIME-Typs des Ausgabedokuments
Formatter	XSLT	Name des Formatierungsprogramms, das zur Erzeugung des im Browser gerenderten Ausgabeformats verwendet werden soll Weitere Informationen über Formatierungsprogramme finden Sie unter XSLT-Filter.

 

Die Parameter Extensions, Mime Types und Path werden in Kombination verwendet. Damit der Filter angewendet werden kann, müssen Ressourcen allen drei Parametern entsprechen.

Die Parameter unterstützen jeweils nur eine Angabe. Möchten Sie z. B. einen Filter auf mehrere MIME-Typen anwenden, müssen Sie mehrere Filter anlegen