Tutorial (X12): Envío de intercambios EDI

Artículo
07/21/2023

En este tutorial se proporciona un conjunto de procedimientos paso a paso que crean una solución para enviar intercambios EDI mediante BizTalk Server.

Requisitos previos

Debe haber iniciado sesión como miembro del grupo Administradores de BizTalk Server o BizTalk Server operadores B2B.

Cómo la solución envía intercambios EDI

La solución hará lo siguiente:

Un puerto de recepción de archivos unidireccional recibe un mensaje EDI de Fabrikam.
Mediante la canalización EdiReceive, el puerto de recepción comprueba el mensaje y lo convierte en XML. A continuación, el puerto de recepción coloca el mensaje de prueba en meassageBox.
Un puerto de envío unidireccional estático recoge el mensaje XML del cuadro de mensajes.
El puerto de envío unidireccional estático valida el mensaje EDI con el esquema de mensajes, serializa el mensaje EDI en un intercambio EDI y, a continuación, envía le mensaje EDI en la carpeta de local de Contoso del socio comercial.

La funcionalidad en esta solución

Este tutorial utiliza la siguiente funcionalidad:

La recepción de una confirmación no se prueba en este tutorial. Para comprender cómo recibir una confirmación, vea Tutorial mostrado (X12): Recepción de intercambios EDI y envío de una confirmación
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 la codificación EDIFACT e HIPAA es bastante parecida a la que usa la codificación X12.
El tipo de codificación EDI y la validación extendida se realizarán en el intercambio saliente.
La solución usa un puerto de envío unidireccional estático con un tipo de transporte de archivo.

Nota

En lugar de un puerto de envío unidireccional estático, puede utilizar un puerto de envío bidireccional estático para enviar el intercambio y recibir la confirmación. Puede también usar un puerto de envío unidireccional dinámico para enviar el intercambio. Para obtener más información sobre el uso de un puerto de envío dinámico, consulte Configuración de un puerto de envío dinámico para enviar intercambios EDI y confirmaciones.

Nota

Puede usar un adaptador de HTTP y transporte AS2. Para obtener más información sobre cómo hacerlo, vea Tutorial (AS2): Envío de EDI a través de AS2 con un MDN sincrónico o tutorial (AS2): Envío de EDI a través de AS2 con un MDN asincrónico.
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 una ubicación de recepción para recibir un mensaje de prueba.

La siguiente figura muestra la arquitectura para esta solución, que usa un puerto de envío unidireccional estático.

Configuración y prueba del tutorial

Los procedimientos necesarios para esta solución son:

Agregue los esquemas de mensaje necesarios a un proyecto de BizTalk y, a continuación, compile e implemente el proyecto, lo que hace que los esquemas estén disponibles para su uso por BizTalk Server en el procesamiento del intercambio saliente.
Cree un puerto de recepción y una ubicación para BizTalk Server para recibir el intercambio EDI. La ubicación de recepción está vinculada a la carpeta de archivo donde Fabrikam suelta el intercambio EDI que debe enviarse a Contoso. La ubicación de recepción usará una canalización de recepción EdiReceive.
Cree un puerto de envío para BizTalk Server para enviar el intercambio EDI a Contoso. En este tutorial se creará un puerto de envío unidireccional estático.
Crear una entidad (socio comercial) para Fabrikam y Contoso.
Crear un perfil de negocio para cada uno de los socios comerciales.
Crear un acuerdo entre los dos perfiles configurando las propiedades de EDI para que se reciba el mensaje.
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 para 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.
Escriba una carpeta para Receive folder (Carpeta de recepción) y escriba *.txt para la máscara de archivo.
Haga clic en OK.
En Canalización de recepción, seleccione EdiReceive.
Haga clic en Aceptar y, a continuación, haga clic en Aceptar de nuevo.
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 EDI.
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 el tipo, por ejemplo, FILE.
Si usa un tipo FILE, haga clic en Configurar. En La carpeta Destino, vaya a una carpeta a la que enviar el intercambio. En Nombre de archivo, escriba %MessageID%.edi. Haga clic en OK.
En Enviar canalización, seleccione EdiSend.
En el árbol de consola, seleccione Filtros y escriba una expresión de filtro para el puerto de envío que se usará para suscribirse al mensaje. Por ejemplo, puede utilizar la ubicación de recepción que recibirá el mensaje de prueba original como una expresión de filtro. Para ello, en Propiedad, escriba BTS. ReceivePortName; en Operador, escriba ==; y en Valor , escriba el nombre del puerto de recepción que creó para recibir el mensaje XML de Fabrikam.

