I componenti interni di un'applicazione composita possono essere cablati insieme in modo che un'azione avviata dall'utente in un componente possa attivare un'azione programmata in un altro componente. Queste funzionalità sono supportate dall'utilizzo di proprietà, azioni, tipi e del broker di proprietà. I componenti delle applicazioni composite utilizzano un modello per dichiarare, pubblicare e condividere le informazioni con altri per mezzo del broker di proprietà WebSphere Portal.

I componenti sottoscrivono il broker pubblicando i dati immessi (proprietà e operazioni) che possono condividere. I componenti possono agire come fornitore o destinatario di queste proprietà e azioni.

Questi componenti possono essere sviluppati e distribuiti separatamente o insieme e possono scambiare informazioni e reagire in modo coordinato, migliorando così l'esperienza dell'utente finale. Al contrario, se alcuni componenti sono rimossi, i restanti componenti saranno ancora in grado di funzionare correttamente e in un modo coordinato. Il broker di proprietà è utilizzato per agevolare lo sviluppo di componenti che possano essere integrati dinamicamente, senza richiedere una precedente coordinazione al momento dello sviluppo. Le applicazioni composite possono essere semplicemente un assemblaggio di più componenti con aggregazione approssimativa che mantengono l'utente dell'applicazione concentrato sul processo aziendale, eliminando la necessità che l'utente dell'applicazione passi da un'applicazione all'altra o da una finestra aperta all'altra.

Per derivare valore aggiuntivo e aumentare ulteriormente la produttività dell'organizzazione, è possibile formare relazioni causali tra i componenti e altri componenti attraverso proprietà e azioni. Una proprietà trasmette un valore e un'azione utilizza un valore. Per assicurarsi che entrambi i lati comunichino coerentemente, sia le proprietà che le azioni devono descrivere il tipo di valore che trasmettono o utilizzano. Questo assicura che siano stabilite connessioni sensate quando i componenti sono cablati insieme.

Utilizzo del Property Broker Editor

I file WSDL utilizzati nelle applicazioni composite sono creati e modificati in IBM® Lotus® Domino(TM) Designer utilizzando il Property Broker Editor.

Questa funzione fornisce un modo semplice per descrivere le proprietà, i tipi e le operazioni del broker senza dover conoscere il formato WSDL. Una semplice interfaccia permette di definire le proprietà, le operazioni e i tipi, generando il file WSDL richiesto dalle implementazioni del broker quando si salvano le impostazioni dell'editor.

Questa funzione permette svolgere le seguenti funzioni:

• Definire le proprietà di cablaggio delle applicazioni composite
• Impostare i tipi di dati per i valori che sono condivisi tra le applicazioni
• Creare operazioni per le applicazioni composite

Definizione delle proprietà di cablaggio delle applicazioni composite

Con le applicazioni composite, è necessario definire le proprietà che le portlet utilizzeranno per scambiare informazioni con il broker di proprietà IBM® WebSphere® Portal. Il broker di proprietà trasferisce le istanze di queste proprietà e i loro valori alle/dalle portlet per avviare le operazioni.

Il broker di proprietà è un'interfaccia WebSphere Portal che gestisce la relazione tra l'origine cooperativa e le portlet di destinazione e trasferisce i dati alla destinazione sotto forma di operazione della portlet corrispondente. Per definire le proprietà e i relativi dettagli di proprietà corrispondenti con il Property Broker Editor di Domino Designer, seguire questa procedura.

1. Avviare Domino Designer

2. Aprire il file dell'applicazione composita che contiene il file WSDL che si desidera aprire.

3. Fare clic su Applicazioni composite-Proprietà cablaggio. I file WSDL per l'applicazione composita vengono visualizzati nella vista Applicazioni composite-Proprietà di cablaggio. È possibile anche fare clic sul pulsante Nuova proprietà cablaggio per creare un nuovo file con cui iniziare e avviare automaticamente l'Editor.

4. Se il file esiste già, selezionare e fare doppio clic sul file che si desidera aprire in modifica. Il Property Broker Editor viene avviato in modo che sia possibile modificare il file WSDL.

5. Fare clic sulla scheda Proprietà dell'area di progettazione. Viene visualizzato un modulo chiamato Proprietà cablaggio.

6. Nel modulo Proprietà cablaggio, eseguire le seguenti operazioni.

