Condividi tramite

Configurare una porta di trasmissione WCF-NetNamedPipe

  • Articolo

È possibile configurare una porta di trasmissione WCF-NetNamedPipe 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-NetNamedPipe 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-NetNamedPipe, come indicato nella tabella seguente.

Nella tabella seguente sono illustrate le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per le porte di trasmissione WCF-NetNamedPipe.

Nome proprietà Type Descrizione
Identità BLOB XML, ad esempio:

<identity>
<userPrincipalName value="username@contoso.com" />
</identity>		 Specifica l'identità del servizio prevista da questa 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 (Windows Communication Foundation) garantirà che l'identità del servizio previsto corrisponda ai valori di questo elemento.

Il valore predefinito è una stringa vuota.
StaticAction string 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/Op1l'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, 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.
OpenTimeout System.TimeSpan Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di apertura di un canale.

Valore predefinito: 00:01:00
SendTimeout System.TimeSpan Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di invio. Se si utilizza una porta di trasmissione sollecitazione-risposta, tale valore specificherà l'intervallo di tempo consentito per il completamento dell'intera interazione, anche se il servizio restituisce un messaggio di grandi dimensioni.

Valore predefinito: 00:01:00
CloseTimeout System.TimeSpan Specificare un valore indicante l'intervallo di tempo consentito per il completamento di un'operazione di chiusura di un canale.

Valore predefinito: 00:01:00
MaxReceivedMessageSize Intero Specificare le dimensioni massime in byte di un messaggio, intestazioni comprese, che è possibile ricevere durante la trasmissione. Le dimensioni dei messaggi sono limitate dalla quantità di memoria allocata per ogni messaggio. È possibile utilizzare questa proprietà per limitare l'esposizione ad attacchi di tipo Denial of Service (DoS).

Valore predefinito: 65536
EnableTransaction Boolean Specificare se un messaggio viene trasmesso al servizio di destinazione ed eliminato dal database MessageBox in un contesto transazionale usando il protocollo WS-AtomicTransaction .

Valore predefinito: False
TransactionProtocol Enumerazione

- OleTransaction
- WS-AtomicTransaction		 Specificare il protocollo di transazione da utilizzare con questo binding.

Valore predefinito: OleTransaction
Securitymode Enumerazione

- Nessuno: disabilita la sicurezza.
- Trasporto: - La sicurezza viene fornita usando la sicurezza basata sul trasporto sottostante. È possibile controllare il livello di protezione con questa modalità.		 Specificare il tipo di sicurezza utilizzato.

Valore predefinito: Transport
TransportProtectionLevel Enumerazione

- Nessuno: nessuna protezione.
- Firma : i messaggi sono firmati.
- EncryptAndSign : i messaggi vengono crittografati e firmati.		 Specifica il livello di sicurezza della named pipe. La firma dei messaggi riduce il rischio di manomissione del messaggio a opera di terze parti durante il trasferimento. La crittografia garantisce la privacy a livello dei dati durante il trasporto.

Valore predefinito: EncryptAndSign
OutboundBodyLocation Enumerazione

- UseBodyElement : usare la parte del corpo del messaggio BizTalk per creare il contenuto dell'elemento SOAP Body per un messaggio in uscita.
- UseTemplate : usare 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.		 Specificare la selezione dei dati per l'elemento SOAP Body dei messaggi WCF in uscita.

Valore predefinito: UseBodyElement
OutboundXMLTemplate string

Per altre informazioni sull'utilizzo della proprietà OutboundXMLTemplate , vedere Specifica del corpo del messaggio per gli adapter WCF.		 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.
InboundBodyLocation 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.		 Specificare la selezione dei dati per l'elemento SOAP Body dei messaggi WCF in arrivo.

Valore predefinito: UseBodyElement
InboundBodyPathExpression string

Per altre informazioni sull'utilizzo della proprietà InboundBodyPathExpression , vedere Proprietà e schema delle proprietà degli adapter WCF.		 Specificare l'espressione percorso del corpo per identificare una parte specifica di un messaggio in arrivo utilizzata per creare la parte 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.
InboundNodeEncoding Enumerazione

