Crear la ubicación de recepción o puerto de envío mediante programación
Configure una ubicación de recepción WCF-BasicHttp y envíe el puerto mediante programación. Para usar la consola de administración de BizTalk, vea Adaptador WCF-BasicHttp.
Configuración de la ubicación de recepción mediante programación
El modelo de objetos del Explorador de BizTalk permite crear y configurar ubicaciones de recepción mediante programación. El modelo de objetos del Explorador de BizTalk expone la interfaz de configuración de ubicación de recepciónIReceiveLocation que tiene una propiedad transportTypeData de lectura y escritura. Esta propiedad acepta una bolsa de propiedades de configuración de ubicación de recepción WCF-BasicHttp con formato de un par de nombre y valor de cadenas XML. Para establecer esta propiedad en el modelo de objetos del Explorador de BizTalk, debe establecer la propiedad InboundTransportLocation de la interfaz IReceiveLocation .
No es necesario establecer la propiedad TransportTypeData de la interfaz IReceiveLocation . Si no se establece, el adaptador de WCF-BasicHttp usa los valores predeterminados para la configuración de la ubicación de recepción WCF-BasicHttp, como se indica en la siguiente tabla.
En el fragmento de código siguiente se muestra cómo crear una ubicación de recepción de WCF-BasicHttp mediante el modelo de objetos del Explorador de BizTalk:
// 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();
Puede usar el siguiente formato para establecer las propiedades en <CustomProps>:
<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>
En la tabla siguiente se enumeran las propiedades de configuración que puede establecer para la ubicación de recepción:
| Nombre de propiedad | Tipo | Descripción |
|---|---|---|
| Identidad | Blob XML Ejemplo: <identity> <userPrincipalName value="username@contoso.com" /> </Identidad> |
Especificar la identidad de servicio que proporciona esta ubicación de recepción. Los valores que se pueden especificar para la propiedad Identity difieren según la configuración de seguridad. Esta configuración hace posible que el cliente autentique la ubicación de recepción. En el proceso de negociación entre el cliente y el servicio, la infraestructura de Windows Communication Foundation (WCF) asegurará que la identidad del servicio esperado coincide con los valores de este elemento. El valor predeterminado es una cadena vacía. |
| OpenTimeout | System.TimeSpan | Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de apertura del canal. Valor predeterminado: 00:01:00 |
| SendTimeout | System.TimeSpan | Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de envío. Si usa un puerto de recepción solicitud-respuesta, este valor especifica un marco temporal para que se complete la interacción, incluso cuando el cliente devuelva un mensaje grande. Valor predeterminado: 00:01:00 |
| CloseTimeout | System.TimeSpan | Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de cierre del canal. Valor predeterminado: 00:01:00 |
| MaxReceivedMessageSize | Entero | Especificar el tamaño máximo, en bytes, para mensajes (con encabezados incluidos) que se pueden recibir a través de la red. El tamaño de los mensajes se limita mediante la cantidad de memoria asignada a cada mensaje. Puede usar esta propiedad para limitar la exposición a ataques por denegación de servicio (DoS). El adaptador de WCF-BasicHttp aprovecha la clase BasicHttpBinding en el modo de transferencia almacenada en búfer para comunicarse con un punto de conexión. Para el modo de transporte almacenado en búfer, la propiedad BasicHttpBinding.MaxBufferSize siempre es igual al valor de esta propiedad. Valor predeterminado: 65536 |
| MessageEncoding | Enumeración - Texto : use un codificador de mensajes de texto. - Mtom : use un codificador de optimización de transmisión de mensajes 1.0 (MTOM). |
Especificar el codificador que se usa para codificar el mensaje SOAP. Valor predeterminado: Texto |
| TextEncoding | Enumeración - unicodeFFF : codificación BigEndian de Unicode. - utf-16 : codificación de 16 bits. - utf-8 : codificación de 8 bits |
Especifique la codificación del juego de caracteres que se usará para emitir mensajes en el enlace cuando la propiedad MessageEncoding esté establecida en Text. Valor predeterminado: utf-8 |
| MaxConcurrentCalls | Entero | Especificar el número de llamadas concurrentes en una instancia de servicio única. Las llamadas que superan el límite se ponen en cola. El intervalo de esta propiedad es de 1 a Int32.MaxValue. Valor predeterminado: 200 |
| SecurityMode | Enumeración - Ninguno - Mensaje - Transporte - TransportWithMessageCredential - TransportCredentialOnly Para obtener más información sobre los nombres de miembro de la propiedad SecurityMode , vea la propiedad Modo de seguridad en el cuadro de diálogo Propiedades de transporte WCF-BasicHttp, Recepción, Seguridad de la guía de la interfaz de usuario y referencia del espacio de nombres de api de desarrolladores. |
Especificar el tipo de seguridad que se usa. Valor predeterminado: None |
| TransportClientCredentialType | Para obtener más información sobre los nombres de miembro de la propiedad TransportClientCredentialType , vea la propiedad Tipo de credencial de cliente de transporte en el cuadro de diálogo Propiedades de transporte WCF-BasicHttp, Recepción, Seguridad de la guía de la interfaz de usuario y referencia del espacio de nombres de la API de desarrolladores. | Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación del cliente. Valor predeterminado: None |
| MessageClientCredentialType | Enumeración - Nombre de usuario - Certificado Para obtener más información sobre los nombres de miembro de la propiedad MessageClientCredentialType , vea la propiedad Tipo de credencial de cliente de mensaje en el cuadro de diálogo Propiedades de transporte WCF-BasicHttp, Recepción, Seguridad de la guía de la interfaz de usuario y referencia del espacio de nombres de la API de desarrolladores. |
Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación de cliente mediante la seguridad basada en mensajes. Valor predeterminado: UserName |
| AlgorithmSuite | Enumeración Para obtener más información sobre los nombres de miembro de la propiedad AlgorithmSuite , vea la propiedad Algorithm suite en el cuadro de diálogo Propiedades de transporte WCF-BasicHttp, Recepción, Seguridad de la guía de la interfaz de usuario y referencia del espacio de nombres de api para desarrolladores. |
Especificar el cifrado de mensajes y los algoritmos de encapsulado de claves. Estos algoritmos se asignan a los que se indican en la especificación Security Policy Language (WS-SecurityPolicy). Valor predeterminado: Basic256 |
| ServiceCertificate | String | Especificar la huella digital del certificado X.509 para esta ubicación de recepción que los clientes utilizan para autenticar el servicio. El certificado que se va a usar para esta propiedad debe instalarse en mi almacén en la ubicación Usuario actual . Nota: Debe instalar el certificado de servicio en la ubicación Usuario actual de la cuenta de usuario para el controlador de recepción que hospeda esta ubicación de recepción. El valor predeterminado es una cadena vacía. |
| UseSSO | Boolean | Especificar si se usa el inicio de sesión único (SSO) empresarial para recuperar credenciales de cliente y emitir, así, un vale de SSO. Para obtener más información sobre las configuraciones de seguridad que admiten SSO, consulte la sección "Enterprise Single Sign-On Supportability for the WCF-BasicHttp Receive Adapter" (Compatibilidad con el adaptador de recepción de WCF-BasicHttp) en el cuadro de diálogo Propiedades de transporte WCF-BasicHttp, Receive, Security (Recepción, seguridad ) de la guía de la interfaz de usuario y referencia del espacio de nombres de api de desarrolladores. Valor predeterminado: False |
| InboundBodyLocation | Enumeración - UseBodyElement : use el contenido del elemento Cuerpo SOAP de un mensaje entrante para crear la parte del cuerpo del mensaje de BizTalk. Si el elemento Body tiene más de un elemento secundario, solo el primer elemento se convierte en la parte del cuerpo del mensaje de BizTalk. - UseEnvelope : cree la parte del cuerpo del mensaje de BizTalk a partir del sobre SOAP completo de un mensaje entrante. - UseBodyPath : use la expresión de ruta de acceso del cuerpo en la propiedad InboundBodyPathExpression para crear la parte del cuerpo del mensaje de BizTalk. La expresión de ruta de acceso del cuerpo se evalúa con el elemento secundario inmediato del elemento Cuerpo SOAP de un mensaje entrante. Esta propiedad sólo es válida para puertos de petición-respuesta. Para obtener más información sobre cómo usar la propiedad InboundBodyLocation , vea Especificar el cuerpo del mensaje para los adaptadores WCF. |
Especifique la selección de datos para el elemento Body SOAP de los mensajes WCF entrantes. Valor predeterminado: UseBodyElement |
| InboundBodyPathExpression | String Para obtener más información sobre cómo usar la propiedad InboundBodyPathExpression , vea Esquema de propiedades y propiedades de adaptadores de WCF. |
Especificar la expresión de ruta de cuerpo para identificar una parte específica de un mensaje entrante utilizada para crear la parte del cuerpo del mensaje de BizTalk. Esta expresión de ruta de acceso del cuerpo se evalúa con el elemento secundario inmediato del nodo Cuerpo SOAP de un mensaje entrante. Si esta expresión de ruta de cuerpo devuelve varios nodos, solo se elegirá el primero de ellos para la parte del cuerpo del mensaje de BizTalk. Esta propiedad es necesaria si la propiedad InboundBodyLocation está establecida en UseBodyPath. El valor predeterminado es una cadena vacía. |
| InboundNodeEncoding | Enumeración - Codificación base64 : codificación base64. - Hex : codificación hexadecimal. - Cadena : codificación de texto- UTF-8 - XML : los adaptadores WCF crean el cuerpo del mensaje de BizTalk con el XML externo del nodo seleccionado por la expresión de ruta de acceso del cuerpo en InboundBodyPathExpression. |
Especifique el tipo de codificación que usa el adaptador de recepción WCF-BasicHttp para descodificar el nodo identificado por la expresión de ruta de acceso del cuerpo especificada en InboundBodyPathExpression. Esta propiedad es necesaria si la propiedad InboundBodyLocation está establecida en UseBodyPath. Valor predeterminado: XML |
| OutboundBodyLocation | Enumeración - UseBodyElement : use la parte del cuerpo del mensaje de BizTalk para crear el contenido del elemento Body soap para un mensaje de respuesta saliente. - UseTemplate : use la plantilla proporcionada en la propiedad OutboundXMLTemplate para crear el contenido del elemento Cuerpo soap para un mensaje de respuesta saliente. Para obtener más información sobre cómo usar la propiedad OutboundBodyLocation , vea Especificar el cuerpo del mensaje para los adaptadores WCF. |
Especifique la selección de datos para el elemento Body SOAP de los mensajes WCF salientes. Esta propiedad sólo es válida para las ubicaciones de recepción de solicitud-respuesta. Valor predeterminado: UseBodyElement |
| OutboundXMLTemplate | String Para obtener más información sobre cómo usar la propiedad OutboundXMLTemplate , vea Especificar el cuerpo del mensaje para los adaptadores de WCF. |
Especifique la plantilla con formato XML para el contenido del elemento Cuerpo SOAP de un mensaje de respuesta saliente. Esta propiedad es necesaria si la propiedad OutboundBodyLocation está establecida en UseTemplate. Esta propiedad sólo es válida para las ubicaciones de recepción de solicitud-respuesta. El valor predeterminado es una cadena vacía. |
| SuspendMessageOnFailure | Boolean | Especificar si se va a suspender el mensaje de solicitud cuyo procesamiento de entrada no se puede realizar correctamente debido a un error de canalización de recepción o de enrutamiento. Valor predeterminado: False |
| IncludeExceptionDetailInFaults | Boolean | Especificar si se va a incluir información de excepción administrada en el detalle de los errores SOAP devueltos al cliente para fines de depuración. Valor predeterminado: False |
Configuración del puerto de envío mediante programación
En el fragmento de código siguiente se muestra cómo crear un puerto de envío WCF-BasicHttp mediante el modelo de objetos del Explorador de BizTalk:
// 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();
Puede usar el siguiente formato para establecer las propiedades en <CustomProps>:
<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>
En la tabla siguiente se enumeran las propiedades de configuración que puede establecer para el puerto de envío:
| Nombre de propiedad | Tipo | Descripción |
|---|---|---|
| SecurityMode | Enumeración - Ninguno - Mensaje - Transporte - TransportWithMessageCredential - TransportCredentialOnly Para obtener más información sobre los nombres de miembro de la propiedad SecurityMode , vea la propiedad Modo de seguridad en el cuadro de diálogo Propiedades de transporte WCF-BasicHttp, Enviar, Seguridad de la guía de la interfaz de usuario y referencia del espacio de nombres de api de desarrolladores. |
Especificar el tipo de seguridad que se usa. Valor predeterminado: None |
| MessageClientCredentialType | Enumeración - Nombre de usuario - Certificado Para obtener más información sobre los nombres de miembro de la propiedad MessageClientCredentialType , vea la propiedad Tipo de credencial de cliente de mensaje en el cuadro de diálogo Propiedades de transporte WCF-BasicHttp, Enviar, Seguridad de la guía de la interfaz de usuario y la referencia del espacio de nombres de la API de desarrolladores. |
Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación de cliente mediante la seguridad basada en mensajes. Valor predeterminado: UserName |
| TransportClientCredentialType | Enumeración - Ninguno - Básica - Windows - Certificado - Digerir - Ntlm Para obtener más información sobre los nombres de miembro de la propiedad TransportClientCredentialType , vea la propiedad Tipo de credencial de cliente de transporte en el cuadro de diálogo Propiedades de transporte WCF-BasicHttp, Enviar, Seguridad pestaña en la guía de la interfaz de usuario y la referencia del espacio de nombres de la API de desarrolladores. |
Especificar el tipo de credenciales que se va a usar a la hora de realizar la autenticación del puerto de envío. Valor predeterminado: None |
| UserName | String | Especifique el nombre de usuario que se usará para la autenticación con el servidor de destino cuando la propiedad UseSSO esté establecida en False. No tiene que usar el formato dominio\usuario para esta propiedad. El valor predeterminado es una cadena vacía. |
| Contraseña | String | Especifique la contraseña que se usará para la autenticación con el servidor de destino cuando la propiedad UseSSO esté establecida en False. El valor predeterminado es una cadena vacía. |
| AffiliateApplicationName | String | Especificar la aplicación afiliada que se utilizará para el inicio de sesión único empresarial (SSO). El valor predeterminado es una cadena vacía. |
| UseSSO | Boolean | Especificar si se utiliza el inicio de sesión único (SSO) para recuperar credenciales de cliente para la autenticación con el servidor de destino. Valor predeterminado: False |
| ClientCertificate | String | Especificar la huella digital del certificado X.509 para la autenticación de este puerto de envío en servicios. Esta propiedad es necesaria si la propiedad ClientCredentialsType está establecida en Certificate. El certificado que se va a usar para esta propiedad debe instalarse en el almacén Mi en la ubicación Usuario actual . El valor predeterminado es una cadena vacía. |
| ServiceCertificate | String | Especificar la huella digital del certificado X.509 para la autenticación del servicio al que este puerto de envío envía mensajes. El certificado que se va a usar para esta propiedad debe instalarse en el almacén Other Personas en la ubicación del equipo local. El valor predeterminado es una cadena vacía. |
| ProxyToUse | Enumeración - Ninguno : no use un servidor proxy para este puerto de envío. - Valor predeterminado : use la configuración de proxy en el controlador de envío que hospeda este puerto de envío. - UserSpecified : use el servidor proxy especificado en la propiedad ProxyAddress . |
Especificar el servidor de proxy que se va a utilizar para el tráfico HTTP saliente. Valor predeterminado: Ninguno |
| ProxyAddress | String | Especifique la dirección del servidor proxy. Use el esquema https o http en función de la configuración de seguridad. Esta dirección puede ir seguida de dos puntos y el número de puerto. Por ejemplo, http://127.0.0.1:8080. El valor predeterminado es una cadena vacía. |
| ProxyUserName | String | Especificar el nombre de usuario que se utilizará para el proxy. El adaptador de WCF-BasicHttp aprovecha BasicHttpBinding en el modo de transferencia almacenada en búfer para comunicarse con un punto de conexión. Las credenciales de proxy de BasicHttpBinding solo son aplicables cuando el modo de seguridad es Transport, None o TransportCredentialOnly. Si establece la propiedad SecurityMode en Message o TransportWithMessageCredential, el adaptador de WCF-BasicHttp no usa la credencial especificada en las propiedades ProxyUserName y ProxyPassword para la autenticación en el proxy. Nota: El WCF-BasicHttp adaptador de envío usa la autenticación básica para el proxy. El valor predeterminado es una cadena vacía. |
| ProxyPassword | String | Especificar la contraseña que se utilizará para el proxy. El valor predeterminado es una cadena vacía. |
| InboundBodyLocation | Enumeración - UseBodyElement : use el contenido del elemento Cuerpo SOAP de un mensaje entrante para crear la parte del cuerpo del mensaje de BizTalk. Si el elemento Body tiene más de un elemento secundario, solo el primer elemento se convierte en la parte del cuerpo del mensaje de BizTalk. Esta propiedad sólo es válida para puertos de petición-respuesta. - UseEnvelope : cree la parte del cuerpo del mensaje de BizTalk a partir del sobre SOAP completo de un mensaje entrante. - UseBodyPath : use la expresión de ruta de acceso del cuerpo en la propiedad InboundBodyPathExpression para crear la parte del cuerpo del mensaje de BizTalk. La expresión de ruta de acceso del cuerpo se evalúa con respecto al elemento secundario inmediato del elemento Body soap de un mensaje entrante. Esta propiedad sólo es válida para puertos de petición-respuesta. Para obtener más información sobre cómo usar la propiedad InboundBodyLocation , vea Especificar el cuerpo del mensaje para los adaptadores de WCF. |
Especifique la selección de datos para el elemento Cuerpo SOAP de los mensajes WCF entrantes. Valor predeterminado: UseBodyElement |
| OutboundBodyLocation | Enumeración - UseBodyElement : use la parte del cuerpo del mensaje de BizTalk para crear el contenido del elemento Cuerpo soap para un mensaje saliente. - UseTemplate : use la plantilla proporcionada en la propiedad OutboundXMLTemplate para crear el contenido del elemento Cuerpo SOAP para un mensaje saliente. Para obtener más información sobre cómo usar la propiedad OutboundBodyLocation , vea Especificar el cuerpo del mensaje para los adaptadores de WCF. |
Especifique la selección de datos para el elemento Cuerpo SOAP de los mensajes WCF salientes. Valor predeterminado: UseBodyElement |
| InboundBodyPathExpression | String Para obtener más información sobre cómo usar la propiedad InboundBodyPathExpression , vea Esquema de propiedades y propiedades de adaptadores de WCF. |
Especificar la expresión de ruta de cuerpo para identificar una parte específica de un mensaje entrante utilizada para crear la parte del cuerpo del mensaje de BizTalk. Esta expresión de ruta de acceso del cuerpo se evalúa con el elemento secundario inmediato del nodo Cuerpo SOAP de un mensaje entrante. Si esta expresión de ruta de cuerpo devuelve varios nodos, solo se elegirá el primero de ellos para la parte del cuerpo del mensaje de BizTalk. Esta propiedad es necesaria si la propiedad InboundBodyLocation está establecida en UseBodyPath. Esta propiedad sólo es válida para puertos de petición-respuesta. El valor predeterminado es una cadena vacía. |
| OutboundXMLTemplate | String Para obtener más información sobre cómo usar la propiedad OutboundXMLTemplate , vea Especificar el cuerpo del mensaje para los adaptadores de WCF. |
Especifique la plantilla con formato XML para el contenido del elemento Cuerpo SOAP de un mensaje saliente. Esta propiedad es necesaria si la propiedad OutboundBodyLocation está establecida en UseTemplate. El valor predeterminado es una cadena vacía. |
| InboundNodeEncoding | Enumeración - Base64 : codificación base64. - Hexadecimal : codificación hexadecimal. - Cadena : codificación de texto- UTF-8 - XML : los adaptadores de WCF crean el cuerpo del mensaje de BizTalk con el XML externo del nodo seleccionado por la expresión de ruta de acceso del cuerpo en InboundBodyPathExpression. |
Especifique el tipo de codificación que usa el adaptador de envío de WCF-BasicHttp para descodificar el nodo identificado por la expresión de ruta de acceso del cuerpo especificada en InboundBodyPathExpression. Esta propiedad es necesaria si la propiedad InboundBodyLocation está establecida en UseBodyPath. Esta propiedad sólo es válida para puertos de petición-respuesta. Valor predeterminado: XML |
| StaticAction | String | Especifique el campo de encabezado HTTP SOAPAction para los mensajes salientes. Esta propiedad también se puede establecer a través de la propiedad de contexto del mensaje WCF. Acción en una canalización o orquestación. Puede especificar este valor de dos maneras diferentes: el formato de acción única y el formato de asignación de acciones. Si establece esta propiedad en el formato de acción única, por ejemplo, http://contoso.com/Svc/Op1, el encabezado SOAPAction para los mensajes salientes siempre se establece en el valor especificado en esta propiedad.Si establece esta propiedad en el formato de asignación de acciones, el encabezado SOAPAction saliente viene determinado por BTS. Propiedad de contexto de la operación . Por ejemplo, si esta propiedad se establece en el siguiente formato XML y BTS. La propiedad Operation se establece en Op1, el adaptador de envío de WCF usa http://contoso.com/Svc/Op1 para el encabezado SOAPAction saliente.<BtsActionMapping> <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" /> <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" /> </BtsActionMapping> Si los mensajes salientes proceden de un puerto de orquestación, las instancias de orquestación establecen dinámicamente el BTS. Propiedad Operation con el nombre de la operación del puerto. Si los mensajes salientes se enrutan con enrutamiento basado en contenido, puede establecer bts. Propiedad Operation en los componentes de canalización. El valor predeterminado es una cadena vacía. |
| MaxReceivedMessageSize | Entero | Especificar el tamaño máximo, en bytes, para mensajes (con encabezados incluidos) que se pueden recibir a través de la red. El tamaño de los mensajes se limita mediante la cantidad de memoria asignada a cada mensaje. Puede usar esta propiedad para limitar la exposición a ataques por denegación de servicio (DoS). El adaptador de WCF-BasicHttp aprovecha la clase BasicHttpBinding en el modo de transferencia almacenada en búfer para comunicarse con un punto de conexión. Para el modo de transporte almacenado en búfer, la propiedad BasicHttpBinding.MaxBufferSize siempre es igual al valor de esta propiedad. Valor predeterminado: 65 536 |
| MessageEncoding | Enumeración - Texto : use un codificador de mensajes de texto. - Mtom : use un codificador de la organización de transmisión de mensajes 1.0 (MTOM). |
Especificar el codificador que se usa para codificar el mensaje SOAP. Valor predeterminado: Texto |
| TextEncoding | Enumeración - unicodeFFF : codificación BigEndian unicode. - utf-16 : codificación de 16 bits. - utf-8 : codificación de 8 bits |
Especifique la codificación del juego de caracteres que se usará para emitir mensajes en el enlace cuando la propiedad MessageEncoding esté establecida en Text. Valor predeterminado: utf-8 |
| SendTimeout | System.TimeSpan | Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de envío. Si usa un puerto de envío de petición-respuesta, este valor especifica un marco temporal para que se complete la interacción, incluso cuando el servicio devuelva un mensaje grande. Valor predeterminado: 00:01:00 |
| OpenTimeout | System.TimeSpan | Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de apertura del canal. Valor predeterminado: 00:01:00 |
| CloseTimeout | System.TimeSpan | Especificar un valor de marco temporal que indica el intervalo de tiempo proporcionado para que se complete una operación de cierre del canal. Valor predeterminado: 00:01:00 |
| AlgorithmSuite | Enumeración Para obtener más información sobre los nombres de miembro de la propiedad AlgorithmSuite , vea la propiedad Conjunto de algoritmos en el cuadro de diálogo Propiedades de transporte WCF-BasicHttp, pestaña Enviar, Seguridad en la guía de la interfaz de usuario y la referencia del espacio de nombres de la API de desarrolladores. |
Especificar el cifrado de mensajes y los algoritmos de encapsulado de claves. Estos algoritmos se asignan a los que se indican en la especificación Security Policy Language (WS-SecurityPolicy). Valor predeterminado: Basic256 |
| Identidad | Blob XML Ejemplo: <identity> <userPrincipalName value="username@contoso.com" /> </Identidad> |
Especifique la identidad de servicio que espera este puerto de envío. Esta configuración permite al puerto de envío autenticar el servicio. En el proceso de negociación entre el cliente y el servicio, la infraestructura de Windows Communication Foundation (WCF) asegurará que la identidad del servicio esperado coincide con los valores de este elemento. El valor predeterminado es una cadena vacía. |
| PropagateFaultMessage | Boolean - True: enrute el mensaje que produce un error en el procesamiento saliente a una aplicación de suscripción (por ejemplo, otro puerto de recepción o programación de orquestación). - False : suspende los mensajes con errores y genera una confirmación negativa (NACK). |
Especificar si se enrutan o se suspenden mensajes que han generado errores en el procesamiento de salida. Esta propiedad sólo es válida para puertos de petición-respuesta. Valor predeterminado: True |
Consulte también
¿Qué son los adaptadores de WCF?Publicar servicios WCF con los adaptadores de recepción de WCF aisladosconfigurando IIS para los adaptadores de recepción WCF aisladosadministrando hosts de BizTalk e instancias de hostcómo cambiar las cuentas de servicio y las contraseñasinstalando certificados para los adaptadores wcFque especifican el cuerpo del mensaje para el esquema de propiedades de adaptadores WCF adaptadores wcF y propiedadesconfigurando puertos de envío dinámicos mediante propiedades de contexto de adaptadores WCF