Agregar un archivo de enlace a una aplicación

Información general

Use la consola de administración de BizTalk Server o la línea de comandos para agregar un archivo de enlace a una aplicación de BizTalk. Es posible que quiera hacerlo para facilitar la implementación de aplicaciones o ensamblados, como se describe en Enlace de archivos y implementación de aplicaciones.

Puede exportar enlaces a un archivo .xml desde una aplicación de BizTalk para un ensamblado, una aplicación o un grupo, como se describe en Exportación de enlaces, y luego utilizar uno de los procedimientos mencionados en este tema para agregar el archivo de enlaces a una aplicación.

Al hacerlo, el archivo de enlace se agrega a la base de datos de administración de BizTalk y se muestra en la consola de administración de BizTalk Server, en la carpeta Recursos de la aplicación. A diferencia de importar un archivo de enlace, agregar un archivo de enlace no aplica inmediatamente sus enlaces. En su lugar, los enlaces se aplican cuando la aplicación se importa a otro grupo de BizTalk.

Importante

Por motivos de seguridad, al exportar enlaces, BizTalk Server quita las contraseñas de los enlaces del archivo. Después de importar los enlaces, debe volver a configurar las contraseñas para los puertos de envío y las ubicaciones de recepción antes de que puedan funcionar. Las contraseñas se configuran en el cuadro de diálogo Propiedades de transporte de la consola de administración de BizTalk Server para el puerto de envío o la ubicación de recepción. Consulte Crear un puerto de envío o Crear una ubicación de recepción.

Nota:

Al usar un archivo de enlace, debe comprobar que los artefactos se han enlazado al host correcto y que el nivel de confianza es adecuado.

Al agregar un archivo de enlace a una aplicación, puede especificar un valor para el entorno de implementación de destino con una cadena que represente el entorno, como Prueba o Producción. Puede usar cualquier cadena para este valor. A continuación, al importar la aplicación, puede seleccionar qué archivo de enlace se va a aplicar proporcionando el valor especificado para su entorno de destino. Al hacerlo, las vinculaciones se aplican desde el archivo de vinculación. Los enlaces existentes de la aplicación que tengan el mismo nombre que los enlaces del archivo se sobrescriben automáticamente.

Al importar una aplicación, los enlaces se aplican en el orden siguiente. A medida que se aplican enlaces durante el proceso de importación, los enlaces que ya se han aplicado se sobrescriben mediante nuevos enlaces que tienen el mismo nombre. En otras palabras, la última asignación de un nombre determinado que se va a aplicar entra en vigor.

1. Enlaces de aplicación generados por BizTalk Server que no se agregaron explícitamente a la aplicación a través de un archivo de enlace, pero que el usuario seleccionó explícitamente para exportarlo al archivo .msi de la aplicación.

2. Los archivos vinculantes que se han agregado de manera explícita y que no tienen un entorno de implementación de destino especificado. Los enlaces de este conjunto no se aplican en ningún orden específico.

3. Enlaces que se han agregado explícitamente y que tienen un entorno de implementación de destino asociado que coincide con el entorno de implementación seleccionado para la importación de la aplicación. Las vinculaciones de este conjunto se aplican en ningún orden específico.

   Para obtener más información sobre cómo importar aplicaciones y aplicar enlaces, vea Importar una aplicación de BizTalk.

Prerrequisitos

Inicie sesión con una cuenta que sea miembro del grupo Administradores de BizTalk Server. Los permisos necesarios para implementar y administrar una aplicación de BizTalk proporcionan más detalles.

Agregar un archivo de enlace mediante la administración de BizTalk

1. Abra Administración de BizTalk Server (en el menú Inicio).

2. Expanda Administración de BizTalk Server, expanda el grupo de BizTalk, expanda Aplicaciones y haga clic con el botón derecho en la aplicación a la que desea agregar un archivo de enlace.

