Compartir a través de

Cómo agregar un artefacto de BAM 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 artefacto de BAM a una aplicación de BizTalk. Al agregar un archivo de definiciones de BAM no se implementa la definición de BAM. La definición de BAM se implementa cuando se importa el archivo .msi de la aplicación.

Si desea sobrescribir un artefacto de BAM que ya existe en la aplicación, especifique la opción de sobrescritura. La opción de sobrescritura solo es necesaria cuando el artefacto de BAM existente tiene el mismo nombre de archivo que el que desea agregar. Si no se especifica y el artefacto de BAM ya existe en la aplicación con el mismo nombre de archivo que el que se va a agregar, se producirá un error en la operación de adició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 artefacto de BAM a una aplicación

Mediante la consola de administración de BizTalk Server

  1. Haga clic en Inicio, En Programas, En 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 grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación a la que desea agregar un archivo de artefacto de BAM.

  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 archivo del artefacto bam y, a continuación, haga clic en Abrir.

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

  6. En Destino, escriba la ruta de acceso completa de la ubicación donde se va a copiar el archivo de artefacto cuando se instale la aplicación desde el archivo .msi, incluido el nombre de archivo. Si no se proporciona esta ruta, el archivo no se copia en el sistema de archivos local durante la instalación; sino que se implementará cuando se importe el archivo .msi de la aplicación.

    Ejemplo: C:\My Applications\MyBAMfile.xml

  7. 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:Bam [/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value]

    Ejemplo:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Bam /Overwrite /Source:"C:\Source BAMfiles\MyBAMfile.xml" /Destination:"%BTADInstallDir%\ BAMfiles\MyBAMfile.xml" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    Parámetro Value
    /Applicationname Nombre de la aplicación de BizTalk a la que se agrega el artefacto de BAM. 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:Bam (este valor no distingue mayúsculas de minúsculas).
    /Sobrescribir Opción para sobrescribir un artefacto de BAM existente. Si no se especifica y ya existe un artefacto de BAM en la aplicación que tiene el mismo nombre de archivo que el artefacto de BAM que se agrega, se produce un error en la operación AddResource.
    /Fuente Ruta completa del archivo de artefacto de BAM, 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 artefacto de BAM 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. Si la ruta incluye espacios, la debe encerrar entre comillas dobles ("). Puede usar la variable de entorno %BTADInstallDir% en la ruta para especificar la carpeta de instalación de la aplicación.
    /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): Artefacto de BAM
Creación y modificación de aplicaciones de BizTalk
Cómo importar una aplicación de BizTalk