Programmgesteuertes Erstellen des Empfangsspeicherorts oder -Sendeports
Konfigurieren Sie einen WCF-BasicHttp Den Speicherort empfangen und den Port programmgesteuert senden. Informationen zur Verwendung der BizTalk-Verwaltungskonsole finden Sie unter WCF-BasicHttp-Adapter.
Programmgesteuertes Konfigurieren des Empfangsspeicherorts
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 jeweiligen WCF-BasicHttp-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. Ist die Eigenschaft nicht festgelegt, verwendet der WCF-BasicHttp-Adapter die Standardwerte für die Konfiguration des WCF-BasicHttp-Empfangsspeicherorts, die in der folgenden Tabelle aufgeführt sind.
Das folgende Codefragment veranschaulicht das Erstellen eines WCF-BasicHttp Empfangsspeicherorts mithilfe des BizTalk-Explorer-Objektmodells:
// Use BizTalk Explorer object model to create new WCF-BasicHttp 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>
<InboundBodyLocation vt=""8"">UseBodyElement</InboundBodyLocation>
<UseSSO vt=""11"">0</UseSSO>
<Identity vt=""8"">
<identity>
<userPrincipalName value=""username@contoso.com"" />
</identity>
</Identity>
</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-BasicHttp
int i = 0;
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)
{
if("WCF-BasicHttp" == explorer.ReceiveHandlers[i].TransportType.Name)
break;
}
receiveLocation.ReceiveHandler = explorer.ReceiveHandlers[i];
receiveLocation.Address = "/samplepath/sampleservice.svc";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
receiveLocation.TransportType = explorer.ProtocolTypes["WCF-BasicHttp"];
receiveLocation.TransportTypeData = transportConfigData;
// Save
explorer.SaveChanges();
Sie können das folgende Format verwenden, um die Eigenschaften in <CustomProps>festzulegen:
<CustomProps>
<ServiceCertificate vt="8" />
<InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
<UseSSO vt="11">0</UseSSO>
<MessageClientCredentialType vt="8">UserName</MessageClientCredentialType>
<InboundBodyPathExpression vt="8" />
<SendTimeout vt="8">00:01:00</SendTimeout>
<OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
<OpenTimeout vt="8">00:01:00</OpenTimeout>
<Identity vt="8">
<identity>
<userPrincipalName value="username@contoso.com" />
</identity>
</Identity>
<AlgorithmSuite vt="8">Basic256</AlgorithmSuite>
<SecurityMode vt="8">None</SecurityMode>
<TransportClientCredentialType vt="8">None</TransportClientCredentialType>
<MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
<TextEncoding vt="8">utf-8</TextEncoding>
<CloseTimeout vt="8">00:01:00</CloseTimeout>
<SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>
<InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
<IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>
<MaxConcurrentCalls vt="3">16</MaxConcurrentCalls>
<MessageEncoding vt="8">Text</MessageEncoding>
<OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>
In der folgenden Tabelle sind die Konfigurationseigenschaften aufgeführt, die Sie für den 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. |
| OpenTimeout | System.TimeSpan | Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Öffnen eines Kanals zur Verfügung steht. Standardwert: 00:01:00 |
| SendTimeout | System.TimeSpan | Legt einen Wert für den Zeitraum fest, der bis zum Abschluss eines Sendevorgangs zur Verfügung steht. Wenn Sie einen Empfangsport vom Typ "Anforderungsantwort" verwenden, gibt dieser Wert den Zeitraum an, in dem die gesamte Interaktion auch dann abgeschlossen sein muss, wenn vom Client eine umfangreiche Nachricht zurückgegeben wird. Standardwert: 00:01:00 |
| CloseTimeout | System.TimeSpan | Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Schließen eines Kanals zur Verfügung steht. Standardwert: 00:01:00 |
| Maxreceivedmessagesize | Integer | Gibt die Maximalgröße in Bytes für Nachrichten einschließlich der Header an, die über das Netzwerk empfangen werden können. Die Nachrichtengröße wird durch den für jede Nachricht reservierten Arbeitsspeicher begrenzt. Sie können diese Eigenschaft verwenden, um das Risiko für Denial-of-Service-Angriffe (DoS-Angriffe) einzuschränken. Der WCF-BasicHttp-Adapter nutzt die BasicHttpBinding-Klasse im gepufferten Übertragungsmodus, um mit einem Endpunkt zu kommunizieren. Für den gepufferten Transportmodus ist die BasicHttpBinding.MaxBufferSize-Eigenschaft immer gleich dem Wert dieser Eigenschaft. Standardwert: 65536 |
| MessageEncoding | Enumeration - Text : Verwenden Sie einen Textnachrichtenencoder. - Mtom : Verwenden Sie einen MTOM-Encoder (Message Transmission Optimization Mechanism 1.0). |
Hier geben Sie den Encoder an, der zum Codieren der SOAP-Nachricht verwendet werden soll. Standardwert: Text |
| TextCodierung | Enumeration - unicodeFFF : Unicode BigEndian-Codierung. - utf-16 – 16-Bit-Codierung. - utf-8 – 8-Bit-Codierung |
Geben Sie die Zeichensatzcodierung an, die zum Senden von Nachrichten in der Bindung verwendet werden soll, wenn die MessageEncoding-Eigenschaft auf Text festgelegt ist. Standardwert: utf-8 |
| MaxConcurrentCalls | Integer | Gibt die Anzahl gleichzeitiger Aufrufe für eine einzelne Dienstinstanz an. Aufrufe, die diese Grenze überschreiten, werden in die Warteschlange eingereiht. Der Bereich dieser Eigenschaft liegt zwischen 1 und Int32.MaxValue. Standardwert: 200 |
| Securitymode | Enumeration - Keine - Nachricht - Transport - Transportwithmessagecredential - TransportCredentialOnly Weitere Informationen zu den Membernamen für die SecurityMode-Eigenschaft finden Sie unter Der Eigenschaft Sicherheitsmodus im Dialogfeld WCF-BasicHttp-Transporteigenschaften, Auf der Registerkarte Empfangen, Sicherheit in der Referenz zu BENUTZERoberflächenleitfaden und API-Namespace für Entwickler. |
Gibt den verwendeten Sicherheitstyp an. Standardwert: None |
| TransportClientCredentialType | Weitere Informationen zu den Membernamen für die TransportClientCredentialType-Eigenschaft finden Sie in der Eigenschaft Transportclientanmeldeinformationstyp im Dialogfeld WCF-BasicHttp Transport Properties, Auf der Registerkarte Empfangen, Sicherheit in der Referenz zur Benutzeroberflächenanleitung und entwickler-API-Namespacereferenz. | Gibt den Typ der Anmeldeinformationen für die Clientauthentifizierung an. Standardwert: None |
| MessageClientCredentialType | Enumeration - Nutzername - Zertifikat Weitere Informationen zu den Membernamen für die MessageClientCredentialType-Eigenschaft finden Sie in der Eigenschaft Nachrichtenclient-Anmeldeinformationstyp im Dialogfeld WCF-BasicHttp Transport Properties, Auf der Registerkarte Empfangen, Sicherheit in der Referenz zur Benutzeroberflächenanleitung und entwickler-API-Namespacereferenz.For more information about the member names for the MessageClientCredentialType property, the Message client credential type in WCF-BasicHttp Transport Properties Dialog Box, Registerkarte Receive, Security in the UI guidance and developers API namespace reference. |
Gibt den Typ der Anmeldeinformationen an, der für die Clientauthentifizierung mit nachrichtenbasierter Sicherheit verwendet werden soll. Standardwert: Benutzername |
| AlgorithmSuite | Enumeration Weitere Informationen zu den Membernamen für die AlgorithmSuite-Eigenschaft finden Sie unter der AlgorithmSuite-Eigenschaft im Dialogfeld WCF-BasicHttp Transport Properties, auf der Registerkarte Empfangen, Sicherheit in der Referenz zur Benutzeroberflächenanleitung und entwickler-API-Namespacereferenz. |
Legt Nachrichtenverschlüsselung und Schlüsselverpackungsalgorithmen fest. Diese Algorithmen sind den Algorithmen in der Spezifikation der Sicherheitsrichtliniensprache (WS-SecurityPolicy) zugeordnet. Standardwert: Basic256 |
| ServiceCertificate | String | Gibt den Fingerabdruck des X.509-Zertifikats für diesen Empfangsspeicherort an, mit dem die Clients den Dienst authentifizieren. Das Zertifikat, das für diese Eigenschaft verwendet werden soll, muss im Speicher "Mein " am Speicherort "Aktueller Benutzer" installiert werden. Hinweis: Sie müssen das Dienstzertifikat im Aktuellen Benutzerspeicherort des Benutzerkontos für den Empfangshandler installieren, der diesen Empfangsspeicherort hostt. Der Standardwert ist eine leere Zeichenfolge. |
| UseSSO | Boolean | Geben Sie an, ob Clientanmeldeinformationen für das Ausstellen eines SSO-Tickets mithilfe von Einmaliges Anmelden für Unternehmen (Single Sign-On, SSO) abgerufen werden sollen. Weitere Informationen zu den Sicherheitskonfigurationen, die einmaliges Anmelden unterstützen, finden Sie im Abschnitt "Enterprise Single Sign-On Supportability for the WCF-BasicHttp Receive Adapter" im WCF-BasicHttp Transport Properties Dialog Box, Receive, Registerkarte Sicherheit in der Referenz zur Benutzeroberflächenleitfaden und Entwickler-API-Namespacereferenz. 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-BasicHttp 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. |
| 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: False |
| 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 |
Programmgesteuertes Konfigurieren des Sendeports
Das folgende Codefragment veranschaulicht das Erstellen eines WCF-BasicHttp Sendeports mithilfe des BizTalk-Explorer-Objektmodells:
// Use BizTalk Explorer object model to create new WCF-BasicHttp 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>
<MessageEncoding vt=""8"">Text</MessageEncoding>
<TextEncoding vt=""8"">utf-8</TextEncoding>
<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-BasicHttp"];
sendPort.PrimaryTransport.Address = "http://mycomputer/samplepath";
sendPort.PrimaryTransport.TransportTypeData = transportConfigData; // propertyData; // need to change
sendPort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];
// Save
explorer.SaveChanges();
Sie können das folgende Format verwenden, um die Eigenschaften in <CustomProps>festzulegen:
<CustomProps>
<ServiceCertificate vt="8" />
<InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
<UseSSO vt="11">0</UseSSO>
<MessageClientCredentialType vt="8">UserName</MessageClientCredentialType>
<InboundBodyPathExpression vt="8" />
<SendTimeout vt="8">00:01:00</SendTimeout>
<OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
<OpenTimeout vt="8">00:01:00</OpenTimeout>
<AlgorithmSuite vt="8">Basic256</AlgorithmSuite>
<SecurityMode vt="8">None</SecurityMode>
<TransportClientCredentialType vt="8">None</TransportClientCredentialType>
<ClientCertificate vt="8" />
<ProxyUserName vt="8" />
<MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
<TextEncoding vt="8">utf-8</TextEncoding>
<StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>
<CloseTimeout vt="8">00:01:00</CloseTimeout>
<ProxyToUse vt="8">Default</ProxyToUse>
<InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
<PropagateFaultMessage vt="11">-1</PropagateFaultMessage>
<ProxyAddress vt="8" />
<MessageEncoding vt="8">Text</MessageEncoding>
<OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>
In der folgenden Tabelle sind die Konfigurationseigenschaften aufgeführt, die Sie für den Sendeport festlegen können:
| Eigenschaftenname | type | BESCHREIBUNG |
|---|---|---|
| Securitymode | Enumeration - Keine - Nachricht - Transport - Transportwithmessagecredential - TransportCredentialOnly Weitere Informationen zu den Membernamen für die SecurityMode-Eigenschaft finden Sie unter Der Eigenschaft Sicherheitsmodus im Dialogfeld WCF-BasicHttp Transport Properties, Auf der Registerkarte Senden, Sicherheit in der Referenz zur Benutzeroberflächenleitfaden und Entwickler-API-Namespacereferenz. |
Gibt den verwendeten Sicherheitstyp an. Standardwert: None |
| MessageClientCredentialType | Enumeration - Nutzername - Zertifikat Weitere Informationen zu den Membernamen für die MessageClientCredentialType-Eigenschaft finden Sie in der Eigenschaft Nachrichtenclient-Anmeldeinformationstyp im Dialogfeld WCF-BasicHttp Transport Properties, auf der Registerkarte Senden, auf der Registerkarte Sicherheit in der Referenz zu UI-Anleitungen und Api-Namespace für Entwickler. |
Gibt den Typ der Anmeldeinformationen an, der für die Clientauthentifizierung mit nachrichtenbasierter Sicherheit verwendet werden soll. Standardwert: Benutzername |
| TransportClientCredentialType | Enumeration - Keine - Basic - Windows - Zertifikat - Digest - Ntlm Weitere Informationen zu den Membernamen für die TransportClientCredentialType-Eigenschaft finden Sie in der Eigenschaft Transportclientanmeldeinformationstyp im Dialogfeld WCF-BasicHttp Transport Properties, auf der Registerkarte Senden, auf der Registerkarte Sicherheit in der Referenz zu ui-Anleitungen und API-Namespace für Entwickler. |
Legt den Typ der Anmeldeinformationen für die Sendeportauthentifizierung fest. Standardwert: None |
| UserName | String | Geben Sie den Benutzernamen an, der für die Authentifizierung mit dem Zielserver verwendet werden soll, wenn die UseSSO-Eigenschaft auf False festgelegt ist. Für diese Eigenschaft muss nicht das Format Domäne\Benutzer verwendet werden. Der Standardwert ist eine leere Zeichenfolge. |
| Kennwort | String | Geben Sie das Kennwort an, das für die Authentifizierung beim Zielserver verwendet werden soll, wenn die UseSSO-Eigenschaft auf False festgelegt ist. Der Standardwert ist eine leere Zeichenfolge. |
| AffiliateApplicationName | String | Gibt die Partneranwendung für Einmaliges Anmelden für Unternehmen (SSO) an. Der Standardwert ist eine leere Zeichenfolge. |
| UseSSO | Boolean | Geben Sie an, ob Clientanmeldeinformationen für die Authentifizierung am Zielserver mittels Einmaligem Anmelden abgerufen werden sollen. Standardwert: False |
| ClientCertificate | String | Geben Sie den Fingerabdruck des X.509-Zertifikats für die Authentifizierung dieses Sendeports gegenüber Diensten an. Diese Eigenschaft ist erforderlich, wenn die ClientCredentialsType-Eigenschaft auf Certificate festgelegt ist. Das für diese Eigenschaft zu verwendende Zertifikat muss im Speicher "Mein Speicher" am Speicherort "Aktueller Benutzer " installiert werden. Der Standardwert ist eine leere Zeichenfolge. |
| ServiceCertificate | String | Legt den Fingerabdruck des X.509-Zertifikats für die Authentifizierung des Diensts fest, an den dieser Sendeport Nachrichten sendet. Das zertifikat, das für diese Eigenschaft verwendet werden soll, muss im Speicher Andere Personen am Lokalen Computerspeicher installiert werden. Der Standardwert ist eine leere Zeichenfolge. |
| ProxyToUse | Enumeration - Keine : Verwenden Sie keinen Proxyserver für diesen Sendeport. - Standard: Verwenden Sie die Proxyeinstellungen im Sendehandler, der diesen Sendeport hosten soll. - UserSpecified: Verwenden Sie den in der ProxyAddress-Eigenschaft angegebenen Proxyserver. |
Geben Sie an, welcher Proxyserver für ausgehenden HTTP-Datenverkehr verwendet werden soll. Standardwert: None |
| ProxyAddress | String | Geben Sie die Adresse des Proxyservers an. Verwenden Sie je nach Sicherheitskonfiguration das HTTPS- oder HTTP-Schema. Nach dieser Adresse kann ein Doppelpunkt und eine Portnummer stehen. Beispiel: http://127.0.0.1:8080. Der Standardwert ist eine leere Zeichenfolge. |
| ProxyUserName | String | Geben Sie den Benutzernamen für den Proxy an. Der WCF-BasicHttp-Adapter nutzt basicHttpBinding im gepufferten Übertragungsmodus, um mit einem Endpunkt zu kommunizieren. Proxyanmeldeinformationen von BasicHttpBinding sind nur anwendbar, wenn der Sicherheitsmodus Transport, None oder TransportCredentialOnly lautet. Wenn Sie die SecurityMode-Eigenschaft auf Message oder TransportWithMessageCredential festlegen, verwendet der WCF-BasicHttp-Adapter nicht die in den Eigenschaften ProxyUserName und ProxyPassword angegebenen Anmeldeinformationen für die Authentifizierung für den Proxy. Hinweis: Der WCF-BasicHttp Sendeadapter verwendet die Standardauthentifizierung für den Proxy. Der Standardwert ist eine leere Zeichenfolge. |
| ProxyPassword | String | Geben Sie das Kennwort für den Proxy an. Der Standardwert ist eine leere Zeichenfolge. |
| 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. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. - 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 anhand des unmittelbar untergeordneten Elements 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 |
| OutboundBodyLocation | Enumeration - UseBodyElement : Verwenden Sie den BizTalk-Nachrichtentextteil, um den Inhalt des SOAP-Body-Elements für eine ausgehende Nachricht zu erstellen. - UseTemplate : Verwenden Sie die Vorlage in der OutboundXMLTemplate-Eigenschaft , um den Inhalt des SOAP-Body-Elements für eine ausgehende Nachricht 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. Standardwert: UseBodyElement |
| InboundBodyPathExpression | String Weitere Informationen zur Verwendung der InboundBodyPathExpression-Eigenschaft finden Sie unter WCF Adapters Property Schema and Properties.For more information about how to use the InboundBodyPathExpression property, see WCF Adapters Property Schema and Properties. |
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 anhand des unmittelbar untergeordneten Elements 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. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. Der Standardwert ist eine leere Zeichenfolge. |
| 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 Nachricht an. Diese Eigenschaft ist erforderlich, wenn die OutboundBodyLocation-Eigenschaft auf UseTemplate festgelegt ist. Der Standardwert ist eine leere Zeichenfolge. |
| InboundNodeEncoding | Enumeration - Base64 – Base64-Codierung. - Hexadezimalcodierung : Hexadezimalcodierung. - Zeichenfolge – Textcodierung – UTF-8 - XML : Die WCF-Adapter erstellen den BizTalk-Nachrichtentext mit dem äußeren XML des Knotens, der durch den Textpfadausdruck in InboundBodyPathExpression ausgewählt wurde. |
Geben Sie den Codierungstyp an, den der WCF-BasicHttp Sendeadapter 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. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. Standardwert: XML |
| StaticAction | String | Geben Sie das SOAPAction-HTTP-Headerfeld für ausgehende Nachrichten an. Diese Eigenschaft kann auch über die Nachrichtenkontexteigenschaft WCF festgelegt werden . Aktion in einer Pipeline oder Orchestrierung. Sie können diesen Wert auf zwei verschiedene Arten angeben: das einzelne Aktionsformat und das Aktionszuordnungsformat. Wenn Sie diese Eigenschaft im Einzelaktionsformat festlegen, z. B. , http://contoso.com/Svc/Op1wird der SOAPAction-Header für ausgehende Nachrichten immer auf den in dieser Eigenschaft angegebenen Wert festgelegt.Wenn Sie diese Eigenschaft im Aktionszuordnungsformat festlegen, wird der ausgehende SOAPAction-Header vom BTS bestimmt. Vorgangskontexteigenschaft . Wenn diese Eigenschaft beispielsweise auf das folgende XML-Format und das BTS festgelegt ist. Die Operation-Eigenschaft ist auf Op1 festgelegt, die der WCF-Sendeadapter für den ausgehenden SOAPAction-Header verwendet http://contoso.com/Svc/Op1.<BtsActionMapping> <Vorgangsname="Op1" Action="http://contoso.com/Svc/Op1" /> <Vorgangsname="Op2" Action="http://contoso.com/Svc/Op2" /> </BtsActionMapping> Wenn ausgehende Nachrichten von einem Orchestrierungsport stammen, legen Orchestrierungsinstanzen den BTS dynamisch fest. Operation-Eigenschaft mit dem Vorgangsnamen des Ports. Wenn ausgehende Nachrichten mit inhaltsbasiertem Routing weitergeleitet werden, können Sie btS festlegen. Vorgangseigenschaft in Pipelinekomponenten. Der Standardwert ist eine leere Zeichenfolge. |
| Maxreceivedmessagesize | Integer | Gibt die Maximalgröße in Bytes für Nachrichten einschließlich der Header an, die über das Netzwerk empfangen werden können. Die Nachrichtengröße wird durch den für jede Nachricht reservierten Arbeitsspeicher begrenzt. Sie können diese Eigenschaft verwenden, um das Risiko für Denial-of-Service-Angriffe (DoS-Angriffe) einzuschränken. Der WCF-BasicHttp-Adapter nutzt die BasicHttpBinding-Klasse im gepufferten Übertragungsmodus, um mit einem Endpunkt zu kommunizieren. Für den gepufferten Transportmodus ist die BasicHttpBinding.MaxBufferSize-Eigenschaft immer gleich dem Wert dieser Eigenschaft. Standardwert: 65.536 |
| MessageEncoding | Enumeration - Text : Verwenden Sie einen Textnachrichtenencoder. - Mtom : Verwenden Sie einen MTOM-Encoder (Message Transmission Organization Mechanism 1.0). |
Hier geben Sie den Encoder an, der zum Codieren der SOAP-Nachricht verwendet werden soll. Standardwert: Text |
| TextCodierung | Enumeration - unicodeFFF : Unicode BigEndian-Codierung. - utf-16 – 16-Bit-Codierung. - utf-8 – 8-Bit-Codierung |
Geben Sie die Zeichensatzcodierung an, die zum Senden von Nachrichten in der Bindung verwendet werden soll, wenn die MessageEncoding-Eigenschaft auf Text festgelegt ist. Standardwert: utf-8 |
| SendTimeout | System.TimeSpan | Legt einen Wert für den Zeitraum fest, der bis zum Abschluss eines Sendevorgangs zur Verfügung steht. Wenn Sie einen Sendeport vom Typ "Antwort anfragen" verwenden, gibt dieser Wert den Zeitraum an, in dem die gesamte Interaktion abgeschlossen sein muss, auch wenn eine umfangreiche Nachricht vom Dienst zurückgegeben wird. Standardwert: 00:01:00 |
| OpenTimeout | System.TimeSpan | Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Öffnen eines Kanals zur Verfügung steht. Standardwert: 00:01:00 |
| CloseTimeout | System.TimeSpan | Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Schließen eines Kanals zur Verfügung steht. Standardwert: 00:01:00 |
| AlgorithmSuite | Enumeration Weitere Informationen zu den Membernamen für die AlgorithmSuite-Eigenschaft finden Sie unter der AlgorithmSuite-Eigenschaft im Dialogfeld WCF-BasicHttp Transport Properties, Auf der Registerkarte Senden, Sicherheit in der Referenz zu UI-Anleitungen und Entwickler-API-Namespace. |
Legt Nachrichtenverschlüsselung und Schlüsselverpackungsalgorithmen fest. Diese Algorithmen sind den Algorithmen in der Spezifikation der Sicherheitsrichtliniensprache (WS-SecurityPolicy) zugeordnet. Standardwert : Basic256 |
| Identität | XML-Blob Beispiel: <Identität> <userPrincipalName value="username@contoso.com" /> </Identität> |
Gibt die Identität des Diensts an, der von diesem Sendeport erwartet wird. Diese Einstellungen ermöglichen dem Sendeport die Authentifizierung dieses Diensts. 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. |
| PropagateFaultMessage | Boolean - True : Leiten Sie die Nachricht, die bei der ausgehenden Verarbeitung fehlschlägt, an eine abonnierende Anwendung (z. B. einen anderen Empfangsport oder einen Orchestrierungszeitplan) weiter. - False : Anhalten fehlerhafter Nachrichten und Generieren einer negativen Bestätigung (NACK). |
Geben Sie an, ob Nachrichten, die bei der Ausgangsverarbeitung nicht verarbeitet wurden, weitergeleitet oder angehalten werden sollen. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. Standardwert: True |
Weitere Informationen
Was sind die WCF-Adapter?Veröffentlichen von WCF-Diensten mit den isolierten WCF-EmpfangsadapternKonfigurieren von IIS für isolierte WCF-EmpfangsadapterVerwalten von BizTalk-Hosts und HostinstanzenÄndern von Dienstkonten und KennwörternInstallieren von Zertifikaten für die WCF-AdapterAngeben des Nachrichtentexts für die WCF-AdapterWCF-Adaptereigenschaften und EigenschaftenKonfigurieren dynamischer Sendeports mithilfe von WCF-Adapterkontexteigenschaften