Compartir vía

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

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 de .NET que no es un ensamblado de BizTalk a una aplicación de BizTalk. Al agregar un ensamblado de .NET a una aplicación, tenga en cuenta los siguientes puntos importantes:

  • Si desea sobrescribir un ensamblado que ya existe en la aplicación, especifique la opción Sobrescribir. La opción de sobrescritura solo es necesaria cuando ambos ensamblados tienen el mismo LUID. Si no se especifica y ya existe un ensamblado en la aplicación con el mismo LUID que el ensamblado que se agrega, se producirá un error en la operación de adición. Puede ver los LUID de los artefactos de una aplicación mediante el comando ListApp.

  • Al agregar un ensamblado de .NET, puede especificar una o varias de las siguientes opciones para instalar el ensamblado en la caché global de ensamblados (GAC):

    • Agregue al caché global de ensamblados al agregar un recurso usando gacutil. Al seleccionar esta opción, el ensamblado se instala en la GAC del equipo local cuando el ensamblado se agrega a una aplicación, como resultado del uso de los procedimientos de este tema.

    • Agregue a la caché global de ensamblados en la importación de archivos MSI (gacutil). Al seleccionar esta opción, si la aplicación se exporta a un archivo .msi y el archivo .msi se importa 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 un ensamblado en el que depende la directiva. Debe hacerlo porque, al importar una aplicación que contiene una directiva, los ensamblados de los que depende la directiva deben estar presentes en la GAC.

    • Agregue a la caché global de ensamblados en la instalación de archivos MSI (gacutil). Al seleccionar esta opción, si la aplicación se exporta a un archivo .msi y la aplicación se instala 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 visibles los componentes COM (regasm). Al seleccionar esta opción, si la aplicación se exporta a un archivo .msi y la aplicación se instala 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 servidos (regsvcs). Al seleccionar esta opción, si la aplicación se exporta a un archivo .msi y la aplicación se instala 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.

Prerrequisitos

Para realizar los procedimientos de este tema, debe iniciar sesión con una cuenta que sea miembro del grupo 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 de .NET a una aplicación

Uso de la consola de administración de BizTalk Server

  1. Haga clic en Inicio, todos los programas, Microsoft BizTalk Server 20xx y, a continuación, haga clic en Administración de BizTalk Server.

  2. En el árbol de consola, expanda Administración de BizTalk Server, expanda el grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación a la que desea agregar el ensamblado .NET.

  3. Haga clic con el botón derecho en la carpeta Recursos , seleccione Agregar y, a continuación, haga clic en Recursos.

  4. Haga clic en Agregar, haga clic en el ensamblado y, a continuación, haga clic en Abrir.

  5. En la lista desplegable Tipo de archivo , seleccione System.BizTalk:Assembly.

  6. En Opciones, seleccione las opciones de implementación de este ensamblado.

  7. En Destino, escriba la ruta de acceso completa de la ubicación donde se va a copiar el archivo cuando se instala la aplicación desde el archivo .msi, incluido el nombre de archivo. Si no se proporciona esta ruta de acceso, el archivo no se copia en el sistema de archivos local durante la 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 de acceso, 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 conocer la ruta de acceso de la carpeta de instalación de la aplicación al especificar la ubicación de destino.

    Ejemplo: %BTADInstall_Dir%\Assemblies\Orchestrations.dll

  8. Haga clic en la pestaña Dependencias y vea los artefactos en los que depende este ensamblado.

  9. 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.

  10. Cuando termine, haga clic en Aceptar.

Uso de la línea de comandos

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

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

    BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Assembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/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 Importancia
    /ApplicationName Nombre de la aplicación de BizTalk a la que se va a agregar el ensamblado. Si no se especifica el nombre de la aplicación, se usa 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 va a agregar, se produce un error en la operación AddResource. El nombre completo incluye el nombre del archivo de ensamblado, la versión, la referencia cultural y el token de clave pública. Puede ver los LUID de los artefactos de una aplicación mediante el comando ListApp.
    /Fuente Ruta completa del archivo de ensamblado, incluido el nombre del archivo. Si la ruta de acceso incluye espacios, debe incluirla entre comillas dobles (").
    /Destino Ruta de acceso completa de la ubicación donde se va a copiar el archivo de ensamblaje cuando se instala la aplicación desde el archivo .msi. Si no se proporciona, el archivo de ensamblado no se copia en el sistema de archivos local durante la instalación. Si la ruta de acceso tiene espacios, debe incluirla entre comillas dobles ("). Si especifica la opción RegasmOnInstall o RegsvcsOnInstall, también debe especificar Destination. Nota: Puede usar la variable de entorno %BTAD_InstallDir% en la ruta. 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 conocer la ruta de acceso de la carpeta de instalación de la aplicación al especificar 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 el archivo de la aplicación .msi.
    - RegasmOnInstall: agregue un ensamblado COM administrado al Registro de Windows cuando la aplicación esté instalada desde el archivo .msi. Si especifica esta opción, también debe especificar el destino.
    - RegsvcsOnInstall:Agregue un ensamblado COM+ administrado al Registro de Windows cuando la aplicación esté instalada desde el archivo .msi. Si especifica esta opción, también debe especificar Destino.

    Debe separar varias opciones con una coma.
    /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: ensamblaje de .NET
Crear y modificar aplicaciones de BizTalk

  • Last updated on