HelloWorld(BizTalk Server 示例)
HelloWorld 示例演示如何使用 BizTalk 业务流程将 XML 消息(采购订单)转换为相关但不同类型的消息(发票)。
本示例的用途
此示例将 In 文件夹配置为接收位置。 将文件(例如示例文件SamplePOInput.xml)放入此文件夹时,BizTalk Server使用以下步骤处理邮件:
BizTalk Server 从接收位置文件夹检索 XML 采购订单消息。
业务流程使用映射文件从 XML 采购订单创建 XML 发票。
BizTalk Server将生成的 XML 发票消息放入 send adapter Out 文件夹中。
此示例的设计方式和原因
在公司间消息交换方案中,经常需要将从贸易合作伙伴接收的入站消息转换为内部应用程序可以识别的格式。 此示例使用 接收 形状、 转换 形状和 发送 形状来实现此结果。 转换形状在此示例中起着重要作用,因为它是消息格式转换的发生位置。 将 转换 形状拖动到业务流程中,并为其配置源消息、映射名称和目标消息。 在运行期间,使用您指定的映射将源消息映射到目标消息。
有关 转换 形状的详细信息,请参阅 如何配置转换形状。 有关生成地图的详细信息,请参阅 使用 BizTalk 映射器创建地图。
本示例所在的位置
<示例路径>\Orchestrations\HelloWorld\
下表显示了本示例中的文件及其用途说明:
文件 | 说明 |
---|---|
Cleanup.bat | 用于取消部署程序集并从全局程序集缓存中删除这些程序集。 删除发送和接收端口。 根据需要删除 Microsoft Internet 信息服务 (IIS) 虚拟目录。 |
HelloOrchestration.odx | 对采购订单转换为发票进行协调的业务流程。 |
HelloWorld.btproj、HelloWorld.sln | 本示例的项目文件和解决方案文件。 |
HelloWorldBinding.xml | 用于如端口绑定之类的自动化设置。 |
InvoiceSchema.xsd、POSchema.xsd | 分别用于发票和采购订单消息的架构。 |
POToInvoice.btm | 将采购订单转换为发票的映射。 |
SamplePOInput.xml | 示例输入文件。 |
Setup.bat | 用于生成和初始化本示例。 |
生成和初始化此示例
生成并初始化 HelloWorld 示例
在命令窗口中,导航到下面的文件夹:
<示例路径>\Orchestrations\HelloWorld
运行 Setup.bat 文件,该文件将执行以下操作:
在下面的文件夹中,为本示例创建输入 (In) 和输出 (Out) 文件夹:
<示例路径>\Orchestrations\HelloWorld
为本示例编译 Visual Studio 项目。
创建 BizTalk Server 接收位置、发送和接收端口,并将它们绑定到业务流程。
启用接收位置并启动发送端口。 登记并启动业务流程。
注意
在尝试运行本示例前,您应确认在生成和初始化过程中 BizTalk Server 未报告任何错误。 通过查看事件日志可以确认这一点。
运行本示例
运行 HelloWorld 示例
将文件的副本 SamplePOInput.xml 粘贴到 In 文件夹中。
观察在 Out 文件夹中创建的 .xml 文件。 此文件包含从输入文件 SamplePOInput.xml 构造的 XML 发票。 此文件的名称的格式为 <MessageID>.xml,其中 <MessageID> 是生成用于唯一标识消息的 GUID。
卸载本示例
卸载 HelloWorld 示例
在命令窗口中,导航到下面的文件夹:
<示例路径>\Orchestrations\HelloWorld\
运行 Cleanup.bat。