• Fare clic su Aggiungi per aggiungere una nuova proprietà nella finestra Proprietà. Con un tipo di dati predefinito di Stringa è stata creata una proprietà predefinita chiamata Proprietà predefinito.
• Nel campo Nome della finestra Dettagli proprietà, scrivere il nome da assegnare alla proprietà. Si può fare riferimento ai nomi delle proprietà negli script che si impostano per l'applicazione composita, ad esempio gli script di operazioni.
• Nel campo Tipo della finestra Dettagli proprietà, selezionare il tipo di dati della proprietà che si sta definendo. Le opzioni comprendono String, Integer, Double, Boolean, Date e Date/Time, oltre a tutti i tipi che sono stati precedentemente creati per il componente.
• Nel campo Titolo della finestra Dettagli proprietà, scrivere il titolo della proprietà. I titoli non sostituiscono i nomi. I titoli sono esposti in WebSphere Portal ma non vengono visualizzati nel codice dello script.

  Nota Facoltativo: Nel campo Descrizione della finestra Dettagli proprietà, immettere una descrizione della proprietà. L'amministratore utilizza questa descrizione quando si connettono le portlet dopo la distribuzione.

• Abilitare o disabilitare l'opzione Consenti pubblicazione. Poiché una proprietà è una voce di dati scambiabili tipizzati che può essere prodotta dai componenti, l'abilitazione di questa opzione significa che si desidera pubblicare questa proprietà nel broker di proprietà. I componenti NSF possono pubblicare e utilizzare le proprietà. La pubblicazione implica l'invio di un valore al broker di proprietà, che lo può passare agli altri componenti.
• Aggiungere lo spazio dei nomi richiesto nel campo Namespace della sezione Spazio dei nomi di destinazione. Come parte della creazione di un nuovo tipo, nel campo Namespace sono necessari gli spazi dei nomi predefiniti per il tipo della proprietà. Lo spazio dei nomi fornisce un identificatore univoco nel file che contiene le definizioni delle proprietà. Questo valore è impostato automaticamente in base al nome del componente e non è necessario modificarlo a meno che non si abbiano requisiti personalizzati.
• Per rimuovere una proprietà, selezionarla dall'elenco delle proprietà. Fare clic su Rimuovi per rimuovere la proprietà.

Nota Nella maggior parte dei casi, il tipo di proprietà è stringa. Normalmente, si impostano soltanto i nuovi tipi di proprietà per le proprietà che contengono più tipi, ad esempio, string, integer e date/time.

Di conseguenza, Domino Designer crea un file Web Services Description Language (WSDL) in modo che il componente possa far riferimento alle proprietà. Questo file sarà distribuito a WebSphere Portal insieme al resto dei file dei componenti.

Se si modifica un file esistente WSDL, è necessario aggiornare l'elemento di progettazione Proprietà cablaggio esistente per aggiornarlo con le modifiche. Fare riferimento all'argomento "Aggiornamento o ripristino di un file WSDL modificato in Domino Designer" per ulteriori informazioni sul ripristino e l'aggiornamento dell'elemento di progettazione Proprietà cablaggio.

Definizione dei tipi di dati delle proprietà per le applicazioni composite

Con le applicazioni composite, le proprietà sono utilizzate per scambiare informazioni tra i componenti delle applicazioni utilizzando il broker IBM® WebSphere® Portal. Il broker di proprietà trasferisce le istanze di queste proprietà e i loro valori alle/dalle portlet per avviare le operazioni.

Il broker delle proprietà è un'interfaccia WebSphere® Portal che tratta la relazione tra la sorgente cooperativa e le portlet di destinazione e invia i dati alla destinazione nel modulo dell'operazione portlet corrispondente. Per informazioni sul broker di proprietà WebSphere Portal, visitare il sito http://www.ibm.com/websphere/portal/library.

Seguire questa procedura per impostare i tipi di dati per queste proprietà:

1. Avviare Domino Designer

2. Aprire il file dell'applicazione composita che contiene il file WSDL che si desidera aprire.

3. Fare clic su Applicazioni composite-Proprietà cablaggio. I file WSDL per l'applicazione composita vengono visualizzati nella vista Applicazioni composite-Proprietà di cablaggio. È possibile anche fare clic sul pulsante Nuova proprietà cablaggio per creare un nuovo file con cui iniziare e avviare automaticamente l'Editor.

4. Se il file esiste già, selezionare e fare doppio clic sul file che si desidera aprire in modifica. Il Property Broker Editor viene avviato in modo che sia possibile modificare il file WSDL.

5. Fare clic sulla scheda Tipi dell'editor. Tutti i nuovi tipi creati nella pagina Tipi vengono visualizzati nell'elenco Tipo della pagina Proprietà.

Nota Nella maggior parte dei casi, il tipo di proprietà è stringa. Normalmente, si impostano soltanto i nuovi tipi di proprietà per le proprietà che contengono più tipi, ad esempio, string, integer e date/time.