- XML
- Codifica Base64 - 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.		 Specificare il tipo di codifica usato dall'adattatore di trasmissione WCF-NetNamedPipe 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
PropagateFaultMessage Boolean

- True : instradare il messaggio che ha esito negativo nell'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).		 Specifica se eseguire il routing o sospendere i messaggi per i quali non è stato possibile eseguire l'elaborazione in uscita.

Questa proprietà è valida solo per le porte sollecitazione-risposta.

Valore predefinito: True

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

È possibile impostare le variabili dell'adapter della porta di trasmissione WCF-NetNamedPipe 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-NetNamedPipe, come indicato nella tabella precedente.

Configurare le variabili per una porta di trasmissione WCF-NetNamedPipe

  1. 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-NetNamedPipe per l'opzione Tipo nella sezione Trasporto della scheda Generale .

  2. Nella sezione Trasporto della scheda Generale fare clic sul pulsante Configura accanto a Tipo.

  3. Nella finestra di dialogo Proprietà trasporto WCF-NetNamedPipe , nella scheda Generale configurare l'indirizzo dell'endpoint, l'identità del servizio e l'intestazione SOAPAction per la porta di trasmissione WCF-NetNamedPipe. Per altre informazioni sulla scheda Generale nella finestra di dialogo Proprietà trasporto WCF-NetNamedPipe , vedere la finestra di dialogo Proprietà trasporto WCF-NetNamedPipe, Invia, Generale nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

  4. Nella finestra di dialogo Proprietà trasporto WCF-NetNamedPipe , nella scheda Binding configurare le proprietà di timeout e transazione. Per altre informazioni sulla scheda Binding nella finestra di dialogo Proprietà trasporto WCF-NetNamedPipe , vedere la finestra di dialogo Proprietà trasporto WCF-NetNamedPipe, Invia, Associazione nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

  5. Nella finestra di dialogo Proprietà trasporto WCF-NetNamedPipe , nella scheda Sicurezza definire le funzionalità di sicurezza del WCF-NetNamedPipe porta di trasmissione. Per altre informazioni sulla scheda Sicurezza nella finestra di dialogo Proprietà trasporto WCF-NetNamedPipe , vedere la finestra di dialogo Proprietà trasporto WCF-NetNamedPipe, Invia, Sicurezza nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

  6. Nella finestra di dialogo Proprietà trasporto WCF-NetNamedPipe , nella scheda Messaggi specificare la selezione dei dati per l'elemento SOAP Body . Per altre informazioni sulla scheda Messaggi nella finestra di dialogo Proprietà trasporto WCF-NetNamedPipe , vedere la finestra di dialogo Proprietà trasporto WCF-NetNamedPipe, Invia, Messaggi nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

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

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

<CustomProps>  
  <TransportProtectionLevel vt="8">EncryptAndSign</TransportProtectionLevel>  
  <TransactionProtocol vt="8">OleTransactions</TransactionProtocol>  
  <InboundBodyPathExpression vt="8" />  
  <PropagateFaultMessage vt="11">-1</PropagateFaultMessage>  
  <CloseTimeout vt="8">00:01:00</CloseTimeout>  
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>  
  <StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>  
  <SendTimeout vt="8">00:01:00</SendTimeout>  
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>  
  <EnableTransaction vt="11">0</EnableTransaction>  
  <SecurityMode vt="8">Transport</SecurityMode>  
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>  
  <OpenTimeout vt="8">00:01:00</OpenTimeout>  
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>  
  <MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>  
</CustomProps>

Nel frammento di codice seguente viene illustrata la creazione di una porta di trasmissione WCF-NetNamedPipe:

// Use BizTalk Explorer object model to create new WCF-NetNamedPipe 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>  
                                 <OpenTimeout vt=""8"">00:01:00</OpenTimeout>  
                               </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-NetNamedPipe"];  
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 proprietà degli adapter WCF
Specifica del corpo del messaggio per gli adapter WCF
Installazione di certificati per gli adapter WCF
Configurazione dell'adapter WCF-NetNamedPipe
Configurazione di porte di trasmissione dinamiche mediante proprietà di contesto degli adapter WCF