Come configurare una porta di trasmissione WCF-Custom

Articolo
10/14/2023

È possibile configurare una porta di trasmissione WCF-Custom a livello di codice o tramite la Console di amministrazione BizTalk.

Proprietà di configurazione

Il modello a oggetti di BizTalk Explorer espone un'interfaccia specifica dell'adapter per le porte di trasmissione denominate ITransportInfo con la proprietà di lettura/scrittura TransportTypeData . Questa proprietà accetta un elenco di proprietà di configurazione delle porte di trasmissione WCF-Custom sotto forma di coppia nome-valore di stringhe XML.

La proprietà TransportTypeData dell'interfaccia ITransportInfo non è obbligatoria. Se non viene impostata, l'adapter utilizza i valori predefiniti per la configurazione delle porte di trasmissione WCF-Custom, come indicato nella tabella seguente.

L'elenco seguente descrive le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per WCF-Custom porte di trasmissione:

Nome proprietà: Identity
- Tipo: BLOB XML
  
  Esempio:
```
<identity>
<userPrincipalName value="username@contoso.com" />
</identity>
```
- Descrizione: specificare l'identità del servizio prevista dalla porta di trasmissione. Queste impostazioni consentono alla porta di trasmissione di autenticare il servizio. Nel processo di handshake tra il client e il servizio, l'infrastruttura WCF garantirà che l'identità del servizio previsto corrisponda ai valori di questo elemento. I valori che è possibile specificare per la proprietà Identity differiscono in base alla configurazione di sicurezza.
  
  Il valore predefinito è una stringa vuota.
Nome proprietà: StaticAction
- Tipo: String
- Descrizione: specificare il campo intestazione SOAPAction per i messaggi in uscita. Questa proprietà può essere impostata anche tramite la proprietà del contesto del messaggio WCF. Azione in una pipeline o in un'orchestrazione. È possibile specificare questo valore in due modi diversi: il formato di azione singola e il formato di mapping delle azioni. Se si imposta questa proprietà nel formato a azione singola, ad esempio http://contoso.com/Svc/Op1, l'intestazione SOAPAction per i messaggi in uscita viene sempre impostata sul valore specificato in questa proprietà.
  
  Se si imposta questa proprietà nel formato di mapping delle azioni, l'intestazione SOAPAction in uscita viene determinata da BTS. Proprietà del contesto dell'operazione . Ad esempio, se questa proprietà è impostata sul formato XML seguente e su BTS. La proprietà Operation è impostata su Op1, quindi l'adattatore di trasmissione WCF usa http://contoso.com/Svc/Op1 per l'intestazione SOAPAction in uscita.
```
<BtsActionMapping>
<Operation Name="Op1" Action="http://contoso.com/Svc/Op1" />
<Operation Name="Op2" Action="http://contoso.com/Svc/Op2" />
</BtsActionMapping>
```
  Se i messaggi in uscita provengono da una porta di orchestrazione, le istanze di orchestrazione impostano dinamicamente BTS. Proprietà Operation con il nome dell'operazione della porta. Se i messaggi in uscita vengono instradati con il routing basato sul contenuto, è possibile impostare BTS. Proprietà Operation nei componenti della pipeline.
  
  Il valore predefinito è una stringa vuota.
Nome proprietà: BindingType
- Tipo: Enumerazione
  
  Per altre informazioni sui nomi dei membri per la proprietà BindingType , vedere la proprietà Binding Type nella finestra di dialogo Proprietà trasporto WCF-Custom, Send, Binding nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.
- Descrizione: specificare il tipo di associazione da usare per l'endpoint usato da questa porta di trasmissione.
  
  Se si utilizza un'associazione personalizzata, la proprietà BindingType può essere configurata con le associazioni personalizzate. Per altre informazioni su come usare l'associazione personalizzata, vedere How to Enable the WCF Extensibility Points with the WCF Adapters.For more information about how to use custom binding, see How to Enable the WCF Extensibility Points with the WCF Adapters.
Nome proprietà: BindingConfiguration
- Tipo: BLOB XML
  
  Esempio:
```
<binding name="netNamedPipeBinding">
<readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384" maxBytesPerRead="4096" maxNameTableCharCount="16384" />
<security mode="None" />
</binding>
```
- Descrizione: specificare una stringa XML con l'elemento <binding> per configurare tipi diversi di associazioni predefinite fornite da Windows Communication Foundation (WCF). Per ulteriori informazioni sul binding fornito dal sistema e sul binding personalizzato, vedere gli argomenti pertinenti nella sezione Vedere anche.
  
  BizTalk Server non supporta tutti i tipi degli elementi dell'estensione di associazione che è possibile configurare con la proprietà BindingConfiguration.
  
  Il valore predefinito è una stringa vuota.
Nome proprietà: EndpointBehaviorConfiguration
- Tipo: BLOB XML
  
  Esempio:
```
<behavior name="sampleBehavior">
<callbackTimeouts />
</behavior>
```
- Descrizione: specificare una stringa XML con l'elemento <behavior> dell'elemento <endpointBehaviors> per configurare le impostazioni di comportamento di un endpoint WCF. Per altre informazioni sull'elemento <endpointBehaviors> , vedere l'argomento appropriato in Vedere anche.
  
  BizTalk Server non supporta tutti i tipi degli elementi di estensione del comportamento che è possibile configurare con la proprietà EndpointBehaviorConfiguration.
  
  Il valore predefinito è una stringa vuota.
Nome proprietà: AffiliateApplicationName
- Tipo: String
- Descrizione: specificare l'applicazione affiliata da usare per Enterprise Single Sign-On (SSO).
  
  Il valore predefinito è una stringa vuota.
Nome proprietà: UseSSO
- Tipo: Boolean
- Descrizione: specificare se usare Single Sign-On per recuperare le credenziali client per l'autenticazione con il server di destinazione.
  
  Valore predefinito: False
Nome proprietà: UserName
- Tipo: String
- Descrizione: specificare il nome utente da utilizzare per l'autenticazione con il server di destinazione quando la proprietà UseSSO è impostata su False. Non è necessario utilizzare il domain\user formato per questa proprietà.
  
  Il valore predefinito è una stringa vuota.
Nome proprietà: Password
- Tipo: String
- Descrizione: specificare la password da utilizzare per l'autenticazione con il server di destinazione quando la proprietà UseSSO è impostata su False.
  
  Il valore predefinito è una stringa vuota.
Nome proprietà: OutboundBodyLocation
- Tipo: Enumerazione
  - UseBodyElement: usare la parte del corpo del messaggio BizTalk per creare il contenuto dell'elemento SOAP Body per un messaggio in uscita.
  - UseTemplate: utilizzare il modello fornito nella proprietà OutboundXMLTemplate per creare il contenuto dell'elemento Corpo SOAP per un messaggio in uscita.
  Per altre informazioni sull'utilizzo della proprietà OutboundBodyLocation , vedere Specifica del corpo del messaggio per gli adapter WCF.
- Descrizione: specificare la selezione dei dati per l'elemento SOAP Body dei messaggi WCF in uscita.
  
  Valore predefinito: UseBodyElement
Nome proprietà: OutboundXMLTemplate
- Tipo: String
  
  Per altre informazioni sull'utilizzo della proprietà OutboundXMLTemplate , vedere Specifica del corpo del messaggio per gli adapter WCF.
- Descrizione: specificare il modello in formato XML per il contenuto dell'elemento SOAP Body di un messaggio in uscita. Questa proprietà è obbligatoria se la proprietà OutboundBodyLocation è impostata su UseTemplate.
  
  Il valore predefinito è una stringa vuota.
Nome proprietà: InboundBodyLocation
- Tipo: Enumerazione
  - UseBodyElement: usare il contenuto dell'elemento SOAP Body di un messaggio in arrivo per creare la parte del corpo del messaggio BizTalk. Se l'elemento Body dispone di più di un elemento figlio, solo il primo elemento diventa la parte corpo del messaggio BizTalk. Questa proprietà è valida solo per le porte sollecitazione-risposta.
  - UseEnvelope: creare la parte del corpo del messaggio BizTalk dall'intera SOAP Envelope di un messaggio in arrivo.
  - UseBodyPath: usare l'espressione del percorso del corpo nella proprietà InboundBodyPathExpression per creare la parte del corpo del messaggio BizTalk. Tale espressione viene valutata in base all'elemento figlio immediato dell'elemento SOAP Body di un messaggio in arrivo. Questa proprietà è valida solo per le porte sollecitazione-risposta.
  Per altre informazioni sull'utilizzo della proprietà InboundBodyLocation , vedere Specifica del corpo del messaggio per gli adapter WCF.
