Konfiguration der Funktion ?Gesponserte Links? (SAP-Bibliothek

Konfiguration der Funktion ‚Gesponserte Links’

Einsatzmöglichkeiten

Damit Sie die Funktion Gesponserte Links nutzen können, müssen Sie als Administrator zuvor folgende Konfigurationsschritte durchführen:

· Sie legen einen Ordner und einen Index an.

· Sie kopieren und konfigurieren verschiedene Elemente der Benutzungsoberfläche.

· Sie erweitern Kontextmenüs um Befehle.

Ablauf

Standardmäßige Verwendung der Komponente „Gesponserte Links“

Sie führen folgende Schritte aus:

...

1. Sie legen einen Ordner an, in dem die gesponserten Links gespeichert werden.

a. Navigieren Sie in das Repository /documents und erstellen Sie den Ordner Sponsored Links.

b. Setzen Sie für den Ordner Berechtigungen. Z. B. sollten nur Administratoren und Content-Manager in diesem Ordner Schreibzugriff haben. Geben Sie allen anderen Benutzern Leseberechtigung.

Wenn Sie möchten, können Sie auch die Sichtbarkeit der gesponserten Links mit Hilfe von Berechtigungen auf bestimmte Benutzer einschränken.

2. Sie legen einen Index an.

a. Rufen Sie das iView Index-Administration auf. Wählen Sie im Portal Systemadministration → Systemkonfiguration → Knowledge Management → Index-Administration.

b. Legen Sie einen Index mit folgenden Werten an:

ID = sponsored_links

Name = Sponsored Links Index

Gruppe = keine Angabe erforderlich

Crawler-Parameter = keine Angabe erforderlich

Service = TREX Search

Zu indizierende Objekte = Dokumente

c. Damit die XML-Dokumente, die im Verzeichnis /Sponsored Links abgelegt sind, nicht selbst als Treffer im Suchergebnis auftauchen, müssen Sie folgende Zusatzeigenschaft anlegen:

Name = searchhidden

Wert = true

Wählen Sie Hinzufügen und danach Index anlegen.

d. Wählen Sie anschließend unter Datenquellen das Verzeichnis /documents/Sponsored Links aus und sichern Sie den Index.

Sobald ein gesponserter Link in diesem Verzeichnis angelegt wurde, wird dieser automatisch indiziert und kann in der Suchergebnisliste angezeigt werden.

Hinweis

Falls Sie den Ordner nicht im Repository /documents erstellen, müssen Sie darauf achten, dass in dem verwendeten Repository der Parameter Send Events aktiviert ist.

3. Sie erzeugen von der Komponente SponsoredLinksComponent eine Kopie und geben Parameter an.

a. Rufen Sie das iView Konfiguration auf. Wählen Sie im Portal Systemadministration → Systemkonfiguration → Knowledge Management. Wählen Sie darin Content Management → User Interface → Mapping → Component.

b. Markieren Sie die Komponente SponsoredLinksComponent. Wählen Sie Duplicate. Geben Sie für die Kopie einen Namen an (z. B. My_SponsoredLinksComponent_1). Im Feld Parameters können Sie folgende Parameter angeben:

Parameter der Komponente SponsoredLinksComponent

Parameter	Obligat.	Beschreibung
Indexes	ja	Geben Sie hier die ID des in Schritt 2 angelegten Indizes an. Falls Sie mehrere Indizes nutzen, trennen Sie die Angaben mit Semikolon.
Style	nein	Angabe eines Designs, in dem die Komponente angezeigt wird Bei den verfügbaren Angaben handelt es sich um HTML-B-Styles, die über den Style-Editor gepflegt werden können. mögliche Werte sind:NONE, SAPCOLOR, PRIMARYCOLOR, SECONDARYCOLOR, SECONDARYBOX, SECONDARYBOXCOLOR Falls Sie keinen Stil angeben, gilt standardmäßig SECONDARYBOXCOLOR.
MinWidth	nein	minimale Breite der Komponente in Pixel Falls Sie den Parameter nicht angeben, wird automatisch der Wert 200 verwendet. Hinweis: Der Name eines gesponserten Links wird immer ohne Umbruch angezeigt.
MaxNoLinks	nein	maximale Anzahl der darzustellenden gesponserten Links Falls Sie den Parameter nicht angeben, wird automatisch der Wert 10 verwendet.

z. B.

Parameters = Indexes=sponsored_links, Style=NONE, MinWidth=200

4. Sie kopieren und konfigurieren den Collection-Renderer für das Suchergebnis.

b. Markieren Sie den Eintrag StandardSearchResultRenderer. Wählen Sie Duplicate. Geben Sie für die Kopie einen Namen an (z. B. My_StandardSearchResultRenderer. Fügen Sie im Parameter Components den Eintrag My_SponsoredLinksComponent_1 ein:

Components = SearchHeaderComponent,My_SponsoredLinksComponent_1,
Pager(alignCenter),this,Pager(alignCenter)

Mit Hilfe von Modifikatoren können Sie die Position der genutzten Komponenten in der Suchergebnisliste festlegen. Damit die gesponserten Links z. B. am rechten Rand der Suchergebnisliste aufgeführt werden, müssen Sie folgende Angaben machen:

Components =
SearchHeaderComponent([1;1-2]),Pager([2;1]/alignCenter),
this([3;1]),My_SponsoredLinksComponent_1([3;2]),Pager([4;1])/alignCenter)

Weitere Informationen zur Syntax der Modifikatoren, die für die tabellenartige Anzeige der Suchkomponenten genutzt wird, finden Sie unter Anzeige von Eigenschaften.

5. Sie tragen die Kopie des Collection-Renderers im Layout-Set SearchResultLayoutSet ein.

b. Wählen Sie den Eintrag SearchResultLayoutSet. Wählen Sie Edit.

c. Tragen Sie den neuen Collection-Renderer (siehe Schritt 4 My_StandardSearchResultRenderer) im Parameter Collection-Renderer ein und entfernen Sie den bisherigen Collection-Renderer. Wählen Sie OK.

6. Sie erweitern das Kontextmenü im Navigations-iView um einen Befehl.

b. Öffnen Sie die Befehlsgruppe AdminResourceCommandGroup. Fügen Sie im Parameter Command List den Befehl edit_xml_forms_properties am Ende ein:

Command List = [...],edit_xml_forms_properties

In Kontextmenü eines Dokuments können Sie nun den Befehl Zu gesponserten Links hinzufügen wählen.

Hinweis

In der Konfiguration des Befehls edit_xml_forms_properties ist der Pfad zu dem Ordner /documents/Sponsored Links und der zugehörige XML Forms Projektname im Feld Parameters fest eingetragen. Falls Sie nicht den Standardpfad und das standardmäßig ausgelieferte XML-Formular verwenden, müssen Sie die Parameter des Befehls anpassen.

7. Sie erweitern das Kontextmenü im iView Portalfavoriten um einen Befehl.

b. Öffnen Sie die Befehlsgruppe LinkListMntcResourceCommandGroup. Fügen Sie im Parameter Command List den Befehl edit_xml_forms_properties wie folgt ein:

Command List = change_link, rename, OrderedListGroup, move, edit_xml_forms_properties, ClipboardCommandGroup(expanded), SingleDeleteGroup(expanded), SingleDetailsGroup(expanded)

c. Um zu sichern, wählen Sie OK.

In Kontextmenü der Portalfavoriten können Sie nun den Befehl Zu gesponserten Links hinzufügen wählen.

Optional: Mehrfache Verwendung der Komponente „Gesponserte Links“

Sie können in der Suchergebnisliste nicht nur eine Komponente für die Anzeige von gesponserten Links nutzen. Es ist auch möglich, mehrere Komponenten mit unterschiedlichem Links anzuzeigen. Z. B. könnten Sie eine Komponente zur Anzeige von internen News oberhalb der Suchergebnisliste anzeigen, eine weitere Komponente in der rechten Bildschirmhälfte, die externe Links enthält.

Hierzu müssen Sie die oben genannten Schritte erneut durchführen:

...

1. Legen Sie einen neuen Ordner an und einen weiteren Index.

2. Legen Sie eine Kopie der Komponente an (z. B. My_SponsoredLinksComponent_2), tragen Sie den neuen Index ein und variieren Sie z. B. den verwendeten Stil.

3. Den Collection-Renderer für das Suchergebnis können Sie z. B. wie folgt konfigurieren:

Components = SearchHeaderComponent([1;1-2]),
My_SponsoredLinksComponent_2([2;1-2]/alignleft),
Pager([3;1-2]/alignCenter),this([4;1]),My_SponsoredLinksComponent_1([4;2]),
Pager([5;1-2])/alignCenter)

4. Legen Sie eine Kopie des Befehls edit_xml_forms_properties an und passen Sie darin die Angabe des Ordners an.

5. Editieren Sie ebenfalls den Bezeichner des Befehls.

6. Nehmen Sie den Befehl in die gewünschten Befehlsgruppen auf.

Sie können nun, abhängig vom Inhalt, in beiden Ordnern inhaltlich verschiedene gesponserte Links anlegen.

Ergebnis

Sie haben alle notwendigen Konfigurationsschritte ausgeführt und können nun die Funktion Gesponserte Links nutzen.