Show TOC

 Konfiguration der Funktion 'Gesponserte Links'Locate this document in the navigation structure

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 durch:

  1. Sie legen einen Ordner an, in dem die gesponserten Links gespeichert werden.
    1. Navigieren Sie in das Repository /documents und erstellen Sie den Ordner Sponsored Links.

       

    2. Vergeben 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 mithilfe von Berechtigungen auf bestimmte Benutzer einschränken.

  2. Sie legen einen neuen Index an.
    1. Rufen Sie das iView Index-Administration auf. Wählen Sie im Portal Systemadministration → Systemkonfiguration → Knowledge Management → Index-Administration
    2. 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

    3. 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.

    4. 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 Eventsaktiviert ist.

  3. Sie erzeugen von der Komponente SponsoredLinksComponent eine Kopie und geben Parameter an.
    1. Rufen Sie das iView Configuration auf. Wählen Sie im Portal Systemadministration → Systemkonfiguration → Knowledge Management. Wählen Sie darin Content Management → User Interface → Mapping → Component.
    2. 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

Obligatorisch

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.

Zum Beispiel:

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

  1. Sie kopieren und konfigurieren den Collection-Renderer für das Suchergebnis.
    1. Rufen Sie das iView Configuration auf. Wählen Sie im Portal Systemadministration → Systemkonfiguration → Knowledge Management. Wählen Sie darin Content Management → User Interface → Settings → Collection Renderer Settings  → Search Result Renderer Settings.
    2. 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)

      Mithilfe 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 .

  2. Sie tragen die Kopie des Collection-Renderers im Layout-Set SearchResultLayoutSet ein.
    1. Rufen Sie das iView Configuration auf. Wählen Sie im Portal Systemadministration → Systemkonfiguration → Knowledge Management. Wählen Sie darin Content Management → Benutzungsoberfläche   → Einstellungen → Layout-Set.
    2. Wählen Sie den Eintrag SearchResultLayoutSet. Wählen Sie Bearbeiten.
    3. 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.
  3. Sie erweitern das Kontextmenü im Navigations-iView um einen Befehl.
    1. Rufen Sie das iView Configuration auf. Wählen Sie im Portal Systemadministration → Systemkonfiguration → Knowledge Management. Wählen Sie darin Content Management → Benutzungsoberfläche → Befehle → UI-Befehlsgruppen.
    2. Ö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ügenwä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.

  4. Sie erweitern das Kontextmenü im iView Portalfavoriten um einen Befehl.
    1. Rufen Sie das iView Configuration auf. Wählen Sie im Portal Systemadministration → Systemkonfiguration → Knowledge Management. Wählen Sie darin Content Management → Benutzungsoberfläche → Befehle → UI-Befehlsgruppen.
    2. Ö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)

    3. Um Ihre Angaben 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. Weitere Informationen finden Sie unter Gesponserte Links anlegen und verwalten .