Konfigurieren eines WCF-CustomIsolated-Empfangsspeicherorts
Sie können einen WCF-CustomIsolated-Empfangsspeicherort entweder programmgesteuert oder über die BizTalk-Verwaltungskonsole konfigurieren.
Konfigurationseigenschaften
Mithilfe des BizTalk-Explorer-Objektmodells können Sie Empfangsspeicherorte programmgesteuert erstellen und konfigurieren. Das BizTalk-Explorer-Objektmodell macht dieIReceiveLocation-Empfangsspeicherortkonfigurationsschnittstelle verfügbar, die über eine TransportTypeData-Lese-/Schreibeigenschaft verfügt. Diese Eigenschaft akzeptiert einen Konfigurationseigenschaftenbehälter für den WCF-CustomIsolated-Empfangsspeicherort in Form eines Name/Wert-Paars aus XML-Zeichenfolgen. Um diese Eigenschaft im BizTalk-Explorer-Objektmodell festzulegen, müssen Sie die InboundTransportLocation-Eigenschaft der IReceiveLocation-Schnittstelle festlegen.
Die TransportTypeData-Eigenschaft der IReceiveLocation-Schnittstelle muss nicht festgelegt werden. Wenn die Eigenschaft nicht festgelegt ist, verwendet der WCF-CustomIsolated-Adapter die Standardwerte für die Konfiguration des WCF-CustomIsolated-Empfangsspeicherorts, die in der folgenden Tabelle aufgeführt sind.
In der folgenden Tabelle sind die Konfigurationseigenschaften aufgelistet, die Sie im Objektmodell von BizTalk-Explorer für den WCF-CustomIsolated-Empfangsspeicherort festlegen können.
| Eigenschaftenname | type | Beschreibung |
|---|---|---|
| Identität | XML-Blob Beispiel: <Identität> <userPrincipalName value="username@contoso.com" /> </Identität> |
Geben Sie die Identität des Diensts an, der von diesem Empfangsspeicherort bereitgestellt wird. Die Werte, die für die Identity-Eigenschaft angegeben werden können, unterscheiden sich je nach Sicherheitskonfiguration. Diese Einstellungen ermöglichen dem Client die Authentifizierung dieses Empfangsspeicherorts. Während des Handshakevorgangs zwischen Client und Dienst stellt die Windows Communication Foundation-Infrastruktur (WCF) sicher, dass die Identität des erwarteten Diensts mit den Werten dieses Elements übereinstimmt. Der Standardwert ist eine leere Zeichenfolge. |
| BindingType | Enumeration - basicHttpBinding - Custombinding - mexHttpBinding - mexHttpsBinding - mexNamedPipeBinding - mexTcpBinding - Netmsmqbinding - Netnamedpipebinding - Netpeertcpbinding - Nettcpbinding - wsDualHttpBinding - wsFederationHttpBinding - wsHttpBinding |
Geben Sie den Bindungstyp für den Endpunkt an, der von diesem Empfangsspeicherort verwendet wird. Hinweis: Wenn Sie eine benutzerdefinierte Bindung verwenden, kann die BindingType-Eigenschaft mit den benutzerdefinierten Bindungen konfiguriert werden. Weitere Informationen zur Verwendung der benutzerdefinierten Bindung finden Sie unter Aktivieren der WCF-Erweiterbarkeitspunkte mit den WCF-Adaptern. Der Standardwert ist eine leere Zeichenfolge. |
| Bindingconfiguration | XML-Blob Beispiel: <binding name="wsHttpBinding" transactionFlow="true"><sicherheitsmeldung><clientCredentialType="UserName" /></security></binding> |
Geben Sie eine XML-Zeichenfolge mit dem <Bindungselement> an, um verschiedene Typen vordefinierter Bindungen zu konfigurieren, die von Windows Communication Foundation (WCF) bereitgestellt werden. Weitere Informationen zur vom System bereitgestellten Bindung und benutzerdefinierten Bindung finden Sie in den entsprechenden Themen unter Siehe auch. Hinweis: BizTalk Server unterstützt nicht alle Typen der Bindungserweiterungselemente, die Sie mit der BindingConfiguration-Eigenschaft konfigurieren können. Der Standardwert ist eine leere Zeichenfolge. |
| ServiceBehaviorConfiguration | XML-Blob Beispiel: <behavior name="SampleServiceBehavior"><serviceAuthorization principalPermissionMode="UseAspNetRoles" /><serviceCredentials><serviceCertificate findValue="539d9ab3089bb6dc187fa7 dbb382cf01f8d78f5f" storeLocation="CurrentUser" x509FindType="FindByThumbprint" /></serviceCredentials><serviceMetadata httpGetEnabled="true" /></behavior> |
Geben Sie eine XML-Zeichenfolge mit dem <behavior-Element> des <serviceBehaviors-Elements> an, um die Verhaltenseinstellungen eines WCF-Diensts zu konfigurieren. Weitere Informationen zum <serviceBehaviors-Element> finden Sie im entsprechenden Thema unter Siehe auch. Der Standardwert ist eine leere Zeichenfolge. |
| EndpointBehaviorConfiguration | XML-Blob Beispiel: <behavior name="sampleBehavior"><callbackTimeouts /></behavior> |
Geben Sie eine XML-Zeichenfolge mit dem <behavior-Element> des <endpointBehaviors-Elements> an, um die Verhaltenseinstellungen eines WCF-Endpunkts zu konfigurieren. Weitere Informationen zum <endpointBehaviors-Element> finden Sie im entsprechenden Thema unter Siehe auch. Hinweis: BizTalk Server unterstützt nicht alle Typen der Verhaltenserweiterungselemente, die Sie mit der EndpointBehaviorConfiguration-Eigenschaft konfigurieren können. Der Standardwert ist eine leere Zeichenfolge. |
| CredentialType | Enumeration - Keine: Verwenden Sie keine Anmeldeinformationen, wenn dieser Empfangsstandort Aufforderungsnachrichten sendet, um einen externen Dienst abzufragen, oder wenn dieser Empfangsstandort keinen externen Dienst abfragen muss. - IssueTicket: Verwenden Sie Enterprise Single Sign-On (SSO), um Clientanmeldeinformationen abzurufen, um ein SSO-Ticket ausstellen zu können. Diese Option erfordert die Verwendung des Sicherheitsmodus, der es dem Empfangsspeicherort ermöglicht, sich als Benutzerkonto auszugeben, um ein SSO-Ticket bereitzustellen. - UserAccount: Verwenden Sie die Anmeldeinformationen, die in den Eigenschaften Benutzername und Kennwort angegeben sind, wenn dieser Empfangsspeicherort Aufforderungsnachrichten sendet, um einen externen Dienst abzufragen. - GetCredentials: Verwenden Sie die SSO-Partneranwendung, die in der AffiliateApplicationName-Eigenschaft angegeben ist, wenn dieser Empfangsstandort Aufforderungsnachrichten sendet, um einen externen Dienst abzufragen. |
Geben Sie den Typ von Anmeldeinformationen für diesen Empfangsspeicherort an, der beim Abrufen eines externen Diensts verwendet werden soll. Standardwert: None |
| UserName | String | Gibt den Benutzernamen für diesen Empfangsspeicherort an, der beim Abrufen eines externen Diensts zum Abrufen von Antwortnachrichten verwendet werden soll. Diese Eigenschaft ist erforderlich, wenn die CredentialType-Eigenschaft auf UserAccount festgelegt ist. Der Standardwert ist eine leere Zeichenfolge. |
| Kennwort | String | Gibt das Kennwort für diesen Empfangsspeicherort an, der beim Abrufen eines externen Diensts zum Abrufen von Antwortnachrichten verwendet werden soll. Diese Eigenschaft ist erforderlich, wenn die CredentialType-Eigenschaft auf UserAccount festgelegt ist. Der Standardwert ist eine leere Zeichenfolge. |
| AffiliateApplicationName | String | Gibt die SSO-Partneranwendung an, die externe Anmeldeinformationen zurückgibt, die von diesem Empfangsspeicherort beim Senden von Anfragenachrichten zum Abrufen eines externen Diensts verwenden werden. Die angegebene SSO-Partneranwendung muss über eine Zuordnung zwischen dem Windows-Konto, unter dem dieser Empfangsspeicherort ausgeführt wird, und dem Konto für den externen Dienst verfügen. Diese Eigenschaft ist erforderlich, wenn die CredentialType-Eigenschaft auf GetCredentials festgelegt ist. Der Standardwert ist eine leere Zeichenfolge. |
| OrderedProcessing | Boolean | Legen Sie fest, ob die Reihenfolge der Nachrichten bei der Nachrichtenverarbeitung beibehalten werden soll. Standardwert: False |
| InboundBodyLocation | Enumeration - UseBodyElement : Verwenden Sie den Inhalt des SOAP-Body-Elements einer eingehenden Nachricht, um den BizTalk-Nachrichtentextteil zu erstellen. Wenn das Body-Element mehr als ein untergeordnetes Element aufweist, wird nur das erste Element zum BizTalk-Nachrichtentextteil. - UseEnvelope : Erstellen Sie den BizTalk-Nachrichtentextteil aus dem gesamten SOAP-Umschlag einer eingehenden Nachricht. - UseBodyPath : Verwenden Sie den Textpfadausdruck in der InboundBodyPathExpression-Eigenschaft , um den BizTalk-Nachrichtentextteil zu erstellen. Der Textpfadausdruck wird mit dem unmittelbar untergeordneten Element des SOAP-Body-Elements einer eingehenden Nachricht ausgewertet. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. Weitere Informationen zur Verwendung der InboundBodyLocation-Eigenschaft finden Sie unter Angeben des Nachrichtentexts für die WCF-Adapter. |
Geben Sie die Datenauswahl für das SOAP-Body-Element eingehender WCF-Nachrichten an. Standardwert: UseBodyElement |
| InboundBodyPathExpression | String Weitere Informationen zur Verwendung der InboundBodyPathExpression-Eigenschaft finden Sie unter WCF-Adaptereigenschaftenschema und -Eigenschaften. |
Geben Sie den Textpfadausdruck an, um einen bestimmten Teil einer eingehenden Nachricht zu identifizieren, der zur Erstellung des Textteils einer BizTalk-Nachricht verwendet wird. Dieser Textpfadausdruck wird mit dem unmittelbar untergeordneten Element des SOAP-Textknotens einer eingehenden Nachricht ausgewertet. Wenn dieser Textpfadausdruck mehrere Knoten zurückgibt, wird nur der erste Knoten für den Textteil der BizTalk-Nachricht ausgewählt. Diese Eigenschaft ist erforderlich, wenn die InboundBodyLocation-Eigenschaft auf UseBodyPath festgelegt ist. Der Standardwert ist eine leere Zeichenfolge. |
| InboundNodeEncoding | Enumeration - Base64 : Base64-Codierung. - Hex : Hexadezimalcodierung. - Zeichenfolge – Textcodierung – UTF-8. - XML : Die WCF-Adapter erstellen den BizTalk-Nachrichtentext mit der äußeren XML des Knotens, der durch den Textpfadausdruck in InboundBodyPathExpression ausgewählt wird. |
Geben Sie den Codierungstyp an, den der WCF-CustomIsolated Empfangsadapter verwendet, um den Knoten zu decodieren, der durch den in InboundBodyPathExpression angegebenen Textpfadausdruck identifiziert wird. Diese Eigenschaft ist erforderlich, wenn die InboundBodyLocation-Eigenschaft auf UseBodyPath festgelegt ist. Standardwert: XML |
| OutboundBodyLocation | Enumeration - UseBodyElement : Verwenden Sie den BizTalk-Nachrichtentextteil, um den Inhalt des SOAP-Body-Elements für eine ausgehende Antwortnachricht zu erstellen. - UseTemplate : Verwenden Sie die in der OutboundXMLTemplate-Eigenschaft angegebene Vorlage, um den Inhalt des SOAP-Body-Elements für eine ausgehende Antwortnachricht zu erstellen. Weitere Informationen zur Verwendung der OutboundBodyLocation-Eigenschaft finden Sie unter Angeben des Nachrichtentexts für die WCF-Adapter. |
Geben Sie die Datenauswahl für das SOAP-Body-Element ausgehender WCF-Nachrichten an. Diese Eigenschaft gilt nur für Empfangsspeicherorte vom Typ "Anforderungsantwort". Standardwert: UseBodyElement |
| OutboundXMLTemplate | String Weitere Informationen zur Verwendung der OutboundXMLTemplate-Eigenschaft finden Sie unter Angeben des Nachrichtentexts für die WCF-Adapter. |
Geben Sie die XML-formatierte Vorlage für den Inhalt des SOAP-Body-Elements einer ausgehenden Antwortnachricht an. Diese Eigenschaft ist erforderlich, wenn die OutboundBodyLocation-Eigenschaft auf UseTemplate festgelegt ist. Diese Eigenschaft gilt nur für Empfangsspeicherorte vom Typ "Anforderungsantwort". Der Standardwert ist eine leere Zeichenfolge. |
| DisableLocationOnFailure | Boolean | Gibt an, ob der Empfangsspeicherort, an dem bei der Eingangsverarbeitung ein Fehler in der Empfangspipeline oder beim Weiterleiten aufgetreten ist, deaktiviert werden soll. Standardwert: False |
| SuspendMessageOnFailure | Boolean | Gibt an, ob Anforderungsnachrichten angehalten werden sollen, bei denen bei der Eingangsverarbeitung ein Fehler in der Empfangspipeline oder beim Weiterleiten aufgetreten ist. Standardwert: True |
| Includeexceptiondetailinfaults | Boolean | Gibt an, ob Informationen zu verwalteten Ausnahmen in die Details der SOAP-Fehler aufgenommen werden sollen, die zum Unterstützen des Debuggens an den Client zurückgegeben werden. Standardwert: False |
| ReferencedBindings | XML-Blob Beispiel: <BindingConfiguration vt="8"> <wsFederationHttpBinding> <binding name="sampleBinding"> <security mode="Message"> <message issuedKeyType="AsymmetricKey"> <issuer address="http://www.contoso.com/samplests" binding="wsFederationHttpBinding" bindingConfiguration="contosoSTSBinding"/> </Nachricht> </Sicherheit> </Bindung> </wsFederationHttpBinding> </BindingConfiguration> <ReferencedBindings vt="8"> <Bindungen> <wsFederationHttpBinding> <binding name="contosoSTSBinding"> <security mode="Message"> <message negotiateServiceCredential="false"> <issuer address=" http://northwind.com/samplests" bindingConfiguration="northwindBinding" binding="wsHttpBinding"></Emittenten> </Nachricht> </Sicherheit> </Bindung> </wsFederationHttpBinding> <wsHttpBinding> <binding name="northwindBinding"> <security mode="Message"> <Message clientCredentialType="Certificate" /> </Sicherheit> </Bindung> </wsHttpBinding> </Bindungen> </ReferencedBindings> Hinweis: Die ReferencedBinding-Eigenschaft darf nicht die Bindungskonfiguration enthalten, die in der BindingConfiguration-Eigenschaft verwendet wird. |
Geben Sie die Bindungskonfigurationen an, auf die das attribut bindingConfiguration des <issuer-Elements> für wsFederationHttpBinding und customBinding verweist, was den Security Token Service (STS) angibt, der Sicherheitstoken ausgibt. Weitere Informationen zum <Ausstellerelement> finden Sie in der <Ausstellerdokumentation> unter Microsoft Learn. Die Bindungsinformationen, einschließlich des <Ausstellerelements> für wsFederationHttpBinding und customBinding , können über die BindingConfiguration-Eigenschaft des WCF-Custom und der WCF-CustomIsolated-Adapter konfiguriert werden. Alle Bindungskonfigurationen, auf die für diese Eigenschaft verwiesen wird, müssen in Form des <bindings-Elements> platziert werden. Hinweis: – Sie können diese Eigenschaft nicht auf der Registerkarte Bindung im Dialogfeld Transporteigenschaften konfigurieren. Sie können diese Eigenschaft über die Registerkarte Importieren/Exportieren im Dialogfeld Transporteigenschaften der WCF-Custom- und WCF-CustomIsolated-Adapter importieren und exportieren. – Das bindingConfiguration-Attribut des <issuer-Elements> muss auf einen gültigen Bindungsnamen in dieser Eigenschaft verweisen. – Das <issuer-Element> in den Bindungskonfigurationen, auf die verwiesen wird, kann auch auf eine andere Bindungskonfiguration in dieser Eigenschaft verweisen, wenn diese Verweiskette keine zirkuläre Abhängigkeit erstellt. Der Standardwert ist eine leere Zeichenfolge. |
Konfigurieren eines WCF-CustomIsolated-Empfangsspeicherorts über die BizTalk Server-Verwaltungskonsole
Sie können die Adaptervariablen für den WCF-CustomIsolated-Empfangsspeicherort in der BizTalk Server-Verwaltungskonsole festlegen. Werden Eigenschaften nicht im Empfangsspeicherort festgelegt, werden die in der BizTalk-Verwaltungskonsole festgelegten Standardwerte des Empfangshandlers verwendet.
Hinweis
Bevor Sie die folgenden Schritte ausführen, müssen Sie bereits einen Empfangsport hinzugefügt haben. Weitere Informationen finden Sie unter Erstellen eines Empfangsports.
Konfigurieren von Variablen für einen WCF-CustomIsolated Empfangsspeicherort
Wenn Sie beim Konfigurieren des WCF-CustomIsolated-Adapters die WCF-Erweiterbarkeitspunkte wie die benutzerdefinierten Bindungselemente, das benutzerdefinierte Verhaltenselement und die benutzerdefinierten Kanalkomponenten verwenden möchten, müssen Sie die Assemblys, mit denen die Erweiterbarkeitspunkte implementiert werden, sowie alle abhängigen Assemblys zum globalen Assemblycache auf dem verarbeitenden BizTalk-Computer (Laufzeitcomputer) und auf dem Verwaltungscomputer hinzufügen. Darüber hinaus müssen Sie die Erweiterungskomponenten in der Datei "machine.config" registrieren. Weitere Informationen zur Verwendung der WCF-Erweiterbarkeitspunkte mit dem WCF CustomIsolated-Adapter finden Sie unter Aktivieren der WCF-Erweiterbarkeitspunkte mit den WCF-Adaptern.
Erweitern Sie in der BizTalk-Verwaltungskonsole BizTalk Server-Verwaltung, BizTalk-Gruppe, Anwendungen und dann die Anwendung, in der Sie einen Empfangsspeicherort erstellen möchten.
Klicken Sie in der BizTalk-Verwaltungskonsole im linken Bereich auf den Knoten Empfangsport . Klicken Sie anschließend im rechten Bereich mit der rechten Maustaste auf den Empfangsport, der einem vorhandenen Empfangsspeicherort zugeordnet ist oder den Sie einem neuen Empfangsspeicherort zuordnen möchten, und klicken Sie dann auf Eigenschaften.
Wählen Sie im Dialogfeld Eigenschaften des Empfangsports im linken Bereich Die Option Empfangsspeicherorte aus, doppelklicken Sie dann im rechten Bereich auf einen vorhandenen Empfangsspeicherort, oder klicken Sie auf Neu, um einen neuen Empfangsspeicherort zu erstellen.
Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts im Abschnitt Transport neben Typ die Option WCF-CustomIsolated aus der Dropdownliste aus, und klicken Sie dann auf Konfigurieren.
Konfigurieren Sie im Dialogfeld WCF-CustomIsolated Transport Properties auf der Registerkarte Allgemein die Endpunktadresse und die Dienstidentität für den WCF-CustomIsolated Empfangsspeicherort. Weitere Informationen zur Registerkarte Allgemein im Dialogfeld WCF-CustomIsolated Transport Properties finden Sie im Dialogfeld WCF-CustomIsolated Transport Properties (WCF-Custom Transport Properties Dialog Box, Registerkarte Empfangen, Allgemein ) in der Referenz zu Benutzeroberflächenleitfaden und ENTWICKLER-API-Namespace.
Konfigurieren Sie im Dialogfeld WCF-CustomIsolated Transport Properties auf der Registerkarte Bindung verschiedene Typen von vordefinierten oder benutzerdefinierten Bindungen für WCF. Weitere Informationen zur Registerkarte Bindung im Dialogfeld WCF-CustomIsolated Transport Properties finden Sie im Dialogfeld WCF-CustomIsolated Transport Properties (WCF-Benutzerdefinierte Transporteigenschaften), auf der Registerkarte Empfangen, Bindung in der Referenz zur Benutzeroberflächenanleitung und im API-Namespace für Entwickler.
Konfigurieren Sie im Dialogfeld WCF-CustomIsolated Transport Properties auf der Registerkarte Verhalten den Endpunkt und das Dienstverhalten für diesen Empfangsspeicherort. Das Endpunktverhalten ist ein Satz von Verhaltenserweiterungselementen, die die Dienst- oder Clientfunktionalität ändern oder erweitern. Weitere Informationen zur Registerkarte Verhalten im Dialogfeld WCF-CustomIsolated Transport Properties (WCF-CustomIsolated Transport Properties) finden Sie im Dialogfeld WCF-Benutzerdefinierte Transporteigenschaften, auf der Registerkarte Empfangen, Verhalten in der Referenz zu UI-Anleitungen und Entwickler-API-Namespace.
Konfigurieren Sie im Dialogfeld WCF-CustomIsolated Transport Properties auf der Registerkarte Andere , welche Anmeldeinformationen für diesen Empfangsspeicherort beim Abfragen eines externen Diensts verwendet werden sollen, und ob dieser Empfangsspeicherort die Nachrichtenreihenfolge beim Verarbeiten von Nachrichten beibewahrt. Weitere Informationen zur Registerkarte Andere im Dialogfeld WCF-CustomIsolated Transport Properties finden Sie im Dialogfeld WCF-CustomIsolated Transport Properties (WCF-Benutzerdefinierte Transporteigenschaften) im Dialogfeld "WCF-Custom Transport Properties", "Empfangen", "Andere " in der Referenz "Ui-Leitfaden" und "Entwickler-API-Namespace".
Geben Sie im Dialogfeld WCF-CustomIsolated Transport Properties auf der Registerkarte Nachrichten die Datenauswahl für das SOAP-Body-Element an. Weitere Informationen zur Registerkarte Nachrichten im Dialogfeld WCF-CustomIsolated Transport Properties finden Sie im Dialogfeld WCF-CustomIsolated Transport Properties (WCF-Custom Transport Properties Dialogfeld), auf der Registerkarte Empfangen, Nachrichten in der Referenz zu Benutzeroberflächenleitfaden und API-Namespace für Entwickler.
Importieren und exportieren Sie im Dialogfeld WCF-CustomIsolated Transport Properties auf der Registerkarte Import/Export die Eigenschaften Address (URI) und Endpoint Identity auf der Registerkarte Allgemein , Bindungsinformationen auf der Registerkarte Bindung und Endpunktverhalten auf der Registerkarte Verhalten für diesen Empfangsspeicherort. Weitere Informationen zur Registerkarte Import/Export im Dialogfeld WCF-CustomIsolated Transport Properties (WCF-CustomIsolated Transport Properties) finden Sie im Dialogfeld WCF-Benutzerdefinierte Transporteigenschaften, auf der Registerkarte Empfangen, Importieren/Exportieren in der Referenz zu UI-Anleitung und API-Namespace für Entwickler.
Programmgesteuertes Konfigurieren eines WCF-CustomIsolated Empfangsspeicherorts
Sie können das folgende Format verwenden, um die Eigenschaften festzulegen:
<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>
Anhand des folgenden Codefragments wird die Erstellung eines WCF-CustomIsolated-Empfangsspeicherorts veranschaulicht:
// 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();
Weitere Informationen
Veröffentlichen von WCF-Diensten mit den isolierten WCF-Empfangsadaptern
Verwalten von BizTalk-Hosts und -Hostinstanzen
Ändern von Dienstkonten und Kennwörtern
Installieren von Zertifikaten für die WCF-Adapter
Angeben des Nachrichtentexts für die WCF-Adapter
Konfigurieren des WCF-CustomIsolated-Adapters
Erstellen einer Partneranwendung
<Verhalten> von <endpointBehaviors>
<Bindungsverhalten><> von <serviceBehaviors>