Paso 2: Configurar un puerto de recepción unidireccional personalizado de WCF

Tiempo de finalización: 10 minutos

Objetivo: En este paso, configurará un puerto de WCF-Custom para recibir un IDOC de archivo plano desde un sistema SAP. Después de configurar el puerto, configure la aplicación de BizTalk para que use el puerto de recepción WCF-Custom.

Requisitos previos

Debe haber compilado e implementado el proyecto de BizTalk vPrev para recibir IDOC de un sistema SAP.

Para configurar un puerto de recepción unidireccional WCF-Custom

1. Inicie la consola de administración de BizTalk Server.

2. En el árbol de consola, expanda Grupo de BizTalk y, a continuación, expanda Aplicaciones.

3. Expanda la aplicación en la que desea crear el puerto de recepción.

4. Haga clic con el botón derecho en Puertos de recepción, seleccione Nuevoy haga clic en Puerto de recepción unidireccional.

5. En el cuadro de diálogo Propiedades del puerto de recepción , en la pestaña General , escriba un nombre para el puerto de recepción.

6. En la pestaña Ubicaciones de recepción , haga clic en Nuevo. Aparece el cuadro de diálogo Propiedades de ubicación de recepción .

7. En el cuadro de diálogo Propiedades de ubicación de recepción , haga lo siguiente:

   1. Especifique un nombre para la ubicación de recepción.

   2. En la lista desplegable Tipo , seleccione WCF-Custom y, a continuación, haga clic en Configurar.

8. En el cuadro de diálogo Propiedades de transporte personalizado de WCF , haga lo siguiente:

   1. Haga clic en la pestaña General y, en el campo Dirección (URI), especifique el URI de conexión para recibir mensajes del sistema SAP. El URI de conexión para recibir mensajes del sistema SAP debe tener el siguiente formato:

      sap://Client=800;lang=EN@A/YourSAPHOST/00?ListenerGwHost=YourSAPHOST&ListenerGwServ=SAPGW00&ListenerProgramId=MyProgramId
      

      En la ilustración siguiente se muestra el cuadro de diálogo de propiedades del puerto con el URI especificado:

      

      Para obtener más información sobre el URI de conexión, consulte Creación de una conexión al sistema SAP.

   2. Haga clic en la pestaña Enlace y, en la lista desplegable Tipo de enlace, seleccione sapBinding. Asegúrese de especificar las siguientes propiedades de enlace para el puerto de recepción.

      Propiedad Binding	Establecer valor en
      flatFileSegmentIndicator	SegmentType. Esto indica que los archivos planos deben contener el tipo de segmento para cada segmento del IDOC.
      padReceivedIdocWithSpaces	True. Especifica si cada línea del IDOC se rellena con espacios a la longitud correcta.
      receiveIDocFormat	Cadena. Esto especifica que el mensaje IDOC debe representarse como un campo de cadena único.

      Para obtener más información sobre las propiedades de enlace, vea Leer sobre el adaptador de BizTalk para mySAP Business Suite Binding Properties.

   3. Haga clic en la pestaña Otros y especifique las credenciales para conectarse a un sistema SAP.

   4. Haga clic en la pestaña Mensajes y, en la sección Cuerpo del mensaje de BizTalk entrante , elija la opción Ruta de acceso .

   5. En el cuadro de texto Expresión de ruta de acceso del cuerpo, especifique la consulta XPath para extraer el IDOC de archivo plano del mensaje XML. Al hacerlo, el puerto de recepción extrae los datos del IDOC y recorta la etiqueta XML que forma parte de la operación ReceiveIdoc para el adaptador de SAP basado en WCF. Para obtener más información sobre el esquema de mensajes para la operación ReceiveIdoc , vea Esquemas de mensaje para operaciones IDOC.

      

      Debe especificar la siguiente consulta XPath:

      /*[local-name()='ReceiveIdoc']/*[local-name()='idocData']
      

   6. En la lista desplegable Codificación de nodos , seleccione Cadena.

   7. Haga clic en Aplicar y en Aceptar.

9. En el cuadro de diálogo Propiedades de ubicación de recepción, en la lista desplegable Controlador de recepción, seleccione BizTalkServerApplication.

10. En la lista desplegable Receive pipeline (Recibir canalización ), seleccione ConvertToXML. Esta canalización de desensamblador de archivos planos ya forma parte del proyecto de BizTalk vPrev para convertir un IDOC de archivo plano en un IDOC XML.

11. Haga clic en OK.

Para configurar la aplicación de BizTalk

1. En la consola de administración de BizTalk Server, expanda Grupo de BizTalk, expanda Aplicaciones y expanda la aplicación de BizTalk donde se implementa la orquestación.

2. Haga clic con el botón derecho en la aplicación de BizTalk y, a continuación, seleccione Configurar.

3. En el panel izquierdo, haga clic en la orquestación que desea configurar. En el panel derecho, en la lista desplegable Host , seleccione una instancia de host de BizTalk.

4. En el cuadro Enlaces, asigne los puertos lógicos de la orquestación de BizTalk a los puertos físicos de la consola de administración de BizTalk Server.

   1. Seleccione el puerto de recepción WCF-Custom que creó anteriormente en este tema.

   2. Seleccione un puerto de archivo donde recibirá el IDOC de archivo plano.

   3. Haga clic en OK.

      Para obtener más información sobre cómo configurar aplicaciones en BizTalk Server, vea How to Configure an Application.

Pasos siguientes

Ya ha completado la migración del proyecto de BizTalk vPrev a un proyecto de BizTalk que recibe iDOC de un sistema SAP mediante el adaptador de SAP basado en WCF. Ahora debe probar la aplicación de BizTalk migrada mediante la recepción de un IDOC de archivo plano, como se describe en Paso 3: Probar la aplicación migrada.

Consulte también

Tutorial 4: Migración de un proyecto de BizTalk IDOC de SAP de recepción