3. Seleccione Agregar y, a continuación, haga clic en Recursos.

4. Haga clic en Agregar, seleccione el archivo que desea agregar y, a continuación, haga clic en Abrir.

5. Para sobrescribir un archivo de enlace existente en esta aplicación que tenga el mismo nombre de archivo, active la casilla Sobrescribir todo . Si existe otro archivo con el mismo nombre y no activa esta casilla, se producirá un error en la operación de adición.

6. En la lista desplegable Tipo de archivo , seleccione System.BizTalk:BizTalkBinding.

7. En el Entorno de destino, escriba una cadena que represente el entorno de implementación de destino donde desea que se apliquen los enlaces de este archivo, como "Test", y haga clic en Aceptar.

   Importante

   Si deja este campo en blanco, los enlaces de este archivo siempre se aplicarán al importar la aplicación.

   El archivo de enlace se agrega y se muestra en la carpeta Resources de la aplicación.

Adición de un archivo de enlace mediante la línea de comandos

1. Abra un símbolo del sistema (menú Inicio, escriba cmd, presione > y seleccione Símbolo del sistema).

2. Escriba el siguiente comando, sustituyendo los valores adecuados, como se describe en la tabla siguiente:

   BTSTask AddResource [/ApplicationName:"value"] /Type:System.BizTalk:BizTalkBinding [/Overwrite] /Source:value/Property:TargetEnvironment="value" [/Server:value] [/Database:value]

   Ejemplo:

   BTSTask AddResource /ApplicationName:"My Application" /Type:System.BizTalk:BizTalkBinding /Source:"C:\Binding Files\MyBinding.xml" /Property:TargetEnvironment="Production" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   Parámetro	Importancia
   /ApplicationName	Nombre de la aplicación de BizTalk a la que se va a agregar el archivo de enlace. Si no se especifica el nombre de la aplicación, se usa la aplicación predeterminada de BizTalk. Si el nombre incluye espacios, debe incluirlo entre comillas dobles (").
   /Tipo	System.BizTalk:BizTalkBinding (este valor no distingue mayúsculas de minúsculas).
   /Sobrescribir	Opción para actualizar un archivo de enlace existente. Si no se especifica y el archivo de enlace ya existe en la aplicación que tiene el mismo nombre de archivo que el archivo que se va a agregar, se produce un error en la operación AddResource.
   /Fuente	Ruta de acceso completa del archivo de enlace, incluido el nombre de archivo. Si la ruta de acceso incluye espacios, debe incluirla entre comillas dobles (").
   /Property:EntornoObjetivo=	Cadena que especifica el entorno de implementación de destino. Puede usar cualquier cadena, por ejemplo Production. Ejemplo: /Property:TargetEnvironment="Production" Si no se especifica, se aplica automáticamente un valor de <Default> . El valor distingue mayúsculas de minúsculas. Si el valor incluye espacios, debe incluirlo entre comillas dobles ("). La longitud máxima del valor del entorno es de 128 caracteres.
   /Servidor	Nombre de la instancia de SQL Server que hospeda la base de datos de administración de BizTalk, en el formulario NombreDeServidor\NombreDeInstancia,Puerto. El nombre de instancia solo es necesario cuando el nombre de instancia es diferente del nombre del servidor. El puerto solo es necesario cuando SQL Server usa un número de puerto distinto del predeterminado (1433). Ejemplos: Server=MyServer Servidor=MyServer\MySQLServer,1533 Si no se proporciona, se usa el nombre de la instancia de SQL Server que se ejecuta en el equipo local.
   /Base de datos	Nombre de la base de datos de administración de BizTalk. Si no se especifica, se usa la base de datos de administración de BizTalk que se ejecuta en la instancia local de SQL Server.

Véase también

Administración de ensamblados, certificados y otros recursos de .NET
Comando AddResource: Enlace de BizTalk
Crear y modificar aplicaciones de BizTalk