使用 流试验程序 来测试消息流

要检查消息流或集成服务是否按预期处理消息，可以使用 流试验程序 或外部客户机将消息发送到流。 然后，可以使用 流试验程序 来显示每条消息所采用的路径。 您还可以在消息流中的任何位置查看消息组合件的结构和内容。

要检查消息流或集成服务是否按预期方式处理消息，请完成下列步骤：

1. 在 IBM App Connect Enterprise 工具包中，通过执行以下任一操作打开消息流：
   • 如果消息流是独立消息流或者是属于应用程序的消息流，请使用流编辑器打开该流。
   • 如果消息流属于集成服务，请使用服务编辑器打开集成服务描述。
   • 如果消息流属于 REST API，请使用消息流编辑器来打开位于资源下的 REST API 的主消息流。
2. 创建或启动集成服务器。 在编辑器中，单击Flow Exerciser工具栏中的Start Flow Exerciser图标 ( )，以便开始流记录。'code2
   在将消息发送至消息流之前，您必须拥有一台已连接至 IBM App Connect Enterprise 工具包的集成服务器，且该集成服务器必须已启动。 如果您尚未将已启动的集成服务器连接到 IBM App Connect Enterprise 工具包 ，系统会显示一条消息，提示您需要连接集成服务器。 单击确定以使用向导来帮助您创建和启动集成服务器。 有关更多信息，请参阅使用工具包创建、启动和停止本地独立集成服务器。

   或者，您可以单击取消，然后使用创建集成服务器中描述的方法之一来创建并启动集成服务器。

   集成服务器已创建并启动后，便可用于测试消息流。

3. 部署消息流。 当有一个或多个已启动的集成服务器连接到 IBM App Connect Enterprise 工具包时，请再次单击 “启动流程演练器 ”图标（）。 流记录开始。

   如果您有多个已启动的集成服务器连接到 IBM App Connect Enterprise 工具包 ，系统会提示您选择要部署该资源的集成服务器。 如果消息流在配置为使用本地队列管理器的 MQInput 节点上接收消息，那么可以使用 流试验程序 将消息发送到该 MQInput 节点。 但只能将流部署到由本地集成节点管理的集成服务器。 选择要在其中部署消息流的集成服务器，然后单击完成。

   将出现一个窗口，告知您无法单独部署消息流，而是部署拥有的应用程序或库。 单击确定以将拥有的应用程序或库部署到所选集成服务器。

   如果资源先前已部署到集成服务器，那么会显示一个窗口，告知您已部署该资源。 单击确定以确认您要重新部署资源，或者单击否以跳过重新部署步骤。

   资源即已部署到集成服务器。 将显示一个窗口，告知您消息流已准备好记录消息。 单击确定以关闭窗口并返回到消息流编辑器。 流编辑器现在显示蓝色边框，并显示文本“正在记录”。 红色的记录按钮现已替换为蓝色将流恢复到编辑方式按钮，并且消息流设置为“记录”方式。 当消息流处于“记录”方式时，无法对其进行编辑。 如果要停止记录并将流恢复到编辑方式，请按蓝色的将流恢复到编辑方式按钮。

4. 使用下列其中一个选项将消息发送到消息流：
   • 如果您正在使用集成服务，或者您的消息流包含MQInput 、 HTTPInput或SOAPInput节点，请单击Flow Exerciser工具栏中的发送消息图标 ( )。 然后，您可以使用发送消息对话框创建输入消息（或者选择现有输入消息或已记录的消息），并将其发送到流。 有关创建消息或使用录制消息的更多信息，请参阅创建输入消息和使用录制消息。 发送消息功能不适用于 REST API 中的流。
   • 如果流试验程序无法直接向您的消息流使用的输入节点发送消息，请使用外部工具或客户机来形成一个或多个输入消息并将其发送到流。

   单击关闭以关闭“发送消息”对话框。

5. 使用下列其中一种方法来查看流经过的路径 :
   • 单击关闭以关闭“发送消息”对话框后，消息路径在流中自动以蓝色突出显示。
   • 在集成服务的“集成服务描述”页面中，单击操作名称以查看子流中突出显示的消息路径。
   • 如果您的消息流使用了 Flow Exerciser 无法直接发送消息的输入节点，并且您使用了外部工具或客户端来形成一个或多个输入消息并将其发送到流，那么您必须单击Flow Exerciser工具栏中的查看路径图标 ( ) 来突出显示流上的消息路径。

   

   此图显示了一个突出显示了消息路径的流。 至少一条消息通过每个突出显示的连接进行传递。

   • 突出显示的连接不会对不同消息经过的路径进行区分。 如果向流发送多条消息，那么必须检查每个突出显示的连接，以确定哪些消息通过该连接进行传递。
   • 如果向流发送单个消息，并且消息多次通过连接，那么每次消息通过连接时，逻辑消息树将作为单独的消息实例被捕获。
   • 默认情况下，消息流中最多显示 200 个消息实例，但您可以在首选项 ( Windows > Preferences > Integration Development > Flow Exerciser ) 中更改此值。
   • 如果捕获的消息实例数超过了首选项中配置的数目，那么系统将提示您选择查看所配置数目的已记录消息还是查看所有已记录消息：
     • 如果您选择查看所配置的最大数目的已记录消息，那么可能无法看到完整的消息序列。
     • 如果您选择查看所有消息，那么性能可能会受到影响。

   查看完流经该流的路径时，请选择下列其中一个选项：

   • 单击清除已记录的消息 以清除记录的消息。 将不再显示突出显示流经该流的路径的蓝线。
   • 单击将流恢复为编辑方式以清除记录的消息并将消息流恢复为编辑方式。 将不再显示突出显示流经该流的路径的蓝线。 然后，可以编辑消息流并将该流重新部署到集成服务器，如步骤 3中所述。 然后，您可以重新发送消息，如步骤 4中所述。
   • 使消息流保持 "记录" 方式，并查看消息组合件，如步骤 6中所述。
