模板（应用程序部署示例）

项目
07/21/2023

本主题介绍如何使用“模板”示例来进行应用程序部署。

可以创建和使用两种类型的部署脚本来自定义 BizTalk 应用程序部署：预处理脚本和后期处理脚本。预处理脚本在应用程序安装和导入开始前以及在卸载完成后调用。后续处理脚本在应用程序安装和导入完成后以及在卸载开始前调用。

您可以编写预处理脚本和后续处理脚本，以便针对上述每项操作进行调用。或者，您也可以将脚本配置为仅在其中一项操作后执行。有关编写脚本的详细信息，请参阅使用预处理和后处理脚本自定义应用程序部署。

本主题演示如何编写并部署脚本，使其仅在一项操作之前或之后调用。具体方法是：编写一段脚本，此脚本通过检查三个环境变量的值来决定操作调用上下文中的操作。根据此上下文，脚本将继续执行或停止执行。

本主题介绍如何执行以下步骤：

设置日志文件位置，以便生成脚本操作的日志文件。

注意

最佳做法是，始终生成日志文件以便验证脚本操作并解决任何问题。
新建一个 BizTalk 应用程序，并向该应用程序添加示例脚本。
导出包含应用程序项目的 .msi 文件。
从 BizTalk 组删除此应用程序，以便将此 .msi 文件导入回原来的组中，并从此 .msi 文件进行安装。
导入此应用程序，然后检查日志文件以查看是否已记录导入操作。
安装此应用程序，然后检查日志文件以查看是否已将安装日志附加到该日志文件中。
查看日志文件，注意脚本执行了哪些操作以及执行这些操作的时间。

本示例的用途

针对本示例提供的两个 .bat 文件包含用于导入、安装和卸载的环境变量的值。 SamplePreProcessing.bat 包含预处理脚本的变量。 SamplePostProcessing.bat 包含后处理脚本的变量。这些文件还演示了如何记录来自脚本的消息。您可以将这些文件的相关部分复制到脚本中。

重要

脚本文件中的某些注释不正确，具体如下：

在 SamplePreProcessing.bat 中，脚本注释“Pre uninstall part of the script called for an existing application”应为“Post uninstall part of the script called for an existing application”。

在 SamplePostProcessing.bat 中，脚本注释“Post uninstall part of the script called for an existing application”应为“Pre uninstall part of the script called for an existing application”。

本示例所在的位置

示例位于 BizTalk Server 安装文件夹中，如下所示：

<示例路径>\应用程序部署\模板

如前所述，本示例包括下列两个文件：

SamplePreProcessing.bat
SamplePostProcessing.bat

如何使用本示例

若要运行本示例，请执行下列步骤。

设置日志记录位置

打开这两个脚本示例并更改 LogFile 变量，使其指向日志文件的写入位置。您必须提供包含文件名的完整路径。如果该路径包含空格，则必须将该路径括在双引号 (") 中。

例如：

set LogFile=“<Samples Path>\ApplicationDeployment\Templates\SampleLogOut.txt”

新建应用程序

依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”和“BizTalk Server管理”。
在控制台树中，展开“BizTalk Server 管理”，然后展开 BizTalk 组。
右键单击“ 应用程序 ”，然后单击“ 新建”。
在 “应用程序名称”中，键入 SamplesTemplate，然后单击“ 确定”。

将脚本添加到应用程序

展开刚刚创建的 SamplesTemplate 应用程序的文件夹，并在左窗格中右键单击“ 资源 ”。
指向 “添加 ”，然后单击“ 预处理脚本”。
单击“ 添加 ”并浏览到 SamplePreProcessing.bat。
选择该文件，然后单击“打开”。
在“ 文件类型”中，单击“ System.BizTalk：PreprocessingScript”，然后单击“ 确定”。

SamplePreProcessing.bat 将添加到应用程序中，并且显示在应用程序的“资源”文件夹中。
再次右键单击“资源”，指向“ 添加”，然后单击“ 后期处理脚本”。
单击“ 添加 ”并浏览到 SamplePostProcessing.bat。
选择该文件，然后单击“打开”。
在“ 文件类型”中，单击“ System.BizTalk：PostprocessingScript”，然后单击“ 确定”。

SamplePostProcessing.bat 将添加到应用程序中，并且显示在应用程序的“资源”文件夹中。

导出 .msi 文件

在BizTalk Server管理控制台中，右键单击 SamplesTemplate 应用程序，指向“导出”，然后单击“MSI 文件”。
在“欢迎使用导出向导”页上，单击“ 下一步”。
在“选择资源”页上，单击“ 下一步”。
在“指定 IIS 主机”页上，单击“ 下一步”。
在“依赖项”页上，单击“ 下一步”。
在“目标”页上的“ 目标应用程序名称”中，键入应用程序名称。
在 要生成的 MSI 文件中，键入 MSI 文件的完整路径，然后单击“ 导出”。示例：C:\MSI\SamplesTemplate.msi
在 “概要” 页上，单击 “完成”。

删除应用程序

在BizTalk Server管理控制台中，右键单击 SamplesTemplate 应用程序，然后单击“删除”。

导入 .msi 文件

在BizTalk Server管理控制台中，右键单击“应用程序”，指向“导入”，然后单击“MSI 文件”。
在“欢迎使用导入向导”页上的 “要导入的 MSI 文件中，键入之前导出的 .msi 文件的路径，然后单击” 下一步”。如有必要，可以通过单击 “ (...”) 按钮来浏览 MSI 文件。
在“应用程序设置”页上的“ 应用程序名称 ”下拉列表中，选择应用程序名称。
在 “要添加引用的可用应用程序”中，选择要向其添加引用的应用程序（如果有），然后单击“ 下一步”。
在“应用程序目标环境设置”页上，单击“ 下一步”。

注意

在本示例中，您无需指定目标环境。有关此功能的背景信息，请参阅绑定文件和应用程序部署。有关添加绑定文件的说明，请参阅如何将绑定文件添加到应用程序。
在“导入摘要”页上，确认摘要信息正确，然后单击“ 导入”。
在“结果”页上，单击“ 完成”。
打开执行脚本时创建的日志文件，并验证是否已记录导入操作。

安装应用程序

双击 .msi 文件并运行安装向导。
打开日志文件，并验证是否已将安装操作添加到日志纪录信息中。

验证脚本运行是否正常

打开日志文件，验证脚本在指定操作期间是否执行。

另请参阅

应用程序部署（BizTalk Server 示例文件夹）
部署 BizTalk 应用程序

通过