Cómo importar una directiva

  • Artículo

En este tema se describe cómo usar la consola de administración de BizTalk Server para importar una directiva en un grupo de BizTalk o la herramienta de la línea de comandos BTSTask para importar una directiva en una aplicación de BizTalk.

Puede crear una directiva mediante el Compositor de reglas de negocios, como se describe en Creación de reglas de negocio mediante el Compositor de reglas de negocios y, a continuación, importarla directamente, o bien puede exportar una directiva desde otro grupo de BizTalk, como se describe en Cómo exportar una directiva y, a continuación, importarla.

Al importar una directiva, se registra en la base de datos del motor de reglas del grupo de BizTalk. Una vez importada la directiva, puede verla en la consola de administración de BizTalk Server. Si usa la consola de administración de BizTalk Server para importar una directiva, se mostrará en el <nodo Todos los artefactos> del grupo de BizTalk. Después, puede publicarlo para que esté disponible para agregarlo a una aplicación de BizTalk, como se describe en Cómo publicar una directiva. Si usa la herramienta de la línea de comandos BTSTask para importar una directiva, ésta se publicará de forma automática y se mostrará en la carpeta Directivas de la aplicación en la que la importó.

Al importar una directiva, tenga en cuenta los siguientes puntos importantes:

  • Incluso si especifica la opción de sobrescritura de una directiva existente con la directiva importada, no podrá importar una directiva que exista ya en la base de datos del motor de reglas del grupo y que se haya implementado. La importación no se llevará a cabo correctamente.

  • Incluso si la directiva se encontraba en un estado implementado al exportarla de otro grupo de BizTalk, estará en un estado no implementado cuando se importe.

  • BTSTask no proporciona un comando específico para la importación de directivas; sin embargo puede usar el comando ExportApp de BTSTask para exportar de forma selectiva únicamente las directivas de la aplicación que desee, sin incluir otros artefactos de la aplicación. A continuación, puede usar el comando ImportApp para importar el archivo .msi a una aplicación de un grupo de BizTalk diferente. Éste es el enfoque que se describe en este tema. Al hacerlo, la directiva se importa y se publica de forma automática en el grupo de BizTalk y se agrega a la aplicación especificada.

    Para obtener más información sobre cómo trabajar con directivas, consulte Administración de directivas. Para conocer los procedimientos recomendados para agregar directivas a las aplicaciones, consulte Procedimientos recomendados para implementar una aplicación de BizTalk.

Nota

El desarrollador de soluciones puede crear directivas y, a continuación, importarlas en la base de datos del motor de reglas para el grupo mediante el Asistente para la implementación del motor de reglas, como se describe en Cómo implementar y anular la implementación de directivas y vocabularios.

Requisitos previos

A continuación, se enumeran los requisitos previos para efectuar los procedimientos de este tema:

Importación de una directiva mediante 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, expanda el grupo de BizTalk en el que desea importar la directiva, expanda Aplicaciones y, a continuación, expanda <Todos los artefactos>.

  3. Haga clic con el botón derecho en Directivasy, a continuación, haga clic en Importar.

  4. Vaya al archivo .xml que contiene la directiva y haga clic en Abrir.

    La directiva se importa en el grupo y se muestra en la carpeta Directivas de <Todos los artefactos>.

Importación de una directiva mediante 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 ImportApp /Package:value [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]

    Ejemplo:

    BTSTask ImportApp /Package:"C:\MSI Files\MyApplication.msi" /Environment:Test /ApplicationName:MyApplication /Overwrite

    Parámetro Value
    /Paquete Ruta completa del archivo .msi que contenga la directiva que se va a importar. Si la ruta de acceso incluye espacios, debe incluirla entre comillas (").
    /Applicationname Nombre de la aplicación de BizTalk en la que se importa la directiva. Si no se especifica, se utiliza el nombre de aplicación especificado al exportar el archivo .msi. Si la aplicación especificada no existe, se creará. Los nombres de aplicación que incluyen espacios deben flanquearse con comillas dobles (").
    /Sobrescribir Opción para sobrescribir directivas en la aplicación con artefactos del archivo .msi que tienen el mismo nombre y número de versión. Si no se especifica esta opción y hay una o varias directivas en la aplicación que tienen el mismo nombre y número de versión que las directivas del archivo .msi, se produce un error en la importación. Puede ver el nombre y el número de versión de las directivas en una aplicación mediante el comando ListApp.
    /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.

    Nota

    En un sistema que admita el Control de cuentas de usuario (UAC), es posible que deba ejecutar la herramienta con privilegios administrativos. Para ello, haga clic con el botón derecho en la aplicación y seleccione Ejecutar como administrador.

Consulte también

Importación de aplicaciones, enlaces y directivas de BizTalk
Exportación de aplicaciones, enlaces y directivas de BizTalk
Administración de directivas