编写BizTalk 自定义管道组件的一个意外错误
作者:郑佐 2006-11-28
假设有一个名为Zhengzuo.BizTalk.Pipelines的组件项目,用来实现一个BizTalk 2006的自定义的管道组件。
以下是笔者编写自定义接收管道组件的一段不完整代码,
[ComponentCategory(CategoryTypes.CATID_PipelineComponent)]
[ComponentCategory(CategoryTypes.CATID_Any)]
[ComponentCategory(CategoryTypes.CATID_Validate)]
[ComponentCategory(CategoryTypes.CATID_DisassemblingParser)]
[System.Runtime.InteropServices.Guid("7EDA198E-6FD8-4046-A974-1C8BF55C3B93")]
public class BoxUpMessageComponent :
IComponent,
IBaseComponent,
IComponentUI,
IPersistPropertyBag,
IDisassemblerComponent
{
private const string description = "管道解码器。编写人:郑佐。\n编写时间:2006-08-1。";
private const string name = "某某管道组件";
private const string version = "1.0.0.0";
}
编译Zhengzuo.BizTalk.Pipelines项目成功,输出到D:\Program Files\Microsoft BizTalk Server 2006\Pipeline Components目录,生成组件为Zhengzuo.BizTalk.Pipelines.dll。
在解决方案中新建一个名为BizTalkTest的BizTalk项目。添加一个发送管道取名为SendPipeline1.btp。打开该发送管道进行编辑,把“某某管道组件”从工具箱拉到解码的位置(如果在工具箱中没有找到“某某管道组件”,在工具箱上右键点击“选择项”菜单,在显示的窗口上选择BizTalk管道组件选项卡,选中“某某管道组件”添加)。
编译BizTalkTest项目,出现一连串错误如下:
错误 11 常量中有换行符
错误 12 意外的字符“:”
错误 13 意外的字符“。”
错误 14 常量中有换行符
错误 15 应输入 ;
错误 16 类、结构或接口成员声明中的标记“:”无效
错误 17 类、结构或接口成员声明中的标记“>”
在BizTalkTest项目文件目录下复制SendPipeline1.btp文件,并修改文件名为SendPipeline1.xml,使用IE或FireFox打开,显示内容如下。
<?xml version="1.0" encoding="utf-16"?>
<Document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" PolicyFilePath="BTSReceivePolicy.xml" MajorVersion="1" MinorVersion="0">
<Description />
<Stages>
<Stage CategoryId="9d0e4103-4cce-4536-83fa-4a5040674ad6">
<Components>
<Component>
<Name>Zhengzuo.BizTalk.Pipelines.BoxUpMessageComponent</Name>
<ComponentName>某某管道组件</ComponentName>
<Description>管道解码器。编写人:郑佐。
编写时间:2006-08-1。</Description>
<Version>1.0.0.0</Version>
<Properties />
<CachedDisplayName>某某管道组件</CachedDisplayName>
<CachedIsManaged>true</CachedIsManaged>
</Component>
</Components>
</Stage>
<Stage CategoryId="9d0e4105-4cce-4536-83fa-4a5040674ad6">
<Components>
<Component>
<Name>Microsoft.BizTalk.Component.FFDasmComp</Name>
<ComponentName>平面文件拆装器</ComponentName>
<Description>流平面文件拆装器组件</Description>
<Version>1.0</Version>
<Properties>
<Property Name="HeaderSpecName" />
<Property Name="DocumentSpecName">
<Value xsi:type="xsd:string">BizTalkTest.SendPipeline1</Value>
</Property>
<Property Name="TrailerSpecName" />
<Property Name="PreserveHeader">
<Value xsi:type="xsd:boolean">false</Value>
</Property>
<Property Name="ValidateDocumentStructure">
<Value xsi:type="xsd:boolean">false</Value>
</Property>
<Property Name="RecoverableInterchangeProcessing">
<Value xsi:type="xsd:boolean">false</Value>
</Property>
</Properties>
<CachedDisplayName>平面文件拆装器</CachedDisplayName>
<CachedIsManaged>true</CachedIsManaged>
</Component>
</Components>
</Stage>
<Stage CategoryId="9d0e410d-4cce-4536-83fa-4a5040674ad6">
<Components />
</Stage>
<Stage CategoryId="9d0e410e-4cce-4536-83fa-4a5040674ad6">
<Components />
</Stage>
</Stages>
</Document>
注意到xml文件的红色标注部分,对应Zhengzuo.BizTalk.Pipelines组件项目中的代码为,
private const string description = "管道解码器。编写人:郑佐。\n编写时间:2006-08-1。";
修改以上代码为
private const string description = "管道解码器。编写人:郑佐。编写时间:2006-08-1。";
修改btp发送管道重新添加“某某管道组件”,编译BizTalkTest项目成功。查看btp文件xml结构为
<Description>管道解码器。编写人:郑佐。编写时间:2006-08-1。</Description>
可见由于“\n”导致项目编译失败。这个算不算是BizTalk Server 2006开发中的一个小bug?