Cómo agregar un script previo o posterior al procesamiento 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 script previo o posterior al procesamiento a una aplicación. Al agregar un script a una aplicación, el script se incluye en la aplicación .msi archivo y se ejecuta cuando se importa, instala o desinstala la aplicación.

Al agregar un script, debe especificar si se trata de un script de preprocesamiento, que se ejecutará antes de que se inicie la importación o instalación de la aplicación, o un script posterior al procesamiento, que se ejecutará después de que se complete la importación o instalación de la aplicació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 un script de una aplicación. Para obtener instrucciones, consulte Cómo quitar un script previo o posterior al procesamiento de una aplicación.

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

Uso de la consola de administración de BizTalk Server

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

2. Expanda el grupo de BizTalk, expanda Aplicacionesy, a continuación, haga clic con el botón derecho en la carpeta de la aplicación a la que desea agregar un script.

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

   • Haga clic en Scripts de preprocesamiento si desea que el script se ejecute antes de que comience la importación o instalación de la aplicación 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 script debe tener el mismo nombre de archivo que el que se va a sobrescribir. De lo contrario, se agregará el nuevo script y el script 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 de acceso predeterminada instalará el script en la carpeta de instalación de la aplicación (%BTAD_InstallDir%).

Nota:

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

El script se agrega a la aplicación y se muestra en la carpeta Resources 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 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: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	Importancia
   /ApplicationName	Nombre de la aplicación de BizTalk a la que se va a agregar el script. Si no se especifica el nombre de la aplicación, se usa 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 un script existente. Si no se especifica y ya existe un archivo de script en la aplicación que tiene el mismo nombre que el archivo de script que se va a agregar, se producirá un error en la operación de adición.
   /Fuente	Ruta de acceso completa del archivo de script, incluido el nombre del archivo. Si la ruta de acceso incluye espacios, debe incluirla entre comillas dobles (").
   /Destino	Ruta de acceso completa de la ubicación a la que se copiará el archivo de script al instalar 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. Si la ruta de acceso incluye espacios, debe incluirla entre comillas dobles (").
   /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.
   /Property:Args=	Cero o más argumentos. Los argumentos proporcionados aquí se pasarán al script cuando se invoque.

Véase también

Administración de scripts previos y posteriores al procesamiento
Comando AddResource: Script de preprocesamiento
Comando AddResource: Script de postprocesamiento