Condividi tramite

Esercitazione: utilizzo dell'adapter BizTalk per TIBCO Rendezvous per la ricezione di dati

  • Articolo

È possibile utilizzare l'adapter BizTalk per TIBCO Rendezvous per ricevere dati da un sistema TIBCO. In questa procedura dettagliata viene descritto un esempio SDK che illustra questa funzionalità.

Prerequisiti

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

Informazioni sull'esempio

  • In questo esempio viene utilizzato l'adapter BizTalk per TIBCO Rendezvous per ricevere dati da un sistema TIBCO. Un'orchestrazione elabora il messaggio e, tramite l'adapter file, scrive i dati come file XML in una cartella specificata.

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

    Nota

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

  • Il percorso predefinito per l'esempio è C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Rendezvous(r)\Sdk\OneWayReceivee include i file seguenti:

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

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

Passaggio 1: Aggiungere l'adapter ad Amministrazione BizTalk

  1. In BizTalk Server Amministrazione espandere Gruppo BizTalk, espandere Impostazioni piattaforma, quindi fare clic su Adapter.

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

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

  4. Selezionare TIBCO(r) Rendezvous(r) nell'elenco di schede disponibili nell'elenco a discesa Adapter e fare clic su OK.

Passaggio 2: Creare una porta di ricezione

  1. In BizTalk Server Amministrazione espandere Gruppo BizTalk, 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 Nuova porta di ricezione unidirezionale per visualizzare la finestra di dialogo Proprietà porta di ricezione .

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

Passaggio 3: Creare un percorso di ricezione

  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, immettere TIBCORvOneWayRL.

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

    Nota

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

  4. Immettere un valore per RendezvousSubjectName in AdapterRequiredProperties.

  5. Immettere i valori per Le proprietà del listener certificato:

    Proprietà Valore
    Ledger file name Nome del file di contabilità generale da utilizzare per il recapito di messaggi certificati permanenti.
    Nome riutilizzabile Nome di contatto riutilizzabile per il recapito di messaggi certificati. Il nome deve essere univoco in tutti i nomi di contatti di messaggi certificati nella rete.

  6. Immettere i valori per Credenziali:

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

  7. Immettere i valori per RendezvousTransport:

    Proprietà Valore
    Daemon Parametro del daemon di trasporto Rendezvous.
    Rete Parametro della rete di trasporto Rendezvous.
    Servizio Parametro del servizio di trasporto Rendezvous.

    Per altre informazioni sulle proprietà, vedere Create Receive artifacts .For more information about the properties, see Create Receive artifacts.

  8. Fare clic su OK.

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

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

Passaggio 4: Creare una porta di trasmissione unidirezionale

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

  2. Nella console di amministrazione di BizTalk Server espandere BizTalk Server Amministrazione, 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 trasmissione e scegliere Nuovo, Statico One-Way Porta di trasmissione... per visualizzare la finestra di dialogo Proprietà porta di trasmissione.

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

  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 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 trasmissione e scegliere Avvia per integrare e avviare la porta di trasmissione.

Passaggio 5: 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 progetto Designer 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.

Passaggio 6: Associare, integrare e avviare l'orchestrazione

  1. Nella console di amministrazione di BizTalk Server espandere BizTalk Server Amministrazione, gruppo BizTalk, applicazioni, espandere Applicazione BizTalk 1 e fare clic su Orchestrazioni.

  2. Fare clic sul pulsante Aggiorna nella barra degli strumenti della console di amministrazione 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 Binding nel riquadro sinistro della finestra di dialogo per visualizzare le opzioni Associazioni per l'orchestrazione.

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

    Parametro Valore
    Host BizTalkServerApplication
    SendPort TIBCORvOneWayFileSP
    ReceivePort TIBCORvOneWayRP

  6. Fare clic su OK.

  7. Fare clic con il pulsante destro del mouse sull'orchestrazione e scegliere Avvia per integrare e avviare l'orchestrazione.

Passaggio 7: Confermare che l'applicazione riceve un messaggio

  • Aprire la cartella a cui è configurata la porta di trasmissione del file e verificare che sia stato generato un documento di output.

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

  1. L'adapter per TIBCO Rendezvous 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 Rendezvous per la trasmissione di dati
Esercitazioni: Uso dell'adapter Microsoft BizTalk per TIBCO Rendezvous
Per iniziare