Personalizar enumeraciones en el esquema de sobres
BizTalk Server permite personalizar las enumeraciones de campos de identificador en el esquema de servicio (sobre). Esto le permite recibir o enviar intercambios que tengan valores que no sean estándar (que estén fuera del conjunto de valores definidos por el organismo de estándares de X12) en los campos de Id. de remitente o de receptor del sobre. También permite cambiar los calificadores disponibles en las listas desplegables para los valores de encabezado en definiciones de propiedades de acuerdo.
Importante
Cuando se modifica un esquema, se aplica la misma modificación para 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 distribuye con el producto. Para ampliar el conjunto de valores base, debe desarrollar e implementar una extensión de esquema de servicio. BizTalk Server proporciona plantillas de esquema de servicio (sobre) que puede usar para modificar las enumeraciones de . Estos esquemas de servicio son X12_ServiceSchemaExtension.xsd y EDIFACT_ServiceSchemaExtension.xsd. Cada esquema personalizado tendrá uno de los siguientes espacios de nombres, en función del estándar. Este espacio de nombres no puede modificarse.
| Estándar | Espacio de nombres |
|---|---|
| X12 y HIPAA | http://schemas.microsoft.com/BizTalk/EDI/X12/2006 |
| EDIFACT | http://schemas.microsoft.com/BizTalk/EDI/EDIFACT/2006 |
Realice los cambios en el esquema en el Editor de BizTalk en Visual Studio (vea el siguiente procedimiento). Una vez realizados estos cambios necesarios, debe implementar el esquema.
Tanto para la recepción como para el 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 el esquema personalizado se implementa, BizTalk Server combinará ese esquema con el esquema de servicio habitual, y usará tanto los valores de enumeración personalizados como estándar cuando se especifique. Puede personalizar el esquema para ampliar una lista de enumeraciones, pero no puede quitarle valores. Si un esquema personalizado no se implementa, BizTalk Server usará el esquema de servicio estándar.
Después de implementar un esquema personalizado, la interfaz de usuario de Trading Partner Management (TPM) de 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 tiempo 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 de conjuntos de transacciones que no tiene sobre.
Requisitos previos
Debe haber iniciado sesión como miembro del grupo de administradores de BizTalk Server.
Campos de sobre que pueden modificarse
Sólo pueden modificarse los siguientes campos de sobre. Sólo se incluyen estos campos en los esquemas de extensiones. La agregación de otros campos en el esquema de extensión de servicio no tendrá ningún efecto en el procesamiento.
| Estándar | Campo |
|---|---|
| X12 y HIPAA | ISA01: calificador de autorización ISA03: calificador de seguridad ISA05: calificador Id. de remitente ISA07: calificador de Id. de receptor GS01: código funcional GS07: agencia responsable |
| EDIFACT | UNB2.2: calificador de código de remitente UNB3.2: calificador de código de receptor |
Campos de sobre que no deben modificarse
Algunos campos del sobre generan 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 de control de intercambio ISA14: confirmación solicitada |
| EDIFACT | UNB 1.1: identificador de sintaxis UNB 1.2: número de versión de sintaxis UNB9: solicitud de confirmación |
Para personalizar una enumeración en el esquema de sobres
En Visual Studio, cree un nuevo proyecto.
Agregue el esquema X12_ServiceSchemaExtension.xsd (para modificar 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.
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 . Haga clic en OK.
Importante
No puede cambiar el espacio de nombres del esquema de servicio. El esquema debe tener el mismo espacio de nombres y el mismo nombre de nodo raíz que el esquema de extensión original instalado con el producto.
Nota
Si agrega un campo nuevo a los esquemas, ese campo se ignorará. Solo se pueden cambiar los campos enumerados en la sección Campos de sobre que se puede modificar anteriormente.
Guarde el esquema.
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.