CreateApp (ejemplo de implementación de aplicaciones)
En este tema se describe cómo usar el ejemplo CreateApp, que muestra cómo implementar o anular la implementación de una aplicación de BizTalk utilizando la herramienta de línea de comandos BTSTask. Puede usar secuencias de comandos como los que se incluyen en este ejemplo para automatizar el proceso de implementación nocturno y, así, implementar o anular la implementación de las aplicaciones de BizTalk.
Importante
Debe escribir siempre las secuencias de comandos de implementación para que se ejecuten en modo silencioso. De lo contrario, los cuadros de diálogo indicarán que requieren la entrada de usuario. Como consecuencia, se detendrá el proceso de implementación hasta que se omita el cuadro de diálogo de forma manual, lo cual puede ocasionar que se cuelgue el proceso de importación.
Descripción del ejemplo
El ejemplo incluye secuencias de comandos que automatizan las tareas de implementación de aplicaciones. Para realizar estas tareas, ejecute una secuencia de comandos que genere los archivos y el proyecto de BizTalk. A continuación, ejecute una secuencia de comandos que genere dos archivos .msi de la aplicación de BizTalk: un archivo .msi que contenga todos los artefactos de una aplicación y otro que solo contenga un ensamblado de la aplicación. Después, ejecute una secuencia de comandos que use un archivo .msi para importar una aplicación en un grupo de BizTalk e instale la aplicación en el equipo local. Durante la instalación, una secuencia de comandos previa al procesamiento incluida en la aplicación crea carpetas utilizadas por la aplicación y registra las acciones en un archivo. Por último, puede ejecutar una secuencia de comandos que elimina y desinstala la aplicación. Durante la desinstalación, una secuencia de comandos previa al procesamiento incluida en la aplicación elimina los archivos y las carpetas creadas en la instalación y, además, registra las acciones en un archivo.
A continuación, se muestran las secuencias de comandos incluidas en este ejemplo:
Build.bat. Genera un archivo de clave y el proyecto en Visual Studio y, por otro lado, firma los archivos .dll.
CreateFullAndPartialMSI.bat. Realiza las siguientes acciones en el orden que se muestra:
Usa el comando BTSTask AddApp para crear una aplicación.
Usa el comando BTSTask AddResource para agregar a la aplicación tres ensamblados de BizTalk, así como otros recursos generados por Build.bat.
Usa el comando BTSTask ExportApp para exportar los artefactos de la aplicación a un archivo .msi denominado CreateApplicationSample.msi.
Usa el comando BTSTask ListApp para generar un manifiesto de aplicación denominado AppManifest.xml, que enumera todos los artefactos contenidos en la aplicación.
Usa el comando BTSTask ExportApp para exportar solo el ensamblado de orquestaciones a un archivo .msi denominado CreateApplicationSamplePartial.msi. Esta operación se lleva a cabo proporcionando ResourceSpecPartial.xml para el parámetro ResourceSpec. ResouceSpecPartial.xml es una versión editada de ResourceSpecComplete.xml que ha sido proporcionada con este ejemplo. Este archivo ha sido editado para que sólo contenga una referencia del ensamblado de orquestaciones. Cuando se proporciona este parámetro, BTSTask solo exporta los artefactos enumerados en el archivo ResourcesSpecPartial.xml (en este caso, el ensamblado de orquestaciones).
Elimina la aplicación de la base de datos de administración de BizTalk para el grupo.
CreateNewAppFromMSI.bat. Usa CreateApplicationSample.msi generado por CreateFullAndPartialMSI.bat para instalar una aplicación denominada CreateApplicationSample en el equipo local además de importar la aplicación en el grupo de BizTalk. Durante la instalación, PreProcScript.bat se ejecuta automáticamente, tal y como se describe en posteriores epígrafes.
RemoveApp.bat. Realiza las siguientes acciones en el orden que se muestra:
Usa el comando RemoveApp BTSTask para eliminar la aplicación CreateApplicationSample de la base de datos de administración de BizTalk para el grupo.
Usa el comando BTSTask UninstallApp para desinstalar la aplicación CreateApplicationSample del equipo local. Durante la instalación, PreProcScript.bat se ejecuta automáticamente, tal y como se describe a continuación.
PreProcScript.bat. Realiza las siguientes acciones en el orden que se indica:
Cada vez que se ejecuta, establece el token de clave pública para el ensamblado que ha sido proporcionado por el usuario.
Durante la instalación de la aplicación, crea las siguientes carpetas que serán utilizadas por la aplicación CreateApplicationSample para contener mensajes.
C:\CreateApplicationSample\Out
C:\CreateApplicationSample\In
Durante la desinstalación de la aplicación, elimina los archivos y carpetas creados en la instalación. También desinstala de la caché de ensamblados global (GAC) cualquier ensamblado que se instaló en la GAC durante la instalación y registra las acciones en un archivo. Para desinstalar los ensamblados de la GAC, hace referencia al token de clave pública proporcionado por el usuario.
Durante la instalación y desinstalación, crea un archivo de registro en la siguiente ubicación:
C:\ScriptLog.txt
Ubicación del ejemplo
Puede encontrar los archivos de ejemplo en las siguientes carpetas en <Ruta> de acceso de ejemplos\Implementación de aplicaciones\:
CreateApp (Carpeta)
Build.bat
CreateFullAndPartialMSI.bat
CreateNewAppFromMSI.bat
RemoveApp.bat
CreateApp\Bindings (Carpeta)
- CreateApplicationSampleBindings.xml
CreateApp\Dlls (Carpeta)
- Vacío
CreateApp\ResourceSpecs (Carpeta)
ResourceSpecPartial.xml
ResourceSpecComplete.xml
CreateApp\Scripts (Carpeta)
- PreProcScript.bat
CreateApp\HelloApplicationDeployment (Carpeta)
HelloApplicationDeployment.suo
HelloApplicationDeployment.sln
CreateApp\HelloApplicationDeployment\Maps (Carpeta)
POToInvoice.btm
Maps.btproj
CreateApp\HelloApplicationDeployment\Orchestrations (Carpeta)
Orchestrations.btproj
HelloOrchestration.odx
CreateApp\HelloApplicationDeployment\Schemas (Carpeta)
Schemas.btproj
POSSchema.xsd
InvoiceSchema.xsd
Uso del ejemplo
Siga el siguiente procedimiento para usar este ejemplo:
Para usar el ejemplo
Ejecute Build.bat. Se genera un archivo de clave, se generan los proyectos en la carpeta HelloApplicationDeployment, se firman los archivos resultantes .dll y se colocan los archivos .dll en la carpeta Dlls.
Abra el archivo PreProcScript.bat, ubicado en la carpeta CreateApp\Scripts. En la siguiente línea de código, elimine REM y proporcione el token de clave pública para el ensamblado:
REM establece PublicKeyToken=
Ejemplo:
establece PublicKeyToken=1234a5b6c1234567
Ejecute CreateFullAndPartialMSI.bat. Se crean así dos archivos de aplicación .msi: CreateApplicationSample.msi y CreateApplicationSamplePartial.msi.
Ejecute CreateNewAppFromMSI.bat. Se importa la aplicación CreateApplicationSample en el grupo de BizTalk y la instala en el equipo local.
Compruebe el archivo de registro de la secuencia de comandos, ubicado en C:\ScriptLog.txt, para verificar que la secuencia registró las acciones de instalación.
Verifique que la aplicación CreateApplicationSample aparece en la consola de administración de BizTalk Server y en Agregar o quitar programas.
Ejecute RemoveApp.bat Así se elimina CreateApplicationsSample de la base de datos de administración de BizTalk y se desinstala del equipo local.
Compruebe el archivo de registro de la secuencia de comandos, ubicado en C:\ScriptLog.txt, para verificar que la secuencia registró las acciones de desinstalación. Deben aparecer después de las acciones de instalación registradas anteriormente durante la instalación.
Verifique que la aplicación CreateApplicationSample ya no aparece en la consola de administración de BizTalk Server ni en Agregar o quitar programas.
Verifique que se han eliminado las carpetas que fueron creadas durante la instalación.
Verifique que los ensamblados han sido desinstalados de la GAC.
Consulte también
Implementación de aplicaciones (carpeta de ejemplos de BizTalk Server)
Implementación de aplicaciones de BizTalk