6. 可选： 当信息流处于 "记录 "模式，并且在 "信息流练习器 "中可以看到突出显示信息流路径的蓝线时，您可以查看信息的记录信息组件。

   消息组件是流程中某个特定点正在处理的消息流的逻辑表示。 更多信息，请参阅 " 消息组装编辑器 "。

   通过选择消息流路径中任意两个节点之间的连接上的消息图标，打开消息组合件的只读视图。

   

   该视图显示流中该点的逻辑消息树。 逻辑消息树称为消息组合件。 默认情况下，消息组件由四棵树组成 ，除非启用了上下文树，在这种情况下会有五棵树 ：

   • environment
   • localEnvironment
   • exceptionList
   • 消息
   • 上下文

   message 树包含消息头和消息主体。 显示视图时，消息组合件的消息体部分将自动展开。

   消息组合件中还显示了检查点文件夹。 检查点显示记录消息流中的位置的详细信息。 它显示源节点和目标节点的详细信息。

   如果信息流启用了上下文树，则会显示上下文树。 更多信息，请参阅上下文树。

   如果将多条消息发送到流，那么可以通过选择消息号下拉菜单中的相应条目来选择要查看的消息。 更改信息编号菜单中的选择时，名称 字段中的信息名称会自动更新。

   

   如果要保存消息组合件，请遵循步骤 7中的指示信息。

7. 可选: 在只读视图中查看消息组合件时，可以通过完成以下步骤来保存该消息组合件:
   1. 可选: 您可以通过覆盖 " 记录的消息组合件 " 窗口的 Name 字段中显示的缺省名称来更改消息组合件的名称。 消息组合件的名称必须具有扩展名 .mxml。
   2. 单击保存。
   

   • 消息组合件保存在应用程序中的“其他资源”下面，其中包含正在记录的消息流。
   • 现在，您可以在同一窗口中查看其他消息编号并保存该消息。
   • 完成查看并保存消息组合件后，选择关闭以关闭窗口。 现在，您可以在“应用程序开发”视图中的应用程序下面查看已保存的消息组合件。
8. 可选: 如果要保存流试验程序中突出显示的路径中的所有连接中的消息组合件，请单击 全部保存 。
   每次调用流生成的所有消息组合件都显示在包含“应用程序开发”视图中的应用程序下面，其中包含已记录的消息流。

   

   下次选择发送消息时，这些消息组合件也会出现在“已记录的消息”下面。

   这些消息组合件也可以用作消息流节点的集成测试资源。

9. 可选: 通过完成以下步骤编辑消息组合件:
   1. 在 IBM App Connect Enterprise 工具包的“应用程序开发”视图下，双击已保存的消息组件。
   2. 从菜单中选择打开方式 > 消息程序集编辑器。
      消息组合件将在消息组合件编辑器中打开。
   3. 编辑“名称”、“类型”和“值”列下的值。
   4. 保存您的更改。
   5. 编辑消息流以期望更新的值。 例如，如果流具有 Compute 节点，请更新 ESQL。 更多信息，请参阅《 编辑》。
10. 如果保存已记录的消息组合件，那么可以通过完成以下步骤将其作为消息发送至消息流：
    1. 单击 发送消息。
       • “已记录的消息”下面显示已保存的记录消息组合件。
       • “主要”选项卡下面显示已记录的消息组合件内容的只读视图。
       • 如果需要更改消息组合件，请从“应用程序开发”视图中选择消息组合件以将其打开，然后在“消息组合件编辑器”中对其进行编辑。
       • 输入节点未与消息组合件一起保存，您可以选择要将其发送到哪个输入节点。 消息流中的所有输入节点都列示在输入位置字段中。
       • 如果消息程序集包含上下文树，则消息流程会忽略该上下文树。 相反，启用上下文树后，流量会构建自己的上下文树，以匹配其他四个消息树。
    2. 按 发送。
       

    将发送消息，并在流编辑器中以蓝色突出显示消息路径，如步骤 5中所示。