使用英语阅读

通过


管道工具

借助 Microsoft BizTalk Server 软件开发工具包 (SDK) 提供的管道工具,无需配置BizTalk Server环境(例如发送/接收端口),即可验证管道是否正常运行。 管道工具还具有以下用途:

  • 调试服务器环境外的第三方管道组件。

  • 诊断解析引擎错误消息。

  • 试验不同的架构,但不必编译、部署、取消部署和重新编译。

  • 浏览平面文件和 XML 程序集/拆装器行为。

  • 查看拆装器输出,发现哪些消息上下文属性已升级及属性值。

  • 运行没有拆装器和组装器组件的发送/接收管道(例如,您可以查看 S/MIME 解码器的输出)。

  • 单独对管道(而不是整个消息传送子系统)进行精细的性能测量。

在 SDK 中的位置

<安装路径>\SDK\Utilities\PipelineTools

将管道工具用于执行、调试和分析管道和管道组件(即平面文件和 XML 组装器/拆装器组件)。

文件库存

下表列出了管道工具文件并说明其用途。

文件 说明
DSDump.exe 允许您转储文档架构结构,它是一个或多个 XSD 架构的内存中轻量表示形式,有或没有平面文件批注。 此工具在您获取诸如 $Root$0$3$2 这样的解析引擎错误并且需要对其进行解码时很有帮助。 $ 后的数字表示基于 0 的索引或记录,这些索引或记录显示在文档架构中。
FFAsm.exe 运行平面文件组装器组件,通过模拟发送管道来直接调用它,从而允许您看到它如何将用户的 XML 文档序列化或组装到平面文件文档中。
FFDasm.exe 运行平面文件拆装器组件,通过模拟接收管道来直接调用它,从而允许您看到它如何将用户的平面文件文档解析或拆装到一个或多个 XML 文档中。
Pipeline.exe 运行发送或接收管道;接受一个或多个输入文档及其部分、XSD 架构和相关信息;并且在管道运行后生成输出文档。 Pipeline.exe 无法访问BizTalk Server数据库,因此可能不支持包含 BizTalk Framework 汇编程序和反汇编程序组件的管道,这些组件在执行期间访问BizTalk Server数据库。
XMLAsm.exe 运行 XML 组装器组件,通过模拟发送管道来直接调用它,从而允许您看到它如何将用户的 XML 文档序列化、组装或封装到输出 XML 文档中。
XMLDasm.exe 运行 XML 拆装器组件,通过模拟接收管道来直接调用它,从而允许您看到它如何将用户的 XML 文档解析、拆装或解封装到一个或多个 XML 文档中。

使用情况

后面的部分针对每个文件提供了更详细的说明。

DSDump.exe

DSDump.exe 允许您转储文档架构结构,它是一个或多个 XSD 架构的内存中轻量表示形式,有或没有平面文件批注。

DSDump.exe(文档架构转储工具)支持以下命令行参数:

DSDump.exe schemaFileName  

如果成功,DSDump 则将文档架构显示到控制台。

FFAsm.exe

FFAsm.exe(平面文件组装器)支持以下命令行参数:

usage: ffasm document... [-dm documentMask...]-bs bodySchema [ -hs headerSchema ] [ -ts trailerSchema ] [ -c ] [ -d ] [ -sb ] [ -m filenamemask ] [ -en encoding ] [ -v ]  

where:  
  document           XML document(s)  
  documentMask       XML document(s) file mask, e.g., c:\\documents\\*.xml  
  bodySchema         Flat File body schema  
  headerSchema       Flat File header schema  
  trailerSchema      Flat File trailer schema  
  -c                 Display assembled FF message on the console  
  -d                 Demote properties  
  -sb                Set body schema(s) as design-time property  
  -m                 Output file name mask (default is %MessageID%)  
  encoding           Output message encoding name (e.g. windows-1252) or   
                         code page (e.g. 936)  
  -v                 Verbose mode  

file name macros:  
  %MessageID%        FF message identifier (Guid)  
  %MessagePartID%    FF message part identifier (Guid)  

例如,如果您希望将三个输入 XML 文档组装到一个具有头部和属性降级的平面文件文档,请使用以下命令:

