OrderedSample (esempio di BizTalk Server)
Nell'esempio OrderedSample viene illustrato come utilizzare un'orchestrazione per ricevere e inviare una serie ordinata di messaggi in modalità round trip.
Scopo dell'esempio
Nell'esempio si presuppone che siano presenti messaggi nella coda MQSeries da cui vengono ricevuti i messaggi. Quando l'adapter legge i messaggi dalla coda MQSeries, li legge nell'ordine e li invia a BizTalk Server.
La porta di ricezione nell'orchestrazione , mqreceive, ha la proprietà Recapito ordinato impostata su True.
Sul lato di trasmissione, l'orchestrazione invia un messaggio, quindi attende una notifica di recapito prima di inviare il messaggio successivo. La porta di trasmissione mqsend ha la proprietà Notifica di recapito impostata su Trasmissione. Per semplificare l'esempio, l'orchestrazione utilizza un ciclo infinito.
L'orchestrazione può ricevere batch di messaggi così come singoli messaggi.
Percorso dell'esempio
<Percorso> degli esempi\AdaptersUsage\MQSeriesAdapter\OrderedSample
Nella seguente tabella sono riportati i file inclusi nell'esempio e ne viene descritto lo scopo.
| File | Descrizione |
|---|---|
| OrderedReceiveSend.btproj, OrderedReceiveSend.sln |
File di progetto e soluzione per l'applicazione. |
| OrderedReceiveSendOrchestration.odx | Orchestrazione dell'applicazione. |
| OrderedSample.snk | File di chiave con nome sicuro. |
| Setup.bat | Compila e inizializza l'esempio. |
Compilazione ed esecuzione dell'esempio
Per compilare e distribuire l'esempio
In una finestra di comando passare alla seguente cartella:
<Samples Path>\AdaptersUsage\MQSeriesAdapter\OrderedSampleEseguire il file Setup.bat. Verranno eseguite le operazioni seguenti:
Crea una chiave con nome sicuro per il progetto.
Compila e distribuisce il progetto di orchestrazione.
Se si dispone delle autorizzazioni necessarie per eseguire l'installazione di Windows nel server MQSeries, è possibile creare la coda MQSeries tramite le finestre di dialogo dell'adapter e saltare la procedura seguente. Se non si dispone delle autorizzazioni di accesso necessarie, è possibile creare la coda mediante IBM WebSphere MQ Explorer. A tale scopo, completare la procedura seguente.
Creazione delle code MQSeries tramite WebSphere MQ Explorer
Per creare le code MQSeries tramite WebSphere MQ Explorer
Fare clic su Start, scegliere Tutti i 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 "queue1" in Nome coda e quindi fare clic su OK.
Fare clic con il pulsante destro del mouse su Code, scegliere Nuovo, quindi fare clic su Coda locale.
Nella finestra di dialogo Crea coda locale digitare "queue2" in Nome coda e quindi fare clic su OK.
Creazione dell'indirizzo di ricezione e della coda MQSeries
Questa procedura consente di creare la porta di trasmissione a cui inviare il messaggio e l'indirizzo di ricezione per la ricezione del messaggio correlato da MQSeries. Se non è stata ancora creata, anche la coda MQSeries verrà creata al momento della creazione dell'indirizzo di ricezione.
Per creare l'indirizzo di ricezione e la coda MQSeries
Aprire la Console di amministrazione BizTalk Server.
Espandere BizTalk Server Amministrazione, gruppo BizTalk, applicazioni e quindi espandere l'applicazione richiesta.
Fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e quindi fare clic su Porta di ricezione unidirezionale.
Nella finestra di dialogo Proprietà porta di ricezione unidirezionale digitare OrderedSampleReceive nella casella Nome e fare clic su OK.
Nel riquadro sinistro fare clic sulla scheda Località di ricezione e quindi su Nuovo.
Nella casella Nome della finestra di dialogo Proprietà posizione di ricezione digitare "OrderedSampleReceiveLocation".
Nella casella Tipo di trasporto selezionare MQSeries.
Nella casella Gestore di ricezione selezionare BizTalkServerApplication.
Nella casella Pipeline di ricezione selezionare Microsoft.BizTalk.DefaultPipelines.PassThruReceive.
Fare clic su Configure.
Nella finestra di dialogo Proprietà trasporto MQSeries digitare "10" 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 " queue1" e quindi fare clic su Esporta.
Nella finestra di dialogo Esporta fare clic su Crea coda e quindi su OK o Fine fino a quando non sono state completate tutte le finestre di dialogo.
Creazione della porta di trasmissione e della coda MQSeries
Per creare la porta di trasmissione e la coda MQSeries
Fare clic con il pulsante destro del mouse su Porte di trasmissione, scegliere Nuovo e quindi fare clic su Porta di trasmissione unidirezionale statica.
Nella casella Nome della finestra di dialogo Proprietà porta statica digitare "OrderedSampleSend".
Nella casella Tipo di trasporto selezionare MQSeries.
Nella casella Invia pipeline selezionare Microsoft.BizTalk.DefaultPipelines.PassThruTransmit.
Fare clic su Configure.
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 " queue2" e quindi fare clic su Esporta.
Nella finestra di dialogo Esporta fare clic su Crea coda e quindi su OK o Fine fino a quando non sono state completate tutte le finestre di dialogo.
Per abilitare l'indirizzo di ricezione e avviare la porta di trasmissione
Nella console di amministrazione di BizTalk Server fare clic su Porte di ricezione.
Nel riquadro dei dettagli fare clic con il pulsante destro del mouse sul percorso di ricezione MQIn e scegliere Abilita.
Nel riquadro dei dettagli fare clic con il pulsante destro del mouse sulla porta di trasmissione MQOut e scegliere Avvia.
Per eseguire il binding dell'orchestrazione e avviarla
Nella console di amministrazione di BizTalk Server espandere la cartella Orchestrazioni.
Fare doppio clic sull'orchestrazione OrderedSampleOrchestration e quindi su Binding.
Associare le porte dell'orchestrazione ai seguenti indirizzi di ricezione e porte di trasmissione:
Porta dell'orchestrazione Porta di messaggistica / indirizzo di ricezione mqreceive OrderedSampleReceive mqsend OrderedSampleSend Fare clic su Host.
Nella casella Host selezionare BizTalkServerApplication e fare clic su OK.
Fare clic con il pulsante destro del mouse sull'orchestrazione e scegliere Avvia.
Per eseguire l'esempio
Avviare l'orchestrazione.
Inserire i messaggi nella coda MQSeries dalla quale l'indirizzo di ricezione legge i messaggi.
Visualizzare i messaggi in WebSphere MQ Explorer nella coda di invio alla quale la porta di trasmissione invia i messaggi.