6. Per creare un nuovo tipo di proprietà, eseguire una delle seguenti operazioni:

• Per creare un nuovo tipo di proprietà singolo, fare clic su Nuovo tipo. Scrivere il nome del tipo di proprietà nel campo Nome e selezionare un tipo dall'elenco nel campo Tipo.
• Per creare un nuovo tipo complesso, fare clic su Nuovo tipo complesso e immettere il nome del tipo di proprietà nel campo Nome. Per ogni tipo dipendente di un tipo di proprietà complesso, assegnare un nome nel campo Nome e selezionare un tipo dall'elenco nel campo Tipo.
• Per la creazione del nuovo tipo, immettere inoltre lo spazio dei nomi predefinito per il tipo di proprietà nel campo Namespace. Lo spazio dei nomi fornisce un identificatore univoco nel file che contiene le definizioni delle proprietà. Questo valore è impostato automaticamente in base al nome del componente e non è necessario modificarlo a meno che non si abbiano requisiti personalizzati.

• Fare clic su Importa tipi. Appare la finestra di dialogo Importa tipi.
• Sfogliare e selezionare il file WSDL che contiene il tipo che si desidera importare. Vengono visualizzati i tipi disponibili da quel file WSDL.
• Selezionare la casella di controllo del tipo che si desidera importare. Fare clic su OK per importare il tipo nel file attuale WSDL.

9. Fare clic su File > Salva per salvare tutti i nuovi tipi e le modifiche.

Sotto la sezione Tipi del modulo, c'è la sezione Spazi dei nomi dei tipi. Per impostazione predefinita, questa sezione è compressa. Può essere aperta facendo clic sul testo Spazi dei nomi dei tipi. Questa sezione è utile per eliminare gli errori di scrittura dallo spazio dei nomi quando si aggiungono spazi dei nomi e per assegnare un prefisso al tipo poiché il campo Namespace della sezione Dettagli tipo non è modificabile e permette solo di scegliere dagli spazi dei nomi validi conosciuti dal componente.

All'interno della sezione Spazi dei nomi dei tipi è possibile aggiungere uno spazio dei nomi con un prefisso che fa riferimento ai tipi, eventualmente da un altro componente o da un altro standard esterno. Fare clic su Aggiungi per aggiungere un nuovo spazio dei nomi. Immettere il nuovo prefisso nel campo Prefisso e lo spazio dei nomi richiesto nel campo Namespace. Per lo spazio dei nomi dei tipi, selezionare ciò che si desidera rimuovere dall'elenco a sinistra e fare clic su Rimuovi.

Se si modifica un file esistente WSDL, è necessario aggiornare l'elemento di progettazione Proprietà cablaggio esistente per aggiornarlo con le modifiche. Fare riferimento all'argomento "Aggiornamento o ripristino di un file WSDL modificato in Domino Designer" per ulteriori informazioni sul ripristino e l'aggiornamento dell'elemento di progettazione Proprietà cablaggio.

Creazione di operazioni e parametri per le applicazioni composite

Con le applicazioni composite, è necessario definire le operazioni attivate quando le portlet pubblicano le proprietà che ricevono da altre portlet. Gli esempi di operazioni includono la modifica o l'aggiornamento delle pagine dei componenti e il reindirizzamento della pagina corrente a un sito Web.

Nelle applicazioni composite, i seguenti passaggi devono avere luogo prima che possa verificarsi un'azione.

• L'utente interagisce in qualche modo con una portlet, ad esempio, immettendo un valore e quindi facendo clic su un pulsante di invio.
• Uno script esegue e pubblica il valore della proprietà al broker di proprietà IBM® WebSphere® Portal.
• Il broker di proprietà trova le portlet che devono ricevere il valore della proprietà e dice loro di eseguire l'azione richiesta.

1. Avviare Domino Designer

2. Aprire il file dell'applicazione composita che contiene il file WSDL che si desidera aprire.

3. Fare clic su Applicazioni composite-Proprietà cablaggio. I file WSDL per l'applicazione composita vengono visualizzati nella vista Applicazioni composite-Proprietà di cablaggio. È possibile anche fare clic sul pulsante Nuova proprietà cablaggio per creare un nuovo file con cui iniziare e avviare automaticamente l'Editor.

4. Se il file esiste già, selezionare e fare doppio clic sul file che si desidera aprire in modifica. Il Property Broker Editor viene avviato in modo che sia possibile modificare il file WSDL.

5. Fare clic sulla scheda Operazioni nell'area di progettazione. Viene visualizzato un modulo intitolato Operazioni cablaggio.