- Descrizione: specificare la selezione dei dati per l'elemento SOAP Body dei messaggi WCF in arrivo.
  
  Valore predefinito: UseBodyElement
Nome proprietà: InboundBodyPathExpression
- Tipo: String
  
  Per altre informazioni sull'utilizzo della proprietà InboundBodyPathExpression , vedere Proprietà e schema delle proprietà degli adapter WCF.
- Descrizione: specificare l'espressione del percorso del corpo per identificare una parte specifica di un messaggio in arrivo usato per creare la parte del corpo del messaggio BizTalk. Questa espressione del percorso del corpo viene valutata rispetto all'elemento figlio immediato del nodo CORPO SOAP di un messaggio in arrivo. Se questa espressione percorso del corpo restituisce più di un nodo, solo il primo nodo verrà scelto per la parte corpo del messaggio BizTalk. Questa proprietà è obbligatoria se la proprietà InboundBodyLocation è impostata su UseBodyPath. Questa proprietà è valida solo per le porte sollecitazione-risposta.
  
  Il valore predefinito è una stringa vuota.
Nome proprietà: InboundNodeEncoding
- Tipo: Enumerazione
  - XML
  - Base64: codifica Base64
  - Esadecimale: codifica esadecimale
  - Stringa: codifica del testo; UTF-8
  - XML: gli adapter WCF creano il corpo del messaggio BizTalk con il codice XML esterno del nodo selezionato dall'espressione del percorso del corpo in InboundBodyPathExpression.
- Descrizione: specificare il tipo di codifica usato dall'adattatore di trasmissione WCF-Custom per decodificare il nodo identificato dal percorso del corpo specificato in InboundBodyPathExpression. Questa proprietà è obbligatoria se la proprietà InboundBodyLocation è impostata su UseBodyPath. Questa proprietà è valida solo per le porte sollecitazione-risposta.
  
  Valore predefinito: XML
Nome proprietà: PropagateFaultMessage
- Tipo: Boolean
  - True: instradare il messaggio che non supera l'elaborazione in uscita a un'applicazione di sottoscrizione, ad esempio un'altra porta di ricezione o una pianificazione dell'orchestrazione.
  - False: sospendere i messaggi non riusciti e generare un riconoscimento negativo (NACK).
- Descrizione: specificare se instradare o sospendere i messaggi non è riuscito nell'elaborazione in uscita.
  
  Questa proprietà è valida solo per le porte sollecitazione-risposta.
  
  Valore predefinito: True
Nome proprietà: ReferencedBindings
- Tipo: BLOB XML
  
  Esempio:
```
<BindingConfiguration vt="8">
<wsFederationHttpBinding>
  <binding name="sampleBinding">
   <security mode="Message">
    <message issuedKeyType="AsymmetricKey">
     <issuer address="http://www.contoso.com/samplests" binding="wsFederationHttpBinding" bindingConfiguration="contosoSTSBinding"/>
    </message>
   </security>
  </binding>
</wsFederationHttpBinding>
</BindingConfiguration>
<ReferencedBindings vt="8">
<bindings>
  <wsFederationHttpBinding>
   <binding name="contosoSTSBinding">
    <security mode="Message">
     <message negotiateServiceCredential="false">
      <issuer address="http://northwind.com/samplests" bindingConfiguration="northwindBinding" binding="wsHttpBinding">
      </issuer>
     </message>
    </security>
   </binding>
  </wsFederationHttpBinding>
  <wsHttpBinding>
   <binding name="northwindBinding">
    <security mode="Message">
     <message clientCredentialType="Certificate" />
    </security>
   </binding>
  </wsHttpBinding>
</bindings>
</ReferencedBindings>
```
  La proprietà ReferencedBinding non deve contenere la configurazione dell'associazione utilizzata nella proprietà BindingConfiguration .
