Cómo agregar un ensamblado .NET a una aplicación

Artículo
07/21/2023

En este tema se describe cómo usar la consola de administración de BizTalk Server o la línea de comandos para agregar un ensamblado .NET (que no sea un ensamblado de BizTalk) a una aplicación de BizTalk. Al agregar un ensamblado .NET a una aplicación, tenga en cuenta que los siguientes puntos son importantes:

Si desea sobrescribir un ensamblado que ya existe en la aplicación, especifique la opción Sobrescribir. La opción de sobrescritura sólo es necesaria cuando los ensamblados tienen el mismo LUID. Si no se especifica y ya existe un ensamblado en la aplicación que tiene el mismo LUID que el ensamblado que se agrega, se produce un error en la operación de agregación. Puede ver los LUID de los artefactos de una aplicación mediante el comando ListApp.
Al agregar un ensamblado .NET, puede especificar una o varias de las siguientes opciones para la instalación del ensamblado a la caché de ensamblados global (GAC):
- Agregar a la caché de ensamblados global a la hora de agregar recursos (gacutil): al seleccionar esta opción, el ensamblado se instala en la GAC del equipo local cuando se agrega el ensamblado a una aplicación mediante los procedimientos que se describen en este tema.
- Agregar a la caché de ensamblados global en la importación de archivos MSI (gacutil): al seleccionar esta opción, si se ha exportado la aplicación a un archivo .msi y el archivo .msi se ha importado en un grupo de BizTalk, el ensamblado se instala en la GAC del equipo local como parte del proceso de importación. Seleccione esta opción cuando la aplicación incluya una directiva así como el ensamblado del que dependa la directiva. Es necesario hacerlo de este modo porque, cuando se importa una aplicación que contiene una directiva, cualquier ensamblado del que dependa la directiva debe estar presente en la GAC.
- Agregar a la caché de ensamblados global en la instalación de archivos MSI (gacutil): Al seleccionar esta opción, si se ha exportado la aplicación a un archivo .msi y se ha instalado la aplicación en un equipo desde el archivo .msi, el ensamblado se instala en la GAC del equipo local como parte del proceso de instalación.
- Hacer visible para componentes COM (regasm): al seleccionar esta opción, si la aplicación se ha exportado a un archivo .msi y se ha instalado en un equipo desde el archivo .msi, se agrega un ensamblado COM administrado al Registro de Windows en el equipo local como parte del proceso de instalación. Si especifica esta opción, también debe especificar una ubicación para el archivo en Destino.
- Registrar componentes con servicios (regsvcs): al seleccionar esta opción, si la aplicación se ha exportado a un archivo .msi y se ha instalado en un equipo desde el archivo .msi, se agrega un ensamblado COM+ administrado al Registro de Windows en el equipo local como parte del proceso de instalación. Si especifica esta opción, también debe especificar una ubicación para el archivo en Destino.

Requisitos previos

Para realizar los procedimientos descritos en este tema, deberá iniciar la sesión con una cuenta que sea miembro del grupo de administradores de BizTalk Server. Para obtener información más detallada sobre los permisos, vea Permisos necesarios para implementar y administrar una aplicación de BizTalk.

Para agregar un ensamblado .NET a una aplicación

Mediante la consola de administración de BizTalk Server

Haga clic en Inicio, en Todos los programas, en Microsoft BizTalk Server 20xx y, a continuación, en Administración de BizTalk Server.
En el árbol de consola, expanda BizTalk Server Administración, expanda el grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación a la que desea agregar el ensamblado de .NET.
Haga clic con el botón derecho en la carpeta Recursos , seleccione Agregar y, a continuación, haga clic en Recursos.
Haga clic en Agregar, haga clic en el ensamblado y, a continuación, haga clic en Abrir.
En la lista desplegable Tipo de archivo , seleccione System.BizTalk:Assembly.
En Opciones, seleccione las opciones de implementación de este ensamblado.
En Destino, escriba la ruta de acceso completa de la ubicación donde se va a copiar el archivo cuando se instale la aplicación desde el archivo .msi, incluido el nombre de archivo. Si no se proporciona la ruta, el archivo no se copiará en el sistema de archivos local durante instalación. Para copiar el archivo en la carpeta de instalación de la aplicación, puede usar la variable de entorno %BTAD_InstallDir% en la ruta, que toma el valor de la carpeta de instalación de la aplicación cuando se instala la aplicación. De este modo, no es necesario que conozca la ruta de la carpeta de instalación de la aplicación cuando especifique la ubicación de destino.

