本主题描述了如何使用工作台中的“新建消息定义文件”向导从 XML 模式创建新的消息定义。
开始之前:
要执行此任务,必须先完成下列任务:
在开始该任务之前,应该了解到以下几点:
- 要从 XML 模式创建新的消息定义文件,模式文件必须已经存在于工作台,例如在您的消息集项目中。这样您可以在新建消息定义文件向导中选择模式文件。
- 如果消息集(要添加新的消息定义文件)有 XML 有线格式层,但没有名称空间支持,将修改导入的模式以除去名称空间。出于此原因,应该在导入模式之前启用名称空间支持。
- 如果要添加新消息定义文件的消息集没有 XML 有线格式层,但有名称空间支持,则在模型中仅显示逻辑信息。出于此原因,应该在导入模式之前向消息集添加物理层。这样可确保植入模式中的设置和值。将不会修改 XML 模式以除去名称空间。
- 如果消息集(要添加新的消息定义文件)没有 XML 有线格式层,且没有名称空间支持,则只有逻辑信息将出现在模型中且将修改导入的模式以除去名称空间。
- 如果您使用的是没有名称空间支持的消息集,则必须指定将模式导入消息集时适用的首选项。通过这些首选项可以指定导入器对待特定的个别模式构造的方式。如果遇到出现任何构造,您可以拒绝模式,或者修改构造的出现。如果选择修改,则导入器将修改构造的所有显示。
- XML 模式文件的扩展名必须是小写的 .xsd。
以下步骤涵盖创建全新的消息定义文件,以及覆盖现有文件的内容。
要从 XML 模式文件创建消息定义:
- 切换到“代理应用程序开发”透视图。
- 通过从工作台菜单单击文件 > 新建 > 消息定义文件,以打开新建消息定义文件向导。 或者,可以通过右键单击先前导入到工作台中的 *.xsd 文件,然后在菜单上单击新建 > 消息定义文件来打开该向导。
- 在显示的选项列表中,单击 XML 模式文件以选中它,然后单击下一步。
- 单步遍历向导的其余部分根据要求填入详细信息。 导入 XML 模式的处理时间取决于该模式的大小和复杂性。在较大的复杂模式中,可能会花费一些时间来导入文件,生成日志文件和显示任何任务列表警告或错误。
当使用向导完成导入 XML 模式时:
- 仔细检查导入文件时创建的报告的日志文件中有无任何错误。这样可获得一些有关于模式在导入时是否失败的信息,以及是否需要修改模式以将其成功导入的信息。此报告可在包含您试图创建的消息定义的项目中的 log 目录结构中找到。该报告的文件扩展名为 .xsd.report.txt,前缀是为新消息定义文件指定的名称。
- 查看工作台任务列表中显示的消息以检查是否出现任何新警告或错误。在您已经导入完全有效的模式时,任务列表仍将显示消息定义文件中存在的任何警告或错误。下面给出了一些消息出现的情况的示例:
- 如果要导入的 XML 模式包含 xsd:key、xsd:keyref 和 xsd:unique 构造,任务列表中就会出现警告消息,提示您这些构造不受支持并且将被代理忽略。如果希望删除这些构造,在消息定义编辑器中打开消息定义文件,然后删除 删除对象 中描述的构造。删除构造的同时还将从任务列表中删除警告消息。如果您决定不删除这些构造,它们将保留在消息模式中,但不能部署到代理或用于其他任何目的。警告消息仍将保留在任务列表中,但可以正常使用消息模型。
- 如果要导入的 XML 模式包含 xsd:redefine 构造,任务列表中将出现错误消息,提示您该构造不受支持。如果右键单击错误消息并选中快速修复,可以选择将 xsd:redefine 构造转换为 xsd:include 构造。此操作还将除去错误消息。
- 如果要导入一系列相关 XML 模式文件,并且消息定义编辑器无法解决两个所导入文件之间的链接,则任务列表中将出现消息,提示您找不到所引用的类型或其他对象。如果出现此情况,请参阅 部署消息模式时解决问题 以获取更多信息。