Tutorial (X12): Recepción de intercambios EDI y devolución de una confirmación
En este tutorial se proporciona un conjunto de procedimientos paso a paso que crean una solución para recibir intercambios EDI mediante BizTalk Server. En esta solución, se envía un intercambio EDI desde un socio comercial, Fabrikam, a otro, Contoso.
Requisitos previos
Debe haber iniciado sesión como miembro del grupo Administradores de BizTalk Server o BizTalk Server operadores B2B.
Cómo recibe la solución intercambios EDI
La solución hará lo siguiente:
Nota
Puede que los eventos de esta lista no se produzcan en el orden mostrado.
Recibir un intercambio EDI de archivos sin formato del socio comercial Fabrikam.
Validar el intercambio EDI con su esquema, desensamblar el mensaje a XML y depositar el mensaje XML en el cuadro de mensajes.
Generar una confirmación 997 al intercambio EDI recibido y depositarla en el cuadro de mensajes.
Generar una confirmación TA1 al intercambio EDI recibido y depositarla en el cuadro de mensajes.
Recoger el mensaje XML mediante un puerto de envío unidireccional y ensamblar el intercambio EDI.
Enviar un intercambio EDI a Contoso.
Recoger el XML de 997 mediante un puerto de envío unidireccional y ensamblar el intercambio EDI 997.
Enviar un intercambio 997 a Fabrikam.
Recoger el XML de TA1 mediante un puerto de envío unidireccional y ensamblar el intercambio EDI de TA1.
Enviar un intercambio TA1 a Fabrikam.
La funcionalidad en esta solución
Por lo que respecta a este tutorial, se habilitará la siguiente funcionalidad:
La solución está diseñada para intercambios que utilizan la codificación X12, no la codificación EDIFACT.
Nota
La configuración que se usa para HIPAA es bastante parecida a la que se usa para la codificación X12. Para obtener instrucciones sobre cómo crear una solución similar para EDIFACT, vea Walkthrough (EDIFACT): Receiveing EDI Interchanges and Sending Back an Acknowledgement.
El tipo de codificación EDI y la validación extendida se realizarán en el intercambio entrante.
Se generarán confirmaciones técnicas y funcionales para la devolución del intercambio al remitente.
La solución usa una ubicación de recepción unidireccional con un tipo de transporte de archivo.
Nota
Puede usar un puerto de recepción bidireccional de petición-respuesta y una ubicación para recibir el mensaje; no obstante, si lo hace, no podrá usar un tipo de transporte de archivo para la ubicación de recepción. Para obtener más información, consulte Configuración de un puerto para recibir mensajes y confirmaciones EDI.
Se habilitarán los informes EDI y se guardarán los conjuntos de transacciones para su visualización a partir del informe de estado de intercambio.
Para realizar pruebas, la solución usa tres puertos de envío para enviar el intercambio EDI y las confirmaciones creadas a carpetas locales.
La siguiente ilustración muestra la arquitectura de esta solución:
Configuración y prueba del tutorial
Los procedimientos necesarios para esta solución son:
Agregar los esquemas de mensaje necesarios a un proyecto de BizTalk y, a continuación, generar e implementar el proyecto, de modo que los esquemas estén disponibles para que BizTalk Server los utilice a la hora de procesar el intercambio recibido.
Crear un puerto de recepción unidireccional para que BizTalk Server reciba el intercambio EDI del socio comercial y genere una confirmación. La ubicación de recepción está vinculada a la carpeta de archivo donde Fabrikam suelta el intercambio EDI que debe enviarse a Contoso.
Nota
Puede usar un puerto de recepción de respuesta de solicitud bidireccional y una ubicación para recibir el mensaje, pero si lo hace, no podrá usar un tipo de transporte FILE para la ubicación de recepción.
Cree un puerto de envío que envíe el intercambio EDI a una carpeta local de Contoso, otro que envíe la confirmación 997 a una carpeta local de Fabrikam y otro que envíe la confirmación TA1 a una carpeta local de Fabrikam.
Crear una entidad (socio comercial) para Fabrikam y Contoso.
Crear un perfil de negocio para cada uno de los socios comerciales.
Cree un acuerdo entre los dos perfiles configurando las propiedades EDI para el mensaje que se va a recibir y la confirmación que se va a enviar.
Probar el tutorial con un intercambio de prueba EDI.
Nota
En un mensaje de prueba, puede usar el archivo SamplePO.txt usado en el tutorial de programadores de la interfaz EDI. Ese archivo se incluye en la carpeta \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\. Es un mensaje X12 850.
Configuración del tutorial
En esta sección se describen los procedimientos para configurar el tutorial.
Para implementar el esquema de mensajes
En Visual Studio, cree o abra un proyecto de BizTalk.
Nota
Este tema presupone que ya ha agregado una referencia de su aplicación a la aplicación EDI de BizTalk, que contiene esquemas, canalizaciones y orquestaciones EDI. Si no es así, vea Agregar una referencia a la aplicación EDI de BizTalk Server.
Haga clic con el botón derecho en el proyecto, seleccione Agregar y, a continuación, haga clic en Elemento existente. Vaya a la carpeta en la que se encuentra el esquema en \Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema\EDI y, a continuación, haga doble clic en el esquema.
Nota
Si los esquemas EDI no se han descomprimido en las carpetas \XSD_Schema\EDI, ejecute el archivo MicrosoftEdiXSDTemplates.exe en la carpeta \XSD_Schema\EDI para descomprimir los esquemas en la carpeta predeterminada.
Nota
Si usa el archivo SamplePO.txt que se usa en el tutorial para desarrolladores de interfaz EDI, debe usar el esquema X12_00401_850.xsd que se incluye en la carpeta \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\Inbound_EDI. No debe usar el esquema X12 850 en la carpeta \Program Files (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema.
Agregue el archivo de clave de ensamblado en el proyecto y, a continuación, genere e implemente el ensamblado.
Procedimiento para crear un puerto de recepción unidireccional (para Fabrikam) para recibir el intercambio EDI
En el Explorador de Windows, cree una carpeta local en la que recibir el intercambio.
En BizTalk Server Consola de administración, haga clic con el botón derecho en el nodo Puertos de recepción en el nodo Aplicación de BizTalk 1, seleccione Nuevo y, a continuación, haga clic en Puerto de recepción unidireccional.
Asigne un nombre al puerto de recepción y, a continuación, haga clic en Ubicaciones de recepción en el árbol de consola.
Haga clic en Nueva.
Asigne un nombre a la ubicación de recepción, seleccione ARCHIVO para Tipo y, a continuación, haga clic en Configurar.
Vaya a una carpeta para el cuadro de texto Receive folder (Recibir carpeta ). Esta carpeta la creó en el paso 1 de este procedimiento. Escriba una máscara de archivo, como *.edi o *.txt.
Haga clic en OK.
En Canalización de recepción, seleccione EdiReceive.
Haga clic en Aceptar en el cuadro de diálogo Propiedades de ubicación de recepción . Haga clic de nuevo en Aceptar en el cuadro de diálogo Propiedades del puerto de recepción .
En el árbol de consola, haga clic en Ubicaciones de recepción. En el panel Ubicaciones de recepción , haga clic con el botón derecho en la ubicación de recepción y, a continuación, haga clic en Habilitar.
Procedimiento para crear un puerto de envío estático unidireccional (para Contoso) para enviar el intercambio EDI
En el Explorador de Windows, cree una carpeta local a la que enviar el intercambio de prueba.
En BizTalk Server Consola de administración, haga clic con el botón derecho en el nodo Puertos de envío en el nodo Aplicación de BizTalk 1, seleccione Nuevo y, a continuación, haga clic en Puerto de envío unidireccional estático.
En el cuadro de diálogo Propiedades del puerto de envío, asigne un nombre al puerto de envío.
En la sección Transporte , seleccione ARCHIVO para Tipo y, a continuación, haga clic en Configurar.
En Carpeta de destino, vaya a la carpeta para recibir el intercambio. Esta carpeta la creó en el paso 1 de este procedimiento. En Máscara de archivo, escriba el formato de intercambio, como *.edi o *.xml.
Haga clic en OK.
En Enviar canalización, seleccione EdiSend.
En el árbol de consola, seleccione Filtros. Especifique un filtro al que suscribir el intercambio EDI. Por ejemplo, en Propiedad, escriba BTS. MessageType; en Operador, escriba ==; y en Valor escriba el esquema del intercambio, por ejemplo,
http://schemas.microsoft.com/BizTalk/Edi/X12/2006#X12_00401_850.Nota
La configuración de filtro anterior asegura que esos intercambios, no las confirmaciones, se enviarán a la carpeta asociada a este puerto de envío.
Haga clic en OK.
En el árbol de consola, haga clic en Puertos de envío. En el panel Puertos de envío, haga clic con el botón derecho en el puerto de envío y, a continuación, haga clic en Iniciar.
Para crear un puerto de envío estático unidireccional para enviar la confirmación 997
En el Explorador de Windows, cree una carpeta local a la que enviar la confirmación 997.
En BizTalk Server Consola de administración, haga clic con el botón derecho en el nodo Puertos de envío en el nodo Aplicación de BizTalk 1, seleccione Nuevo y, a continuación, haga clic en Puerto de envío unidireccional estático.
En el cuadro de diálogo Propiedades del puerto de envío, asigne un nombre al puerto de envío.
En la sección Transporte , seleccione ARCHIVO para Tipo y, a continuación, haga clic en Configurar.
En Carpeta de destino, vaya a una carpeta para recibir la confirmación 997. Esta carpeta la creó en el paso 1 de este procedimiento. En Máscara de archivo, escriba el formato de intercambio, como *.edi o *.txt.
Haga clic en OK.
En Enviar canalización, seleccione EdiSend.
En el árbol de consola, seleccione Filtros. Especifique un filtro al que suscribir la confirmación 997. Por ejemplo, en Propiedad, escriba BTS. MessageType; en Operador, escriba y, en Valor, escriba ==el esquema para la confirmación, por ejemplo,
http://schemas.microsoft.com/Edi/X12#X12_997_Root.Haga clic en OK.
En el árbol de consola, haga clic en Puertos de envío. En el panel Puertos de envío, haga clic con el botón derecho en el puerto de envío y, a continuación, haga clic en Iniciar.
Para crear un puerto de envío estático unidireccional para enviar la confirmación TA1
En el Explorador de Windows, cree una carpeta local a la que enviar la confirmación TA1.
En BizTalk Server Consola de administración, haga clic con el botón derecho en el nodo Puertos de envío en el nodo Aplicación de BizTalk 1, seleccione Nuevo y, a continuación, haga clic en Puerto de envío unidireccional estático.
En el cuadro de diálogo Propiedades del puerto de envío, asigne un nombre al puerto de envío.
En la sección Transporte , seleccione ARCHIVO para Tipo y, a continuación, haga clic en Configurar.
En Carpeta de destino, vaya a una carpeta para recibir la confirmación TA1. Esta carpeta la creó en el paso 1 de este procedimiento. En Máscara de archivo, escriba el formato de intercambio, como *.edi o *.txt.
Haga clic en OK.
En Enviar canalización, seleccione EdiSend.
En el árbol de consola, seleccione Filtros. Especifique un filtro al que suscribir la confirmación TA1. Por ejemplo, en Propiedad, escriba BTS. MessageType; en Operador, escriba y, en Valor, escriba ==el esquema para la confirmación, por ejemplo,
http://schemas.microsoft.com/Edi/X12#X12_TA1_Root.Haga clic en OK.
En el árbol de consola, haga clic en Puertos de envío. En el panel Puertos de envío, haga clic con el botón derecho en el puerto de envío y, a continuación, haga clic en Iniciar.
Para crear una entidad y un perfil de negocio para Fabrikam
Haga clic con el botón derecho en el nodo Partes de la consola de administración de BizTalk Server, seleccione Nuevoy, a continuación, haga clic en Parte.
Escriba un nombre para la entidad en el cuadro de texto Nombre y, a continuación, haga clic en Aceptar.
Nota
Al seleccionar la casilla Local BizTalk procesa los mensajes recibidos por la entidad OR admite el envío de mensajes de esta entidad, puede especificar que la entidad que se va a crear sea para la misma organización que también hospeda BizTalk Server. En función de ello, algunas propiedades estarán habilitadas o deshabilitadas cuando se crea un acuerdo. Sin embargo, para este tutorial, puede dejar activada esta casilla.
Haga clic con el botón derecho en el nombre de la entidad, seleccione Nuevoy, a continuación, haga clic en Perfil de negocio.
En el cuadro de diálogo Propiedades del perfil , en la página General , escriba Fabrikam_Profile en el cuadro de texto Nombre .
Nota
Cuando se crea una entidad, también se crea un perfil. Puede cambiar el nombre y usar ese perfil en lugar de crear uno nuevo. Para cambiar el nombre de un perfil, haga clic con el botón derecho en el perfil y seleccione Propiedades. En la página General , especifique un nombre para el perfil.
Para crear una entidad y un perfil de negocio para Contoso
Haga clic con el botón derecho en el nodo Partes de la consola de administración de BizTalk Server, seleccione Nuevoy, a continuación, haga clic en Parte.
Escriba un nombre para la entidad en el cuadro de texto Nombre y, a continuación, haga clic en Aceptar.
Nota
Al seleccionar la casilla Local BizTalk procesa los mensajes recibidos por la entidad OR admite el envío de mensajes de esta entidad, puede especificar que la entidad que se va a crear sea para la misma organización que también hospeda BizTalk Server. En función de ello, algunas propiedades estarán habilitadas o deshabilitadas cuando se crea un acuerdo. Sin embargo, para este tutorial, puede dejar activada esta casilla.
Haga clic con el botón derecho en el nombre de la entidad, seleccione Nuevoy, a continuación, haga clic en Perfil de negocio.
En el cuadro de diálogo Propiedades del perfil , en la página General , escriba Contoso_Profile en el cuadro de texto Nombre .
Nota
Cuando se crea una entidad, también se crea un perfil. Puede cambiar el nombre y usar ese perfil en lugar de crear uno nuevo. Para cambiar el nombre de un perfil, haga clic con el botón derecho en el perfil y seleccione Propiedades. En la página General , especifique un nombre para el perfil.
Para crear un acuerdo entre los dos perfiles de negocio
Haga clic con el botón derecho en Fabrikam_Profile, seleccione Nuevoy, a continuación, haga clic en Contrato.
En la página Propiedades generales , en el cuadro de texto Nombre , escriba un nombre para el contrato.
En la lista desplegable Protocolo , seleccione X12.
En la sección Second Partner (Segundo asociado ), en la lista desplegable Nombre , seleccione Contoso.
En la sección Second Partner (Segundo asociado ), en la lista desplegable Perfil , seleccione Contoso_Profile.
Observará que se agregan dos pestañas nuevas junto a la pestaña General . Cada pestaña es para configurar un contrato unidireccional y cada contrato unidireccional representa una transacción completa del mensaje (incluida la transferencia de mensajes y la transferencia de confirmación).
En la pestaña General , en la página Propiedades generales , en la sección Configuración de host común , seleccione Activar informes y, a continuación, seleccione Almacenar carga de mensajes para los informes.
Realice las siguientes tareas en la pestaña Fabrikam-Contoso>.
En la página Identificadores de la sección Configuración de intercambio, escriba valores para los campos calificador e identificador (ISA5, ISA6, ISA7 e ISA8) que corresponden a los valores de esos campos de encabezado en el mensaje de prueba.
Nota
BizTalk Server requiere los campos de calificador e identificador para el remitente y el receptor con el fin de realizar la resolución del contrato. Coincidirá con los valores de ISA5, ISA6, ISA7 e ISA8 en el encabezado de intercambio con los de las propiedades de un contrato. BizTalk Server también resolverá el contrato haciendo coincidir el calificador y el identificador del remitente (sin el calificador y el identificador del receptor). Si BizTalk Server no puede resolver el contrato, usará las propiedades del contrato de reserva.
Nota
Si usa el archivo SamplePO.txt del "Tutorial para desarrolladores de interfaz EDI" como mensaje de prueba, establezca ISA5 en ZZ, ISA6 en THEM, ISA7 en ZZ e ISA8 en EE. UU.
En la página Confirmación , en la sección Configuración de intercambio , active TA1 Esperado y 997 Esperado.
En la página Validación de la sección Configuración de intercambio , asegúrese de que la opción Buscar ISA13 duplicada esté desactivada.
Nota
Borrar la propiedad Check for duplicate ISA13 permite recibir varias instancias del mismo mensaje.
En la página Charset and Separators (Conjuntos de caracteres y separadores ) de la sección Configuración de intercambio , seleccione la opción CR LF .
En la página Configuración de host local de la sección Configuración de intercambio , desactive la opción Route ACK to send pipeline on request-response receive port (Enrutamiento de ACK para enviar canalización al puerto de recepción de solicitud-respuesta ).
Nota
Si usaba un puerto de recepción bidireccional para recibir el intercambio y devolver la confirmación, comprobaría route ACK para enviar canalización en el puerto de recepción de solicitud-respuesta.
En la página Puertos de envío de la sección Configuración de intercambio , asocie los puertos de envío que recibirán el intercambio desde Fabrikam y los puertos de envío que recibirán las confirmaciones de Contoso. En la cuadrícula Puertos de envío , en la columna Nombre , haga clic en una celda vacía y, en la lista desplegable, seleccione el puerto de envío creado para recibir el intercambio EDI de Fabrikam. Repita el paso para el puerto de envío creado para recibir la confirmación de TA1 y para el puerto de envío creado para recibir la confirmación de 997.
En la página Validación de la sección Configuración del conjunto de transacciones , deje activada la validación de tipos EDI y active Validación extendida.
Si usa uno de los esquemas estándar enviados con BizTalk Server, en la página Configuración de host local de la sección Configuración del conjunto de transacciones, seleccione el espacio de nombres del esquema que se usará para procesar el intercambio entrante. Si usa un esquema personalizado, escriba valores en la cuadrícula Personalizar espacio de nombres de destino para que BizTalk Server pueda determinar el espacio de nombres mediante los valores de encabezado de grupo y conjunto de transacciones.
En la página Sobres de la sección Configuración del conjunto de transacciones , escriba los valores de todas las columnas de la primera línea de la cuadrícula.
Use Para hacer esto Valor predeterminado Seleccione Predeterminado. Nota: Al seleccionar esta fila como valor predeterminado, los valores de GS1, GS2, GS3, GS7 y GS8 se usan incluso si los valores de Tipo de transacción, Versión/Versión y Espacio de nombres de destino no coinciden con el mensaje. Tipo de transacción Seleccione el tipo de mensaje del mensaje de prueba, 850 - Pedido de compra. Versión/Lanzamiento Escriba la versión edi 00401. Espacio de nombres de destino Seleccione http://schemas.microsoft.com/Edi/X12>.GS1 Compruebe que el tipo de mensaje del mensaje de prueba está seleccionado, pedido de compra (850). GS2 Escribir un valor para el remitente de aplicación. GS3 Escribir un valor para Receptor de aplicación. GS4 Seleccionar el formato de fecha que desee. Nota: Tiene que seleccionar el valor de la lista desplegable, no solo hacer clic en el campo para mostrar el valor predeterminado. Si hace clic en el campo sin seleccionar el valor de la lista desplegable, el valor no se seleccionará realmente. GS5 Seleccione el formato de hora que desee. GS7 Seleccione X - Comité de estándares acreditados X12. GS8 Compruebe que se ha especificado la versión de EDI, 00401. Nota
BizTalk Server establecerá los valores de GS01, GS02, GS03, GS04, GS05, GS07 y GS08 de las confirmaciones salientes en función de los valores especificados para Tipo de transacción, Versión/Versión y Espacio de nombres de destino. La canalización de envío intenta hacer coincidir el tipo de conjunto de transacciones, la versión X12 y el espacio de nombres de destino con los valores correspondientes del encabezado del mensaje. Si se ejecuta correctamente, usa los valores de GS asociados con los valores de tipo de transacción, versión y versión y espacio de nombres de destino .
Realice las siguientes tareas en la pestaña Contoso-Fabrikam>.
Nota
En este tutorial, especificamos el valor necesario en la ficha para que se pueda crear un acuerdo correctamente. Para crear correctamente un contrato, ambas pestañas de contrato unidireccional deben tener valores definidos para ISA5, ISA6, ISA7 e ISA8.
Nota
Aunque la confirmación forma parte de la misma transacción de mensaje, las propiedades relacionadas con cómo se debe generar la confirmación se configuran en la pestaña Contoso-Fabrikam>. Esto es necesario porque las propiedades de contexto de confirmación para los calificadores de remitente y receptor se establecen en lo contrario de los valores especificados en la pestaña Contoso-Fabrikam>. Por ejemplo, si los identificadores de remitente y receptor se establecen en THEM y US en la pestaña Fabrikam-Contoso>, las propiedades de contexto del remitente y del receptor se establecerán en US y THEM en la confirmación. Normalmente, la otra ficha de acuerdo unidireccional también tendrá los identificadores de remitente y receptor configurados respectivamente en NOSOTROS y ELLOS. Por lo tanto, el mensaje de confirmación se resolverá en dicho acuerdo y se seleccionará la configuración de propiedades. Por lo tanto, si desea que la confirmación use separadores de elementos diferentes o si desea que la confirmación use CR LF, especifique las propiedades en la pestaña Contoso-Fabrikam>.
Conceptualmente, las propiedades para la confirmación se seleccionarán desde cualquier ficha de acuerdo unidireccional que tenga los mismos calificadores de remitente y receptor que están configurados en las propiedades de contexto de la confirmación. No obstante, para facilitar su uso en la práctica, normalmente debe configurar esto en la otra ficha de acuerdo unidireccional del acuerdo que creó en el cual debe haberse resuelto el intercambio.
En la página Identificadores de la sección Configuración de intercambio, escriba los valores de los campos calificador e identificador (ISA5, ISA6, ISA7 e ISA8) que corresponden a los valores de esos campos de encabezado en el mensaje de prueba.
Nota
Si usa el archivo SamplePO.txt de "EDI Interface Developer Tutorial" como mensaje de prueba, establezca ISA5 en ZZ, ISA6 enUS, ISA7 en ZZ e ISA8 en THEM.
Haga clic en Aplicar.
Haga clic en OK. El acuerdo recién agregado aparece en la sección Acuerdos del panel Partes y perfiles de negocio . El acuerdo recién agregado está habilitado de forma predeterminada.
Probar el tutorial
Esta sección proporciona información acerca de cómo probar el tutorial.
Para probar el tutorial
En el Explorador de Windows, coloque el intercambio EDI de prueba en su carpeta de recepción local.
Nota
En un mensaje de prueba, puede usar el archivo SamplePO.txt usado en el tutorial de programadores de la interfaz EDI. Ese archivo se incluye en la carpeta \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial. Es un mensaje X12 850. Si usa este mensaje, debe haber implementado el esquema X12_00401_850.xsd que se incluye en la carpeta \Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\Inbound_EDI. No debe usar el esquema X12 850 en la carpeta \Program Files (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema.
Abra la carpeta asociada al puerto de envío para los intercambios y compruebe que ésta contiene el intercambio EDI.
Abra la carpeta asociada al puerto de envío para la confirmación 997 y compruebe que ésta contiene una confirmación 997.
Abra la carpeta asociada al puerto de envío para la confirmación TA1 y compruebe que ésta contiene una confirmación TA1.
Consulte también
Desarrollo y configuración de soluciones EDI de BizTalk Server
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de