Erstellen und Verwenden von Widgets › Einbetten von Widgets zum Anfordern von Services und Verwalten von Requests › Verwenden des Request-Widget, um Anwendern das Anfordern von Services zu ermöglichen › Aufrufen des Such-Widget mithilfe von Quellcode

Aufrufen des Such-Widget mithilfe von Quellcode

In Liferay können Sie das Such-Widget aufrufen, indem Sie das Portlet erstellen und den Quellcode angeben. Sehen Sie sich die folgenden Schritte zum Erstellen des bereits weiter oben aufgeführten Beispiels für ein Such-Widget an. Folgen Sie diesen Schritten als ein Modell, um die Anzeige und das Verhalten des Such-Widget in Ihrer Implementierung zu konfigurieren.

Gehen Sie wie folgt vor:

1. Führen Sie auf der Portalseite diese Aktionen aus, um das Portlet zu erstellen:
   1. Klicken Sie auf "Add", "Web Content Display".
   2. Klicken Sie auf das Plussymbol ("Add", "Web Content").

      Das Fenster "New Web Content" wird angezeigt.

   3. Füllen Sie die erforderlichen Felder aus, und schließen Sie das Fenster.

   Das neue Portlet wird Liferay hinzugefügt.

2. Klicken Sie im oberen Bildschirmbereich auf "Edit Controls".
3. Führen Sie die Maus über das Portlet, und klicken Sie auf das Bleistiftsymbol (Webinhalt bearbeiten).

   Die Portlet-Einstellungen werden angezeigt.

4. Klicken Sie im Inhaltsfenster auf die Option für den Quellcode.

   Der Quellcode-Container wird zur Bearbeitung geöffnet.

5. Überprüfen Sie den folgenden Quellcode und die Schlüsselparameter für das bereits weiter oben erwähnte Beispiel eines Such-Widget. Verwenden Sie sie als Modell, um Ihren Quellcode anzugeben.
6. Führen Sie Folgendes durch:
   • Schließen Sie den Quellcode-Container.
   • Veröffentlichen Sie das aktualisierte Portlet, und überprüfen Sie es.
   • Verfeinern Sie im Bedarfsfall Ihre Spezifikationen, bis das Widget Ihren Anforderungen entspricht.

Quellcode und Schlüsselparameter

Nachfolgend ist der Quellcode für das Beispiel des Such-Widget aufgeführt:

<script type="text/javascript" src="http://Hostname:Portnummer/usm/explorer/scripts/browse.widget.js"> </script>

<script type="text/javascript"> CA_Catalog.buildWidget({type: 'browse', renderTo: 'browse1', rootId: 10001, linkColor: 'inherit', borderColor: 'black', layout:'layout-1', openIn:'_widget', search: true } ); </script>

<div id="browse1" style="margin-bottom: 10px; height: 700px">
	&nbsp;</div>

Die Anfangszeile bezieht sich auf die JavaScript-Datei für das Such-Widget.

Die zweite Zeile gibt den JavaScript-Code mit den Konfigurationsparametern für das Such-Widget an.

Hinweis: Trennen Sie Parameter durch Kommas voneinander, geben Sie nach dem letzten Parameter jedoch kein Komma an.

Die dritte Zeile gibt das DOM-Element an, in dem das Such-Widget wiedergegeben wird.

Schlüsselparameter und Erklärungen für den CA_Catalog.buildWidget-Funktionsaufruf im Beispiel für das Such-Widget folgen.

Anmeldeinformationen

Wir empfehlen Single Sign-On für Widgets. Wenn jedoch Anmeldeinformationen für dieses Widget erforderlich sein sollen, geben Sie diese in diesem Funktionsaufruf an. Verwenden Sie das folgende Format:

Anwendername: 'Anwendername', Kennwort: 'Kennwort'

type:"browse"

Gibt an, dass das Widget ein Such-Widget ist.

renderTo:"browse1"

Gibt an, dass das Widget in dem DOM-Element wiedergegeben wird, dessen ID "browse1" ist.

rootId:10001

Gibt die Objekt-ID des Ordners oder des Service an, der vom Such-Widget angezeigt wird. In diesem Beispiel ist 1001 der Stammordner des Katalogs des Geschäftsbereichs.

Sie können entweder einen einzelnen Ordner oder eine Liste von Services, die durch Kommas getrennt ist, mithilfe der Objekts-IDs angeben.

Hinweis: Sie können die Struktur optional ausblenden (die Liste der Ordner links). Um die Struktur auszublenden, geben Sie den hideTree:true-Parameter an. Dieser Parameter ist standardmäßig auf hideTree:false gesetzt.

layout:'layout-1'

Zeigt die Symbole und Namen der Services an, die im Such-Widget angezeigt werden.

Geben Sie alternativ "layout-2" an, um die Namen, Symbole und Beschreibungen der Services anzuzeigen.

openIn:"_widget"

Gibt an, dass ein anderes Widget auf der gleichen Seite Events abhört, die vom Such-Widget gesendet werden, und darauf reagiert. In diesem Szenario antwortet das Request-Widget durch das Öffnen des Service, wenn der Anwender auf einen Service klickt. Sie müssen dieser Seite das Request-Widget hinzufügen, um diese Funktion zu aktivieren.

"OpenIn" gibt an, wie ein Service im Request-Widget geöffnet wird, wenn der Anwender im Such-Widget auf den Service klickt. Andere mögliche Werte für den openIn-Parameter folgen:

_self

Öffnet den Service im Katalog auf der gleichen Seite.

_top

Erfüllt die gleiche Funktion wie _self, außer dass es im obersten Frame des Browsers geöffnet wird. Wenn der Service ein Frame ist, wird der erste zugeordnete Frame im Serviceoptionselement ausgewählt.

_blank

Öffnet den Service im Katalog auf einer neuen Seite. Der Anwender fordert den Service auf diese Seite an.

_url

Öffnet den Service mithilfe einer anwenderspezifischen URL. Die URL kann einen Platzhalter für die Objekt-ID des Service einschließen. Ein Beispiel folgt:

http://www.google.com?id={id}

search: true

Gibt an, dass das Such-Widget das Suchfeld enthält. Anwender können mit diesem Feld den Katalog anhand des Names oder von Schlüsselbegriffen nach Services durchsuchen.

Hinweis: Sie können auch die folgenden Einstellungen, wie im Quellcode angezeigt, angeben: Hervorgehobene Angebote anzeigen, Link-Farbe, Randfarbe und Hintergrundfarbe.