MQSSendPipelineComponent (esempio di BizTalk Server)

In questo esempio viene illustrato come scrivere un componente della pipeline che legge un set di valori di proprietà MQSeries da un file XML e li applica a un messaggio.

Scopo dell'esempio

Questo esempio è costituito da due progetti di Visual Studio, un progetto componente della pipeline e un progetto della pipeline che usa il componente della pipeline.

Percorso dell'esempio

• <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\SetMQSeriesHeaderPropertyComponent

• <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\SetMQSeriesHeaderPropertyPipeline

  Nella seguente tabella sono riportati i file inclusi nell'esempio e ne viene descritto lo scopo.

Modalità di utilizzo dell'esempio

Per creare l'applicazione, è necessario completare la procedura seguente:

1. Creare le cartelle per l'applicazione.

2. Modificare e compilare il progetto di Visual Studio per il componente della pipeline.

3. Copiare l'assembly compilato e il file di intestazione nelle cartelle appropriate.

4. Modificare il progetto di Visual Studio per la pipeline di BizTalk Server.

5. Compilare e distribuire il progetto della pipeline di BizTalk Server.

6. Configurare una posizione di ricezione BizTalk Server.

7. Creare una coda MQSeries.

8. Impostare una porta di trasmissione.

9. Abilitare l'indirizzo di ricezione e avviare la porta di trasmissione

Creazione delle cartelle per l'applicazione

Questa procedura consente di creare le cartelle appropriate per l'applicazione.

Per creare le cartelle per l'applicazione

1. Creare una cartella denominata temp nell'unità C:\ se non esiste già.

2. Creare una cartella nella directory C:\temp denominata Pickup3.

Modifica e compilazione del progetto per il componente della pipeline

Questa procedura modifica e compila il progetto di Visual Studio per il componente della pipeline.

Per modificare e compilare il progetto per il componente della pipeline

1. Fare doppio clic sul file della soluzione, SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent.sln per aprire la soluzione in Visual Studio.

2. Fare doppio clic sul file di classe CSetMQSeriesHeaderPropertyComponent.cs per aprire il file di classe in Visual Studio.

3. Individuare gli esempi di variabileDir, verificare che questa variabile sia impostata sul percorso C:\temp.

4. Fare clic con il pulsante destro del mouse sulla soluzione nel Esplora soluzioni e scegliere Compila. Verrà compilato il progetto in una dll situata nella directory SetMQSeriesHeaderPropertyComponent\SetMQSeriesHeaderPropertyComponent\bin\Debug.

Copia l'assembly e il file di intestazione nelle cartelle appropriate

Con questa procedura l'assembly compilato e il file di intestazione vengono copiati nelle cartelle appropriate.

Per copiare l'assembly compilato e il file di intestazione nelle cartelle appropriate

1. Copiare l'assembly compilato SetMQSeriesHeaderPropertyComponent.dll nella cartella componenti della pipeline BizTalk. Il percorso predefinito per la cartella componenti della pipeline BizTalk è \Programmi (x86)\Microsoft BizTalk Server <VERSION>Pipeline Components.

2. Copiare il file delle proprietà MQHeader SetMQSMQMDHdrProps.xml nella directory C:\temp .

Modifica del progetto per la pipeline di BizTalk Server

Questa procedura modifica il progetto di Visual Studio per la pipeline di BizTalk Server.

Per modificare il progetto per la pipeline di BizTalk Server

1. In Visual Studio aprire la soluzione facendo doppio clic sul file della soluzione, SetMQSeriesHeaderPropertyPipeline\SetMQSeriesHeaderPropertyPipeline.sln.

2. Creare un file di chiave con nome sicuro per il progetto. A tal scopo, eseguire le operazioni seguenti:

   1. Aprire un prompt dei comandi di Visual Studio.

   2. Modificare le directory in <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent.

   3. Digitare quanto segue:

      sn -k MQSSendPipelineComponent.snk

   4. Premere INVIO. Verrà creato il file di chiave.

3. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e scegliere Proprietà per avviare Project Designer per il progetto (nella finestra centrale).

   1. Nella scheda Progetto Designer fare clic sulla scheda Firma.

   2. Nel riquadro a destra selezionare l'opzione Firma l'assembly .

   3. Fare clic sull'elenco a discesa per l'opzione Scegli un file di chiave con nome sicuro e fare clic su Sfoglia.

   4. Passare a <SamplesPath>\AdaptersUsage\MQSeriesAdapter\MQSSendPipelineComponent\MQSSendPipelineComponent.snk, fare clic su Apri.

4. Il componente della pipeline creato in precedenza viene già aggiunto alla fase Pre-Assembl di questo progetto di pipeline. Se il componente non fosse già aggiunto, sarebbe necessario completare la procedura seguente per aggiungerlo:

   1. Nell'IDE di Visual Studio fare clic sulla scheda Casella degli strumenti a sinistra.

   2. Fare clic con il pulsante destro del mouse sulla casella degli strumenti e scegliere Scegli elementi.

   3. Nella finestra di dialogo Scegli elementi casella degli strumenti fare clic sulla scheda Componenti della pipeline BizTalk , selezionare il componente personalizzato per impostare le proprietà delle intestazioni MQseriese quindi fare clic su OK.

   4. Trascinare il componente personalizzato per impostare le proprietà delle intestazioni MQseriesnella fase Pre-Assembly di questa pipeline.

Compilazione e distribuzione del progetto di pipeline

Questa procedura compila e distribuisce il progetto della pipeline di BizTalk Server.

Per compilare e distribuire il progetto di pipeline

1. Nella finestra Esplora soluzioni fare clic con il pulsante destro del mouse sulla soluzione e quindi scegliere Distribuisci soluzione. Verrà generata la soluzione e verrà distribuito l'assembly nel database di gestione BizTalk.

2. Verificare che l'assembly sia stato distribuito nel database di gestione BizTalk:

   1. Aprire la Console di amministrazione BizTalk.

   2. Fare clic per espandere Il gruppo BizTalk [<servername>:<database> di gestione], quindi fare clic per espandere la cartella Assembly .

      L'assembly della pipeline distribuito deve essere visibile nella cartella Assembly .

Creazione dell'indirizzo di ricezione

Questa procedura crea un percorso di ricezione BizTalk Server.

Per creare l'indirizzo di ricezione

1. Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e quindi fare clic su Porta di ricezione unidirezionale.

2. Nella finestra di dialogo Proprietà porta unidirezionale digitare "MQReply" e fare clic su OK.

3. Nel riquadro sinistro fare clic sulla scheda Percorsi di ricezione e quindi su Nuovo.

4. Nella finestra di dialogo Proprietà percorso di ricezione digitare "ReceiveFile".

5. Nella casella Tipo di trasporto selezionare FILE.

6. Nel campo Gestore ricezione selezionare BizTalkServerApplication.

7. Nel campo Ricezione pipeline selezionare Microsoft.BizTalk.DefaultPipelines.PassThruReceive.

8. Nel campo Ricezione cartella digitare "C:\temp\Pickup3".

9. Nel campo Maschera file digitare "*.*".

10. Fare clic su OK e quindi fare di nuovo clic su OK per uscire dalla finestra di dialogo Proprietà percorso ricezione .

Creazione di una coda MQSeries mediante MQSeries Explorer

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 utilizzare la procedura seguente per creare la coda mediante IBM WebSphere MQ Explorer.

Per creare una coda MQSeries mediante MQSeries Explorer

1. Fare clic su Start, scegliere Programmi, scegliere IBM WebSphere MQ e quindi fare clic su WebSphere MQ Explorer.

