- Passare alla Prospettiva Sviluppo dell'applicazione
broker.
- Aprire il flusso di messaggi per il quale si desidera promuovere le proprietà facendo doppio
clic sul flusso di messaggi nella vista Navigator. E' possibile aprire il flusso di messaggi
anche facendo clic con il tasto destro del mouse su di esso nella vista Navigator e facendo
clic su Apri. Il contenuto del flusso di messaggi viene visualizzato nella vista dell'editor.
Se questo è il primo flusso di messaggi che è stato
aperto, vengono visualizzati anche la finestra di controllo del flusso di messaggi e l'elenco dei nodi del flusso di messaggi integrati
disponibili, alla sinistra della vista
dell'editor.
- Nella vista dell'editor, fare clic con il tasto destro del mouse sul simbolo del nodo del flusso di messaggi
di cui si desidera promuovere le proprietà.
- Selezionare Promuovi proprietà.
Viene visualizzata la finestra di dialogo Promuovi proprietà.
Sul lato sinistro della finestra di dialogo sono elencate
tutte le proprietà disponibili per tutti i nodi all'interno del flusso di messaggi. Le proprietà per il nodo evidenziato vengono espanse. E' possibile accedere alle proprietà per tutti i nodi nel flusso di messaggi aperto da questa finestra
di dialogo, indipendentemente dal nodo selezionato all'inizio quando si è aperta
la finestra di dialogo, espandendo le proprietà per tutti gli altri nodi nel flusso
(queste all'inizio sono compresse).
Sul lato destro della finestra di dialogo sono elencati il nome
del flusso di messaggi aperto e tutte le proprietà attualmente promosse al flusso di
messaggi. Se non è stata ancora promossa alcuna proprietà, viene visualizzato sulla destra solo il nome del flusso di messaggi
come root della struttura ad albero della proprietà promossa. Nella figura mostrata il flusso di messaggi non contiene proprietà promosse quindi è visualizzato solo il nome
del flusso di messaggi.
La maggior parte delle proprietà del nodo del flusso di messaggi sono
disponibili per la promozione, ma non è possibile promuovere le seguenti
proprietà:
- Le proprietà che denominano i moduli Mappatura.
- Un gruppo di proprietà, ma è possibile promuovere una singola proprietà.
- Una proprietà che non è possibile modificare (ad esempio, la proprietà Correzione
nel gruppo di proprietà Convalida per il nodo MQInput).
- Le proprietà relative alla descrizione (Descrizione breve e Descrizione completa).
- Selezionare la proprietà che si desidera promuovere al flusso di
messaggi. L'elenco sulla sinistra mostra inizialmente l'elenco espanso di tutte le proprietà
disponibili per il nodo selezionato. Se sono già state promosse proprietà da questo nodo, esse non compaiono sulla sinistra, ma sulla
destra.
L'elenco sulla sinistra include anche gli altri nodi nel flusso di messaggi
aperto. E' possibile espandere le proprietà elencate in ogni nodo e contemporaneamente
gestire tutte queste proprietà. Non è necessario chiudere la finestra di dialogo e selezionare un altro nodo dalla
vista dell'editor per continuare a promuovere le proprietà.
E' possibile selezionare più proprietà da promuovere selezionando una proprietà, tenendo premuto
Ctrl e selezionando una o più altre proprietà.
Se sono state selezionate
più proprietà da promuovere, tutte le proprietà selezionate devono essere disponibili per la
promozione. Se una o più delle proprietà selezionate non sono disponibili per la
promozione, tutta la selezione diventa non disponibile per la promozione e il pulsante
Promuovi nel pannello di destra viene disabilitato.
- Fare clic sul pulsante Promuovi
per promuovere la proprietà o le proprietà
Facendo clic sul pulsante Promuovi si richiama la
finestra di dialogo relativa alla selezione della destinazione:
La finestra di dialogo Selezione destinazione visualizza solo le
destinazioni valide per la promozione della proprietà o delle proprietà selezionate in precedenza e consente di creare una nuova destinazione per la
promozione, come ad esempio in un nuovo gruppo o in una nuova proprietà.
- Nella finestra di dialogo Selezione destinazione, selezionare il gruppo o la proprietà di
destinazione per la proprietà o le proprietà che si desidera promuovere. E' possibile raggruppare le proprietà correlate dagli stessi nodi o da nodi differenti
nel flusso di messaggi rilasciando la proprietà o le proprietà selezionate in un gruppo o proprietà già
esistente. In alternativa, è possibile fare clic su Nuovo
gruppo o Nuova proprietà per creare una nuova destinazione per la
promozione. E' possibile ridenominare i gruppi e le proprietà selezionandoli e facendo
clic su Rinomina o facendo doppio clic sul gruppo o sulla proprietà.
- Fare clic su OK per confermare le
selezioni.
Nota: se si crea un nuovo gruppo o proprietà utilizzando la finestra di dialogo Selezione destinazione, le
modifiche permangono anche se si seleziona Annulla nella finestra di
dialogo. Quando si chiude la finestra di dialogo, i gruppi o le proprietà creati utilizzando la finestra di dialogo
Selezione destinazione compariranno nella finestra di dialogo Promuovi proprietà.
- Una volta selezionate le proprietà che si desidera promuovere al flusso di
messaggi, fare clic su OK. Viene eseguito il commit degli aggiornamenti e si chiude la finestra di dialogo Proprietà promossa.
Facendo clic su Applica, si esegue il commit delle modifiche ma la finestra di dialogo rimane
aperta.
Una volta promossa una proprietà, non è più possibile effettuare modifiche a
quella proprietà attraverso la finestra di dialogo delle proprietà del nodo. E' possibile solo aggiornare il suo valore al livello del
flusso di messaggi.
Nota: è possibile promuovere le proprietà anche dalla finestra di dialogo Promuovi proprietà
trascinando la proprietà o le proprietà selezionate dal pannello di sinistra della finestra di dialogo
Promuovi proprietà al pannello di destra:
- Selezionare la proprietà che si desidera promuovere. E' possibile selezionare più proprietà da promuovere selezionando una proprietà, tenendo premuto
Ctrl e selezionando una o più altre proprietà.
- E' possibile rilasciare la proprietà o le proprietà selezionate nel pannello di destra utilizzando i seguenti
metodi:
- Rilasciare la proprietà o le proprietà selezionate in uno spazio vuoto.
Viene creato automaticamente un nuovo gruppo
per il flusso di messaggi e la proprietà viene collocata al suo interno, con il
nome originale della proprietà e il nome del nodo del flusso di messaggi da cui proveniva visualizzato sotto la voce relativa alla proprietà.
Il nome del primo gruppo creato è per impostazione
predefinita Group1. Se un gruppo denominato Group1 esiste già, viene attribuito al gruppo il nome Group2 e così via. E' possibile ridenominare
il gruppo facendo doppio clic sul gruppo e immettendo il
nuovo testo o selezionando il gruppo nel pannello delle proprietà promosse e facendo clic su
Rinomina.
Nota: Quando si crea una nuova proprietà
promossa, il nome che si immette è quello per il quale la proprietà è nota all'interno
del sistema e deve rispettare certe limitazioni di denominazione Java e XML. Queste vengono applicate
dalla finestra di dialogo e viene visualizzato un messaggio se si immette un nome che include
un carattere non valido. Ad esempio, non è possibile includere uno spazio o un simbolo di
doppi apici.
Se si sta sviluppando un flusso di messaggi all'interno di un
progetto definito dall'utente che sarà inviato come un plug-in
Eclipse, è possibile aggiungere la conversione delle proprietà promosse che sono state
aggiunte. I nomi convertiti possono contenere caratteri, come uno spazio, che hanno delle
limitazioni per i nomi del sistema. L'opzione per fornire stringhe tradotte per le proprietà
promosse non è disponibile se si sta gestendo un flusso di messaggi all'interno di un progetto
del flusso di messaggi.
- Rilasciare la proprietà o le proprietà selezionate in un gruppo che già esiste, per raggruppare le
proprietà correlate dagli stessi nodi o da nodi differenti nel flusso di
messaggi.
Ad esempio, si potrebbe voler raggruppare tutte le proprietà promosse che riguardano le interazioni
con il database. E' possibile modificare i gruppi a cui appartengono le proprietà
promosse in qualsiasi momento, selezionando una proprietà nel pannello Proprietà
promosse e trascinandola in un gruppo differente.
- Rilasciare la proprietà o le proprietà selezionate in una proprietà che già
esiste, per far convergere le proprietà correlate dagli stessi nodi o da nodi differenti nel
flusso di messaggi.
Ad esempio, si potrebbe voler creare una singola proprietà promossa che sovrascriva
la proprietà su ogni nodo che definisce un'origine dati.
Per ulteriori informazioni sulla
convergenza delle proprietà, consultare Convergenza di più proprietà.
Le proprietà del nodo del flusso di messaggi sono ora promosse al
flusso di messaggi. Per confermare, fare clic con il tasto destro del mouse sul flusso di messaggi nella vista
Navigator o fare clic con il tasto destro del mouse nella vista dell'editor e selezionare Proprietà.
Viene visualizzata la finestra di dialogo Proprietà
del flusso di messaggi, che mostra le proprietà del nodo del flusso di messaggi promosse,
organizzate nei gruppi che sono stati creati. Se ora si imposta il valore per una di queste proprietà, tale valore compare come valore
predefinito per la proprietà tutte le volte che il flusso di messaggi stesso viene incluso
in altri flussi di messaggi.
Una volta promossa una proprietà, non è più possibile effettuare modifiche a
quella proprietà attraverso la finestra di dialogo delle proprietà del nodo. E' possibile solo aggiornare il suo valore al livello del
flusso di messaggi.
Quando si seleziona un flusso di messaggi integrato all'interno di un altro flusso di
messaggi (un flusso secondario) e si visualizzano le sue proprietà, si ottengono i valori della proprietà promossa.
Se apre il flusso integrato (cioè, se si seleziona Apri flusso
secondario), si visualizzano i valori originali per le proprietà. Il valore della proprietà promossa non sostituisce la proprietà originale, ma ha
precedenza quando si distribuisce il flusso di messaggi.