Creazione e utilizzo dei widget › Integrazione di widget per la richiesta di servizi e la gestione delle richieste › Utilizzo del widget Richiesta per consentire agli utenti la richiesta dei servizi › Chiamata del widget Sfoglia con il codice sorgente

Chiamata del widget Sfoglia con il codice sorgente

In Liferay è possibile richiamare il widget Sfoglia creando la portlet e specificando il codice sorgente. Consultare i passaggi seguenti per ottenere il precedente esempio del widget Sfoglia. Questi passaggi servono da riferimento per configurare la visualizzazione e il comportamento del widget Sfoglia nella propria implementazione.

Procedere come descritto di seguito:

1. Nella pagina del portale, eseguire queste azioni per la creazione della portlet:
   1. Fare clic su Add, Web Content Display.
   2. Fare clic sull'icona a forma di segno più (Add, Web Content).

      Viene visualizzata la finestra New Web Content.

   3. Specificare i campi obbligatori e chiudere la finestra.

   La nuova portlet viene aggiunta a Liferay.

2. Fare clic su Edit Controls nella parte superiore della pagina.
3. Passare il puntatore del mouse sulla portlet e fare clic sull'icona a forma di matita (Edit Web Content).

   Viene visualizzata la finestra delle impostazioni per la portlet.

4. Nella finestra Content, fare clic su Source.

   Il contenitore Source viene visualizzato per la modifica.

5. Controllare il codice sorgente e i parametri chiave seguenti per il precedente esempio del widget Sfoglia. Utilizzarli come modello per specificare il proprio codice sorgente.
6. Eseguire le azioni seguenti:
   • Chiudere il contenitore Source.
   • Pubblicare e controllare la portlet aggiornata.
   • Se necessario, perfezionare le impostazioni finché il widget non soddisfa i propri requisiti.

Codice sorgente e parametri chiave

Di seguito è riportato il codice sorgente per l'esempio del widget Sfoglia:

<script type="text/javascript" src="http://hostname:portnumber/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>

La prima riga fa riferimento al file JavaScript per il widget Sfoglia.

La seconda riga specifica JavaScript con i parametri di configurazione per il widget Sfoglia.

Nota: separare i parametri con una virgola, ma non inserire una virgola dopo l'ultimo parametro.

La terza riga specifica l'elemento DOM in cui viene eseguito il rendering del widget Sfoglia.

Di seguito sono illustrati i parametri chiave e le descrizioni per la chiamata della funzione CA_Catalog.buildWidget nell'esempio del widget Sfoglia.

Credenziali di accesso

Si consiglia di utilizzare Single Sign-On per i widget. Tuttavia, se sono richieste le credenziali di accesso per il widget, specificarle in questa chiamata di funzione. Utilizzare il formato seguente:

username: 'username', password: 'password'

type:"browse"

Specifica che il widget è Sfoglia.

renderTo:"browse1"

Specifica che venga eseguito il rendering del widget nell'elemento DOM con ID browse1.

rootId:10001

Specifica l'ID di oggetto della cartella o del servizio visualizzato con il widget Sfoglia. In questo esempio, 10001 è la cartella principale del catalogo dell'unità di business.

È possibile specificare una cartella singola o un elenco di servizi separato da virgola con il rispettivo ID di oggetto.

Nota: è possibile eventualmente nascondere la struttura (l'elenco di cartelle a sinistra). Per nascondere la struttura, specificare il parametro hideTree:true. Per impostazione predefinita, questo parametro è impostato su hideTree:false.

layout:'layout-1'

Visualizza le icone e i nomi dei servizi mostrati con il widget Sfoglia.

In alternativa, specificare layout-2 per visualizzare i nomi, le icone e le descrizioni dei servizi.

openIn:"_widget"

Specifica che un altro widget nella stessa pagina può ascoltare e rispondere a eventi dal widget Sfoglia. In questo scenario, quando l'utente fa clic su un servizio, il widget Richiesta risponde aprendo il servizio. È necessario aggiungere il widget Richiesta nella pagina per abilitare questa funzione.

OpenIn indica la modalità di apertura di un servizio nel widget Richiesta quando l'utente fa clic sul servizio nel widget Sfoglia. Di seguito sono riportati altri valori possibili per il parametro openIn:

_self

Apre il servizio nella stessa pagina del catalogo.

_top

Esegue la stessa funzione di _self, anche se il servizio viene aperto nel riquadro di primo livello del browser. Se il servizio è un riquadro, viene selezionato il primo riquadro associato nell'elemento opzione di servizio.

_blank

Apre il servizio in una nuova pagina del catalogo. L'utente richiedere il servizio in tale pagina.

_url

Apre il servizio con un URL personalizzato. Gli URL possono includere un segnaposto per l'ID di oggetto del servizio. Un esempio è indicato di seguito:

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

search: true

Specifica che il widget Sfoglia include il campo di ricerca. Gli utenti possono utilizzare questo campo per eseguire nel catalogo la ricerca dei servizi per nome o parole chiave.

Nota: inoltre è possibile specificare le impostazioni seguenti, come illustrato nel codice sorgente: visualizzazione delle offerte disponibili, colore dei collegamenti, dei bordi e dello sfondo.