Nota

Puede filtrar en otra propiedad distinta a la de su elección, por ejemplo, en BTS.MessageType.
Haga clic en OK.
Haga clic en el nodo Puertos de envío de la Consola de administración, 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 Entidad.
Escriba un nombre para la entidad en el cuadro de texto Nombre y, a continuación, haga clic en Aceptar.

Nota

Al activar la casilla Local BizTalk procesa los mensajes recibidos por la entidad O admite el envío de mensajes de esta entidad, puede especificar que la entidad que se va a crear es 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 Entidad.
Escriba un nombre para la entidad en el cuadro de texto Nombre y, a continuación, haga clic en Aceptar.

Nota

Al activar la casilla Local BizTalk procesa los mensajes recibidos por la entidad O admite el envío de mensajes de esta entidad, puede especificar que la entidad que se va a crear es 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 partner ), en la lista desplegable Nombre , seleccione Contoso.
En la sección Second Partner (Segundo partner ), 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 sirve 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 común del host , seleccione Activar informes y, a continuación, seleccione Almacenar la 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 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

BizTalk Server requiere los campos de calificador e identificador para remitente y receptor para realizar la resolución de acuerdos. 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, ISA6en THEM, ISA7 en ZZ e ISA8 en EE. UU.
En la página Validación de la sección Configuración de intercambio , asegúrese de que la opción Comprobar si hay ISA13 duplicada está desactivada.

Nota

Borrar la propiedad Check for duplicate ISA13 permite recibir varias instancias del mismo mensaje.
En la página Conjunto de caracteres y separadores de la sección Configuración de intercambio , seleccione la opción CR LF .
En la página Puertos de envío de la sección Configuración de intercambio , asocie el puerto de envío que recibirá el intercambio EDI de Fabrikam. 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.
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.

Use	Para hacer esto
Valor predeterminado	Activar la casilla en la columna Predeterminado.
Para ST1	Seleccione 850 - Pedido de compra.
GS2	Escriba THEM.
Espacio de nombres de destino	Seleccione `http://schemas.microsoft.com/BizTalk/EDI/X12/2006`.

Nota

Establecer las propiedades permite BizTalk Server determinar el esquema que se va a usar para procesar el intercambio entrante 850. Si un intercambio tiene los valores de GS02 y ST01 que se escriben en una línea de la cuadrícula, se utilizará el espacio de nombres de destino para la misma línea con el fin de determinar el esquema que se va a utilizar.

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	Active la casilla en la columna Predeterminado . Nota: Al seleccionar esta fila como valor predeterminado, los valores de GS1, GS2, GS3, GS7 y GS8 se usan aunque los valores de Tipo de transacción, Versión/Versión y Espacio de nombres de destino no coincidan 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/BizTalk/EDI/X12/2006`.
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.
1. 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.
En el Explorador de Windows, abra la carpeta de destino especificada para el puerto de envío. Compruebe que la carpeta contenga el intercambio EDI de salida que tiene encabezados ISA, GS y ST que coincidan con los valores que ha especificado en las propiedades de acuerdo.

Consulte también

Desarrollo y configuración de soluciones EDI de BizTalk Server

Share via