Promozione di una proprietà

E' possibile promuovere una proprietà del nodo al livello del flusso di messaggi per semplificare la gestione del flusso di messaggi e dei relativi nodi e per fornire valori comuni per più nodi all'interno del flusso facendo convergere le proprietà promosse.

Prima di iniziare:

Per promuovere le proprietà del nodo del flusso di messaggi al livello del flusso di messaggi:

  1. Passare alla Prospettiva Sviluppo dell'applicazione broker.
  2. 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.

  3. 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à.
  4. Selezionare Promuovi proprietà.

    Viene visualizzata la finestra di dialogo Promuovi proprietà.

    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).
  5. 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.

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

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

  7. 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à.
  8. 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à.
  9. 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:
  1. 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à.
  2. E' possibile rilasciare la proprietà o le proprietà selezionate nel pannello di destra utilizzando i seguenti metodi:
    1. 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.

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

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

Promozione delle proprietà obbligatorie

Se si promuove una proprietà che è obbligatoria (cioè, compare un asterisco accanto al nome nella finestra di dialogo delle proprietà del nodo del flusso di messaggi), la caratteristica di obbligatorietà della proprietà viene conservata. Quando si promuove una proprietà obbligatoria, non è necessario impostarne il valore al livello del nodo. Se il flusso che contiene la proprietà obbligatoria promossa è incluso come flusso secondario all'interno di un altro flusso, la proprietà deve essere compilata per il nodo del flusso secondario.

Promozione delle proprietà attraverso una gerarchia di flussi di messaggi

E' possibile ripetere il processo di promozione delle proprietà del nodo del flusso di messaggi attraverso diversi livelli del flusso di messaggi. E' possibile promuovere le proprietà da qualunque livello nella gerarchia al livello superiore successivo e così via attraverso la gerarchia fino al livello più elevato. Il valore di una proprietà è trasmesso dal punto più alto nella gerarchia sul quale è impostato al nodo del flusso di messaggi quando il flusso di messaggi viene distribuito a un broker. Il valore di quella proprietà sul nodo del flusso di messaggi originale viene sovrascritto.

Riferimenti correlati
Nodi integrati
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
ac02380_