Procedura dettagliata: Creazione di un'applicazione BizTalk che usa l'adapter MQSeries
In questa sezione viene illustrata la creazione di una semplice applicazione microsoft BizTalk Server che usa l'adapter MQSeries.
Nota
L'applicazione presuppone che si sia installato IBM WebSphere MQ, il componente server per le piattaforme Windows, sullo stesso computer di BizTalk Server. Presuppone inoltre che non siano ancora stati creati indirizzi di ricezione o porte di trasmissione. Se sono già presenti porte di trasmissione o indirizzi di ricezione, è necessario sostituire i nomi appropriati durante l'esecuzione della procedura.
L'applicazione è costituita da un semplice sistema di routing basato sul contenuto che utilizza soltanto un indirizzo di ricezione e una porta di trasmissione. L'indirizzo di ricezione viene letto da una coda IBM WebSphere MQ. La porta di trasmissione accetta il messaggio dall'indirizzo di ricezione e lo invia a un'altra coda IBM WebSphere MQ.
Per creare l'applicazione, è necessario creare le code IBM WebSphere MQ, impostare l'indirizzo di ricezione del server BizTalk e la porta di trasmissione, avviare la porta di ricezione e abilitare l'indirizzo di ricezione, quindi inserire un messaggio di test nella coda.
Se si dispone delle autorizzazioni necessarie per eseguire l'installazione di IBM WebSphere MQ, è possibile creare le code IBM WebSphere MQ tramite le finestre di dialogo dell'adapter e saltare la procedura seguente. Se non si dispone delle autorizzazioni di accesso necessarie, è possibile creare le code mediante IBM WebSphere MQ, i componenti client per Esplora risorse su piattaforme Windows. Per creare le code tramite lo snap-in IBM WebSphere MQ Explorer, effettuare le operazioni seguenti.
Per creare le code IBM WebSphere MQ tramite IBM WebSphere MQ Explorer
Per creare le code IBM WebSphere MQ tramite IBM WebSphere MQ Explorer, effettuare le operazioni seguenti:
Fare clic su Start, scegliere Programmi, IBM WebSphere MQ, quindi Fare clic su WebSphere MQ Explorer.
Fare doppio clic su Gestione code, quindi fare doppio clic sul gestore code predefinito. Il gestore code predefinito è in genere denominato QM_<machine_name> dove machine_name è il nome del computer.
Fare clic con il pulsante destro del mouse su Code, scegliere Nuovoe quindi fare clic su Coda locale.
Nella finestra di dialogo Crea coda locale digitare BTStoMQS in Nome coda e quindi fare clic su OK.
Fare clic con il pulsante destro del mouse su Code, scegliere Nuovoe quindi fare clic su Coda locale.
Nella finestra di dialogo Crea coda locale digitare MQStoBTS in Nome coda e quindi fare clic su OK.
Mediante le operazioni seguenti è possibile creare l'indirizzo di ricezione e la porta di trasmissione, nonché avviare la porta di trasmissione e abilitare l'indirizzo di ricezione. Vengono inoltre create le code IBM WebSphere MQ.
Per creare l'indirizzo di ricezione e la coda MQSeries
Per creare l'indirizzo di ricezione e la coda MQSeries, effettuare le operazioni seguenti:
Nella console di amministrazione di BizTalk Server espandere BizTalk Server Amministrazione, gruppo BizTalk, espandere Applicazioni e quindi espandere l'applicazione predefinita (Applicazione BizTalk 1 per impostazione predefinita).
Fare clic con il pulsante destro del mouse sul nodo Porte di ricezione , scegliere Nuovo e selezionare Porta unidirezionale.
Nella casella Nome della finestra di dialogo Proprietà porta di ricezione digitare MQStoBTS.
Nel riquadro sinistro fare clic su Percorsi di ricezione e nel riquadro destro fare clic su Nuovo.
Nella casella Nome della finestra di dialogo Proprietà posizione di ricezione digitare MQStoBTS.
Selezionare MQSeries nell'elenco a discesa accanto all'opzione Tipo .
Nella sezione Trasporto fare clic su Configura.
Nella finestra di dialogo Proprietà trasporto MQSeries digitare 1 nella casella Intervallo di polling.
Nella casella Definizione coda fare clic sul pulsante con i puntini di sospensione (...).
Nella casella Nome server della finestra di dialogo Definizione coda digitare il nome del computer.
Nella casella Gestione code selezionare il gestore code predefinito.
Nella casella Coda digitare MQStoBTS e quindi fare clic su Esporta.
Nella finestra di dialogo Esporta fare clic su Crea coda, quindi su OK e di nuovo su OK per tornare alla finestra di dialogo Proprietà posizione ricezione .
Nella casella Gestore di ricezione selezionare BizTalkServerApplication.
Nella casella Pipeline di ricezione selezionare PassThruReceive.
Fai clic su OK per applicare le modifiche.
Per creare la porta di trasmissione e la coda MQSeries
Per creare la porta di trasmissione e la coda MQSeries, effettuare le operazioni seguenti:
Fare clic con il pulsante destro del mouse su Porte di trasmissione, scegliere Nuovo e selezionare Porta di trasmissione unidirezionale statica.
Nella casella Nome della finestra di dialogo Proprietà porta di trasmissione digitare BTStoMQS.
Selezionare MQSeries nell'elenco a discesa accanto all'opzione Tipo .
Nella sezione Trasporto fare clic su Configura.
Nella finestra di dialogo Proprietà trasporto MQSeries fare clic sul pulsante con i puntini di sospensione (...) nella casella Definizione coda.
Nella casella Nome server della finestra di dialogo Definizione coda digitare il nome del computer.
Nella casella Gestione code selezionare il gestore code predefinito.
Nella casella Coda digitare BTStoMQS e quindi fare clic su Esporta.
Nella finestra di dialogo Esporta fare clic su Crea coda, quindi fare di nuovo clic su OK e su OK per tornare alla finestra di dialogo Proprietà porta di trasmissione.
Nella casella Invia pipeline selezionare PassThruTransmit.
Fare clic per selezionare Filtri nel riquadro sinistro e quindi configurare le opzioni di filtro nel riquadro destro.
Nell'elenco a discesa Proprietà selezionare BTS. ReceivePortName.
Nella casella Valore digitare MQStoBTS.
Fai clic su OK per applicare le modifiche.
Per abilitare l'indirizzo di ricezione e avviare la porta di trasmissione
Per abilitare l'indirizzo di ricezione e avviare la porta di trasmissione, attenersi alla seguente procedura:
Fare clic con il pulsante destro del mouse sul percorso di ricezione MQStoBTS e quindi scegliere Abilita.
Fare clic con il pulsante destro del mouse sulla porta di trasmissione BTStoMQS e quindi scegliere Avvia.
Il passaggio successivo consente di testare l'applicazione inviato un messaggio di test alla coda di ricezione.
Per testare l'applicazione
Per testare l'applicazione, effettuare le operazioni seguenti:
Fare clic su Start, scegliere Programmi, IBM WebSphere MQ, quindi Fare clic su WebSphere MQ Explorer.
Fare clic con il pulsante destro del mouse su MQStoBTS, quindi scegliere Put Test Message (Inserisci messaggio di test).
Nella casella Dati messaggio digitare un messaggio di test. Fare clic su OK.
Dopo aver immesso i dati, la profondità corrente per la coda MQStoBTS è una (1). Quando l'applicazione elabora il messaggio, il conteggio torna a zero (0) e la profondità corrente per BTStoMQS diventa una (1). È anche possibile visualizzare il contenuto del messaggio.
Per visualizzare il messaggio
Per visualizzare il messaggio, attenersi alla seguente procedura:
Fare doppio clic sulla coda BTStoMQS .
Fare doppio clic sul messaggio e quindi selezionare il foglio dati . È possibile visualizzare il testo del messaggio nella casella Dati messaggio .
Fare clic su OK.
Vedere anche
Informazioni sull'adapter MQSeries
Architettura dell'adapter MQSeries