HTML-Collection-Renderer-Einstellungen (SAP-Bibliothek

HTML-Collection-Renderer-Einstellungen

Verwendung

Der HTML-Collection-Renderer ermöglicht es, beliebige Ordnerinhalte (Dateien, Ordner, Links) im Stil einer Webseite anzuzeigen. Sie können z. B. an Stelle der Dateinamen Dateien als Hyperlinks mit beliebigen Text anzeigen und Bilddateien direkt im Explorer-iView einbinden.

Voraussetzungen

Sie haben Überlegungen durchgeführt, wie der HTML-Collection-Renderer einen Ordner als Webseite darstellen soll.

Funktionsumfang

Bei dem HTML-Collection-Renderer handelt es sich um einen „statischen“ Collection-Renderer, da nur die Ressourcen (Dateien, Links, Ordner) gerendert werden, die in einer HTML-Datei eingetragen sind. Sie geben diese HTML-Datei in der Konfiguration des HTML-Collection-Renderers an:

Parameter der Gruppe HTML Collection Renderer Settings

Parameter

Beschreibung

HTML Filename
(rndHtmlFilename)

Angabe einer HTML-Datei, die Rendering-Informationen enthält

Sie können die Datei (z. B. meeting.html) in dem Ordner abgelegen, der diesen HTML Collection Renderer nutzt. Die Angabe im Eingabefeld lautet in diesem Fall meeting.html

Sie können die Datei auch in einem anderem Ordner ablegen (z.B. /documents/html). Die Angabe im Eingabefeld lautet dann /documents/html/meeting.html

Informationen zu den weiteren Parametern finden Sie im Abschnitt Collection-Renderer-Einstellungen.

Funktionsweise und Aufbau der HTML-Datei

Das System durchsucht die angegebene HTML-Datei nach bestimmten Start-Tags (<a href=”http://com.sap.cm/ und <img src="http://com.sap.cm/) und generiert nach deren Auswertung die gewünschte Anzeige.

Hinweis

Neben den Tags für Hyperlinks und Bilder, die vom CM ausgewertet werden, können Sie auch andere HTML-Funktionen wie z. B. Tabellen nutzen.

Aufbau eines Hyperlinks

Damit ein Hyperlink auf eine Ressource vom CM ausgewertet werden kann, müssen Sie ihn nach folgendem Prinzip aufbauen:

<a href=“systeminterne URL + relativer Pfad und Name der Ressource + Modifikator“>Linktext</a>

Hinweis

Sie können in einem Hyperlink jeweils nur einen Modifikator verwenden.

Elemente zum Aufbau eines Hyperlinks

Elemente des Hyperlinks	Obligat.	Beschreibung
<a href=”http://com.sap.cm/	ja	Start-Tag des Hyperlinks und Angabe der URL, die das System intern interpretiert
./ oder ../ oder ../folder/	ja	relativer Pfad zu der Ressource ./ die als Hyperlink anzuzeigende Ressource befindet sich in dem Verzeichnis, das der HTML-Collection-Renderer darstellen soll ../ die als Hyperlink anzuzeigende Ressource befindet in der Verzeichnishierarchie eine Verzeichnisebene höher als das Verzeichnis, das der HTML-Collection-Renderer darstellen soll ../folder/ die als Hyperlink anzuzeigende Ressource befindet sich in dem angegebenen Verzeichnis verschachtelte Kombinationen dieser Angaben sind möglich
filename.txt oder foldername oder linkname	nein	Name der Ressource (z. B. der Datei- oder Ordnername)
?uicommand=name	nein	Modifikator, der den textuellen Link mit einem Befehl hinterlegt
?uicommand_with_label=name	nein	Modifikator, der den Namen des Befehls als Linktext anzeigt Wenn Sie diesen Modifikator nutzen, wird kein selbst definierter Linktext angezeigt.
?property=propertyID	nein	Modifikator, der eine Eigenschaft der Datei (mit Hilfe des zugehörigen Eigenschafts-Renderers) im Ursprungsformat (z. B. als Text oder Grafik) anzeigt siehe Vordefinierte Eigenschaften
?property=name&asString=true	nein	zeigt die Eigenschaft im Textformat (string) an
”>Linktext</a>	ja	Linktext und Schluss-Tag des Hyperlinks

Beispiel:

<a href="http://com.sap.cm/./Meeting.doc">Our meeting document</a>

Um den Namen des aktuellen Ordners anzuzeigen, nutzen Sie die folgende Zeile:

Um den Namen des übergeordneten Ordners anzuzeigen, nutzen Sie die folgende Zeile:

Aufbau des Tags zur Anzeige eines Bildes

Damit eine Bilddatei eingebunden werden kann, müssen Sie den Tag nach folgendem Prinzip aufbauen:

Elemente zum Aufbau eines Tags zur Anzeige eines Bildes

Elemente des Hyperlinks	Obligat.	Beschreibung
<img src="http://com.sap.cm/	ja	Start-Tag und Angabe der URL, die das System intern interpretiert
./ oder ../ oder ../folder/	ja	relativer Pfad zu der Bilddatei ./ das einzubindende Bild befindet sich in dem Verzeichnis, das der HTML-Collection-Renderer darstellen soll ../ das einzubindende Bild befindet in der Verzeichnishierarchie eine Verzeichnisebene höher als das Verzeichnis, das der HTML-Collection-Renderer darstellen soll ../folder/ das einzubindende Bild befindet sich in einem beliebigen Verzeichnis innerhalb von KM verschachtelte Kombinationen dieser Angaben sind möglich
filename.gif	ja	Name der Bilddatei
”>	ja	schließendes Tag

Beispiel:

Aktivitäten

Um eine HTML-Collection-Renderer zu konfigurieren, wählen Sie Content Management → User Interface → Settings → Collection Renderer Settings → HTML Collection Renderer Settings.

Beispiel

Der Ordner Project soll mit einem HTML-Collection-Renderer angezeigt werden. Es sind folgende Dateien im Ordner abgelegt:

● Meeting.doc

● Members.jpg

Wenn Benutzer den Ordner öffnen, soll statt dem Dateinamen Meeting.doc der Linktext Our meeting document und die Beschreibung des Dokuments angezeigt werden. Das Bild soll in der Größe 320 x 240 Pixel darunter angezeigt werden.

...

1. Sie legen eine HTML-Datei an und speichern sie unter dem Namen meeting.html im Ordner Project ab.

<html>

<head>

<title>Meetings</title>

</head>

<body>

<a href="http://com.sap.cm/./Meeting.doc">Our meeting document</a>

<br>

<br>

</body>

</html>

2. Sie legen einen HTML-Collection-Renderer (my_HTML_Collection_Renderer) an. Sie konfigurieren ihn und nehmen folgende Einstellung vor:

HTML Filename = meeting.html

3. Sie legen ein Layout-Set (my_LayoutSet) an. Sie konfigurieren es und nehmen folgende Einstellung vor:

Collection Renderer = my_HTML_Collection_Renderer

4. Sie legen ein Layout-Profil an. Sie konfigurieren es und nehmen folgende Einstellung vor:

Layout Set = my_LayoutSet

5. Sie ordnen dem Ordner das Layout-Profil zu.