Condividi tramite

Schemi di configurazione dell'adapter

  • Articolo

Nella configurazione Design-Time di un adapter vengono utilizzati diversi tipi di schemi. A seconda della visibilità e dell'ambito dei valori delle proprietà, vengono modificati e utilizzati schemi diversi.

Schemi gestori

Una configurazione adapter che proviene da un gestore viene applicata all'adapter e a tutti i relativi consumer in un ambito globale. Un amministratore può modificare staticamente la configurazione del gestore in fase di progettazione usando la console di amministrazione di BizTalk Server per espandere il gestore di ricezione o invio della scheda e visualizzare le proprietà dell'host specificato.

L'adapter per file di esempio incluso nel Software Development Kit (SDK) contiene un insieme di file XSD utilizzati per configurarne l'indirizzo di ricezione, la porta di trasmissione, il gestore di ricezione e il gestore di trasmissione. Modificare questi file XSD in modo che l'adapter personalizzato riceva le proprietà di configurazione necessarie. I file inclusi con l'dapter per file di esempio che è necessario modificare sono i file di schema TransmitHandler.xsd e ReceiveHandler.xsd Questi file configurano rispettivamente il gestore di invio e il gestore di ricezione controllando le pagine delle proprietà usate per configurare i gestori nella console di amministrazione BizTalk Server.

Utilizzando i requisiti dell'adapter, creare un elenco delle proprietà di configurazione necessarie per ognuno degli endpoint. Se tutte le proprietà di configurazione sono globali, sarà necessario modificare soltanto le configurazioni della porta di trasmissione e della porta di ricezione. Se le proprietà dell'adapter devono essere impostate per ogni porta di trasmissione o indirizzo di ricezione, sarà inoltre necessario modificare i file di configurazione dell'indirizzo di ricezione e della porta di trasmissione.

Per supportare i comuni requisiti di configurazione degli adapter, Adapter Framework fornisce estensioni di schema e opzioni di configurazione avanzate. Fornisce inoltre estensioni non presenti nello schema incluso con l'adapter per file di esempio. Per altre informazioni sulle estensioni dello schema di Adapter Framework, vedere Estensioni dello schema di configurazione di Adapter Framework. Per altre informazioni sulle opzioni di configurazione avanzate, ad esempio editor a discesa personalizzati e convertitori di tipi personalizzati, vedere Componenti di configurazione avanzati per adapter.

Il codice riportato alla fine di questo argomento è incluso nel file TransmitHandler.xsd e genera la pagina delle proprietà seguente:

Screenshot che mostra la scheda Proprietà.
Pagina delle proprietà del gestore di trasmissione creata dal file TransmitHandler.xsd

Si noti l'uso <dei tag baf:designer>, <baf:displayname> e <baf:description> nel codice TransmitHandler.xsd illustrato di seguito. Si tratta di effetti personalizzati forniti da Adapter Framework per accelerare la generazione di queste pagine delle proprietà.

Per un elenco di tutte le decorazioni disponibili per l'uso all'interno di Adapter Framework, vedere Tag di decorazione dello schema di configurazione di Adapter Framework.

Notare che lo schema contiene un solo elemento e non contiene elementi URI.

Importante

Non archiviare dati riservati dei clienti nello schema dell'adapter predefinito. Per motivi di sicurezza, configurare le informazioni relative al nome utente e alla password solo dopo aver distribuito un adapter. In questo modo si garantisce che le informazioni verranno memorizzate nel database Enterprise Single Sign-On (SSO). Per altre informazioni sul database SSO, vedere Uso dell'accesso SSO.

<?xml version="1.0" encoding="utf-16"?>  
<xs:schema xmlns:baf="BiztalkAdapterFramework.xsd"   
xmlns:b="http://schemas.microsoft.com/BizTalk/2003"   
xmlns="http://tempuri.org/XMLSchema1.xsd"   
elementFormDefault="qualified" targetNamespace="http://tempuri.org/XMLSchema1.xsd"   
id="TransmitHandler" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
  <xs:element name="Config">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element default="50" name="sendBatchSize" type="xs:int" >  
      <xs:annotation>  
         <xs:appinfo>  
            <baf:designer>  
               <baf:displayname _locID="sendBatchSizeName">Batch Size</baf:displayname>  
               <baf:description _locID="sendBatchSizeDesc">Enter the   
maximum number of files to be transmitted per batch</baf:description>  
            </baf:designer>  
         </xs:appinfo>  
      </xs:annotation>  
   </xs:element>  
  
        <xs:element default="4096" name="bufferSize" type="xs:int" >  
      <xs:annotation>  
         <xs:appinfo>  
            <baf:designer>  
               <baf:displayname _locID="bufferSizeName">Write Buffer Size</baf:displayname>  
               <baf:description _locID="bufferSizeDesc">Enter the size of   
the buffer used to write the file</baf:description>  
            </baf:designer>  
         </xs:appinfo>  
      </xs:annotation>  
   </xs:element>  
  
        <xs:element default="1" name="threadsPerCPU" type="xs:int" >  
      <xs:annotation>  
         <xs:appinfo>  
            <baf:designer>  
               <baf:displayname _locID="threadsPerCPUName">Threads Per CPU</baf:displayname>  
               <baf:description _locID="threadsPerCPUDesc">Enter the   
number of threads per CPU to execute in the thread pool</baf:description>  
            </baf:designer>  
         </xs:appinfo>  
      </xs:annotation>  
   </xs:element>  
  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
</xs:schema>

Schemi delle porte di trasmissione e degli indirizzi di ricezione

