Exportación de enlaces para una solución EDI-AS2
En este tema se describe cómo exportar la configuración de un equipo configurado como solución EDI y/o AS2. Permite definir la misma configuración en otro equipo de forma automática. Puede exportar los enlaces desde una aplicación, un grupo o un ensamblado.
Cree un archivo de enlace desde la consola de administración de BizTalk Server. El archivo de enlace .xml contiene toda la información relativa a la configuración de BizTalk Server. Esto incluye todas las propiedades de configuración de EDI y AS2, con la excepción de cierta información de seguridad. Para obtener información detallada sobre los nodos de un archivo de enlace (incluidos los nodos EDI y AS2), vea Estructura de un archivo de enlace. Para obtener información general acerca de los enlaces EDI y AS2, vea "Nodos EDI y AS2 en el archivo de enlace de BizTalk Server" a continuación.
También puede exportar enlaces como parte de la exportación de una aplicación mediante un archivo .msi. Para obtener más información, vea How to Export a BizTalk Application. También puede utilizar el comando BTSTask para exportar e importar enlaces. Para obtener más información sobre BTSTask, consulta BTSTask Command-Line Reference.
Exportación de enlaces
Al exportar la configuración, BizTalk Server exportará de forma automática las propiedades EDI y otra información de entidades de todas las entidades enlazadas. Si activa la exportación de la información de entidad global, BizTalk Server también exportará las propiedades de las entidades que no estén enlazadas con la orquestación y las propiedades EDI globales. Puede exportar información de entidad global de tres formas distintas:
Activando la propiedad Exportar información de entidad global en el cuadro de diálogo Exportar enlaces.
Activando la casilla de verificación Entidades globales en el panel Seleccionar recursos del Asistente para exportación de archivos MSI.
Utilizando el conmutador GlobalParties de la herramienta de línea de comandos BTSTask del modo que se muestra a continuación:
BTSTask ExportBindings -Destination:value ((([-ApplicationName:value] | [-AssemblyName:value]) [-GlobalParties]) | [-GroupLevel])
Por motivos de seguridad, cuando exporte un archivo de enlace, BizTalk Server quita las contraseñas de los enlaces del archivo. BizTalk Server quita los campos UNB6.1 y UNB6.2 de las propiedades de EDIFACT y los campos ISA1, ISA2, ISA3 e ISA4 de las propiedades de X12.
Además de utilizar los comandos export-bindings, export-application o BTSTask, puede crear un archivo de enlace XML de forma manual. Al hacerlo, puede exportar la configuración de EDI y de entidad desde una aplicación de línea empresarial. A continuación, podría importar los enlaces mediante el comando import-bindings o el comando BTSTask.
Requisitos previos
Es preciso haber iniciado sesión con una cuenta que sea miembro del grupo de administradores de BizTalk Server. Para obtener más información, vea "Permisos necesarios para implementar y administrar una aplicación de BizTalk" en la documentación de BizTalk Server.
Exportar la configuración a un archivo de enlace
En el equipo desde el que desea exportar la configuración, abra la consola de administración de BizTalk Server.
Haga clic con el botón derecho en la aplicación de BizTalk desde la que desea copiar la configuración, seleccione Exportary, a continuación, haga clic en Enlaces.
Nota
También puede utilizar la utilidad BTSTask para exportar o importar la configuración.
Seleccione la opción de exportación e indique que la exportación se va a realizar desde la aplicación o el grupo actual, o bien exportando los enlaces de un ensamblado.
Si desea exportar todas las partes y sus propiedades no confidenciales, incluso si una orquestación no está enlazada a ellas, haga clic en Exportar información de entidad global.
Nota
Si no hace clic en Exportar información de entidad global, BizTalk Server exportará propiedades para las partes enlazadas a una orquestación, en el archivo de enlace. Sin embargo, no exportará ninguna parte que no esté enlazada a una orquestación, a menos que haga clic en Exportar información de entidad global.
Nota
El archivo de enlace generado mientras se selecciona la propiedad Exportar información de entidad global incluirá la configuración de todas las partes definidas en el equipo. No es posible exportar la configuración de un subconjunto del conjunto completo de entidades definido en un equipo.
Haga clic en Aceptar para exportar los enlaces.
Nota
BizTalk Server no exportará ningún campo confidencial de EDI, como contraseñas o información de autenticación o seguridad. Exportará una cadena en blanco por cada campo confidencial de EDI. Tras importar los enlaces en otro equipo, debe establecer manualmente los valores de los campos confidenciales de EDI.
Anote manualmente todos los campos confidenciales de EDI, como las contraseñas o la información de autenticación o seguridad para definirlos más tarde en el equipo en el que esté importando los enlaces.
Nodos EDI y AS2 en el archivo de enlace de BizTalk Server
Si exporta la configuración con la propiedad Exportar información de entidad global seleccionada, BizTalk Server generará un archivo de enlace que tenga esos nodos siguientes:
EdiData
PartyEDIProperties
PartnerAgreement
Contacts
PartnerEdifact
PartnerEdifactReceiverGroups
PartnerEdifactSenderGroups
PartnerAckValidation
PartnerX12
PartnerX12ReceiverGroups
PartnerX12SenderGroups
PartnerBatchUpdatable
PartnerAS2CommonUpdatable
PartnerAS2
Las propiedades globales de EDI se agregarán al archivo de enlace en los nodos siguientes.
EDIGlobalProperties
EDIGlobalProperties
GlobalCommon
GlobalEdiFact
GlobalX12
Los nodos EDI y AS2 se agregan al final del archivo de enlace de BizTalk Server. El nodo EdiData se agrega al subnodo Entidad bajo el nodo Colección de entidades y el nodo EdiGlobalProperties se agregará más tarde y al mismo nivel que el nodo Colección de entidades. Para obtener más información sobre los nodos EDI y AS2 en el archivo de enlace de BizTalk, vea Estructura de un archivo de enlace.
El nodo EdiData es opcional. Sin embargo, si el nodo EdiData está presente, serán necesarios los subnodos de EdiData. De forma similar, el nodo EdiGlobalProperties es opcional; sin embargo, si está presente el nodo EdiGlobalProperties, serán necesarios los subnodos de éste.
Los nodos de archivo de enlace EDI y AS2 no se corresponden directamente con las páginas de propiedades del Administrador de contratos de partners en la consola de administración de BizTalk Server. Algunos nodos del archivo de enlace de EDI y AS2 incluyen propiedades utilizadas para las funciones de remitente y propiedades utilizadas para las funciones del receptor. La propiedad IsSender en el nodo indica la función. Para los nodos que no se utilicen para funciones de remitente y receptor (PartnerAgreement, PartnerBatchUpdatable, PartnerAS2Updatable y GlobalCommon), IsSender tendrá siempre el valor False.
Los nodos PartnerEdifact y PartnerX12 contienen propiedades para funciones de remitente y receptor, independientemente de que IsSender esté definido como True o False. Por ejemplo, PartnerEdifact incluirá un campo Una1 (utilizado para la entidad como receptor de intercambio), incluso si IsSender tiene el valor True. Por ejemplo, PartnerEdifact incluirá un campo Unb5CheckDup (utilizado para la entidad como remitente de intercambio), incluso si IsSender tiene el valor False. Sin embargo, si IsSender tiene el valor True, los campos de la entidad como receptor de intercambio no se utilizan en la IU ni en el motor, pero se ofrecen como valores predeterminados. De forma similar, si IsSender tiene el valor False, los campos de la entidad como remitente de intercambio no se utilizan en la IU ni en el motor, pero se ofrecen como valores predeterminados.
Si el valor predeterminado de una propiedad es nulo, el campo no se incluirá en el archivo de enlace a menos que se le haya otorgado un valor al campo.
Los datos del archivo de enlace se guardan en tablas de la base de datos de administración de BizTalk (BizTalkMgmtDb).