Compartir a través de

Cómo agregar secuencias de comandos previas y posteriores al procesamiento 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 una secuencia de comandos previa o posterior al procesamiento a una aplicación. Al agregar una secuencia de comandos a una aplicación, la secuencia de comandos se incluye en el archivo .msi de la aplicación y se ejecuta cuando se importa, se instala o se desinstala la aplicación.

Al agregar una secuencia de comandos, debe especificar si es una secuencia de comandos previa al procesamiento (que se ejecutará antes de que se importe la aplicación o de que se inicie la instalación) o si se trata de una secuencia de comandos posterior al procesamiento (que se ejecutará después de la importación de la aplicación o cuando finalice la instalación). Los scripts previos y posteriores al procesamiento también se ejecutan en la desinstalación, en el orden opuesto al que se ejecutaron en la instalación: los scripts de preprocesamiento se ejecutan después de la desinstalación y los scripts posteriores al procesamiento se ejecutan antes de la desinstalación.

También puede quitar una secuencia de comandos de una aplicación. Para obtener instrucciones, consulte Cómo quitar un script previo o posterior al procesamiento de una aplicació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 una secuencia de comandos 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. Expanda el grupo de BizTalk, expanda Aplicaciones y, a continuación, haga clic con el botón secundario en la carpeta de la aplicación a la que desee agregar una secuencia de comandos.

  3. Seleccione Agregar y realice una de las siguientes acciones:

    • Haga clic en Scripts de preprocesamiento si desea que el script se ejecute antes de que la importación o instalación de la aplicación comience o después de la desinstalación.

    • Haga clic en Scripts posteriores al procesamiento si desea que el script se ejecute después de la importación o instalación de la aplicación, o antes de la desinstalación.

  4. Haga clic en Agregar y vaya al archivo de script que se va a agregar.

  5. Seleccione el archivo de script y haga clic en Abrir.

  6. Si desea sobrescribir un archivo de script que ya existe en la aplicación, active la casilla Sobrescribir todo . El archivo de secuencias de comandos debe tener el mismo nombre de archivo que el que se va agregar para sobrescribirse. De no ser así, se agregará la secuencia de comandos nueva, y la existente permanecerá en la aplicación sin cambios.

  7. Haga clic en la lista desplegable Tipo de archivo y haga clic en el tipo de archivo: System.BizTalk:PreprocessingScript o System.BizTalk:PostprocessingScript.

  8. Si es necesario, en Ubicación de destino , escriba la ruta de acceso donde desea que se copie el archivo de script cuando se instale la aplicación y, a continuación, haga clic en Aceptar. La ruta predeterminada instalará la secuencia de comandos en la carpeta de instalación de la aplicación (%BTAD_InstallDir%).

Nota

Si no proporciona la ruta, la secuencia de comandos no se copiará en el sistema de archivos local durante la instalación. Si la secuencia de comandos se debe ejecutar cuando la aplicación esté desinstalada, asegúrese de proporcionar esta ruta; de lo contrario, la secuencia de comandos no estará presente en el sistema de archivos local y no se ejecutará durante la desinstalación.

La secuencia de comandos se agrega a la aplicación y se muestra en la carpeta Recursos de la aplicación.

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:PreProcessingScript|System.BizTalk:PostProcessingScript [/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value][/Property:Args="argument list"]

    Ejemplo:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:PreProcessingScript /Overwrite /Source:"C:\Source Scripts\MyScript.vbs" /Destination:"C:\New Scripts\MyScript.vbs" /Server:MyDatabaseServer /Database:BizTalkMgmtDb /Property:Args="argument1 argument2"

    Parámetro Value
    /Applicationname Nombre de la aplicación de BizTalk a la que se agrega la secuencia de comandos. 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:PreProcessingScript o System.BizTalk:PostProcessingScript, dependiendo del tipo de script que se va a agregar. Use System.BizTalk:PreProcessingScript si desea que el script se ejecute antes de la importación o instalación de la aplicación o después de la desinstalación. Use System.BizTalk:PostProcessingScript si desea que el script se ejecute después de la importación o instalación de la aplicación, o antes de la desinstalación.
    /Sobrescribir Actualice una secuencia de comandos existente. Si no se especifica y ya existe un archivo de secuencias de comandos en la aplicación que tiene el mismo nombre que el archivo de secuencia de comandos que se agrega, se producirá un error en la operación de agregación.
    /Fuente Ruta completa del archivo de secuencia de comandos, 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 secuencias de comandos 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 (").
    /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.
    /Property:Args= Cero o más argumentos. Los argumentos que se proporcionen aquí pasarán a la secuencia de comandos cuando ésta se invoque.

Consulte también

Administración de scripts previos y posteriores al procesamiento
AddResource (comando): Scripts previos al procesamiento
AddResource (comando): Scripts posteriores al procesamiento