Condividi tramite

Come configurare un indirizzo di ricezione WCF-Custom

  • Articolo

Un indirizzo di ricezione WCF-Custom può essere configurato sia a livello di codice sia tramite la Console di amministrazione BizTalk.

Proprietà di configurazione

Il modello a oggetti di BizTalk Explorer consente di creare e configurare indirizzi di ricezione a livello di codice. Il modello a oggetti di BizTalk Explorer espone l'interfaccia di configurazione della posizione di ricezioneIReceiveLocation con una proprietà di lettura/scrittura TransportTypeData . Questa proprietà accetta il contenitore delle proprietà di configurazione dell'indirizzo di ricezione WCF-Custom sotto forma di una coppia nome-valore di stringhe XML. Per impostare questa proprietà nel modello a oggetti di BizTalk Explorer, è necessario impostare la proprietà InboundTransportLocation dell'interfaccia IReceiveLocation .

La proprietà TransportTypeData dell'interfaccia IReceiveLocation non deve essere impostata. Se non è impostata, l'adapter WCF-Custom utilizza i valori predefiniti della configurazione dell'indirizzo di ricezione WCF-Custom indicata nella tabella riportata di seguito.

Nella seguente tabella vengono elencate le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per l'indirizzo di ricezione WCF-Custom.

Nome proprietà Type Descrizione
Identità BLOB XML

Esempio:

<identity>

<userPrincipalName value="username@contoso.com" />

</Identità>		 Specificare l'identità del servizio fornito dall'indirizzo di ricezione. I valori che è possibile specificare per la proprietà Identity differiscono in base alla configurazione di sicurezza. Queste impostazioni consentono al client di autenticare l'indirizzo di ricezione. 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.
BindingType Enumerazione

- basicHttpBinding
- Custombinding
- mexHttpBinding
- mexHttpsBinding
- mexNamedPipeBinding
- mexTcpBinding
- Netmsmqbinding
- Netnamedpipebinding
- Netpeertcpbinding
- Nettcpbinding
- wsDualHttpBinding
- wsFederationHttpBinding
- wsHttpBinding		 Specificare il tipo di binding da impostare per l'endpoint utilizzato da questo indirizzo di ricezione. Nota: 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.

Il valore predefinito è una stringa vuota.
Bindingconfiguration BLOB XML

Esempio:

<binding name="netNamedPipeBinding"><security mode="None" /></binding>		 Specificare una stringa XML con l'elemento di <associazione> 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 in Vedere anche. Nota: 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.
ServiceBehaviorConfiguration BLOB XML

Esempio:

<behavior name="SampleServiceBehavior"><serviceMetadata httpGetEnabled="true" httpGetUrl="http://mycomputer:9995/SampleMex" /><serviceCredentials /></behavior>		 Specificare una stringa XML con l'elemento behavior> dell'elemento<<serviceBehaviors> per configurare le impostazioni di comportamento di un servizio WCF. Per altre informazioni sull'elemento <serviceBehaviors> , vedere l'argomento appropriato in Vedere anche.

Il valore predefinito è una stringa vuota.
EndpointBehaviorConfiguration BLOB XML

Esempio:

<behavior name="sampleBehavior"><callbackTimeouts /></behavior>		 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. Nota: BizTalk Server non supporta tutti i tipi di elementi di estensione del comportamento che è possibile configurare con la proprietà EndpointBehaviorConfiguration.

Il valore predefinito è una stringa vuota.
CredentialType Enumerazione

- Nessuno: non usare credenziali quando questa posizione di ricezione invia messaggi di richiesta per eseguire il polling di un servizio esterno o questa posizione di ricezione non deve eseguire il polling di alcun servizio esterno.
- IssueTicket: usare Enterprise Single Sign-On (SSO) per recuperare le credenziali client per emettere un ticket SSO. Questa opzione richiede l'utilizzo della modalità di protezione che consente all'indirizzo di ricezione corrente di rappresentare l'account utente per emettere un ticket SSO.
- UserAccount: usare le credenziali specificate nelle proprietà Nome utente e Password quando questa posizione di ricezione invia messaggi di richiesta per eseguire il polling di un servizio esterno.
- GetCredentials: usare l'applicazione affiliata SSO specificata nella proprietà AffiliateApplicationName quando questa posizione di ricezione invia messaggi di richiesta per eseguire il polling di un servizio esterno.		 Specificare il tipo di credenziali da utilizzare per questo indirizzo di ricezione durante il polling di un servizio esterno.