- Descrizione: specificare le configurazioni di associazione a cui fa riferimento l'attributo bindingConfiguration dell'elemento <issuer> per wsFederationHttpBinding e customBinding, che indica il servizio token di sicurezza (STS) che rilascia i token di sicurezza. Per altre informazioni sull'elemento <issuer> , vedere Schema di configurazione WCF: <issuer>.
  
  Le informazioni di associazione, incluso l'elemento <issuer> per wsFederationHttpBinding e customBinding , possono essere configurate tramite la proprietà BindingConfiguration delle WCF-Custom e delle schede WCF-CustomIsolated. Tutte le configurazioni di associazione a cui si fa riferimento per questa proprietà devono essere inserite sotto forma di <bindings> elemento .
  
  Non è possibile configurare questa proprietà nella scheda Binding della finestra di dialogo delle proprietà di trasporto. È possibile importare ed esportare questa proprietà tramite la scheda Importazione/Esportazione nella finestra di dialogo delle proprietà di trasporto degli adattatori WCF-Custom e WCF-CustomIsolated.
  
  L'attributo bindingConfiguration dell'elemento <issuer> deve fare riferimento a un nome di associazione valido in questa proprietà.
  
  L'elemento <issuer> nelle configurazioni di associazione a cui si fa riferimento può anche fare riferimento a una configurazione di associazione diversa in questa proprietà se questa catena di riferimenti non crea una dipendenza circolare.
  
  Il valore predefinito è una stringa vuota.

Configurare una porta di trasmissione WCF-Custom con la console di amministrazione BizTalk

È possibile impostare le variabili dell'adapter della porta di trasmissione WCF-Custom nella Console di amministrazione BizTalk. Se non vengono impostate proprietà per la porta di trasmissione, vengono utilizzati i valori predefiniti per la configurazione della porta di trasmissione WCF-Custom, come indicato nella tabella precedente.

Configurare le variabili per una porta di trasmissione WCF-Custom

Se durante la configurazione dell'adapter WCF-Custom si prevede di utilizzare i punti di estendibilità WCF, ad esempio elementi di binding, elementi di comportamento e componenti di canale personalizzati, è necessario aggiungere gli assembly che implementano i punti di estendibilità e tutti gli assembly dipendenti nella Global Assembly Cache sia nel computer di elaborazione BizTalk (il computer di runtime) che nel computer di amministrazione. È inoltre necessario registrare i componenti di estensione nel file machine.config. Per altre informazioni su come usare i punti di estendibilità WCF con l'adattatore personalizzato WCF, vedere Come abilitare i punti di estendibilità WCF con gli adapter WCF.
Nella Console di amministrazione BizTalk creare una nuova porta di trasmissione oppure fare doppio clic su una porta di trasmissione esistente per modificarla. Per altre informazioni, vedere Come creare una porta di trasmissione. Configurare tutte le opzioni della porta di trasmissione e specificare WCF-Custom per l'opzione Tipo nella sezione Trasporto della scheda Generale nella guida all'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.
Nella sezione Trasporto della scheda Generale fare clic sul pulsante Configura accanto a Tipo.
Nella scheda Generale della finestra di dialogo Proprietà trasporto personalizzato WCF configurare l'indirizzo dell'endpoint, l'identità del servizio e l'intestazione SOAPAction per la porta di trasmissione WCF-Custom. Per altre informazioni sulla scheda Generale nella finestra di dialogo Proprietà trasporto WCF-Custom , vedere la finestra di dialogo Proprietà trasporto WCF-Custom, Invia, Generale nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.
Nella scheda Binding della finestra di dialogo Proprietà trasporto personalizzato WCF configurare tipi diversi di associazioni predefinite o personalizzate per WCF. Per altre informazioni sulla scheda Binding nella finestra di dialogo Proprietà trasporto WCF-Custom , vedere la finestra di dialogo Proprietà trasporto WCF-Custom, Send, Binding nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.
Nella scheda Comportamento della finestra di dialogo Proprietà trasporto personalizzato WCF configurare il comportamento dell'endpoint per questa porta di trasmissione. Il comportamento dell'endpoint è un set di elementi di estensione di comportamento che modifica o estende il servizio o la funzionalità client. Per altre informazioni sulla scheda Comportamento nella finestra di dialogo Proprietà trasporto WCF-Custom , vedere la finestra di dialogo Proprietà trasporto WCF-custom, Invia, Comportamento nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.
Nella scheda Credenziali della finestra di dialogo Proprietà trasporto personalizzato WCF specificare le credenziali da utilizzare durante l'invio di messaggi. Per altre informazioni sulla scheda Credenziali nella finestra di dialogo Proprietà trasporto WCF-Custom , vedere la finestra di dialogo Proprietà trasporto PERSONALIZZATE WCF, Invia, Credenziali nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.
Nella scheda Messaggi della finestra di dialogo Proprietà trasporto personalizzato WCF specificare la selezione dei dati per l'elemento SOAP Body. Per altre informazioni sulla scheda Messaggi nella finestra di dialogo Proprietà trasporto WCF-Custom , vedere la finestra di dialogo Proprietà trasporto PERSONALIZZATE WCF, Invia, Messaggi nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.
Nella scheda Importazione/Esportazione della finestra di dialogo Proprietà trasporto personalizzato WCF importare ed esportare le proprietà Address (URI) e Endpoint Identity nella scheda Generale, le informazioni sull'associazione nella scheda Binding e il comportamento dell'endpoint nella scheda Comportamento per questa porta di trasmissione. Per altre informazioni sulla scheda Importazione/Esportazione nella finestra di dialogo Proprietà trasporto WCF-Custom , vedere la finestra di dialogo Proprietà trasporto WCF-Custom, Inviare, Importa-Esportazione nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

