Compartir a través de

Cómo exportar vinculaciones para la solución EDI-AS2

En este tema se describe cómo exportar la configuración desde un equipo configurado como una solución EDI o AS2. Esto le permite configurar la misma configuración en otro equipo de forma automatizada. 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 de .xml contiene toda la información pertinente para la configuración de BizTalk Server. Esto incluye todas las propiedades de configuración EDI y AS2, a 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 sobre los enlaces EDI/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 Cómo exportar una aplicación de BizTalk. O bien, puede usar el comando BTSTask para exportar e importar enlaces. Para obtener más información sobre BTSTask, consulta BTSTask Command-Line Reference.

Exportar enlaces

Al exportar la configuración, BizTalk Server exportará automáticamente las propiedades edi y la información de terceros de todas las partes enlazadas. Si activa la exportación de información de partido global, BizTalk Server también exportará propiedades para los partidos que no están vinculados a una orquestación, y también exportará los valores globales de EDI. Puede exportar la información de partes globales de tres maneras:

  • Al comprobar la propiedad "Export Global Party Information" en el cuadro de diálogo Exportar vínculos.

  • Al activar la casilla Partes globales en el panel Seleccionar recursos del Asistente para exportar archivos MSI.

  • Usando el conmutador GlobalParties en la herramienta de línea de comandos BTSTask, como se indica a continuación:

    BTSTask ExportBindings -Destination:value ((([-ApplicationName:value] | [-AssemblyName:value]) [-GlobalParties]) | [-GroupLevel])

    Por motivos de seguridad, al exportar un archivo de enlace, BizTalk Server quita las contraseñas de los enlaces del archivo. BizTalk Server quita campos UNB6.1 y UNB6.2 de propiedades EDIFACT e ISA1, ISA2, ISA3 e ISA4 de propiedades X12.

    Además de usar los comandos export-bindings, export-application o BTSTask, puede crear manualmente un archivo de enlace XML. Al hacerlo, puede exportar la configuración de entidad y EDI desde una aplicación de línea de negocio. A continuación, puede importar los enlaces mediante el comando import-bindings o el comando BTSTask.

Prerrequisitos

Debe iniciar sesión con una cuenta que sea miembro del grupo 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 vinculación

  1. En el equipo desde el que desea exportar la configuración, abra la Consola de administración de BizTalk Server.

  2. Haga clic con el botón derecho en la aplicación de BizTalk desde la que desea copiar la configuración, seleccione Exportar y, a continuación, haga clic en Enlaces.

    Nota:

    También puede usar la utilidad BTSTask para exportar o importar la configuración.

  3. Seleccione la opción de exportación, selecciónela para exportar desde la aplicación o grupo actual o exporte enlaces para un ensamblado.

  4. 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á ningún partido que no esté enlazado a una orquestación, a menos que haga clic en Exportar información de partido global.

    Nota:

    El archivo de vinculación generado cuando se selecciona la propiedad Exportar información de entidad global incluirá la configuración de todas las entidades definidas en el equipo. No es posible exportar la configuración de un subconjunto del conjunto completo de partes definidas en un equipo.

  5. Haga clic en Aceptar para exportar las vinculaciones.

    Nota:

    BizTalk Server no exportará ningún campo confidencial de EDI, como contraseñas o información de seguridad o autenticación. Exportará una cadena en blanco para cualquier campo confidencial de EDI. Después de importar los enlaces en otro equipo, debe establecer manualmente los valores de los campos confidenciales de EDI.

  6. Anote manualmente los campos confidenciales de EDI, como las contraseñas o la información de seguridad o autenticación, para una configuración posterior en el equipo en el que se importan 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 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 Party en el nodo Colección de partes y el nodo EdiGlobalProperties se agrega después, y en el mismo nivel que el nodo Colección de partes. 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, se requieren los subnodos bajo EdiData. Del mismo modo, el nodo EdiGlobalProperties es opcional; Sin embargo, si el nodo EdiGlobalProperties está presente, se requieren los subnodos debajo de él.

Los nodos de archivo de enlace EDI y AS2 no se corresponden directamente con las páginas de propiedades del Administrador de acuerdos de socios en la Consola de administración de BizTalk Server. Algunos nodos de archivo de enlace EDI y AS2 incluyen propiedades utilizadas para roles de remitente y propiedades utilizadas para roles de receptor. El rol se indica mediante la propiedad IsSender en el nodo. Para aquellos nodos que no se usan para roles de remitente y receptor (PartnerAgreement, PartnerBatchUpdatable, PartnerAS2Updatable y GlobalCommon), IsSender siempre es False.

Los nodos PartnerEdifact y PartnerX12 contienen propiedades para los roles de remitente y receptor, independientemente de si IsSender está configurado en True o False. Por ejemplo, PartnerEdifact incluirá un campo Una1 (utilizado para la parte como receptor de intercambio), incluso cuando IsSender sea True. PartnerEdifact también incluirá un campo denominado Unb5CheckDup (utilizado para la entidad como remitente de intercambio), incluso cuando IsSender sea False. Sin embargo, cuando IsSender es True, los campos de la entidad como receptor de intercambio no se usan en la interfaz de usuario o en el motor, pero se proporcionan valores predeterminados. Del mismo modo, cuando IsSender es False, los campos de la entidad como remitente de intercambio no se usan en la interfaz de usuario o en el motor, pero se proporcionan valores predeterminados.

Si el valor predeterminado de una propiedad es NULL, el campo no se incluirá en el archivo de enlace a menos que ese campo se haya dado un valor.

Los datos del archivo de enlace se guardan en tablas de la base de datos de administración de BizTalk (BizTalkMgmtDb).