Condividi tramite

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

  • Articolo

È possibile utilizzare l'adapter BizTalk per TIBCO Enterprise Message Service (EMS) per inviare i dati a un sistema TIBCO. In questa procedura dettagliata viene descritto un esempio SDK che illustra questa funzionalità.

Prerequisiti

  • L'adapter BizTalk per TIBCO EMS richiede l'aggiunta della API C# TIBCO EMS, TIBCO.EMS.dll, alla Global Assembly Cache. 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 del file system, viene inviato a un'orchestrazione e l'adapter BizTalk per TIBCO Enterprise Message Service viene quindi utilizzato per creare un record nel sistema TIBCO.

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.

Percorso dell'esempio

Il percorso predefinito dell'esempio è

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

Nella tabella seguente vengono elencati e descritti i file dell'esempio.

Nome file del progetto di runtime Descrizione file progetto di runtime
OneWaySend.btproj

OneWaySend.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, Tutti i programmi, MicrosoftBizTalk Server, amministrazione BizTalk Server.

  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 trasmissione BizTalk

  1. 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.

  2. 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 .

  3. Immettere un valore per il campo Nome , ad esempio TIBCOEMSOneWaySP.

  4. 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 la scheda di sistema di messaggi enterprise TIBCO nella console di amministrazione di BizTalk Server.

  5. 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.

  6. 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 invio del servizio messaggi aziendali TIBCO.

  7. Fare clic su OK.

  8. Selezionare la pipeline di trasmissione XML nell'elenco a discesa Pipeline di invio e fare clic su OK.

  9. Fare clic con il pulsante destro del mouse sulla porta di invio e scegliere Avvia per inserire e avviare la porta di invio.

Creare una porta di ricezione file

  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 per visualizzare la finestra di dialogo Proprietà porta di ricezione.

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

Creare un indirizzo di ricezione file

  1. Creare una cartella per l'indirizzo di ricezione del file da monitorare, ad esempio C:\Filesource.

  2. 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 .

  3. Immettere un valore per il campo Name , ad esempio TIBCOEMSOneWayFileRL.

  4. 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.

  5. Immettere il percorso della cartella creata in precedenza per la proprietà Receive Folder e fare clic su OK.

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

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

Generare un'istanza del documento dallo schema dell'adapter

  1. Fare clic con il pulsante destro del mouse su Schema.xsd in Esplora soluzioni e scegliere Proprietà.

  2. Nella Finestra Proprietà fare clic per selezionare l'opzione Nome file istanza di output nella categoria Generale.

  3. Fare clic sul pulsante puntini di sospensione (...) per visualizzare la finestra di dialogo Seleziona file di output .

  4. Specificare una cartella e un nome per l'istanza del file di output, ad esempio C:\instance.xml e fare clic su Salva.

    Nota

    Non specificare il percorso della cartella che è stato utilizzato per l'indirizzo di ricezione file.

  5. Fare clic con il pulsante destro del mouse su Schema.xsd in Esplora soluzioni e scegliere Genera istanza per generare un'istanza del documento nel percorso specificato.

Modificare l'istanza del documento generata

  1. Aprire l'istanza di documento generata in un editor di testo, ad esempio Blocco note, e quindi modificare il contenuto dell'istanza di documento per verificare che i dati genereranno un record univoco nel sistema TIBCO. Nel codice seguente viene ad esempio mostrata la prima parte del file di dati:

    <ns0:Root xmlns:ns0="http://TibcoEMSOne_WaySend.TibcoEMSOneWaySendSchema">  
  <Name>Punya Palit</Name>  
  <MailAddress>Prose Ware, Inc.</MailAddress>  
</ns0:Root>

  2. Salvare l'istanza del documento modificata.

Compilare e distribuire il progetto

  1. Fare clic con il pulsante destro del mouse sul progetto OneWaySend 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 OneWaySend 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 MMC o 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
    FileReceivePort TIBCOEMSOneWayFileRP
    TibcoEMSOneWaySendPort TIBCOEMSOneWaySP

  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.

Posizionare un'istanza del documento nella cartella monitorata dall'indirizzo di ricezione file

  • Copiare l'istanza di documento creata in precedenza nella cartella di ricezione dei file monitorata dall'applicazione.

Verificare che il sistema TIBCO sia aggiornato

  • Utilizzare l'interfaccia Web TIBCO per verificare che sia stato creato il record dai dati del file XML.

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

  1. L'adapter File recupera il file dalla cartella e lo pubblica in MessageBox come messaggio BizTalk.

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

  3. L'istanza di orchestrazione elabora il messaggio utilizzando la logica specificata nell'orchestrazione e lo ripubblica su MessageBox.

  4. La porta di trasmissione TIBCO sottoscrive il messaggio pubblicato in modo da poterlo ricevere dal motore di messaggistica BizTalk.

  5. La porta di trasmissione invia il messaggio all'adapter BizTalk per TIBCO Enterprise Message Service.

  6. L'adapter BizTalk per TIBCO Enterprise Message Service invia il messaggio al sistema TIBCO.

Vedere anche

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