Compartir a través de

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

Al agregar un componente COM a una aplicación, tenga en cuenta los siguientes puntos 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 identificador único local (LUID). Si no se especifica y ya existe un componente COM en la aplicación con el mismo LUID 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.

  • BizTalk Server no comprueba las dependencias de los componentes COM para comprobar que están presentes, por lo que debe comprobar que hay artefactos en los que depende el componente.

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

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

Uso de la consola de administración de BizTalk Server

  1. Haga clic en Inicio, haga clic en Programas, haga clic en 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 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 esta ruta de acceso, el archivo no se copia en el sistema de archivos local durante la 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 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: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 Importancia
    /ApplicationName Nombre de la aplicación de BizTalk a la que se va a agregar el componente COM. 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: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 va a agregar, 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 de acceso completa del archivo del componente COM .dll, incluido el nombre del archivo. Si la ruta de acceso incluye espacios, debe incluirla entre comillas dobles (").
    /Destino Ruta de acceso completa del lugar donde se copiará el archivo del componente COM .dll cuando se instale la aplicación desde el archivo .msi. Si no se proporciona, el archivo no se copia en el sistema de archivos local durante la instalación; por lo tanto, el componente no se puede agregar al Registro de Windows durante la instalación. Si la ruta de acceso incluye espacios, debe incluirla entre comillas dobles ("). Si especifica Regsvr32OnInstallOption, también debe especificar Destination.
    /Opciones Regsvr32OnInstall. Especifique para agregar el componente COM 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.
    /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: componente COM
Crear y modificar aplicaciones de BizTalk