Componenti dell'adapter
Un adapter personalizzato condivide i meccanismi standardizzati di installazione, gestione e configurazione utilizzati dagli adapter nativi. Con la standardizzazione in Adapter Framework, una scheda personalizzata viene gestita tramite la console di amministrazione di BizTalk Server.
La figura seguente illustra i componenti principali di una scheda personalizzata: il file del Registro di sistema dell'adattatore, il componente di progettazione dell'adattatore e il componente di runtime dell'adapter.
File del Registro di sistema dell'adapter
Alcune informazioni sugli adapter devono essere registrate nel Registro di sistema e nel database di gestione BizTalk. Informazioni quali l'alias di un adapter, il gestore di ricezione, l'indirizzo di ricezione e il tipo di trasporto vengono definite metadati. Queste voci di metadati vengono create durante la registrazione manuale della scheda usando la console di amministrazione di BizTalk Server. In alternativa, è possibile eseguire l'utilità Creazione guidata Registro di sistema adapter (AdapterRegistryWizard.exe) dell'SDK per generare un file del Registro di sistema per l'adapter personalizzato. Fare doppio clic su questo file del Registro di sistema o scegliere Importa nel menu File usando l'editor del Registro di sistema (regedit32.exe) scrive i metadati nel Registro di sistema.
Nota
Eseguendo il file del Registro di sistema, le informazioni sull'adapter non vengono aggiunte al database di gestione BizTalk. È necessario eseguire questa operazione manualmente usando la console di amministrazione di BizTalk Server.
Componente design-time
L'interfaccia utente di un adapter personalizzato viene implementata utilizzando Adapter Framework. Si tratta di un approccio produttivo allo sviluppo dell'interfaccia utente, poiché quest'ultima viene sottoposta a rendering da uno schema XML fornito come parte dell'assembly dell'adapter. Per trasformare il contenuto dello schema in un'interfaccia utente per la configurazione delle proprietà dell'adapter è necessaria una piccola quantità di codice.
Per un'orchestrazione che deve comunicare con un adapter applicazione come l'adapter SQL, l'Aggiunta guidata adapter consente di aggiungere i metadati dell'adapter, quali schemi, tipi di messaggio e tipi di porta, a un progetto BizTalk. Utilizzare l'Aggiunta guidata adapter con adapter applicazione per eseguire il pull degli schemi corrispondenti nel sistema. Per richiamare questa procedura guidata dall'interno di un progetto BizTalk (non adattatore), fare clic con il pulsante destro del mouse sul progetto, scegliere Aggiungi elementi generati, fare clic su Aggiungi metadati adattatori e quindi selezionare dall'elenco delle schede registrate per importare i metadati dell'adapter.
Componente runtime
In genere una scheda è costituita da due componenti di runtime pubblici: il componente che implementa il ricevitore del messaggio e il componente che implementa il mittente del messaggio. Questi componenti possono essere distribuiti nello stesso assembly o in due assembly diversi.
Adapter di ricezione
Gli adapter di ricezione sono responsabili della creazione di un nuovo messaggio BizTalk mediante l'associazione del flusso di origine dati/rete al corpo del messaggio. Aggiungono inoltre eventuali metadati attinenti all'endpoint su cui sono stati ricevuti dati, quindi inviano il messaggio al motore di messaggistica. L'adapter elimina i dati dall'endpoint di ricezione o invia il messaggio di riconoscimento appropriato al client che indica che i dati sono stati accettati in BizTalk Server.
Adapter di trasmissione
Gli adapter di trasmissione sono responsabili dell'invio di un messaggio BizTalk all'endpoint specificato utilizzando il protocollo di trasporto specifico.