Ejemplo: %BTADInstall_Dir%\Assemblies\Orchestrations.dll
Haga clic en la pestaña Dependencias y vea los artefactos en los que depende este ensamblado.
Si un artefacto en el que depende este ensamblado no está presente en esta aplicación y desea agregarlo, haga clic en Agregar a la aplicación, vaya al artefacto y, a continuación, haga clic en Abrir.
Cuando termine, haga clic en Aceptar.

Uso de la línea de comandos

Abra un símbolo del sistema como se indica a continuación: haga clic en Inicio, haga clic en Ejecutar, escriba cmdy, a continuación, haga clic en Aceptar.

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:Assembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstallRegsvcsOnInstall|] [/Server:value] [/Database:value]

Ejemplo:

BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Assembly /Overwrite /Source:"C:\Source Assemblies\MyAssembly.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\MyAssembly.dll" /Options:GacOnAdd,RegasmOnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

Parámetro	Value
/Applicationname	Nombre de la aplicación de BizTalk a la que se agrega el ensamblado. Si no se especifica el nombre de aplicación, se utiliza la aplicación predeterminada de BizTalk para el grupo. Si el nombre incluye espacios, debe incluirlo entre comillas dobles (").
/Tipo	System.BizTalk:Assembly (este valor no distingue mayúsculas de minúsculas).
/Sobrescribir	Opción para actualizar un ensamblado existente. Si no se especifica y ya existe un ensamblado en la aplicación que tiene el mismo nombre completo que el ensamblado que se agrega, se produce un error en la operación AddResource. El nombre completo consta del nombre del archivo de ensamblado, de la versión, de la referencia cultural y del token de clave pública. Puede ver los LUID de los artefactos de una aplicación mediante el comando ListApp.
/Fuente	Ruta de acceso completa del archivo de ensamblado, incluido el nombre de archivo. Si la ruta incluye espacios, los debe encerrar entre comillas dobles (").
/Destino	Ruta completa de la ubicación en la que se va a copiar el archivo de ensamblado cuando se instale la aplicación desde el archivo .msi. Si no se proporciona, el archivo de ensamblado no se copia al sistema de archivos local durante instalación. Si la ruta tiene espacios, los debe encerrar entre comillas dobles ("). Si especifica la opción RegasmOnInstall o RegsvcsOnInstall, también debe especificar Destino. Nota: Puede usar la variable de entorno %BTAD_InstallDir% en la ruta de acceso. Toma el valor de la carpeta de instalación de la aplicación cuando se instala la aplicación. De este modo, no es necesario que conozca la ruta de la carpeta de instalación de la aplicación cuando especifique la ubicación de destino. Ejemplo: %BTAD_InstallDir%\Assemblies\Orchestrations.dll
/Opciones	- GacOnAdd: instale el ensamblado en la caché global de ensamblados (GAC) en el equipo local durante la operación AddResource. - GacOnInstall: instale el ensamblado en la GAC cuando la aplicación esté instalada desde el archivo .msi. - GacOnImport: instale el ensamblado en la GAC cuando se importe la aplicación .msi archivo. - RegasmOnInstall: agregue un ensamblado COM administrado al Registro de Windows cuando la aplicación se instale desde el archivo .msi. Si especifica esta opción, también debe especificar Destino. - RegsvcsOnInstall:Add a managed COM+ assembly to the Windows registry when the application is installed from the .msi file. Si especifica esta opción, también debe especificar Destino. Debe separar varias opciones mediante una coma.
/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): ensamblado de .NET
Creación y modificación de aplicaciones de BizTalk

Compartir a través de