Configurazione della fase di progettazione dell'adapter
Gli adapter contengono un componente della fase di esecuzione e un componente della fase di progettazione. Il componente della fase di esecuzione non è visibile all’utente, È responsabile in modo trasparente della trasmissione, della ricezione e dell'elaborazione dei messaggi di BizTalk Server.
Il componente della fase di progettazione di un adapter è visibile tramite interfacce utente di amministrazione, ed è responsabile della visualizzazione delle proprietà disponibili nonché dell’accettazione dell’input amministrativo e della convalida di tale input per la configurazione di un adapter. È fondamentale che il componente della fase di progettazione consenta la corretta configurazione delle proprietà dell’adapter in modo da attivare la funzionalità della fase di esecuzione per lo scambio corretto dei messaggi.
In questa sezione viene descritto solo il componente della fase di progettazione di un adapter. In particolare, verranno illustrate le modalità di visualizzazione e impostazione della configurazione di un adapter. Sono disponibili due metodi di configurazione di un adapter:
Visualizzatore proprietà. Le proprietà dell'adapter per una porta di trasmissione o ricezione o un gestore di invio o ricezione vengono configurate tramite il menu Proprietà usando la console di amministrazione di BizTalk Server. Durante la configurazione di questi elementi, l’adapter (trasporto) è selezionato e le relative proprietà vengono configurate mediante un visualizzatore. Le proprietà applicabili vengono visualizzate tramite uno schema con un nome del set. Ad esempio, le proprietà relative a un gestore di trasmissione si troveranno nel file TransmitHandler.xsd, mentre quelle relative a un indirizzo di ricezione si troveranno nel file ReceiveLocation.xsd. L'adapter implementa l'interfaccia IAdapterConfig per individuare e caricare lo schema appropriato per esporre proprietà specifiche nel browser delle proprietà. L'interfaccia IAdapterConfigValidation viene usata per convalidare tali voci e apportare eventuali modifiche finali ai valori prima di salvare i dati di configurazione.
Aggiunta guidata adapter. Nel caso delle schede di database e dell'applicazione, potrebbe essere necessario importare schemi di supporto che descrivono i tipi di messaggio e i tipi di porta necessari per l'adapter nel progetto BizTalk in Visual Studio. Talvolta è invece necessario utilizzare i servizi forniti dall’adapter. L’Aggiunta guidata adapter consente di visualizzare i servizi supportati da un adapter nonché importare nel progetto i tipi di porte e i tipi di messaggi correlati. Questo processo è noto come "raccolta dei metadati". Come sviluppatore di adapter si crea un file XML che descrive tali servizi e lo espone alla procedura guidata in fase di progettazione tramite l'interfaccia IStaticAdapterConfig o IDynamicAdapterConfig , con i risultati seguenti:
Adapter statico. La procedura guidata include una struttura gerarchica predefinita standard che consente di visualizzare i servizi dell’adapter. L’adapter statico viene definito come un adapter che utilizza l’interfaccia utente della struttura standard fornita dalla procedura guidata. Usare i metodi IStaticAdapterConfig.GetServiceOrganization e GetServiceDescription per consentire l'aggiunta di servizi selezionati al progetto BizTalk. Pur essendo questa l’opzione di configurazione più semplice per uno sviluppatore di adapter, presenta lo svantaggio di conferire rigidità al formato di visualizzazione.
Adapter dinamico. Se l’interfaccia utente per la selezione dei servizi di base fornita dalla procedura guidata non è abbastanza flessibile da soddisfare le proprie esigenze, è possibile creare un’interfaccia utente personalizzata che venga visualizzata nella procedura guidata in modo dinamico. Usare il metodo IDynamicAdapterConfig.DisplayUI per visualizzare l'interfaccia utente personalizzata per consentire l'aggiunta di servizi a un progetto BizTalk.
In questa sezione vengono illustrate entrambe le linee guida per definire la gestione della configurazione della fase di progettazione sia in modo statico che dinamico.
Microsoft BizTalk Server software development kit (SDK) include un adattatore di file di esempio che è possibile usare come modello per creare e personalizzare le proprie soluzioni di configurazione in fase di progettazione dell'adattatore. In tutti gli argomenti relativi alla configurazione della fase di progettazione sono inclusi riferimenti e note sull’adapter per file di esempio che consentono di modificare i requisiti per la configurazione personalizzata di un adapter. Per comprendere meglio tali linee guida, è possibile installare, generare ed eseguire l’adapter per file di esempio incluso nel Software Development Kit. Per altre informazioni, vedere Adapter file (BizTalk Server Sample).