Argomento precedente: Chiamata del widget Sfoglia con le opzioni di menuArgomento successivo: Chiamata del widget Richiesta con le opzioni di menu


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:

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', login credentials, businessUnit:’London222", 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'
Unità di business: London222

Specifica l'unità di business a cui possono accedere gli utenti del catalogo durante l'utilizzo del widget Sfoglia. Gli utenti possono accedere ai servizi di tutte le cartelle dell'unità di business in questione.

Ad esempio, se si specifica l'unità di business principale, gli utenti di catalogo possono accedere ai servizi da tutte le cartelle in tutte le unità di business, compresa l'unità di business principale. In caso contrario, se si specifica il nome dell'unità di business con livello più basso, gli utenti di catalogo potranno accedere ai servizi soltanto dalle cartelle contenute in tale unità di business.

Se non si specifica un valore, il sistema di catalogo utilizzerà l'unità di business predefinita dell'utente che esegue l'accesso al widget.

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, 1001 è 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.

La cartella o il servizio specificati devono essere contenuti in un'unità di business a cui l'utente può accedere, in base a quanto definito nel parametro Unità di business.

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.