Valore predefinito: Nessuno
UserName string Specificare il nome utente per l'indirizzo di ricezione corrente da utilizzare durante il polling di un servizio esterno al fine di recuperare messaggi di risposta. Questa proprietà è obbligatoria quando la proprietà CredentialType è impostata su UserAccount.

Il valore predefinito è una stringa vuota.
Password string Specificare la password per l'indirizzo di ricezione corrente da utilizzare durante il polling di un servizio esterno al fine di recuperare messaggi di risposta. Questa proprietà è obbligatoria quando la proprietà CredentialType è impostata su UserAccount.

Il valore predefinito è una stringa vuota.
AffiliateApplicationName string Specificare l'applicazione affiliata SSO per restituire le credenziali esterne da utilizzare quando l'indirizzo di ricezione corrente invia messaggi di sollecitazione per eseguire il polling di un servizio esterno. L'applicazione affiliata SSO specificata deve disporre di un mapping tra l'account Windows con cui viene eseguito questo indirizzo di ricezione e l'account del servizio esterno. Questa proprietà è obbligatoria quando la proprietà CredentialType è impostata su GetCredentials.

Il valore predefinito è una stringa vuota.
OrderedProcessing Boolean Specificare se mantenere l'ordine dei messaggi durante l'elaborazione dei messaggi (da utilizzare con il binding NetMsmq).

Valore predefinito: False
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.
- 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.

Il valore predefinito è una stringa vuota.
InboundNodeEncoding Enumerazione

- 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 ricezione WCF-Custom per decodificare il nodo identificato dall'espressione del percorso del corpo specificata in InboundBodyPathExpression. Questa proprietà è obbligatoria se la proprietà InboundBodyLocation è impostata su UseBodyPath.

Valore predefinito: XML
OutboundBodyLocation Enumerazione

- UseBodyElement : usare la parte del corpo del messaggio BizTalk per creare il contenuto dell'elemento SOAP Body per un messaggio di risposta in uscita.
- UseTemplate : usare il modello fornito nella proprietà OutboundXMLTemplate per creare il contenuto dell'elemento Corpo SOAP per un messaggio di risposta 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. La proprietà è valida solo per gli indirizzi di ricezione di tipo richiesta-risposta.

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 di risposta in uscita. Questa proprietà è obbligatoria se la proprietà OutboundBodyLocation è impostata su UseTemplate. La proprietà è valida solo per gli indirizzi di ricezione di tipo richiesta-risposta.

Il valore predefinito è una stringa vuota.
DisableLocationOnFailure Boolean Specificare se disattivare l'indirizzo di ricezione per il quale non è possibile eseguire l'elaborazione in ingresso a causa di un problema della pipeline di ricezione o di un errore di routing.

Impostazione predefinita: False
SuspendMessageOnFailure Boolean Specificare se sospendere il messaggio di richiesta per cui non è possibile eseguire l'elaborazione in ingresso a causa di un problema della pipeline di ricezione o di un errore di routing.

Valore predefinito: True
Includeexceptiondetailinfaults Boolean Specificare se includere le informazioni sulle eccezioni gestite nei dettagli relativi agli errori SOAP restituiti al client a scopo di debug.

Impostazione predefinita: False
ReferencedBindings 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"/>

</Messaggio>

</Sicurezza>

</Associazione>

</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">

</Emittente>

</Messaggio>

</Sicurezza>

</Associazione>

</wsFederationHttpBinding>

<wsHttpBinding>

<binding name="northwindBinding">

<security mode="Message">

<message clientCredentialType="Certificate" />

</Sicurezza>

</Associazione>

</wsHttpBinding>

</Associazioni>

