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 de .xml desde una aplicación de BizTalk para un ensamblado, una aplicación o un grupo, como se describe en Exportar enlaces y, a continuación, usar uno de los procedimientos de este tema para agregar el archivo de enlace 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 lo que ocurre al importar un archivo de enlace, agregar un archivo de enlace no aplica inmediatamente los enlaces que contiene. En cambio, los enlaces se aplican cuando la aplicación se importa a otro grupo de BizTalk.

Importante

Por motivos de seguridad, cuando se exportan enlaces, BizTalk Server quita las contraseñas de los enlaces del archivo. Después de importar los enlaces, deberá volver a configurar las contraseñas para que funcionen los puertos de envío y las ubicaciones de recepción. Configure las contraseñas 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.

Cuando se agrega un archivo de enlace a una aplicación, puede especificar un valor para el entorno de implementación de destino mediante una cadena que representa el entorno (de prueba, o producción, por ejemplo). Puede utilizar cualquier cadena para este valor. Posteriormente, cuando importe la aplicación, podrá seleccionar qué archivo de enlace desea aplicar proporcionando el valor especificado para su entorno de destino. Al hacerlo, los enlaces se aplican desde el archivo de enlace: Los enlaces existentes en la aplicación que tengan el mismo nombre que los enlaces del archivo se sobrescriben automáticamente.

Cuando se importa una aplicación, los enlaces se aplican en el orden siguiente. A medida que se aplican los enlaces durante el proceso de importación, los enlaces que ya se han aplicado se sobrescriben con enlaces nuevos que tienen el mismo nombre. Es decir, surtirá efecto el último enlace de un nombre concreto que se aplica.

1. Los enlaces de la aplicación generados por BizTalk Server que no se agregaron explícitamente a la aplicación mediante un archivo de enlace, pero que el usuario seleccionó explícitamente para exportarlos al archivo .msi de la aplicación.

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

3. Los enlaces que se ha 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. Los enlaces de este conjunto no 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.

Requisitos previos

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 BizTalk Server Administración, 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 al agregar.

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

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

   Importante

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

   Se agrega el archivo de enlace y se muestra en la carpeta Recursos de la aplicación.

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

1. Abra un símbolo del sistema (en el menú >Inicio, escriba cmd> el símbolo del sistema).

2. Escriba el siguiente comando, sustituyendo los valores según corresponda, como se describe en la tabla que se presenta a continuación:

   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	Value
   /Applicationname	Nombre de la aplicación de BizTalk a la que se agrega el archivo de enlace. Si no se especifica el nombre de aplicación, se utiliza 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 completa del archivo de enlace, incluido el nombre de archivo. Si la ruta incluye espacios, la debe encerrar entre comillas dobles (").
   /Property:TargetEnvironment=	Cadena que especifica el entorno de implementación de destino. Puede utilizar cualquier cadena, por ejemplo Producción. 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, lo debe encerrar entre comillas dobles ("). La longitud máxima del valor del entorno es 128 caracteres.
   /Servidor	Nombre del servidor SQL Server que aloja la base de datos de administración de BizTalk en el formato Nombredelservidor\Nombredeinstancia,Puerto. Sólo se necesita el nombre de instancia cuando el nombre de instancia es diferente del nombre de servidor. Sólo se necesita el puerto cuando el servidor SQL Server utiliza un nombre de puerto diferente al predeterminado (1433) Ejemplos: Servidor = MyServer Servidor = MyServer\MySQLServer,1533 Si no se proporciona, se utiliza el nombre de la instancia de SQL Server que se ejecuta en el equipo local.
   /Base	Nombre de la base de datos de administración de BizTalk. Si no se especifica, se utiliza la base de datos de administración de BizTalk que se ejecuta en la instancia local de SQL Server.

Consulte también

Administración de ensamblados .NET, certificados y otros recursos
AddResource (comando): Enlace de BizTalk
Creación y modificación de aplicaciones de BizTalk