FFAsm.exe file_in1.xml file_in2.xml file_in3.xml –hs myHeaderSchema.xsd –bs myBodySchema.xsd -d  

FFDasm.exe

FFDasm.exe(平面文件拆装器)支持以下命令行参数:

usage: ffdasm document -bs bodySchema [ -hs headerSchema ] [ -ts trailerSchema ] [ -s ] [ -c ] [ -p ] [ -m filenamemask ] [ -en encoding ] [ -v ]  

where:  
  document           Flat File document  
  bodySchema         Flat File body schema  
  headerSchema       Flat File header schema  
  trailerSchema      Flat File trailer schema  
  -s                 Validate document structure  
  -c                 Display disassembled XML message on the console  
  -p                 Display promoted properties on the console  
  encoding           Input message body part encoding name (e.g. windows-1252) or code page (e.g., 396)  
  -m                 Output file name mask (default is %MessageID%)  
  -v                 Verbous mode  

file name macros:  
  %MessageID%        XML message identifier (Guid)  
  %MessagePartID%    XML message part identifier (Guid)  

例如,如果您希望拆装一个具有头部、正文和尾部的平面文件文档,并将结果显示到控制台,请使用以下命令:

FFDasm.exe file_in.txt –hs myHeaderSchema.xsd –bs myBodySchema.xsd –ts myTrailerSchema.xsd –c  

Pipeline.exe

Pipeline.exe(管道工具)支持以下命令行参数:

usage: pipeline ( pipeline[.btp] | -pt pipelineTypeName [ -an assemblyName ] ) -d document... [ -part part... ] [ -s schema[.xsd][:namespace.type]... ] [ -proj project[.btproj] ] [ -p ] [ -c ] [ -t ] [ -m filenamemask ] [ -pm partfilenamemask ] [ -en encoding ] [ -v ]  

