Configuración de un enlace de puerto físico mediante un archivo de enlace de puerto a SAP
Cuando se usa el complemento consumir el proyecto de bizTalk del servicio adaptador para generar metadatos para un artefacto de SAP, aparte de los archivos de esquema, el complemento consumir servicio adaptador también genera un archivo de enlace de puerto. Puede importar este archivo de enlace en la aplicación de BizTalk para crear un puerto físico de envío o recepción. La reutilización de enlaces de adaptador de SAP incluye pasos para importar archivos de enlace. Si importa este archivo de enlace, no es necesario crear manualmente un puerto de envío o recepción físicos.
Importante
Al usar el Complemento de servicio de adaptador de consumo, si no especifica un valor para una propiedad de enlace de tipo cadena y cuyo valor predeterminado es NULL, esa propiedad de enlace no estará disponible en el archivo de enlace. Debe agregar manualmente la propiedad de enlace y su valor en el archivo de enlace, si es necesario.
La creación de un puerto mediante el archivo de enlace de puertos siempre crea un puerto de envío o recepción bidireccional. Si desea crear un puerto unidireccional, puede crearlo manualmente siguiendo los pasos descritos en Configuración manual de un enlace de puerto físico al adaptador de SAP. O bien, puede seguir las soluciones alternativas documentadas en este tema para modificar el archivo de enlace de puerto para crear puertos unidireccionales.
Importante
El uso del Asistente para agregar metadatos del adaptador no crea un archivo de enlace de puerto mediante el que puede crear un puerto WCF-SAP. Sin embargo, puede realizar algunos cambios en el archivo de enlace de puerto generado por el complemento consumir servicio adaptador y usarlo para crear un puerto WCF-SAP. Para obtener más información, vea Configuración de un puerto WCF-SAP mediante el archivo de enlace de puerto generado mediante el complemento de servicio consumir adaptador.
A continuación se muestran algunos puntos clave que debe comprender con respecto al archivo de enlace generado por el Complemento de servicio de adaptador de consumo:
Los archivos se crean con una convención de nomenclatura específica. Si generó metadatos para las operaciones salientes, es decir, enviar mensajes al sistema SAP, el nombre del archivo se WcfSendPort_SAPBinding_Custom.bindinginfo.xml.
Si generó metadatos para las operaciones entrantes, es decir, recibir mensajes del sistema SAP, el nombre del archivo se WcfReceivePort_SAPBinding_Custom.bindinginfo.xml.
El archivo contiene información sobre la configuración de enlace, el tipo de enlace, el URI del punto de conexión y la acción de puerto en función de las operaciones para las que se generaron metadatos. Al importar este archivo de enlace para crear un puerto, toda la información pertinente necesaria para configurar un puerto físico se establece automáticamente en el puerto.
Importante
De forma predeterminada, la acción en el puerto de envío se asigna al nombre de la operación para la que se generan metadatos. Por ejemplo, si genera metadatos para RFC_CUSTOMER_GET, la acción en el puerto se establece
<Operation Name="RFC_CUSTOMER_GET" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET " />en . Sin embargo, es posible que el nombre de la operación en el puerto de envío lógico que cree en la orquestación de BizTalk no sea el mismo. Debe asegurarse de que el nombre de la operación en el puerto lógico (en la orquestación de BizTalk) y el puerto de envío físico (en BizTalk Server consola de administración) sean los mismos. Si no es así, recibirá un error al enviar mensajes al sistema SAP a través del puerto de envío.Solo tiene que proporcionar las credenciales para que el puerto se conecte al sistema SAP. Aunque el archivo de enlace conserva el nombre de usuario con el que conectarse, por motivos de seguridad el archivo de enlace no contiene la contraseña.
Consideraciones clave para usar el archivo de enlace de puerto
Al importar el archivo de enlace, es posible que reciba un mensaje de diálogo que informa de que el nombre de la aplicación de BizTalk en el archivo de enlace no coincide con el nombre de la aplicación al que va a importar el archivo de enlace. Puede omitir este mensaje de forma segura y continuar.
El archivo de enlace también contiene nombres de puertos y ubicaciones de recepción. Si la aplicación de BizTalk a la que va a importar el archivo de enlace crea un puerto o una ubicación de recepción que tiene el mismo nombre que un puerto ya existente en la misma aplicación de BizTalk, obtendrá un error. Debe editar manualmente el archivo de enlaces para especificar un nombre único para los puertos o ubicaciones de recepción.
El archivo de enlace también contiene información sobre el URI de conexión. Si el archivo de enlace crea una ubicación de recepción que tiene el mismo URI de recepción que una ubicación de recepción ya existente en la misma aplicación de BizTalk, recibirá un error. Debe editar manualmente el archivo de enlace para especificar un URI único.
De forma predeterminada, el archivo de enlace de puertos siempre contiene definiciones para puertos bidireccionales (envío o recepción). Al importar este archivo en una aplicación de BizTalk, se crea un puerto de envío o recepción bidireccional. Sin embargo, es posible que tenga una orquestación que tenga un puerto de envío o recepción unidireccional. Por lo tanto, al configurar esta orquestación y usar el puerto creado importando el archivo de enlace, el puerto no está disponible en la lista. Esto sucede porque el puerto lógico que creó como parte de la orquestación es un puerto unidireccional mientras que el puerto físico creado en la orquestación es un puerto bidireccional. En tales casos, puede editar el archivo de enlaces para realizar los siguientes cambios:
Para Haga esto Para editar el archivo de enlaces de puerto para configurar un puerto de envío unidireccional 1. En el siguiente extracto, cambie el valor de la propiedad IsTwoWay a false. Originalmente, se establece en true.
<SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0">
2. Comente los siguientes extractos:
<ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="1" TrackingOption="None" Description=""/>
<ReceivePipelineData xsi:nil="true" />Para editar el archivo de enlaces de puerto para configurar un puerto de recepción unidireccional 1. En el siguiente extracto, cambie el valor de la propiedad IsTwoWay a false. Originalmente, se establece en true.
<ReceivePort Name="port_name" IsTwoWay="false" BindingOption="1">
2. Comente los siguientes extractos:
<SendPipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLTransmit" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLTransmit, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="2" TrackingOption="None" Description="" />
<SendPipelineData xsi:nil="true" />
<SendPipelineData xsi:nil="true" />
Configuración de un puerto WCF-SAP mediante el archivo de enlace de puerto generado mediante el complemento de servicio consumir adaptador
El Complemento de servicio consumir adaptador también crea un archivo de enlace de puerto que puede importar en BizTalk Server consola de administración. Puede usar el mismo archivo de enlace de puerto para crear también el puerto WCF-SAP de BizTalk en BizTalk Server consola de administración. Sin embargo, antes de crear el puerto WCF-SAP, debe realizar las siguientes tareas para modificar el archivo de enlace de puerto.
Abra el archivo de enlace de puertos en un editor de texto.
Busque y reemplace "WCF-Custom" por el nombre con el que agregó el adaptador WCF-SAP en BizTalk Server consola de administración. Por ejemplo, si agregó el adaptador WCF-SAP como "SAPAdapter", reemplace "WCF-Custom" por "SAPAdapter".
Busque el atributo "ConfigurationClsid" y reemplace el valor existente del atributo por "A5F15999-8879-472d-8C62-3B5EA9406504".
Guarde y cierre el archivo de enlace.
Importe el archivo de enlace en BizTalk Server consola de administración. Reutilización de enlaces de adaptador de SAP enumera los pasos.