</ReferencedBindings>Nota: la proprietà ReferencedBinding non deve contenere la configurazione dell'associazione utilizzata nella proprietà BindingConfiguration .		 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 dell'autorità emittente>, vedere l'argomento< "<issuer>" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=83476.

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 <elemento binding.> Nota: 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. Nota: L'attributo bindingConfiguration dell'elemento <issuer> deve fare riferimento a un nome di associazione valido in questa proprietà. Nota: L'elemento <autorità di> certificazione nelle configurazioni di associazione a cui si fa riferimento può anche fare riferimento a una configurazione di associazione diversa in t la relativa proprietà se questa catena di riferimenti non crea una dipendenza circolare.

Il valore predefinito è una stringa vuota.

Configurare un percorso di ricezione WCF-Custom con la console di amministrazione BizTalk

È possibile impostare le variabili dell'adapter dell'indirizzo di ricezione WCF-Custom nella Console di amministrazione BizTalk. Se alcune proprietà non vengono impostate nell'indirizzo di ricezione, verranno utilizzati i valori predefiniti del gestore di ricezione impostati nella Console di amministrazione BizTalk.

Nota

Prima di completare la seguente procedura, è necessario avere già aggiunto una porta di ricezione. Per altre informazioni, vedere Come creare una porta di ricezione.

Configurare le variabili per un percorso di ricezione di WCF-Custom

  1. 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'adapter personalizzato WCF, vedere Come abilitare i punti di estendibilità WCF con gli adapter WCF.

  2. Nella console amministrazione BizTalk espandere amministrazione BizTalk Server Amministrazione, espandere Gruppo BizTalk, espandere Applicazioni e quindi espandere l'applicazione in cui si vuole creare un percorso di ricezione.

  3. Nel riquadro sinistro della Console di amministrazione BizTalk fare clic sul nodo Porta di ricezione . Nel riquadro destro fare quindi clic con il pulsante destro del mouse sulla porta di ricezione associata a un indirizzo di ricezione esistente o che si desidera associare a un nuovo indirizzo di ricezione e scegliere Proprietà.

  4. Nella finestra di dialogo Proprietà porta di ricezione, nel riquadro sinistro selezionare Posizioni di ricezione e quindi nel riquadro destro fare doppio clic su un percorso di ricezione esistente o fare clic su Nuovoper creare una nuova posizione di ricezione.

  5. Nella finestra di dialogo Proprietà percorso di ricezione , nella sezione Trasporto accanto a Tipo selezionare WCF-Custom nell'elenco a discesa e quindi fare clic su Configura.

  6. Nella scheda Generale della finestra di dialogo Proprietà trasporto personalizzate WCF configurare l'indirizzo dell'endpoint e l'identità del servizio per il percorso di ricezione WCF-Custom. Per altre informazioni sulla scheda Generale nella finestra di dialogo Proprietà trasporto personalizzate WCF , vedere la finestra di dialogo Proprietà trasporto personalizzate WCF, Ricezione, Generale nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.

  7. 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 personalizzate WCF , vedere la finestra di dialogo Proprietà trasporto personalizzate WCF, Ricezione, Associazione nella guida dell'interfaccia utente e informazioni di riferimento sull'API per sviluppatori.

  8. Nella scheda Comportamento della finestra di dialogo Proprietà trasporto personalizzate WCF configurare l'endpoint e i comportamenti del servizio per questa posizione di ricezione. Il comportamento dell'endpoint è un insieme di elementi estensione di comportamento che modificano o estendono le funzionalità del client o del servizio. Per altre informazioni sulla scheda Comportamento nella finestra di dialogo Proprietà trasporto personalizzate WCF , vedere la finestra di dialogo Proprietà trasporto personalizzate WCF, Ricezione, Comportamento nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi api per sviluppatori.

  9. Nella finestra di dialogo Proprietà trasporto personalizzate WCF , nella scheda Altro configurare le credenziali per la posizione di ricezione da usare durante il polling di un servizio esterno e se questa posizione di ricezione mantiene l'ordine dei messaggi durante l'elaborazione dei messaggi. Per altre informazioni sulla scheda Altre nella finestra di dialogo Proprietà trasporto personalizzate WCF , vedere la finestra di dialogo Proprietà trasporto personalizzate WCF, Ricezione, Altra scheda nella guida dell'interfaccia utente e informazioni di riferimento sull'API per sviluppatori.

  10. 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 personalizzate WCF , vedere la finestra di dialogo Proprietà trasporto personalizzate WCF, Ricezione, Messaggi nella guida dell'interfaccia utente e informazioni di riferimento sull'API per sviluppatori.

  11. Nella finestra di dialogo Proprietà trasporto personalizzate WCF , nella scheda Importa/Esporta importare ed esportare le proprietà Indirizzo (URI) ed Endpoint Identity nella scheda Generale , informazioni sull'associazione nella scheda Binding e comportamento dell'endpoint nella scheda Comportamento per questa posizione di ricezione. Per altre informazioni sulla scheda Importazione/Esportazione nella finestra di dialogo Proprietà trasporto personalizzate WCF , vedere la finestra di dialogo Proprietà trasporto personalizzate WCF, Ricezione, Importazione/Esportazione nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi api per sviluppatori.