2. Fare doppio clic su Gestione code e quindi fare doppio clic su Gestione code predefinita. Il gestore code predefinito è in genere denominato QM_<machine_name> dove machine_name è il nome del computer.

3. Fare clic con il pulsante destro del mouse su Code, scegliere Nuovo e quindi fare clic su Coda locale.

4. Nella finestra di dialogo Crea coda locale digitare SETHEADER e quindi fare clic su OK.

Creazione della porta di trasmissione e della coda MQSeries

Questa procedura consente di creare la porta di trasmissione per il messaggio di output. Quando si crea la porta di trasmissione viene creata anche la coda MQSeries, se non è già stata creata.

Per creare la porta di trasmissione e la coda MQSeries

1. Fare clic con il pulsante destro del mouse su Invia porte, scegliere Nuovo e quindi fare clic su Porta di invio statica unidirezionale.

2. Nella finestra di dialogo Invia proprietà porta digitare "MQSolicitResponse" nella casella Nome .

3. Nella casella Tipo di trasporto selezionare MQSeries.

4. Nella casella Invia pipeline selezionare SetMQSeriesHeaderPropertyPipeline.SetMQSeriesHeadersSendPipeline.

5. In Filtri aggiungere una nuova voce con le coppie nome/valore seguenti:

   • Impostare proprietà su "BTS. ReceivePortName".

   • Impostare Operatore su "==".

   • Impostare valore su "ReceiveFile".

     Nota

     In questo modo la porta di trasmissione viene impostata per la sottoscrizione dei messaggi che giungono alla porta di ricezione ReceiveFile.

6. Fare clic su Trasporto.

7. Nel campo Address (URI) fare clic sul pulsante con i puntini di sospensione (...) .

8. Nella finestra di dialogo Proprietà trasporto MQSeries fare clic sul pulsante con i puntini di sospensione (...) nel campo Definizione coda .

9. Nella finestra di dialogo Definizione coda digitare il nome del computer nel campo Nome server .

10. Nel campo Gestione code selezionare il gestore code predefinito.

11. Nel campo Coda digitare "SETHEADER" e quindi fare clic su Esporta.

12. Nella finestra di dialogo Esporta fare clic su Crea coda e quindi fare clic su OK o Fine fino a quando non è stata chiusa tutta la finestra di dialogo.

Abilitazione dell'indirizzo di ricezione e avvio della porta di trasmissione

Questa procedura consente di abilitare l'indirizzo di ricezione e avviare la porta di trasmissione.

Per abilitare l'indirizzo di ricezione e avviare la porta di trasmissione

1. Nella console di amministrazione BizTalk Server fare clic su Porte di ricezione.

2. Nel riquadro dei dettagli fare clic con il pulsante destro del mouse sul percorso di ricezione MQIn e scegliere Abilita.

3. Nel riquadro dei dettagli fare clic con il pulsante destro del mouse sulla porta di invio SetMQHeader e scegliere Avvia.

Test dell'applicazione

Questa procedura consente di testare l'applicazione.

Per testare l'applicazione

1. Inserire un file nella cartella C:\Temp\Pickup3 .

2. Avviare WebSphere MQ Explorer e fare doppio clic sulla coda SETHEADER per esaminare i messaggi che contiene.

   Per visualizzare tutte le proprietà di contesto per i messaggi nella coda SETHEADER, eseguire la procedura seguente:

   1. Fare doppio clic sulla coda SETHEADER per visualizzare la finestra di dialogo Browser messaggi .

   2. Nella finestra di dialogo Browser messaggi fare clic su Colonne per visualizzare la finestra di dialogo Mostra/Nascondi colonne per i messaggi .

   3. In Colonne disponibili fare doppio clic su ogni voce per renderla visibile nella finestra di dialogo Browser messaggi e quindi fare clic su OK.

3. Le proprietà del contesto del messaggio per ogni messaggio devono essere visibili nella finestra di dialogo Browser messaggi .

Vedere anche

Esempi di adapter MQSeries