Per impostare proprietà specifiche delle porte per l'adapter, modificare gli schemi di configurazione dell'indirizzo di ricezione e della porta di trasmissione. I file di schema TransmitLocation.xsd e ReceiveLocation.xsd consentono di configurare rispettivamente la porta di trasmissione e l'indirizzo di ricezione.

Per supportare i comuni requisiti di configurazione degli adapter, Adapter Framework fornisce estensioni di schema e opzioni di configurazione avanzate. Per altre informazioni sulle estensioni dello schema di Adapter Framework, vedere Estensioni dello schema di configurazione di Adapter Framework. Per altre informazioni sulle opzioni di configurazione avanzate, ad esempio editor a discesa personalizzati e convertitori di tipi personalizzati, vedere Componenti di configurazione avanzati per adapter.

Il codice riportato di seguito è incluso nel file TransmitLocation.xsd e genera la pagina delle proprietà seguente:

Immagine che mostra la finestra di dialogo Proprietà trasporto statico.
Pagina delle proprietà della porta di trasmissione per l'adapter per file di esempio

Nota nel file TransmitLocation.xsd seguente che la configurazione della porta di invio contiene il <tag baf:designer>, <baf:displayname> e <baf:description> , proprio come il gestore di invio e usa anche il <tag baf:category> . Il tag category consente di raggruppare le proprietà. Se si dispone di più categorie, ognuna di esse può essere espansa e compressa e viene visualizzata in grigio come un'intestazione delle proprietà della categoria specifica. Per altre informazioni, vedere Estensioni dello schema di configurazione di Adapter Framework.

Questo schema contiene inoltre un campo URI. Questo campo viene compilato nella pagina che viene visualizzata dopo avere immesso tutte le informazioni relative ai campi nella pagina delle proprietà della porta di trasmissione durante l'elaborazione della convalida da parte dell'adapter.

<?xml version="1.0" encoding="utf-16"?>  
<xs:schema xmlns:baf="BiztalkAdapterFramework.xsd" xmlns:b="http://schemas.microsoft.com/BizTalk/2003" xmlns="http://tempuri.org/XMLSchema1.xsd" elementFormDefault="qualified" targetNamespace="http://tempuri.org/XMLSchema1.xsd" id="TransmitLocation" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
  <xs:element name="Config">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="directory" type="xs:string">  
      <xs:annotation>  
         <xs:appinfo>  
            <baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">  
               <baf:displayname _locID="sendDirectoryName">Directory</baf:displayname>  
               <baf:description _locID="sendDirectoryDesc">Directory to write the file to</baf:description>  
                         <baf:category _locID="transmitLocationCategory">Transmit Location</baf:category>  
                    </baf:designer>  
         </xs:appinfo>  
      </xs:annotation>  
        </xs:element>  
  
        <xs:element default="%MessageID%.xml" name="fileName" type="xs:string">  
          <xs:annotation>  
            <xs:appinfo>  
              <baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">  
                <baf:displayname _locID="fileNameName">File Name</baf:displayname>  
      <baf:description _locID="fileNameDesc">The name of the file that will be written</baf:description>  
                <baf:category _locID="transmitLocationCategory">Transmit Location</baf:category>  
              </baf:designer>  
            </xs:appinfo>  
          </xs:annotation>  
        </xs:element>  
  
        <xs:element default="2" name="fileCopyMode" type="CopyMode">  
          <xs:annotation>  
            <xs:appinfo>  
              <baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">  
                <baf:displayname _locID="fileCopyModeName">File Mode</baf:displayname>  
                <baf:category _locID="transmitLocationCategory">Transmit Location</baf:category>  
              </baf:designer>  
            </xs:appinfo>  
          </xs:annotation>  
        </xs:element>  
  
        <xs:element name="uri" type="xs:string">  
          <xs:annotation>  
            <xs:appinfo>  
              <baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">  
                <baf:browsable show="false" />  
              </baf:designer>  
            </xs:appinfo>  
          </xs:annotation>  
        </xs:element>  
  
   <!-- An example of how an SSO affiliate application would be configured for this endpoint: -->  
   <!--  
   <xs:element name="ssoAffiliateApplication" type="baf:SSOList">  
      <xs:annotation>  
         <xs:appinfo>  
            <baf:designer>  
               <baf:displayname _locID="ssoAffiliateApplicationName">SSO Affiliate</baf:displayname>  
               <baf:description _locID="ssoAffiliateApplicationDesc">The Single Sign On (SSO) Affiliate Application</baf:description>  
               <baf:category _locID="ftpCategory">FTP</baf:category>  
            </baf:designer>  
         </xs:appinfo>  
      </xs:annotation>  
   </xs:element>  
   -->  
  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:simpleType name="CopyMode">  
    <xs:restriction base="xs:int">  
      <xs:enumeration value="0">  
        <xs:annotation>  
          <xs:appinfo>  
            <baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">  
              <baf:displayname _locID="appendName">Append</baf:displayname>  
            </baf:designer>  
          </xs:appinfo>  
        </xs:annotation>  
      </xs:enumeration>  
      <xs:enumeration value="1">  
        <xs:annotation>  
          <xs:appinfo>  
            <baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">  
              <baf:displayname _locID="createName">Create</baf:displayname>  
            </baf:designer>  
          </xs:appinfo>  
        </xs:annotation>  
      </xs:enumeration>  
      <xs:enumeration value="2">  
        <xs:annotation>  
          <xs:appinfo>  
            <baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">  
              <baf:displayname _locID="createNewName">CreateNew</baf:displayname>  
            </baf:designer>  
          </xs:appinfo>  
        </xs:annotation>  
      </xs:enumeration>  
    </xs:restriction>  
  </xs:simpleType>  
</xs:schema>