Condividi tramite

Esercitazione: utilizzo dell'adapter BizTalk per TIBCO Enterprise Message Service per ricevere dati

  • Articolo

L'adapter BizTalk per TIBCO Enterprise Message Service (EMS) consente di ricevere dati da un sistema TIBCO. In questa procedura dettagliata viene descritto un esempio SDK che illustra questa funzionalità.

Prerequisiti

  • L'adapter BizTalk per TIBCO Enterprise Message Service richiede l'aggiunta dell'API C# TIBCO EMS, TIBCO.EMS.dll, alla Global Assembly Cache (GAC). Per altre informazioni sull'installazione dell'assembly, vedere Requisiti e limitazioni del servizio messaggi aziendali TIBCO.

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

Scopo dell'esempio

In questo esempio un file XML viene prelevato da una cartella e inviato a un'orchestrazione, quindi viene utilizzato l'adapter BizTalk per TIBCO Enterprise Message Service per recuperare dati da un sistema TIBCO. Il risultato viene scritto in un file XML.

Progettazione e finalità dell'esempio

Questo esempio, progettato in Visual Studio, illustra le funzionalità di base usando l'adapter BizTalk per il servizio messaggi TIBCO Enterprise con un'orchestrazione BizTalk.

Nota

Si presuppone che l'utente sia in grado di inviare un messaggio da TIBCO che verrà elaborato dall'applicazione.

Percorso dell'esempio

Il percorso predefinito dell'esempio è

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

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

Nome file del progetto di runtime Descrizione file progetto di runtime
OneWayReceive.btproj,

OneWayReceive.sln		 File di progetto e soluzione per l'applicazione.
Schema.xsd, File di schema dell'applicazione.
Orchestration.odx Orchestrazione utilizzata dall'applicazione.
TIBCOEMSOneWaySend.snk File di chiave con nome sicuro.

Modalità di utilizzo dell'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, BizTalk Server Amministrazione.

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

  3. Fare clic con il pulsante destro del mouse su Adapter e scegliere Nuovoadattatore per visualizzare la finestra di dialogo Proprietà adattatore .

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

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

Creare una porta di ricezione BizTalk

  1. Nella console di amministrazione BizTalk Server espandere BizTalk Server Amministrazione, espandere Gruppo BizTalk, espandere Applicazioni, espandere Applicazioni BizTalk Application 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 Nuovaporta di ricezione unidirezionale 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 indirizzo di ricezione BizTalk

  1. Fare clic con il pulsante destro del mouse sulla nuova porta di ricezione e quindi scegliere Nuova posizione 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'adapter TIBCO EMS nell'elenco a discesa Schede disponibili nella casella a discesa Tipo e fare clic sul pulsante Configura per visualizzare la finestra di dialogo Proprietà trasporto adattatore.

    Nota

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

  4. Immettere i valori per la definizione connessione server:

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

  5. Immettere i valori per le credenziali utente:

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

    Per altre informazioni sulle proprietà, vedere Creazione di gestori di ricezione del servizio messaggi aziendali TIBCO.

  6. Fare clic su OK.

  7. Selezionare XMLReceive nell'elenco a discesa Pipeline di ricezione nell'elenco a discesa Della pipeline di ricezione e fare clic su OK.

  8. Fare clic con il pulsante destro del mouse sul percorso di ricezione e scegliere Abilita.

Creare una porta di trasmissione File unidirezionale

  1. Creare una cartella di destinazione che deve essere utilizzata dalla porta di trasmissione, ad esempio C:\FilesOut.

  2. Nella console di amministrazione BizTalk Server espandere amministrazione BizTalk Server, espandere Gruppo BizTalk, espandere Applicazioni, espandere Applicazione BizTalk 1 e fare clic su Invia porte.

  3. Fare clic con il pulsante destro del mouse su Invia porte e scegliere Nuova porta di invio statica per visualizzare la finestra di dialogo Proprietà porta di invio .

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

  5. Selezionare FILE dall'elenco degli 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à Destination Folder immettere il percorso della cartella creata in precedenza e fare clic su OK.

  7. Selezionare la pipeline XMLTransmit dall'elenco di 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 invio e scegliere Avvia per inserire e avviare la porta di invio.

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 il Designer progetto 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 BizTalk Server.

Eseguire il binding dell'orchestrazione e integrarla

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

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

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

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

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

    Parametro Valore
    Host BizTalkServerApplication
    FileSendPort TIBCOEMSOneWayFileSP
    TibcoEMSOneWayReceiveOperation 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 la ricezione di un messaggio da parte dell'applicazione

  • Aprire la cartella configurata come destinazione della porta di trasmissione File 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 seguente sequenza di eventi:

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

  2. L'orchestrazione effettua la sottoscrizione al messaggio pubblicato, quindi il motore di messaggistica BizTalk attiva un'istanza dell'orchestrazione e invia il messaggio a tale istanza.

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

  4. La porta di trasmissione File sottoscrive questo messaggio e BizTalk lo invia quindi all'adapter File.

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

Vedere anche

Esercitazione: utilizzo dell'adapter BizTalk per TIBCO Enterprise Message Service per inviare dati
Esercitazioni: Uso dell'adapter Microsoft BizTalk per TIBCO Enterprise Message Service
Per iniziare