Condividi tramite

Adapter BizTalk per la configurazione DB2 - HIS

  • Articolo

Panoramica

L'adapter Microsoft BizTalk per DB2 si connette BizTalk Server ai dati vitali archiviati in IBM mainframe DB2 per z/OS, IBM midrange DB2 per IBM i e IBM server DB2 in esecuzione in sistemi operativi Linux, UNIX e Windows. La scheda si basa sul provider di dati Microsoft ADO.NET per DB2 e supporta un'ampia gamma di funzioni, tra cui porte di invio e porte di ricezione con transazioni distribuite tra connessioni di rete SNA e TCP/IP. Usando i comandi SQL definiti nelle procedure guidate di configurazione delle porte, i professionisti IT possono creare facilmente soluzioni che integrano in modo efficiente i database DB2 senza scrivere codice.

L'adattatore serve due funzioni principali:

  • Per le operazioni Send (One Way and Solicit Response), l'adapter invia comandi e stored procedure SQL a un'istanza di DB2, con l'opzione di richiedere una risposta.

  • Per le operazioni di ricezione (solo One Way), l'adapter crea un comando SQL o una stored procedure che esegue il polling di oggetti DB2 e crea messaggi per riga, che vengono quindi inviati al sistema messaggi BizTalk.

    Inoltre, l'adapter BizTalk per DB2 usa lo strumento di traccia dell'adapter BizTalk standard come meccanismo di risoluzione dei problemi.

Creare una porta di trasmissione DB2

Accedere con un account membro del gruppo Administrators di BizTalk Server.

  1. In BizTalk Server Amministrazione espandere Gruppo BizTalk, espandere Applicazioni e quindi selezionare l'applicazione.

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

  3. Nelle proprietà della porta di trasmissione impostare il tipo di trasporto su DB2. Selezionare Configura e immettere le proprietà seguenti:

    Usare Per
    BulkCopyBatchSize La proprietà BulkCopyBatchSize indica all'Adapter il numero di righe da elaborare per ogni transazione batch. Questa proprietà facoltativa accetta un valore intero . Il valore predefinito è 20. Un valore pari a 0 indica all'adapter di elaborare tutte le righe in un singolo batch.
    CommandTimeout La proprietà CommandTimeout imposta il tempo di attesa prima dell'interruzione di un tentativo di esecuzione di un comando e quindi genera un errore. Questa proprietà facoltativa accetta un valore intero . Il valore predefinito è 30 secondi. Un valore pari a 0 indica un limite (un tentativo di esecuzione di un comando attenderà indefinito).
    Stringa di connessione Nome di un stringa di connessione usato per connettersi al database DB2.

    Per configurare una stringa di connessione nuova o esistente, fare clic sui puntini di sospensione (...). Viene avviata la Creazione guidata origine dati.

    Per accedere alla Guida, fare clic sulla Guidata nelle pagine della procedura guidata oppure aprire la Guidata server di integrazione host e cercare l'origine dati guidata (DB2).
    Registri set DB2 La proprietà DB2 Set Registers indica all'adapter di eseguire una o più istruzioni SQL SET. Questa proprietà facoltativa accetta un valore stringa . Il valore predefinito è una stringa vuota, che indica nessuna istruzione. La sintassi supportata è un elenco delimitato da punti e virgola dei comandi dell'istruzione SET con un elenco separato da virgole dei valori delle istruzioni SET "<SET command 1 space <SET value 1>> semi-colon; <Set command 2> space <SET value a> virgole <value b> semi-colon"). Ad esempio, immettere "SET CURRENT PATH 'DSN8910', 'HISDEMO'".
    Spazio dei nomi di destinazione del documento Spazio dei nomi di destinazione usato nei documenti XML inviati a DB2.
    Nome elemento principale risposta Nome dell'elemento radice usato nei documenti XML ricevuti da DB2. Questa proprietà può essere vuota per una porta unidirezionale.
    URI Identificatore di risorsa uniforme. Nome per identificare il percorso della porta di invio. Il valore predefinito è DB2://.
    UseBulkCopy La proprietà UseBulkCopy indica all'adapter di elaborare i comandi INSERT della porta di invio in modalità copia bulk per migliorare le prestazioni. Questa proprietà facoltativa accetta un valore booleano . Il valore predefinito è false.

  4. Selezionare OK per salvare le modifiche.

  5. Per il gestore di invio selezionare l'istanza host per eseguire l'adapter e selezionare la pipeline di invio.

  6. Selezionare OK per salvare le modifiche.

  7. In Invia porte fare clic con il pulsante destro del mouse sulla nuova porta di invio e selezionare Enlist e quindi Start.

Creare una porta di ricezione DB2