where:  
  pipeline                Pipeline file name  
  pipelineTypeName     Compiled pipeline assembly qualified type name (e.g.   
"MyPipelines.ReceivePipeline, MyPipelines,   
Version=1.0.0.0, Culture=neutral,   
PublicKeyToken=e03965cb5971ad66" or full name (e.g.   
"MyPipelines.ReceivePipeline") if assembly name is   
specified  
  assemblyName         Compiled pipeline assembly file name (e.g.   
MyPipelines.dll) or name (e.g. "MyPipelines,   
Version=1.0.0.0, Culture=neutral,   
PublicKeyToken=e03965cb5971ad66")  
  document             Input document(s)  
  part                 Input document's part  
  schema               Schema file name  
  namespace            Schema namespace (as in BizTalk project system)  
  type                 Schema type (as in BizTalk project system)  
  project              BizTalk project file  
  -p                   Display promoted context properties for receive and   
send pipelines, and promote context properties for   
send pipelines  
  -c                      Display output document on the console  
  -t                      Display elapsed time of components execution  
  filenamemask         Output message file name mask (default is   
Message_%MessageID%.out)  
  partfilenamemask     Output part file name mask (default is   
Part_%MessagePartID%.out)  
  encoding             Output message encoding name (e.g. windows-1252)   
or code page (e.g. 936)  
  -v                   Verbous mode  

note:  
You can specify namespace and type for schemas either using namespace.type notation in schema file reference or by using BizTalk project file.  

file name macros:  
  %MessageID%           Message identifier (Guid)  
  %MessagePartID%       Message part identifier (Guid)  
  %MessageNumber%       Message number  

例如,如果要使用 mySchema.xsd 从 ReceivePipeline.btp(具有 XML 拆装器和 XML 验证器组件)运行接收管道,并将结果显示到控制台,请使用以下命令:

Pipeline.exe ReceivePipeline.btp –d file_in.xml –s MySchema.xsd:MyProject.MySchema -c  

- 或 -

Pipeline.exe ReceivePipeline.btp –d file_in.xml –s MySchema.xsd –proj MyProject.btproj -c  

在第一个示例中,架构的限定类型名称 (MyProject.MySchema) 作为命令行参数包含在内。 在第二个示例中,从指定的 BizTalk 项目文件获取架构。

还可以从编译的BizTalk Server项目文件运行管道,如以下示例中 (管道由其程序集限定类型名称) 引用:

Pipeline.exe -pt "TestBtsProject.ReceivePipeline, TestBtsProject, Version=1.0.0.0, Culture=neutral, PublicKeyToken=e03965cb5971ad66" -d in.xml -s PO.xsd -proj TestBtsProject.btproj –c  

在以下示例中,管道由其类型名和程序集文件名分别引用:

Pipeline.exe -pt TestBtsProject.ReceivePipeline –an TestBtsProject.dll -d in.xml -s PO.xsd -proj TestBtsProject.btproj –c   

以下示例显示了由其程序集名称引用的管道:

Pipeline.exe -pt TestBtsProject.ReceivePipeline –an "TestBtsProject, Version=1.0.0.0, Culture=neutral, PublicKeyToken=e03965cb5971ad66" -d in.xml -s PO.xsd -proj TestBtsProject.btproj –c  

Pipeline.exe 运行时,使用您用于启动它的任意凭据。 它不使用正常BizTalk Server主机实例运行的帐户,因此可能无法运行包含需要数据库访问的组件的管道。 请确保在具有所有必需权限的帐户下运行 Pipeline.exe。

您应该只使用 Pipeline.exe 来验证没有第三方自定义组件的自定义管道。 如果使用 pipeline.exe 来验证有第三方自定义组件的自定义管道,Pipeline.exe 将生成所需的输出。 不过,如果部署同一个具有第三方自定义组件的自定义管道,在接收或发送端口中使用管道,然后使用 Pipeline.exe 将消息提交到管道,该管道将失败,BizTalk Server 将返回错误。

XMLAsm.exe

XMLAsm.exe (XML 汇编程序工具) 支持以下命令行参数:

usage: xmlasm document...[-dm documentmask...] -ds documentSchema... [ -es envelopeSchema... ] [ -c ] [ -d ] [ -sd ] [ -m filenamemask ] [ -v ]  

where:  
  document           XML document(s)  
  documentMask       XML document(s) file mask, e.g., c:\\documents\\*.xml  
  documentSchema     XML document schema(s)  
  envelopeSchema     XML envelope schema(s)  
  -c                 Display assembled XML message on the console  
  -d                 Demote properties  
  -sd                Set document schema(s) as design-time property  
  -d                 Demote properties  
  -m                 Output file name mask (default is %MessageID%)  
  -v                 Verbous mode  

file name macros:  
  %MessageID%        XML message identifier (Guid)  
  %MessagePartID%    XML message part identifier (Guid)  

例如,如果您希望将两个输入 XML 文档组装到一个具有信封的 XML 文档,并将结果显示到控制台,请使用以下命令:

FFAsm.exe file_in1.xml file_in2.xml–es myEnvelopeSchema.xsd –ds myBodySchema.xsd –c  

XMLDasm.exe

XMLDasm.exe 支持以下命令行参数:

usage: xmldasm document -ds documentSchema... [ -es envelopeSchema... ] [ -s ] [ -c ] [ -p ] [ -sd ] [ -se ] [ -m filenamemask ] [ -en encoding ] [ -v ]  

where:  
  document           XML document  
  documentSchema     XML document schema(s)  
  envelopeSchema     XML envelope schema(s)  
  -s                 Validate document structure  
  -c                 Display disassembled XML message on the console  
  -p                 Display promoted properties on the console  
  -sd                Set document schema(s) as design-time property  
  -se                Set envelope schema(s) as design-time property  
  -m                 Output file name mask (default is %MessageID%)  
  encoding           Input message body part encoding name (e.g., windows-1252) or code page (e.g., 936)  
  -v                 Verbous mode  

file name macros:  
  %MessageID%        XML message identifier (Guid)  
  %MessagePartID%    XML message part identifier (Guid)  
  %MessageNumber%    XML message number  

例如,如果您希望拆装具有两个嵌套信封的 XML 文档,并将结果显示到控制台,请使用以下命令:

XmlDasm.exe file_in.txt –ds myDocumentSchema.xsd –es myEnvelopeSchema1.xsd –es myEnvelopeSchema2.xsd –c  

另请参阅

SDK 中的实用工具