Come configurare un'indirizzo di ricezione WCF-CustomIsolated

È possibile configurare gli indirizzi di ricezione WCF-CustomIsolated a livello di codice o 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 un elenco proprietà di configurazione degli indirizzi di ricezione WCF-CustomIsolated sotto forma di 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. in quanto l'adapter WCF-CustomIsolated utilizza i valori predefiniti per la configurazione dell'indirizzo di ricezione WCF-CustomIsolated come indicato nella tabella riportata di seguito.

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

Come configurare un indirizzo di ricezione WCF-CustomIsolated con la Console di amministrazione BizTalk

È possibile impostare le variabili dell'adapter dell'indirizzo di ricezione WCF-CustomIsolated 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.

Configurare le variabili per un percorso di ricezione WCF-CustomIsolated

1. Se si prevede di utilizzare i punti di estendibilità WCF quali gli elementi di binding personalizzati, l'elemento di comportamento personalizzato e i componenti di canale personalizzati durante la configurazione dell'adapter WCF-CustomIsolated, è necessario aggiungere gli assembly che implementano i punti di estendibilità e tutti gli assembly dipendenti alla Global Assembly Cache nel computer di elaborazione BizTalk (computer di runtime) e 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 WCF CustomIsolated, vedere How to Enable the WCF Extensibility Points with the WCF Adapters.For more information about how to use the WCF extensibility points with the WCF Extensibility Points with the WCF Adapters.

2. Nella console amministrazione BizTalk espandere 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. Nel riquadro sinistro della finestra di dialogo Proprietà porta di ricezione selezionare Percorsi di ricezione e quindi nel riquadro destro fare doppio clic su un percorso di ricezione esistente oppure fare clic su Nuovoper creare una nuova posizione di ricezione.

5. Nella sezione Trasporto accanto a Tipo della finestra di dialogo Proprietà posizione di ricezione selezionare WCF-CustomIsolated nell'elenco a discesa e quindi fare clic su Configura.

6. Nella scheda Generale della finestra di dialogo Proprietà trasporto isolato personalizzato WCF configurare l'indirizzo dell'endpoint e l'identità del servizio per il percorso di ricezione WCF-CustomIsolated. Per altre informazioni sulla scheda Generale nella finestra di dialogo Proprietà trasporto isolato WCF-Custom , vedere la finestra di dialogo Proprietà trasporto WCF-Custom, 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 isolato personalizzato WCF configurare tipi diversi di associazioni predefinite o personalizzate per WCF. Per altre informazioni sulla scheda Binding nella finestra di dialogo Proprietà trasporto isolato WCF-Custom , vedere la finestra di dialogo Proprietà trasporto WCF-Custom, Ricezione, Associazione nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.

8. Nella scheda Comportamento della finestra di dialogo Proprietà trasporto isolato personalizzato WCF configurare i comportamenti dell'endpoint e del servizio per questo percorso 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 isolato WCF-Custom , vedere la finestra di dialogo Proprietà trasporto WCF-Custom, Ricezione, Comportamento nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

9. Nella scheda Altro della finestra di dialogo Proprietà trasporto isolato personalizzato WCF configurare le credenziali da utilizzare per questo percorso di ricezione durante il polling di un servizio esterno e se il percorso di ricezione mantiene l'ordine dei messaggi durante l'elaborazione dei messaggi. Per altre informazioni sulla scheda Altro nella finestra di dialogo Proprietà trasporto isolato WCF-Custom , vedere la finestra di dialogo Proprietà trasporto WCF-Custom, Receive, Other nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

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

11. Nella finestra di dialogo Proprietà trasporto isolato PERSONALIZZATO WCF , nella scheda Importazione/Esportazione importare ed esportare le proprietà Indirizzo (URI) ed Identità endpoint nella scheda Generale , le informazioni sull'associazione nella scheda Binding e il comportamento dell'endpoint nella scheda Comportamento per questo percorso di ricezione. Per altre informazioni sulla scheda Importazione/Esportazione nella finestra di dialogo Proprietà trasporto isolato WCF-Custom , vedere la finestra di dialogo Proprietà trasporto WCF-Custom, Receive, Import-Export nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.

Configurare un percorso di ricezione WCF-CustomIsolated 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="wsHttpBinding" transactionFlow="true"><security><message clientCredentialType="UserName" /></security></binding></BindingConfiguration>
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
  <CredentialType vt="8">None</CredentialType>
  <Identity vt="8" />
  <ServiceBehaviorConfiguration vt="8"><behavior name="SampleServiceBehavior"><serviceAuthorization principalPermissionMode="UseAspNetRoles" /><serviceCredentials><serviceCertificate findValue="539d9ab3089bb6dc187fa7dbb382cf01f8d78f5f" storeLocation="CurrentUser" x509FindType="FindByThumbprint" /></serviceCredentials><serviceMetadata httpGetEnabled="true" /></behavior></ServiceBehaviorConfiguration>
  <OrderedProcessing vt="11">0</OrderedProcessing>
  <IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>
  <AffiliateApplicationName vt="8" />
  <DisableLocationOnFailure vt="11">0</DisableLocationOnFailure>
  <SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>
  <BindingType vt="8">wsHttpBinding</BindingType>
  <UserName vt="8" />
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
  <EndpointBehaviorConfiguration vt="8"><behavior name="EndpointBehavior" /></EndpointBehaviorConfiguration>
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>

Nel frammento di codice seguente viene illustrata la creazione di un indirizzo di ricezione WCF-CustomIsolated:

// Use BizTalk Explorer object model to create new WCF-CustomIsolated 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=""wsHttpBinding"" transactionFlow=""true""><security><message clientCredentialType=""UserName"" /></security></binding></BindingConfiguration>
  <BindingType vt=""8"">wsHttpBinding</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 = "SampleBizTalkApplication1001";
// 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-CustomIsolated
int i = 0;
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)
{
    if("WCF-CustomIsolated" == explorer.ReceiveHandlers[i].TransportType.Name)
        break;
}
receiveLocation.ReceiveHandler = explorer.ReceiveHandlers[i];
receiveLocation.Address = "http://mycomputer/samplepath/sampleservice";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
receiveLocation.TransportType = explorer.ProtocolTypes["WCF-CustomIsolated"];
receiveLocation.TransportTypeData = transportConfigData;
// Save
explorer.SaveChanges();

Vedere anche

Pubblicazione di servizi WCF con gli adapter di ricezione WCF isolati
Gestione di host e istanze host BizTalk
Come modificare account di servizio e password
Installazione di certificati per gli adapter WCF
Specifica del corpo del messaggio per gli adapter WCF
Configurazione dell'adapter WCF-CustomIsolated
Come creare un'applicazione affiliata
<comportamento> degli <endpointBehaviors>
<><comportamento> delle associazioni di <serviceBehaviors>