Cómo agregar un ensamblado de BizTalk a una aplicación

  • Artículo

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 BizTalk a una aplicación.

Al agregar el ensamblado de BizTalk a una aplicación, tenga en cuenta que los siguientes puntos son importantes:

  • Si desea agregar un ensamblado y sobrescribir otro con el mismo identificador local único (LUID) que ya existe en la aplicación, especifique la opción de sobrescritura. Si no se especifica y ya existe en la aplicación un ensamblado con el mismo LUID que el ensamblado agregado, se produce un error en la operación de agregación. El LUID incluye el nombre de archivo del ensamblado, así como su versión, referencia cultural y token de clave pública. Puede ver los LUID de los artefactos de una aplicación mediante el comando ListApp.

  • Si el ensamblado que está agregando tiene una dependencia en otro artefacto que no está incluido en la aplicación, se producirá un error en la operación de agregación.

  • Al agregar un ensamblado de BizTalk, 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.

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

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 de BizTalk a una aplicación

Mediante la consola de administración de BizTalk Server

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

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

  3. Expanda Administración de la aplicación la aplicación a la que desea agregar un ensamblado de BizTalk.

  4. Haga clic con el botón derecho en Recursos, seleccione Agregar y, a continuación, haga clic en Ensamblados de BizTalk.

  5. Haga clic en Agregar, seleccione el archivo de ensamblado de BizTalk y, a continuación, haga clic en Abrir.

  6. En Destino, escriba la ruta de acceso completa de la ubicación donde se va a copiar el archivo de ensamblado cuando se instale la aplicación desde el archivo .msi, incluido el nombre de archivo. Si no se proporciona, el archivo de ensamblado no se copia al sistema de archivos local durante instalación.

  7. En Opciones, especifique las opciones para instalar el ensamblado de BizTalk en la GAC y, a continuación, 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 cmdy, a continuación, haga clic en Aceptar.

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

    Ejemplo:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkAssembly /Overwrite /Source:"C:\BizTalk Assemblies\MyOrchestration.dll" /Destination:"C:\New BizTalk Assemblies\ MyOrchestration.dll " /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    Parámetro Value
    /Applicationname Nombre de la aplicación de BizTalk a la que se agrega el ensamblado de BizTalk. 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:BizTalkAssembly
    /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 LUID que el ensamblado que se agrega, se produce un error en la operación AddResource. Puede ver los LUID de los artefactos de una aplicación mediante el comando ListApp. Sin embargo, si otra aplicación depende del ensamblado que se está sobrescribiendo, se producirá un error en la operación AddResource aunque se especifique este parámetro.
    /Fuente Ruta de acceso completa del archivo de ensamblado, incluido el nombre de archivo. Si la ruta incluye espacios, la 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 incluye espacios, la debe encerrar entre comillas dobles (").
    /Opciones - GacOnAdd: especifique para instalar el ensamblado en la caché global de ensamblados (GAC) en el equipo local durante la operación AddResource.
    - GacOnInstall: especifique para instalar el ensamblado en la GAC cuando la aplicación se instala desde el archivo .msi.
    - GacOnImport: especifique para instalar el ensamblado en la GAC cuando se importe la aplicación .msi archivo.

    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 de BizTalk
AddResource (comando): Ensamblado de BizTalk