Compartir a través de


Personalización de enumeraciones en el esquema envolvente

BizTalk Server le permite personalizar las enumeraciones de los campos de ID en el esquema de contenedor (servicio). Esto le permite recibir o enviar intercambios que tienen valores no estándar (fuera del conjunto de valores definidos por el cuerpo de estándares X12) en los campos de identificador de remitente o receptor en el sobre. También permite cambiar los calificadores que están disponibles en listas desplegables para los valores de encabezado en las definiciones de propiedades del acuerdo.

Importante

Al modificar un esquema, esa modificación se aplica a todas las transacciones del estándar en cuestión. No se puede realizar una modificación en el esquema de sobre para una sola entidad.

BizTalk Server extrae la lista de valores permitidos de esquemas de servicio estáticos en el Microsoft.BizTalk.Edi.BaseArtifacts.dll, que se incluye con el producto. Para ampliar el conjunto base de valores, debe desarrollar e implementar una extensión de esquema de servicio. BizTalk Server proporciona plantillas de esquemas de servicio que puede utilizar para modificar las enumeraciones. Estos esquemas de servicio son X12_ServiceSchemaExtension.xsd y EDIFACT_ServiceSchemaExtension.xsd. Cada esquema personalizado tendrá uno de los siguientes espacios de nombres, según el estándar. No se puede cambiar este espacio de nombres.

Estándar Namespace
X12 y HIPAA http://schemas.microsoft.com/BizTalk/EDI/X12/2006
EDIFACT http://schemas.microsoft.com/BizTalk/EDI/EDIFACT/2006

Haces los cambios en el esquema en el Editor de BizTalk en Visual Studio (consulte el procedimiento siguiente). Después de realizar los cambios necesarios, debe implementar el esquema.

En los lados de recepción y envío, cuando BizTalk Server valida los segmentos de sobre (ISA y GS para X12, o UNB y UNG para EDIFACT), comprobará la existencia del esquema de servicio personalizado en función de su espacio de nombres. Si se implementa el esquema personalizado, BizTalk Server combinará ese esquema con el esquema de servicio normal y usará los valores de enumeración personalizados y estándar donde se especifique. Puede personalizar el esquema para extender una lista de enumeraciones, pero no puede quitar valores de él. Si no se implementa un esquema personalizado, BizTalk Server usará el esquema de servicio estándar.

Después de implementar un esquema personalizado, la interfaz de usuario de Administración de socios comerciales (TPM) en la Consola de administración de BizTalk Server usará los valores de una enumeración personalizada para rellenar las listas desplegables adecuadas en las páginas de propiedades de TPM. Si no ha implementado un esquema personalizado, TPM usará los valores de las enumeraciones del esquema de servicio estándar. Además, el entorno de ejecución de BizTalk Server usará la enumeración personalizada para validar un mensaje.

Si usa las herramientas XML proporcionadas con BizTalk Server para validar una instancia con su sobre y ha personalizado el esquema de servicio, tendrá que incluir el esquema de servicio personalizado en el proyecto de BizTalk, además de los esquemas de documento (conjunto de transacciones) y, si es necesario, el esquema por lotes. Esto no es necesario si va a validar una instancia del conjunto de transacciones que no tiene un sobre.

Prerrequisitos

Debe iniciar sesión como miembro del grupo Administradores de BizTalk Server.

Campos del sobre que se pueden modificar

Solo se pueden modificar los siguientes campos del sobre. Solo estos campos se incluyen en los esquemas de extensión. Se agregaron otros campos en el esquema de extensión de servicio no tendrán ningún efecto en el procesamiento.

Estándar Campo
X12 y HIPAA ISA01: Calificador de autorización

ISA03: calificador de seguridad

ISA05: Calificador de ID de remitente

ISA07: calificador de ID del receptor

GS01: código funcional

GS07 - Agencia responsable
EDIFACT UNB2.2: calificador de código remitente

UNB3.2: calificador de código receptor

Campos de sobre que no se deben modificar

Algunos campos del sobre determinan los comportamientos en el motor. Como resultado, no debe agregar valores a la lista de enumeraciones existente para cualquiera de estos campos. Estos campos son los siguientes:

Estándar Campo
X12 y HIPAA ISA11: identificador de estándares de control de intercambio

ISA12: número de versión del control de intercambio

ISA14: confirmación solicitada
EDIFACT UNB1.1: identificador de sintaxis

UNB1.2: número de versión de sintaxis

UNB9: solicitud de confirmación

Para personalizar una enumeración en el esquema de sobres

  1. En Visual Studio, cree un nuevo proyecto.

  2. Agregue el esquema X12_ServiceSchemaExtension.xsd (para modificar las enumeraciones X12 o HIPAA) o el esquema EDIFACT_ServiceSchemaExtension.xsd en \Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema\EDI a un proyecto de BizTalk en el Editor de BizTalk. Abra el esquema.

  3. Para cambiar los valores de una enumeración, seleccione la enumeración en el panel Propiedades y, a continuación, haga clic en los puntos suspensivos para abrir el Editor de enumeraciones. Agregue a la lista de valores, según sea necesario, asegurándose de que hay un valor en cada línea del panel Valores . Haz clic en Aceptar.

    Importante

    No se puede cambiar el espacio de nombres del esquema de servicio. El esquema debe tener el mismo espacio de nombres y el nombre del nodo raíz que el esquema de extensión original instalado con el producto.

    Nota:

    Si fuera a agregar un nuevo campo a los esquemas, ese campo se omitiría. Solo se pueden cambiar los campos enumerados en la sección Campos de sobre que pueden modificarse más arriba.

  4. Guarde el esquema.

  5. Haga clic con el botón derecho en el esquema y haga clic en Implementar.

    Nota:

    El esquema debe implementarse en el grupo actual de BizTalk.

Véase también

Desarrollo de esquemas EDI
Modificación de esquemas EDI