Creazione e utilizzo dei widget › Integrazione di widget per la richiesta di servizi e la gestione delle richieste › Utilizzo del widget Stato e di altri widget per consentire agli utenti l'accesso alle richieste › Utilizzo dei widget Stato ed Elenco richieste per consentire ai manager della richiesta l'approvazione o il rifiuto delle richieste › Chiamata del widget Stato con il codice sorgente

Chiamata del widget Stato con il codice sorgente

In Liferay è possibile richiamare il widget Stato creando la portlet e specificando il codice sorgente. Consultare i passaggi seguenti per ottenere il precedente esempio del widget Stato. Questi passaggi servono da riferimento per configurare la visualizzazione e il comportamento del widget Stato 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 Stato. 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 Stato:

<script type="text/javascript" src="http://hostname:portnumber/usm/explorer/scripts/status.widget.js"></script>

<script> CA_Catalog.buildWidget({type: 'status', login credentials, renderTo: 'status1', businessUnit:"London222",  layout:'layout-2', openIn: '_widget', hideCart: true} ); </script>

<div align="center" id="status1" style="width: 400px; margin-bottom: 10px; height: 100px">

	&nbsp;</div>

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

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

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

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

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:"status"

Specifica che il widget è Stato.

renderTo:"status1"

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

Unità di business: London222

Specifica l'unità di business a cui possono accedere gli utenti del catalogo durante l'utilizzo del widget Stato. Per questa unità di business e le unità di business associate, gli utenti possono visualizzare lo stato delle richieste per cui dispongono delle autorizzazioni:

• Gli utenti che non dispongono di diritti di manager della richiesta possono visualizzare soltanto lo stato delle proprie richieste.
• I manager della richiesta possono visualizzare lo stato sia delle proprie richieste che delle richieste in sospeso a loro assegnate.

Se si specifica l'unità di business principale, gli utenti possono visualizzare lo stato delle richieste per tutte le unità di business, compresa l'unità di business principale. Al contrario, se si specifica l'unità di business con livello più basso, gli utenti potranno visualizzare lo stato delle richieste soltanto per 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.

layout:'layout-2'

Visualizza le opzioni del widget Stato come pulsanti in una riga singola. Le opzioni sono Carrello, Aperto, Chiuso e In sospeso.

In alternativa, specificare layout-1 per visualizzare le opzioni in verticale, ciascuna nella propria riga di una tabella.

openIn:"_widget"

Specifica che altri widget nella stessa pagina possono ascoltare e rispondere a eventi dal widget Stato. In questo scenario, quando l'utente fa clic su un'opzione del widget Stato, un altro widget risponde aprendo la destinazione. Le destinazioni sono le seguenti:

Per consentire il corretto completamento delle funzioni di destinazione quando gli utenti fanno clic sull'opzione del carrello, aggiungere i widget seguenti nella pagina:

• Widget Modifica richiesta
• Widget Elenco richieste

OpenIn specifica la modalità di apertura di una destinazione quando l'utente fa clic sul widget Stato. Di seguito sono riportati altri valori possibili per questo parametro:

_self

Apre la destinazione nella stessa pagina del catalogo.

_top

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

_blank

Apre la destinazione in una pagina nuova.

_url

Apre la destinazione con un URL personalizzato. Gli URL possono includere un segnaposto per l'ID di oggetto del contesto di origine, ad esempio, il servizio.

Un esempio è indicato di seguito:

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

Nota: inoltre è possibile specificare le impostazioni seguenti, come illustrato nel codice sorgente: frequenza di aggiornamento in minuti e comando per nascondere il carrello.