6. Nel modulo Operazioni cablaggio, eseguire le seguenti operazioni:

• Fare clic su Aggiungi per aggiungere una nuova operazione nella finestra Operazioni. Viene creata un'operazione predefinita chiamata Operazione. Le impostazioni predefinite per questa operazione hanno le seguenti opzioni:
  • Azione predefinita se più azioni corrispondono alla proprietà - Se più azioni corrispondono alla proprietà subentrante, rendere questa operazione predefinita se sono state definite altre operazioni che erano state configurate per ricevere la stessa proprietà.
  Nota Se più operazioni utilizzano la stessa proprietà Parametri input operazione, è necessario determinare quale operazione è quella predefinita. Per specificare l'azione predefinita per quella proprietà, immettere un segno di spunta nella casella accanto all'operazione predefinita se più operazioni corrispondono alla proprietà. Assicurarsi di avere soltanto un'operazione selezionata con la stessa proprietà delle altre operazioni. Inoltre, se si hanno più azioni selezionate come predefinite per la proprietà dell'input, si verificheranno errori quando si eseguirà l'applicazione composita.

  Se si desidera modificare queste opzioni, deselezionare l'opzione per disattivarla.

• Nel campo Nome della finestra Dettagli operazione, immettere il nome che si desidera assegnare alla proprietà. Si può fare riferimento ai nomi delle proprietà negli script che si impostano per l'applicazione composita, ad esempio gli script di operazioni.
• Nel campo Titolo della finestra Dettagli operazione, immettere il titolo dell'operazione. I titoli non sostituiscono i nomi. I titoli sono esposti in WebSphere Portal ma non vengono visualizzati nel codice dello script.

  Nota Facoltativo: Nel campo Descrizione della finestra Dettagli operazione, immettere una descrizione dell'operazione. L'amministratore utilizza questa descrizione quando si connettono le portlet dopo la distribuzione.

• Per rimuovere un'operazione, selezionarla dall'elenco delle operazioni. Fare clic su Rimuovi per rimuovere l'operazione.

Per le operazioni, è possibile definire quanto segue:

• Parametro di input dell'operazione
• Parametro di output dell'operazione

Parametro di input dell'operazione

Per identificare l'azione associata a una proprietà di input, si utilizza il parametro di input dell'operazione. Questa operazione viene avviata quando viene pubblicata la proprietà di input, a condizione che sia attiva. Si potrebbe quindi utilizzare il valore in uno script per aggiornare tutte le informazioni della pagina che sono dipendenti dal valore.

Il parametro di input dell'operazione viene specificato la proprietà di input associata nel campo Proprietà della sezione Parametro di input dell'operazione del modulo Operazioni cablaggio. L'operazione viene quindi attivata in risposta alla proprietà pubblicata e, quando l'operazione viene richiamata, il valore della proprietà può essere richiesto dallo script.

Parametro di output dell'operazione

Se un'operazione pubblica una proprietà, è necessario definire un parametro di output dell'operazione. Questo è possibile utilizzando le finestre Proprietà disponibili e Proprietà selezionate della sezione Parametro di output dell'operazione del modulo Operazioni cablaggio.

La finestra Proprietà disponibili elenca tutte le proprietà del file WSDL corrente (che non è ancora stato scelto per le proprietà di output). È possibile selezionare una o più proprietà e fare clic su Aggiungi per impostarle come parametri di output per l'operazione corrente.

La finestra Proprietà selezionate elenca le proprietà che sono state scelte come parametri di output per l'operazione corrente.

È quindi possibile utilizzare i pulsanti Aggiungi e Rimuovi per definire e azzerare l'impostazione dei parametri di output dall'elenco Proprietà disponibili.

Ricordare di fare clic su File >Salva per salvare tutte le modifiche dei parametri di input e output dell'operazione.

Se si modifica un file esistente WSDL, è necessario aggiornare l'elemento di progettazione Proprietà cablaggio esistente per aggiornarlo con le modifiche. Fare riferimento all'argomento "Aggiornamento o ripristino di un file WSDL modificato in Domino Designer" per ulteriori informazioni sul ripristino e l'aggiornamento dell'elemento di progettazione Proprietà cablaggio.

Vedere anche

Sintassi dei file WSDL
Utilizzo dei tipi di dati nelle applicazioni composite
Importazione dei file WSDL in Domino Designer
Esportazione dei file WSDL da Domino Designer
Aggiornamento di un file WSDL in Domino Designer
Specifica di un editor di proprietà alternativo predefinito in Domino Designer

Glossario

Guida sulla Guida

Contenuto completo della Guida

Glossario