Esercitazione: Uso dell'adattatore BizTalk per TIBCO Enterprise Message Service per ricevere dati.

È possibile usare l'adapter BizTalk per TIBCO Enterprise Message Service (EMS) per ricevere dati da un sistema TIBCO. Questa procedura dettagliata descrive un esempio dell'SDK che illustra questa operazione.

Prerequisiti

• Per l'adapter BizTalk per TIBCO Enterprise Message Service è necessario aggiungere l'API C# TIBCO EMS, TIBCO.EMS.dll, alla Global Assembly Cache (GAC). Per ulteriori informazioni sull'installazione dell'assembly, vedere TIBCO Enterprise Message Service Requisiti e Limitazioni.

• Installare Visual Studio in BizTalk Server in cui è in esecuzione l'adapter per compilare e distribuire l'esempio.

Che cosa fa questo esempio

Questo esempio preleva un file XML da una cartella, invia il file a un'orchestrazione e quindi usa l'adapter BizTalk per TIBCO Enterprise Message Service per recuperare i dati da un sistema TIBCO. Il risultato viene scritto in un file XML.

Come questo esempio è progettato e perché

Questo esempio, progettato in Visual Studio, illustra le funzionalità di base dell'adapter BizTalk per TIBCO Enterprise Message Service con un'orchestrazione BizTalk.

Annotazioni

L'esempio presuppone che si sappia come inviare un messaggio da TIBCO per l'elaborazione dell'applicazione.

Dove trovare questo esempio

Il percorso predefinito per l'esempio è

C:\Programmi\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Enterprise Message Service(TM)\Sdk\OneWayReceive

La tabella seguente illustra i file in questo esempio e ne descrive lo scopo.

Nome del file di progetto in fase di esecuzione	Descrizione del file di progetto di runtime
OneWayReceive.btproj, OneWayReceive.sln	File di progetto e di soluzione per l'applicazione.
Schema.xsd,	File di schema per l'applicazione.
Orchestration.odx	Orchestrazione utilizzata dall'applicazione.
TIBCOEMSOneWaySend.snk	File della chiave di firma sicura.

Come usare questo esempio

Creare una nuova istanza dell'adapter BizTalk per TIBCO EMS

1. Avviare la console di amministrazione di BizTalk Server. Fare clic su Start, Programmi, MicrosoftBizTalk Server, Amministrazione bizTalk Server.

2. Nella console di amministrazione di BizTalk Server espandere Amministrazione BizTalk Server, espandere Gruppo BizTalk, espandere Impostazioni piattaformae quindi fare clic su Adapter.

3. Fare clic con il pulsante destro del mouse su Adattatori e scegliere Nuovo, Adattatore per visualizzare la finestra di dialogo Proprietà Adapter.

4. Immettere un valore per il campo Nome , ad esempio TIBCO EMS.

5. Selezionare TIBCO Enterprise Message System dall'elenco di adattatori disponibili nell'elenco a discesa Adapter e fare clic su OK.

Creare una porta di ricezione BizTalk

1. Nella console di amministrazione di BizTalk Server, espandere Amministrazione BizTalk Server, espandere Gruppo BizTalk, espandere Applicazioni, espandere Applicazione BizTalk 1 e fare clic su Porte di ricezione.

2. Fare clic con il pulsante destro del mouse sulla cartella Porte di ricezione e quindi scegliere Nuovo,One-Way Porta di ricezione per visualizzare la finestra di dialogo Proprietà porta di ricezione.

3. Immettere un valore per il campo Nome , ad esempio TIBCOEMSOneWayRP e fare clic su OK.

Creare un percorso di ricezione BizTalk

1. Fare clic con il pulsante destro del mouse sulla nuova porta di ricezione e quindi scegliere Nuovo, Indirizzo di ricezione per visualizzare la finestra di dialogo Proprietà posizione ricezione .

2. Immettere un valore per il campo Nome , ad esempio TIBCOEMSOneWayRL.

3. Selezionare l'adattatore TIBCO EMS dall'elenco di adattatori disponibili nella casella a discesa Tipo e fare clic sul pulsante Configura per visualizzare la finestra di dialogo Proprietà trasporto adattatore.

   Annotazioni

   Questo valore è il nome specificato quando è stato creato l'adapter TIBCO nella console di amministrazione di BizTalk Server.

4. Immettere i valori per la definizione connessione server:

   Proprietà	Valore
   Destinazione	Nome della coda o dell'argomento di destinazione del server.
   Numero di porta	Porta in cui il server TIBCO è in ascolto. Il valore predefinito è 7222.
   Nome del server	Nome del server TIBCO EMS.

5. Immettere i valori per le credenziali utente:

   Proprietà	Valore
   Parola chiave	Password per il server TIBCO EMS.
   Nome utente	Nome utente per il server TIBCO EMS.

   Per ulteriori informazioni sulle proprietà, vedere Creazione di Gestori di Ricezione di TIBCO Enterprise Message Service.