Accedere con un account membro del gruppo Administrators di BizTalk Server.

  1. In BizTalk Server Amministrazione espandere Gruppo BizTalk, espandere Applicazioni e quindi selezionare l'applicazione.

  2. Fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e quindi selezionare Porta di ricezione unidirezionale. Configurare le proprietà e selezionare OK.

  3. Fare clic con il pulsante destro del mouse su Posizioni di ricezione, scegliere Nuovo e quindi selezionare Posizione di ricezione unidirezionale. Selezionare la porta di ricezione appena creata e quindi fare clic su OK.

  4. Nelle proprietà della posizione di ricezione impostare il tipo di trasporto su DB2. Selezionare Configura e immettere le proprietà seguenti:

    Usare Per
    CommandTimeout La proprietà CommandTimeout imposta il tempo di attesa prima dell'interruzione di un tentativo di esecuzione di un comando e quindi genera un errore. Questa proprietà facoltativa accetta un valore intero. Il valore predefinito è 30 secondi. Un valore pari a 0 indica un limite (un tentativo di esecuzione di un comando attenderà indefinito).
    Stringa di connessione Immettere il nome di un stringa di connessione che verrà usato per connettersi al database DB2.

    Per configurare una stringa di connessione nuova o esistente, fare clic sui puntini di sospensione (...). Viene avviata la Creazione guidata origine dati. Per accedere alla Guida, fare clic sulla Guidata nelle pagine della procedura guidata oppure aprire la Guidata server di integrazione host e cercare l'origine dati guidata (DB2).
    Registri set DB2 La proprietà DB2 Set Registers indica all'adapter di eseguire una o più istruzioni SQL SET. Questa proprietà facoltativa accetta un valore stringa. Il valore predefinito è una stringa vuota, che indica nessuna istruzione. La sintassi supportata è un elenco delimitato da punti e virgola dei comandi dell'istruzione SET con un elenco separato da virgole dei valori delle istruzioni SET "<SET command 1 space <SET value 1>> semi-colon; <Set command 2> space <SET value a> virgole <value b> semi-colon"). Ad esempio, immettere "SET CURRENT PATH 'DSN8910', 'HISDEMO'".
    Nome elemento principale documento Nome dell'elemento radice usato nei documenti XML ricevuti da DB2.
    Spazio dei nomi di destinazione del documento Spazio dei nomi di destinazione usato nei documenti XML ricevuti da DB2.
    Comando SQL Comando select o stored procedure che viene eseguito una sola volta per ogni intervallo di polling.
    Comando di aggiornamento Il comando eseguito dopo l'elaborazione di ogni riga nell'operazione di ricezione. Può essere un'istruzione di eliminazione che elimina la riga dalla tabella nel comando SQL o un comando di aggiornamento che modifica in modo statico una o più righe. Quando si specifica questa opzione, il comando SQL deve essere un'istruzione Select e deve accedere a una singola tabella.
    URI Nome che identifica la posizione della porta di ricezione. Il valore predefinito è DB2://.
    Intervallo di polling Numero di unità tra le richieste di polling. L'intervallo consentito è 1 - 65535.
    Unità di misura polling Unità di misura (secondi, minuti o ore) usata tra le richieste di polling. Il valore predefinito è secondi.

  5. Selezionare OK per salvare le modifiche.

  6. Per il gestore di ricezione selezionare l'istanza host per eseguire l'adapter. Il gestore di ricezione deve essere in esecuzione su questo host. Selezionare la pipeline di ricezione. . Selezionare OK per salvare le modifiche.

  7. Nella posizione di ricezione fare clic con il pulsante destro del mouse sul percorso di ricezione e quindi abilitare.

Creare uno schema della scheda DB2

  1. Aprire il progetto BizTalk Visual Studio.

  2. Fare clic con il pulsante destro del mouse sul progetto, selezionare Aggiungi, selezionare Aggiungi elementi generati e quindi selezionare Aggiungi.

  3. Nella finestra di dialogo Aggiungi elementi generati selezionare Aggiungi metadati adattatore.

  4. Nella pagina Seleziona adattatore della procedura guidata Aggiungi adattatore selezionare DB2. Nell'elenco Porta selezionare una porta di trasmissione o una posizione di ricezione configurata e quindi selezionare Avanti.

  5. Nella Creazione guidata schema dell'adapter DB2:

    1. In Informazioni database creare un stringa di connessione oppure selezionare un stringa di connessione esistente.

    2. In Informazioni sullo schema definire lo spazio dei nomi predefinito, gli elementi radice e il tipo di porta da usare nello schema.

      Se si seleziona Ricezione porta, è necessario solo un nome dell'elemento radice del documento di richiesta. Se si seleziona Invia porta, sono necessari i nomi degli elementi radice della richiesta e della risposta.

    3. In Informazioni sul tipo di istruzione selezionare il tipo di comando del database da emettere.

      Se sono state selezionate le porte nella pagina precedente, è possibile scegliere un'istruzione SELECT SQL o una stored procedure. Se si selezionano le porte di invio nella pagina precedente, è possibile scegliere di rilasciare un updategram, una stored procedure o un'istruzione SELECT.

    4. In Informazioni sull'istruzione immettere i dettagli sul database DB2. A seconda delle informazioni immesse in precedenza, sono disponibili le proprietà seguenti:

      1. Ricevere l'istruzione Select nella finestra di dialogo Informazioni istruzione digitare un'istruzione SQL SELECT nella casella di modifica dello script SQL . Facoltativamente, fare clic su Sfoglia per caricare un file di testo contenente un'istruzione.

      2. Ricevere stored procedure nella finestra di dialogo Informazioni istruzione , fare clic su un nome stored procedure. Nell'elenco Parametri fare clic sulla casella di controllo Valore per ogni parametro richiesto.

      3. Inviare Updategram nella finestra di dialogo Informazioni istruzione , fare clic su un nome tabella. Nell'elenco Parametri fare clic sulla casella di controllo Valore per ogni colonna richiesta. Quando si usa BulkCopy, è necessario fare clic su ogni casella di controllo Valore per selezionare tutte le colonne.

      4. Inviare stored procedure nella finestra di dialogo Informazioni istruzione , fare clic su un nome di stored procedure. Nell'elenco Parametri fare clic sulla casella di controllo Valore per ogni parametro richiesto.

      5. Invia istruzione Select nella finestra di dialogo Informazioni sull'istruzione, digitare l'istruzione SQL SELECT nella casella di modifica dello script SQL. Facoltativamente, fare clic su Sfoglia per caricare un file di testo contenente un'istruzione.

  6. Selezionare Fine per completare la procedura guidata.

A questo momento è disponibile uno schema.