Proprietà di configurazione per gli adapter BizTalk integrati

  • Articolo

Il modello a oggetti BizTalk Explorer espone le proprietà IReceiveLocation.CustomData e ISendPort.CustomData che contengono il contenitore delle proprietà di configurazione della scheda sotto forma di stringa XML di coppia nome/valore. Questa stringa XML nome/valore viene archiviata in un elemento CustomProps> all'interno di un <<elemento TransportTypeData> in un file di associazione. La maggior parte delle informazioni nell'elemento <CustomProps> corrisponde a informazioni che possono essere impostate per un adattatore nell'interfaccia utente BizTalk Server, ad esempio la console di amministrazione BizTalk o BizTalk Explorer. Se questi valori sono presenti in un file di associazione vengono applicati alla configurazione dell'adapter per gli indirizzi di ricezione e le porte di trasmissione specificati al momento dell'importazione del file di associazione. Le informazioni di configurazione di tutti gli adapter vengono archiviate nel database Single Sign-On.

In questa sezione vengono descritte le proprietà di configurazione impostabili per ogni adapter BizTalk integrato.

Nota

Le informazioni sulla password archiviate nell'elemento <TransportTypeData> di un file di associazione vengono mascherate in modo che i dati sensibili non vengano salvati in testo chiaro. A seconda del trasporto, le informazioni relative alle password vengono sostituite da NULL o da asterischi. Per aggiornare la configurazione dell'adapter prima di importare il file di associazione nella configurazione BizTalk Server di destinazione, è necessario immettere manualmente queste informazioni.

I dati di configurazione per le schede compilate usando Adapter Framework vengono archiviati in un <elemento AdapterConfig> . Poiché l'elemento <AdapterConfig> specifica il tipo di dati VT_BSTR (vt="8"), i < > caratteri contenuti in questo elemento devono essere eliminati o si verificherà un errore quando si tenta di importare il file di associazione. Se per i caratteri indicati non vengono utilizzati caratteri di escape, il testo dei dati di configurazione risulterà meno comprensibile per l'uomo. Nell'esempio seguente viene illustrato l'effetto dell'utilizzo di caratteri di escape per i caratteri indicati ricavati dai dati di configurazione di esempio relativi a una porta di trasmissione associata all'adapter POP3.

Dati di configurazione di TransportTypeData che non es escape dei <> caratteri usati nell'elemento <AdapterConfig>

Questi dati di configurazione non sono validi perché l'elemento <AdapterConfig specifica il tipo di dati VT_BSTR (vt="8") e i><caratteri contenuti nell'elemento <AdapterConfig>> non vengono escape:

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
<mailServer>test.microsoft.com</mailServer>  
<serverPort>0</serverPort>  
<userName>testuser</userName>  
<password>******</password>  
<authenticationScheme>Basic</authenticationScheme>  
<sslRequired>false</sslRequired>  
<applyMIME>true</applyMIME>  
<bodyPartContentType>text/xml</bodyPartContentType>  
<bodyPartIndex>1</bodyPartIndex>  
<errorThreshold>10</errorThreshold>  
<pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure>   
<uri>POP3://test.microsoft.com#testuser</uri>  
</Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

Dati di configurazione transportTypeData che eseggono i <> caratteri usati nell'elemento <AdapterConfig>

Poiché l'elemento <AdapterConfig specifica il tipo di dati VT_BSTR (vt="8"), i <> caratteri devono essere escape dall'elemento <AdapterConfig>>, come illustrato di seguito:

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
xmlns:xsd="http://www.w3.org/2001/XMLSchema"><mailServer>test  
microsoft.com</mailServer><serverPort>0</serverPort>&  
lt;userName>testuser</userName><password>******</pass  
word><authenticationScheme>Basic</authenticationScheme>&  
lt;sslRequired>false</sslRequired><applyMIME>true</ap  
plyMIME><bodyPartContentType>text/xml</bodyPartContentType&  
gt;<bodyPartIndex>1</bodyPartIndex><errorThreshold>10  
</errorThreshold><pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure><uri  
>POP3://test.microsoft.com#testuser</uri></Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

Tra gli adapter integrati creati con Adapter Framework sono inclusi i seguenti:

  • Adapter FTP

  • Adapter MQSeries

  • Adapter MSMQ

  • Adapter POP3

  • Adapter Windows SharePoint Services

    Per visualizzare una stringa di esempio utilizzata per i dati di configurazione TransportTypeData di ogni adapter integrato, vedere l'argomento sulle proprietà di configurazione associato all'adapter in questa sezione.

Contenuto della sezione

Tipi di variabili delle proprietà di configurazione

Proprietà di configurazione di adapter FILE

Proprietà di configurazione di adapter FTP

Proprietà di configurazione di adapter HTTP

Proprietà di configurazione di adapter MQSeries

Proprietà di configurazione di adapter MSMQ

Proprietà di configurazione di adapter POP3

Proprietà di configurazione di adapter SMTP

Proprietà di configurazione di adapter SOAP

Proprietà di configurazione di adapter Windows SharePoint Services