6. Fare clic su OK.

7. Selezionare XMLReceive nell'elenco delle pipeline disponibili nella casella a discesa Pipeline di ricezione e fare clic su OK.

8. Fare clic con il tasto destro sull'ubicazione di ricezione e scegliere Abilita.

Creare una porta di trasmissione file unidirezionale

1. Creare una cartella di destinazione da usare dalla porta di trasmissione, ad esempio C:\FilesOut.

2. Nella console di amministrazione di BizTalk Server espandere Amministrazione BizTalk Server, espandere Gruppo BizTalk, espandere Applicazioni, espandere Applicazione BizTalk 1 e fare clic su Porte di trasmissione.

3. Fare clic con il pulsante destro del mouse su Porte di invio e scegliere Nuovo, Porta di invio statica unidirezionale per visualizzare la finestra di dialogo Proprietà della porta di invio.

4. Immettere un valore per il campo Nome , ad esempio TIBCOEMSOneWayFileSP.

5. Selezionare FILE dall'elenco di adattatori disponibili nella casella a discesa Tipo e fare clic sul pulsante Configura per visualizzare la finestra di dialogo Proprietà trasporto adattatore.

6. Per la proprietà Cartella di destinazione, immettere il percorso della cartella creata in precedenza e fare clic su OK.

7. Selezionare la pipeline XMLTransmit dall'elenco delle pipeline disponibili nell'elenco a discesa Invia pipeline e fare clic su OK.

8. Fare clic con il pulsante destro del mouse sulla porta di trasmissione e scegliere Avvia per integrare e avviare la porta di trasmissione.

Compilare e distribuire il progetto

1. Fare clic con il pulsante destro del mouse sul progetto OneWayReceive in Esplora soluzioni e scegliere Proprietà per avviare Progettazione progetti per il progetto.

2. Fare clic sulla scheda Distribuzione .

3. Immettere i valori appropriati per la proprietà Server e la proprietà Database di configurazione nella categoria Gruppo BizTalk .

4. Fare clic con il pulsante destro del mouse sul progetto OneWayReceive in Esplora soluzioni e scegliere Distribuisci per compilare il progetto e distribuire l'assembly nel database di configurazione di BizTalk Server.

Vincolare e arruolare l'orchestrazione

1. Nella console di amministrazione di BizTalk Server espandere Amministrazione BizTalk Server, espandere Gruppo BizTalk, espandere Applicazioni, espandere BizTalk Application 1 e fare clic su Orchestrazioni.

2. Fare clic sul pulsante Aggiorna nella barra degli strumenti della console di amministrazione di BizTalk Server oppure premere F5 sulla tastiera per aggiornare la visualizzazione della console di amministrazione di BizTalk Server.

3. Fare doppio clic sull'orchestrazione per visualizzare la finestra di dialogo Proprietà orchestrazione .

4. Fare clic su Bindings nel riquadro sinistro della finestra di dialogo per visualizzare le opzioni Binding per l'orchestrazione.

5. Specificare i valori appropriati per le opzioni di associazione, ad esempio:

   Parametro	Valore
   Padrone di casa / Ospitante / Conduttore (depending on the intended context)	BizTalkServerApplication
   FileSendPort	TIBCOEMSOneWayFileSP
   OperazioneRicezioneUnidirezionaleTibcoEMS	TIBCOEMSOneWayRP

6. Fare clic su OK.

Avviare l'orchestrazione

• Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse sull'orchestrazione e scegliere Avvia per integrare e avviare l'orchestrazione.

Verificare che l'applicazione riceva un messaggio

• Aprire la cartella a cui è configurata la porta di trasmissione file per l'invio e verificare che sia stato generato un documento di output. Questo file deve contenere i risultati della query elaborata dall'adapter BizTalk per TIBCO Enterprise Message Service.

  Se l'istanza del documento viene elaborata correttamente, si verifica la sequenza di eventi seguente:

1. L'adapter TIBCO EMS riceve un messaggio dal sistema TIBCO e lo pubblica in MessageBox come messaggio BizTalk.

2. L'orchestrazione sottoscrive questo messaggio pubblicato in modo che il motore di messaggistica BizTalk attivi un'istanza dell'orchestrazione e invii il messaggio all'istanza di orchestrazione.

3. L'istanza di orchestrazione pubblica nuovamente il messaggio in MessageBox.

4. La porta di trasmissione file sottoscrive questo messaggio in modo che BizTalk invii il messaggio all'adapter File.

5. L'adapter File scrive il messaggio contenente il set di risultati nella cartella di output designata.

Vedere anche

Esercitazione: Uso dell'adapter BizTalk per TIBCO Enterprise Message Service per l'invio di dati
Esercitazioni: Uso dell'adapter Microsoft BizTalk per TIBCO Enterprise Message Service
Introduzione