Adattatore BizTalk per la configurazione di file host
Panoramica
L'adapter BizTalk per i file host è un adattatore di invio e ricezione che consente alle orchestrazioni BizTalk di interagire con i sistemi host. In particolare, l'adattatore consente operazioni di invio e ricezione su connessioni TCP/IP e APPC ai file host eseguiti su mainframe e piattaforme IBM i. In base alla tecnologia Host Integration Server, l'adattatore usa gli assembly di metadati della libreria di accesso ai dati per configurare le connessioni e il provider di dati Microsoft .NET Framework per i file host per eseguire comandi SQL e stored procedure.
L'adattatore svolge due funzioni principali:
Per le operazioni di invio (One Way e Solicit Response), l'adapter invia comandi SQL e comandi di sistema a un'istanza del file host, con l'opzione di richiedere una risposta.
Per le operazioni di ricezione (solo One Way) l'adapter crea un comando SQL che esegue il polling di oggetti file host e crea messaggi per riga, che vengono quindi inviati al sistema di messaggi BizTalk.
Inoltre, l'adapter BizTalk per i file host usa lo strumento di traccia dell'adapter BizTalk standard come meccanismo di risoluzione dei problemi.
Nota
L'adapter BizTalk per i file host è un adattatore non transazionale. Ciò significa che una volta eseguita un'azione, non è possibile annullare o eseguire il rollback.
Creare un assembly di metadati
Dopo aver installato l'adattatore, è possibile creare un assembly di metadati che descrive il sistema remoto per BizTalk Server.
Parte del processo di creazione di un'applicazione file host in Visual Studio descrive il layout del file system host. Questo processo crea sia un assembly di metadati che uno schema. L'assembly di metadati è una rappresentazione programmatica del file system host remoto, mentre lo schema è una rappresentazione XML del file system host. Si userà l'assembly di metadati per descrivere il file system host per BizTalk Server.
Per altre informazioni su come creare un'applicazione file host in Visual Studio, vedere Creazione di un'applicazione con il provider di dati gestito per i file host.
Creare una porta di trasmissione
Accedere con un account membro del gruppo BizTalk Server Administrators.
In BizTalk Server Amministrazione espandere Gruppo BizTalk, espandere Applicazioni e quindi selezionare l'applicazione.
Fare clic con il pulsante destro del mouse su Porte di trasmissione, scegliere Nuovo e quindi selezionare Porta di trasmissione unidirezionale statica o Porta di trasmissione richiesta di risposta.
In Proprietà porta di trasmissione impostare Il tipo di trasporto su File host. Selezionare Configura e immettere le proprietà seguenti:
Usare Per Stringa di connessione Nome di un stringa di connessione utilizzato per connettersi al database file host.
Per configurare un stringa di connessione nuovo o esistente, fare clic sui puntini di sospensione (...). Verrà avviata la Creazione guidata origine dati. Per accedere alla Guida, fare clic su Guida nelle pagine della procedura guidata oppure aprire la Guida di Host Integration Server e cercare in Creazione guidata origine dati (file host).Spazio dei nomi di destinazione del documento Spazio dei nomi di destinazione utilizzato nei documenti XML inviati all'host. Nome elemento principale risposta Nome dell'elemento radice utilizzato nei documenti XML ricevuti dall'host. Questa proprietà può essere vuota per una porta unidirezionale. URI Identificatore di risorsa uniforme. Nome per identificare il percorso della porta di trasmissione. Selezionare OK per salvare le modifiche.
Per Il gestore di trasmissione selezionare l'istanza host per eseguire l'adapter e selezionare la pipeline di trasmissione.
Selezionare OK per salvare le modifiche.
In Porte di trasmissione fare clic con il pulsante destro del mouse sulla nuova porta di trasmissione e scegliere Enlist (Enlist ) e quindi Start (Avvia).
Creare una porta di ricezione e una posizione
Accedere con un account membro del gruppo BizTalk Server Administrators.
In BizTalk Server Amministrazione espandere Gruppo BizTalk, espandere Applicazioni e quindi selezionare l'applicazione.
Fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e quindi selezionare Porta di ricezione unidirezionale statica. Configurare le proprietà della porta di ricezione e selezionare OK per salvare le modifiche.
Fare clic con il pulsante destro del mouse su Percorsi di ricezione, scegliere Nuovo e quindi selezionare Posizione di ricezione unidirezionale. Selezionare la porta di ricezione creata e quindi OK.
In Proprietà posizione di ricezione impostare Il tipo di trasporto su HostFiles. Selezionare Configura e immettere le proprietà seguenti:
Usare Per Stringa di connessione Immettere il nome di un stringa di connessione che verrà usato per connettersi al database host.
Per configurare un stringa di connessione nuovo o esistente, fare clic sui puntini di sospensione (...). Verrà avviata la Creazione guidata origine dati. Per accedere alla Guida, fare clic su Guida nelle schermate della procedura guidata oppure aprire la Guida di Host Integration Server e cercare in Creazione guidata origine dati (file host).To access Help, click Help on the wizard, or open the Host Integration Server Help and look in Data Source Wizard (Host Files).
Quando si configura un percorso di ricezione o una porta di trasmissione in base all'adapter BizTalk per i file host, la definizione dei metadati deve essere creata come file di metadati HIDX (Host Integration Designer XML) per la codifica e la decodifica dei record. Per istruzioni su come creare un file HIDX, vedere Creazione di un'applicazione con il provider di dati gestito per i file host.Nome elemento principale documento Nome dell'elemento radice utilizzato nei documenti XML ricevuti dall'host. Spazio dei nomi di destinazione del documento Spazio dei nomi di destinazione utilizzato nei documenti XML ricevuti dall'host. Comando SQL Comando Select eseguito una volta per ogni intervallo di polling. Comando Update Comando eseguito dopo l'elaborazione di ogni riga nell'operazione di ricezione. Può trattarsi di un'istruzione delete che elimina la riga dalla tabella nel comando SQL o un comando di aggiornamento che modifica in modo statico una o più righe. Quando questa opzione viene specificata, il comando SQL deve essere un'istruzione Select e accedere a una singola tabella.
È possibile specificare proprietà aggiuntive facendo clic sul pulsante con i puntini di sospensione (...). Verrà visualizzata la finestra di dialogo Cambia comando , che fornisce tre opzioni:
- Se selezionata, non deselezionare le altre due opzioni.
- Eliminare dopo che la lettura elimina la riga dopo che l'adattatore lo ha letto.
- L'aggiornamento consente di digitare un comando SQL da aggiornare.URI Identificatore di risorsa uniforme. Nome che identifica la posizione della porta di ricezione. 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. Selezionare OK per salvare le modifiche.
Per Il gestore di ricezione selezionare l'istanza host. Il gestore di ricezione deve essere in esecuzione su questo host. Selezionare la pipeline di ricezione.
Selezionare OK per salvare le modifiche.
In Località di ricezione fare clic con il pulsante destro del mouse sul percorso di ricezione e scegliere Abilita.
Creare uno schema
Usare la Generazione guidata schema file host per creare gli schemi XSD per l'adapter BizTalk per i file host. Dopo aver creato lo schema, è possibile continuare la configurazione sul lato BizTalk Server.
Aprire il progetto di Visual Studio BizTalk Server.
Fare clic con il pulsante destro del mouse sul progetto, scegliere Aggiungi, aggiungi elementi generati e quindi selezionare Aggiungi metadati adapter.
Nella pagina Selezione adattatore della procedura guidata Aggiungi adapter selezionare File host e quindi selezionare Avanti.
Nella Generazione guidata schema adapter file host:
In Informazioni database passare a un stringa di connessione esistente o crearne uno nuovo.
Può trattarsi di catalogo iniziale, raccolta pacchetti, (indirizzo TCP e porta) o (LU locale APPC, LU remoto e modalità), (nome utente e password) o (sicurezza integrata). La lunghezza massima è 1024.
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 Porta di ricezione, è necessario solo un nome di elemento radice del documento di richiesta. Se si seleziona Porta di trasmissione, sono necessari i nomi degli elementi radice del documento di richiesta e risposta.
In Informazioni sul tipo di istruzione selezionare il tipo di comando di database da eseguire.
Se si selezionano le porte di trasmissione nella pagina precedente, è possibile scegliere di eseguire un updategram, una stored procedure o un'istruzione SELECT. Se si selezionano le porte di ricezione, questo passaggio non è necessario.
In Informazioni sull'istruzione immettere i dettagli relativi al file host. A seconda delle informazioni immesse in precedenza nelle pagine precedenti, immettere le proprietà seguenti. Se è stata selezionata la porta di trasmissione:
Send Updategram Se si sceglie di usare una porta di trasmissione e gli updategram, è possibile selezionare l'operazione updategram qui e anche la tabella e le colonne che saranno presenti nell'updategram.
Comando Send System Se si sceglie di usare una porta di trasmissione ed eseguire una stored procedure, è possibile selezionare una stored procedure dal catalogo della connessione corrente. Non è necessario immettere valori per tutti i parametri in questa pagina.
Istruzione Send Select Se si sceglie di usare una porta di trasmissione con un'istruzione SQL Select, è possibile selezionare o passare all'istruzione qui.
Se è stata selezionata la porta di ricezione:
Istruzione Receive Select Se si sceglie di usare una porta di ricezione con un'istruzione SQL, è possibile selezionare o passare all'istruzione qui.
Send Updategram Se si sceglie di usare una porta di trasmissione e gli updategram, è possibile selezionare l'operazione updategram qui e anche la tabella e le colonne che saranno presenti nell'updategram.
Invia stored procedure Se si sceglie di usare una porta di trasmissione ed eseguire una stored procedure, è possibile selezionare una stored procedure dal catalogo della connessione corrente. Non è necessario immettere valori per tutti i parametri in questa pagina.
Istruzione Send Select Se si sceglie di usare una porta di trasmissione con un'istruzione SQL Select, è possibile selezionare o passare all'istruzione qui.
Al termine, selezionare Fine .
Creare un'applicazione BizTalk
Dopo aver creato lo schema, è possibile scrivere il codice dell'applicazione BizTalk. L'applicazione usa l'assembly di metadati creato in Visual Studio, oltre allo schema e alle porte create.
Creare un progetto BizTalk in Visual Studio.
Usare lo schema creato per descrivere il file system host all'applicazione BizTalk.
Usare la porta di trasmissione creata per inviare dati al file system host.
Se necessario, usare la porta di ricezione e il percorso creati.
Aggiungere eventuali orchestrazioni, componenti o codice aggiuntivi in base alle esigenze.
Testare l'applicazione.
Al termine del test dell'applicazione, creare un pacchetto .msi per spostare l'applicazione in un server di staging o live. Quando si crea un pacchetto BizTalk Server .msi, assicurarsi di includere l'assembly di metadati del file host creato.