Configurare un percorso di ricezione WCF-Custom a livello di codice

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

<CustomProps>
  <InboundBodyPathExpression vt="8" />
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
  <BindingConfiguration vt="8"><binding name="netNamedPipeBinding"><security mode="None" /></binding></BindingConfiguration>
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
  <CredentialType vt="8">GetCredentials</CredentialType>
  <Identity vt="8" />
  <ServiceBehaviorConfiguration vt="8"><behavior name="SampleServiceBehavior"><serviceMetadata httpGetEnabled="true" httpGetUrl="http://mycomputer:9995/SampleService/Mex" /><serviceCredentials /></behavior></ServiceBehaviorConfiguration>
  <Password vt="1" />
  <OrderedProcessing vt="11">-1</OrderedProcessing>
  <IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>
  <AffiliateApplicationName vt="8">SampleAffiliateApplication</AffiliateApplicationName>
  <DisableLocationOnFailure vt="11">0</DisableLocationOnFailure>
  <SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>
  <BindingType vt="8">netNamedPipeBinding</BindingType>
  <UserName vt="8">Hello</UserName>
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
  <EndpointBehaviorConfiguration vt="8"><behavior name="EndpointBehavior" /></EndpointBehaviorConfiguration>
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>

Nel frammento di codice riportato di seguito viene illustrato come creare un indirizzo di ricezione WCF-Custom:

// Use BizTalk Explorer object model to create new WCF-Custom receive location
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
string transportConfigData = @"<CustomProps>
  <BindingConfiguration vt=""8""><binding name=""netNamedPipeBinding""><security mode=""None"" /></binding></BindingConfiguration>
  <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 one-way receive port
IReceivePort receivePort = application.AddNewReceivePort(false);
receivePort.Name = "SampleReceivePort";
// Add a new one-way receive location
IReceiveLocation receiveLocation = receivePort.AddNewReceiveLocation();
receiveLocation.Name = "SampleReceiveLocation";
// Find a receive handler for WCF-Custom
int i = 0;
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)
{
    if("WCF-Custom" == explorer.ReceiveHandlers[i].TransportType.Name)
        break;
}
receiveLocation.ReceiveHandler = explorer.ReceiveHandlers[i];
receiveLocation.Address = "net.pipe://mycomputer/samplePipeName";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
receiveLocation.TransportType = explorer.ProtocolTypes["WCF-Custom"];
receiveLocation.TransportTypeData = transportConfigData;
// Save
explorer.SaveChanges();

Vedere anche

Pubblicazione dei metadati del servizio per gli adapter di ricezione WCFche gestiscono host BizTalk e istanze hostCome modificare gli account del servizio e le passwordinstallando i certificati per gli adattatori WCF Specificando il corpo del messaggio per gli adapter WCFConfigurando l'adapter WCF-CustomCome creare un comportamento dell'applicazione<affiliata dei binding endpointBehaviors del comportamento> delle <associazioni di endpointBehaviors><><><Servicebehaviors>