Plantilla (ejemplo de implementación de aplicaciones)
En este tema se describe cómo usar el ejemplo de la plantilla para la implementación de aplicaciones.
Puede crear y usar dos tipos de scripts de implementación para personalizar la implementación de aplicaciones de BizTalk: scripts de preprocesamiento y scripts posteriores al procesamiento. Las secuencias de comandos previas al procesamiento se invocan antes de la importación e instalación de la aplicación y después de finalizar el proceso de desinstalación. Las secuencias de comandos posteriores se invocan después de la importación e instalación de la aplicación y antes de finalizar el proceso de desinstalación.
Puede escribir secuencias de comandos previas y posteriores al procesamiento para que estén invocadas en cada una de estas operaciones. También puede configurar las secuencias de comandos para que sólo se ejecuten después de una operación. Para obtener más información sobre cómo escribir scripts, consulte Uso de scripts previos y posteriores al procesamiento para personalizar la implementación de aplicaciones.
En este tema se muestra cómo escribir e implementar una secuencia de comandos para que sólo sea invocada antes o después de una operación. Para ello, escriba una secuencia de comandos que compruebe los valores de tres variables de entorno para determinar la operación en el contexto en que se llama. En función de este contexto, la secuencia de comandos continúa o no con la ejecución.
En este tema se describe cómo realizar los siguientes pasos:
Establezca la ubicación del archivo de registro para poder generar un archivo de registro de las operaciones de secuencias de comandos.
Nota
Se recomienda generar siempre un archivo de registro para poder verificar las operaciones de secuencias de comandos y poder resolver cualquier tipo de problema.
Cree una nueva aplicación de BizTalk y agréguele las secuencias de comandos de ejemplo.
Exporte un archivo .msi que contiene los artefactos de la aplicación.
Elimine la aplicación del grupo de BizTalk para poder importar de nuevo el archivo .msi al mismo grupo e instalarlo desde el archivo .msi.
Importe la aplicación y compruebe el archivo de registro para ver si se ha registrado la operación de importación.
Instale la aplicación y compruebe el archivo de registro para ver si el registro de instalación se anexó al archivo de registro.
Vea los archivos de registro y observe qué operaciones realizaron las secuencias de comandos y cuándo se realizaron.
Descripción del ejemplo
Los dos archivos .bat proporcionados para este ejemplo contienen los valores de las variables de entorno para la importación, instalación y desinstalación. SamplePreProcessing.bat contiene variables para una secuencia de comandos previa al procesamiento. SamplePostProcessing.bat contiene variables para una secuencia de comandos posterior al procesamiento. Los archivos también muestran cómo registrar los mensajes de las secuencias de comandos. Puede copiar las secciones relevantes de estos archivos en las secuencias de comandos.
Importante
Algunos de los comentarios de los archivos de secuencias de comandos no son correctos, como por ejemplo:
En SamplePreProcessing.bat, el comentario de la secuencia, “Desinstale previamente parte de la secuencia de comandos llamada a una aplicación existente” debería ser “Desinstale posteriormente parte de la secuencia de comandos llamada a una aplicación existente”.
En SamplePreProcessing.bat, el comentario de la secuencia, “Desinstale posteriormente parte de la secuencia de comandos llamada a una aplicación existente” debería ser “Desinstale previamente parte de desinstalación anterior de la secuencia de comandos llamada a una aplicación existente”.
Ubicación del ejemplo
El ejemplo se encuentra en la carpeta de instalación de BizTalk Server, como se indica a continuación:
<Ruta de acceso de> ejemplos\Implementación de aplicaciones\Plantilla
Como se ha mencionado anteriormente, el ejemplo incluye dos archivos:
SamplePreProcessing.bat
SamplePostProcessing.bat
Uso del ejemplo
Para ejecutar el ejemplo, siga estos pasos.
Para establecer la ubicación de registro
Abra los dos ejemplos de secuencias de comandos y modifique la variable LogFile para indicar la ubicación donde se escribirán los archivos de registro. Debe proporcionar la ruta completa incluyendo el nombre del archivo. Si la ruta incluye espacios, debe ponerla entre comillas dobles (").
Ejemplo:
set LogFile="<Samples Path>\ApplicationDeployment\Templates\SampleLogOut.txt"
Para crear una aplicación nueva
Haga clic en Inicio, en Todos los programas, en Microsoft BizTalk Server 20xx y, a continuación, en Administración de BizTalk Server.
En el árbol de la consola, expanda Consola de administración de BizTalk Server y el grupo de BizTalk.
Haga clic con el botón derecho en Aplicaciones y, a continuación, haga clic en Nuevo.
En Nombre de la aplicación, escriba
SamplesTemplatey, a continuación, haga clic en Aceptar.
Para agregar las secuencias de comandos a la aplicación
Expanda la carpeta de la aplicación SamplesTemplate que acaba de crear y haga clic con el botón derecho en Recursos en el panel izquierdo.
Seleccione Agregar y haga clic en Scripts de preprocesamiento.
Haga clic en Agregar y vaya a SamplePreProcessing.bat.
Seleccione el archivo y haga clic en Abrir.
En Tipo de archivo, haga clic en System.BizTalk:PreprocessingScript y, a continuación, haga clic en Aceptar.
SamplesPreProcessing.bat se agrega a la aplicación y se muestra en la carpeta Recursos de la aplicación.
Vuelva a hacer clic con el botón derecho en Recursos, seleccione Agregary, a continuación, haga clic en Scripts posteriores al procesamiento.
Haga clic en Agregar y vaya a SamplePostProcessing.bat.
Seleccione el archivo y haga clic en Abrir.
En Tipo de archivo, haga clic en System.BizTalk:PostprocessingScript y, a continuación, haga clic en Aceptar.
SamplesPostProcessing.bat se agregará a la aplicación y se mostrará en la carpeta Recursos de la aplicación.
Para exportar un archivo .msi
En la consola de administración de BizTalk Server, haga clic con el botón derecho en la aplicación SamplesTemplate, seleccione Exportar y, a continuación, haga clic en Archivo MSI.
En la página Asistente para exportación, haga clic en Siguiente.
En la página Seleccionar recursos, haga clic en Siguiente.
En la página Especificar hosts de IIS, haga clic en Siguiente.
En la página Dependencias, haga clic en Siguiente.
En la página Destino, en Nombre de aplicación de destino, escriba el nombre de la aplicación.
En el archivo MSI que se va a generar, escriba la ruta de acceso completa para el archivo MSI y, a continuación, haga clic en Exportar. Ejemplo: C:\MSI\SamplesTemplate.msi
En la página de resumen, haga clic en Finalizar.
Eliminación de la aplicación
- En la consola de administración de BizTalk Server, haga clic con el botón derecho en la aplicación SamplesTemplate y, a continuación, haga clic en Eliminar.
Para importar el archivo .msi
En la consola de administración de BizTalk Server, haga clic con el botón derecho en Aplicaciones, seleccione Importary, a continuación, haga clic en Archivo MSI.
En la página Asistente para importación, en archivo MSI que se va a importar, escriba la ruta de acceso del archivo .msi que exportó anteriormente y, a continuación, haga clic en Siguiente. Si es necesario, puede buscar el archivo MSI haciendo clic en el botón (....) .
En la página Configuración de la aplicación, en la lista desplegable Nombre de la aplicación, seleccione el nombre de la aplicación.
En Aplicaciones disponibles a las que agregar referencias, seleccione las aplicaciones a las que agregar referencias, si las hay, y haga clic en Siguiente.
En la página Configuración del entorno de destino de la aplicación, haga clic en Siguiente.
Nota
No es necesario especificar un entorno de destino para los fines de este ejemplo. Para obtener información general sobre esta característica, consulte Enlace de archivos y implementación de aplicaciones. Para obtener instrucciones sobre cómo agregar archivos de enlace, vea Cómo agregar un archivo de enlace a una aplicación.
En la página Resumen de importación, confirme que la información de resumen es correcta y, a continuación, haga clic en Importar.
En la página Resultados, haga clic en Finalizar.
Abra el archivo de registro que se creó cuando se ejecutaron las secuencias de comandos y verifique que se registró la operación de importación.
Para instalar la aplicación
Haga doble clic en el archivo .msi y ejecute el Asistente para instalación.
Abra el archivo de registro y verifique que la operación de instalación se agregó a la información de registro.
Para verificar que las secuencias funcionaron correctamente
- Abra los archivos de registro y verifique que se ejecutaron durante las operaciones especificadas.
Consulte también
Implementación de aplicaciones (carpeta de ejemplos de BizTalk Server)
Implementación de aplicaciones de BizTalk