Compartir a través de

Cómo agregar un componente COM 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 componente COM a una aplicación de BizTalk.

Al agregar un componente COM a una aplicación, tenga en cuenta que los siguientes puntos son importantes:

  • Si desea sobrescribir un componente COM que ya existe en la aplicación, especifique la opción Sobrescribir. La opción de sobrescritura solo es necesaria cuando ambos artefactos tienen el mismo LUID. Si no se especifica y ya existe un componente COM en la aplicación que tiene el mismo LUID que el 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.

  • BizTalk Server no comprueba las dependencias para los componentes COM a fin de comprobar si están presentes. Por lo tanto, debería comprobar que están presentes los artefactos de los que depende el componente.

  • Si agrega un componente COM o COM+ de 64 bits sin administrar e intenta instalar la aplicación que incluye el componente COM o COM+ en un equipo de 32 bits, no se instalará el componente. Solo se instalará en un equipo de 64 bits.

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 componente COM a una aplicación

Mediante la consola de administración de BizTalk Server

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

  2. 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 un componente COM.

  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, seleccione el componente COM y, a continuación, haga clic en Abrir.

  5. En la lista desplegable Tipo de archivo , haga clic en System.BizTalk:Com.

  6. En Opciones, active o desactive la casilla Registrar el archivo en el destino (regsvr32) según si desea que el componente se agregue al Registro de Windows cuando se instale la aplicación.

  7. En Destino, escriba la ruta de acceso completa de la ubicación donde se va a copiar el componente COM cuando se instala 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. Esta ruta de acceso es necesaria si ha seleccionado la casilla Registrar el archivo en el destino (regsvr32) en el paso anterior.

    Ejemplo: %BTAD_InstallDir%\MyComponent.dll

  8. 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 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:Com [/Overwrite] /Source:value [/Destination:value] [/Options:Regsvr32OnInstall] [/Server:value] [/Database:value]

    Ejemplo:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Com /Overwrite /Source:"C:\Source Components\COM.dll" /Destination:"C:\New Components\COM.dll" /Options:Regsvr32OnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    Parámetro Value
    /Applicationname Nombre de la aplicación de BizTalk a la que se agrega el componente COM. 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:Com (este valor no distingue mayúsculas de minúsculas).
    /Sobrescribir Opción para actualizar un componente COM existente. Si no se especifica y ya existe un componente COM en la aplicación que tiene el mismo LUID que el componente COM 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.
    /Fuente Ruta completa del archivo .dll del componente COM, 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 .dll del componente COM cuando se instale la aplicación desde el archivo .msi. Si no se proporciona, el archivo no se copia al sistema de archivos local durante instalación; por tanto, el componente no se puede agregar al Registro de Windows durante instalación. Si la ruta incluye espacios, la debe encerrar entre comillas dobles ("). Si especifica el Regsvr32OnInstallOption, también debe especificar Destino.
    /Opciones Regsvr32OnInstall. Especificar que se agregue el componente COM al Registro de Windows cuando se instale la aplicación desde el archivo .msi. Si especifica esta opción, también debe especificar Destino.
    /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): Componente de COM
Creación y modificación de aplicaciones de BizTalk