Configurare una porta di trasmissione WCF-Custom a livello di codice

Per impostare le proprietà, è possibile utilizzare il seguente formato:

<CustomProps>
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
  <InboundBodyPathExpression vt="8" />
  <EndpointBehaviorConfiguration vt="8"><behavior name="sampleBehavior"><callbackTimeouts /></behavior></EndpointBehaviorConfiguration>
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
  <StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>
  <BindingConfiguration vt="8"><binding name="NetNamedPipeOrderProcessService.OrderProcessServieEndpoint"><readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384" maxBytesPerRead="4096" maxNameTableCharCount="16384" /><security mode="None" /></binding></BindingConfiguration>
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
  <UseSSO vt="11">0</UseSSO>
  <AffiliateApplicationName vt="8" />
  <BindingType vt="8">netNamedPipeBinding</BindingType>
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
  <UserName vt="8" />
  <PropagateFaultMessage vt="11">-1</PropagateFaultMessage>
</CustomProps>

Nel frammento di codice riportato di seguito viene illustrata la creazione di una porta di trasmissione WCF-Custom:

// Use BizTalk Explorer object model to create new WCF-Custom send port.
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
string transportConfigData = @"<CustomProps>
                                 <StaticAction vt=""8"">http://www.northwindtraders.com/Service/Operation</StaticAction>
                                 <EndpointBehaviorConfiguration vt=""8""><behavior name=""sampleBehavior""><callbackTimeouts /></behavior></EndpointBehaviorConfiguration>
                                 <BindingType vt=""8"">netNamedPipeBinding</BindingType>
                               </CustomProps>";
//requires project reference to \Program Files\Microsoft BizTalk Server 2009\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll
BtsCatalogExplorer explorer = new Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer();
explorer.ConnectionString = connectionString;
// Add a new BizTalk application
Application application = explorer.AddNewApplication();
application.Name = "SampleBizTalkApplication";
// Save
explorer.SaveChanges();

// Add a new static one-way send port
SendPort sendPort = application.AddNewSendPort(false, false);
sendPort.Name = "SampleSendPort";
sendPort.PrimaryTransport.TransportType = explorer.ProtocolTypes["WCF-Custom"];
sendPort.PrimaryTransport.Address = "net.pipe://mycomputer/private/samplequeue";
sendPort.PrimaryTransport.TransportTypeData = transportConfigData; // propertyData; // need to change
sendPort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];
// Save
explorer.SaveChanges();

Vedere anche

Proprietà e schema delle proprietà degli adapter WCF Specificando il corpo del messaggio per gli adapter WCF Che installano i certificati per gli adapter WCF Che configurano l'adapter WCF-Custom Configuring Dynamic Send Ports Using WCF Adapters Context Properties <behaviors><> behavior of <endpointBehaviors>

Condividi tramite