Hello, Biztalk 2006 R2 BAM 中提到了如何配置一个BAM的Activity模型以及通过BAM API直接把关键业务数据喂给BAM。这个适合于企业中Legacy 系统的场景。
接下来我们还是以上次的HelloBamActivity模型为例，配置一个WCF程序。通过添加一个Behavior，定义一个IC（interceptor Configuration）拦截模型。把WCf运行过程中的一些关键业务数据喂给BAM。
我们首先写一个简单的WCF 程序。客户端发送一个订单到WCF 服务。订单包括State，和 Amount以及ID，这个订单的两个属性我们认为是个关键业务数据，需要提取出来反映在BAM中。
写一个WCF 程序。 由于WCF是基于消息的应用，不像Remoting，会有对象的跨Appdomain调用，写一个remoting应用需要两个appdomain，一般来说是两个应用程序。所以很简单，我就把WCF的Client和Service 都放在一个Console程序中。 为了调试方便，采用最简单的basicHttpBinding，没有安全。这样我们可以很轻松用TCPTrace，看到消息的传递过程。编译IC中的Xpath配置。
New一个Console Application叫做SingleWCF，添加对System.ServiceModel 和 System.Runtime.Serialization 的引用。
然后新建一个Class，定义Contract，Service实现。代码如下：
using System;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.Threading;
namespace SingleWCF
{
[DataContract()]
public class PO
{
[DataMember]
public float Amount;
[DataMember]
public string State;
[DataMember]
public string Id;
}
[ServiceContract()]
public interface IPOService
{
[OperationContract()]
string SubmitPo(PO po);
}
[ServiceBehavior(AddressFilterMode=AddressFilterMode.Any)]
public class POServiceImpl : IPOService
{
#region IPOService Members
public string SubmitPo(PO po)
{
Console.WriteLine("Service get the PO");
Thread.Sleep(3000);
Console.WriteLine("Service Processed the PO");
return po.Id;
}
#endregion
}
}
然后添加一个 APP.Config 文件。来Host这个Service。文件如下，
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.serviceModel>
<behaviors>
<serviceBehaviors>
<behavior name="enableWSDL">
<serviceMetadata httpGetEnabled="true" />
</behavior>
</serviceBehaviors>
</behaviors>
<services>
<service behaviorConfiguration="enableWSDL" name="SingleWCF.POServiceImpl">
<endpoint address="ws" binding="basicHttpBinding" bindingConfiguration="basicBindingNoSecurity"
contract="SingleWCF.IPOService" behaviorConfiguration="bamBehavior" />
<host>
<baseAddresses>
<add baseAddress="http://localhost:8888/service" />
</baseAddresses>
</host>
</service>
</services>
<client>
<endpoint address=http://localhost:8888/service/ws behaviorConfiguration="bamBehavior" binding="basicHttpBinding" bindingConfiguration="basicBindingNoSecurity"
contract="SingleWCF.IPOService" name="clientendpoint" />
</client>
<bindings>
<basicHttpBinding>
<binding name="basicBindingNoSecurity">
<security mode="None"/>
</binding>
</basicHttpBinding>
</bindings>
</system.serviceModel>
</configuration>
然后来Host Service并且调用。
using System;
using System.ServiceModel;
using System.Threading;
namespace SingleWCF
{
class Program
{
static System.Threading.ManualResetEvent mre;
static void Main(string[] args)
{
mre = new ManualResetEvent(false);
System.Threading.ThreadPool.QueueUserWorkItem(StartHost);
mre.WaitOne();
System.Threading.ThreadPool.QueueUserWorkItem(StartClient);
Console.ReadLine();
}
public static void StartHost(object o)
{
ServiceHost host = new ServiceHost(typeof(POServiceImpl));
host.Open();
Console.WriteLine("HostStarted");
mre.Set();
Console.ReadLine();
}
public static void StartClient(object o)
{
ChannelFactory<IPOService> factory = new ChannelFactory<IPOService>("clientendpoint");
IPOService client = factory.CreateChannel();
PO p=new PO();
p.Amount=120;
p.State="WA";
p.Id = Guid.NewGuid().ToString();
client.SubmitPo(p);
Console.WriteLine("PO Sent Done");
}
}
}
然后运行一下，就可以看到Service正常调用。
这时候把程序App.Config少许该一下，让客户端发送的目的地址由http://localhost:8888/service/ws 端口8888改为9999，然后TCPTrace负责forward9999到8888.这样客户和服务端之间的http通讯都可以被监视到。类似Soaptoolkit的monitor工具。
首先启动TCPTrace，可以从 http://www.pocketsoap.com/tcptrace/ 下载。
在运行程序，就可以在TCPTrace看到消息的调用。包括发送和接受的消息。
到这里我们的WCF service 就写好了。接下来需要配置我们的拦截模型IC，并且部署到BAM的配置库。
关于拦截模型。
首先需要定义一个事件源（EventSource），比如WCF程序是一个事件源。WF程序也是一个事件源。Biztalk也是事件源。
对于事件源，如果是.net 程序集，需要制定Assembly的fullname，如果是Biztalk，要制定是messagebox还是orchastration。
有了事件源，需要定义一个或者多个事件模型。
事件的定义，是通过Filter来筛选，事件发生后有要更改Activity的那些属性，通过Update来配置。另外还可以指定Reference，类似引用那个文档或者Activity。以及如何把多个事件源生成的Activity关联到一个的Continous模型。这个后面会讲。
对于事件源，一下是一个例子。
对于WCF，manifest是Contract的fullname，WF，则是workflow的fullname。
然后是一个事件的tree
接下来我们配置一个我们的IC.
我们需要配置的IC的事件源来自WCF。
当客户端发出一个请求的时候，并且是调用SubmitPo 的时候，我们称这个事件叫做BeginOrder。这时候拦截到State，Amount 属性。并且把当前的时间更新到Activity的BeginOrder。
当客户端收到submitPO的时候，我们成为事件EndOrder，更新Activity的EndOrder属性。
为了方便生成这个XML。Biztalk R2提供了三个Schema，分别面向WCF、WF，Common IC
WcfInterceptorConfiguration.xsd
CommonInterceptorConfiguration.xsd
这两个文件可以在SDK目录下面找到，如果没有的话，在安装盘Msi\Program Files\SDK\Samples\BIX 下面。可以把这两个文件copy到visual studio的schema 目录下面。方便有智能提示。
我们新建一个XML到项目中，成为wcfInterceptor.xml
<?xml version="1.0" encoding="utf-8" ?>
<bam:InterceptorConfiguration xmlns:bam="http://schemas.microsoft.com/BizTalkServer/2004/10/BAM/InterceptorConfiguration"
xmlns:bamwcf="http://schemas.microsoft.com/BizTalkServer/2004/10/BAM/WcfInterceptorConfiguration">
</bam:InterceptorConfiguration>
这时候按照智能提示，大多数配置可以轻松搞定。
定义一个事件源
<bam:EventSource Manifest="SingleWCF.IPOService, SingleWCF, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" Name="wcfSource" Technology="WCF">
</bam:EventSource>
注意这里的manifest是fullname，wcf程序在运行的时候会根据当前endpoint所绑定的contract的全名去数据库中选招match的ic。如果manifest写错了的话，你就得不到任何BAM数据。
然后定义第一个事件。条件是：
ClientRequest 一个Operation是SubmitPo
对应成语法是GetServiceContractCallPoint()=ClientRequest And GetOperationName()="SubmitPO"
IC 采用一个特殊的语法，叫做反向表达式。就是操作数在前，操作符在后。比如我们计算2+3×4 写作 234×+
WCF 有一些特殊的Operation，比如：
AutoGenerateCorrelationToken
GetContextProperty
GetEndpointName
GetOperationName //返回当前的调用的Contract的Operation
GetServiceContractCallPoint//调用拦截点。是ClientRequest还是ServiceReply
XPath//从message中抓数据。
这些可以从MSDN看到返回值和使用方式。
对应成ic的xml就是
<bam:OnEvent Name="BeginOrder" IsBegin="true" IsEnd="false" Source="wcfSource">
<bam:Filter>
<bam:Expression>
<bamwcf:Operation Name="GetServiceContractCallPoint">
</bamwcf:Operation>
<bam:Operation Name="Constant">
<bam:Argument>ClientRequest</bam:Argument>
</bam:Operation>
<bam:Operation Name="Equals">
</bam:Operation>
<bamwcf:Operation Name="GetOperationName">
</bamwcf:Operation>
<bam:Operation Name="Constant">
<bam:Argument>SubmitPo</bam:Argument>
</bam:Operation>
<bam:Operation Name="Equals">
</bam:Operation>
<bam:Operation Name="And"></bam:Operation>
</bam:Expression>
</bam:Filter>
<bam:CorrelationID>
<bam:Expression>
<bamwcf:Operation Name="XPath">
<bamwcf:Argument>
//*[local-name(.)='Id']
</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:CorrelationID>
<bam:Update DataItemName="BeginOrder" Type="DATETIME">
<bam:Expression>
<bamwcf:Operation Name="GetContextProperty">
<bamwcf:Argument>EventTime</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:Update>
<bam:Update DataItemName="State" Type="NVARCHAR">
<bam:Expression>
<bamwcf:Operation Name="XPath">
<bamwcf:Argument>//*[local-name(.)='State']</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:Update>
<bam:Update DataItemName="Amount" Type="FLOAT">
<bam:Expression>
<bamwcf:Operation Name="XPath">
<bamwcf:Argument>//*[local-name(.)='Amount']</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:Update>
</bam:OnEvent>
其中有一个element是CorrelationID，相当于Activity的PK值。不同的事件触发如何关联到一个Activity
接下来定义另外一个事件，服务返回。更新EndOrder时间。
<bam:OnEvent Name="EndOrder" IsBegin="false" IsEnd="true" Source="wcfSource">
<bam:Filter>
<bam:Expression>
<bamwcf:Operation Name="GetServiceContractCallPoint">
</bamwcf:Operation>
<bam:Operation Name="Constant">
<bam:Argument>ServiceReply</bam:Argument>
</bam:Operation>
<bam:Operation Name="Equals">
</bam:Operation>
</bam:Expression>
</bam:Filter>
<bam:CorrelationID>
<bam:Expression>
<bamwcf:Operation Name="XPath">
<bamwcf:Argument>
//*[local-name(.)='SubmitPoResult']
</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:CorrelationID>
<bam:Update DataItemName="EndOrder" Type="DATETIME">
<bam:Expression>
<bamwcf:Operation Name="GetContextProperty">
<bamwcf:Argument>EventTime</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:Update>
</bam:OnEvent>
请注意CorrelationID 的两个写法。从TCPTrace中可以看到这两个值对应一个请求。
写好这个IC之后，通过BM.exe部署
bm deploy-interceptor -filename:"xxx\SingleWCF\wcfInterceptor.xml"
这样IC模型就部署到BAM的元数据库中。你可以查询
数据中记录了该IC对应的Activity，以及事件的XML描述。
接下来我们要配置WCF程序，enable 一个BAM提供的EndpointBehavior，来横向拦截IC模型的数据。
右键 app.config,选择用EDIT with WCF Configuration.
Advance-> Extensions->new behavior element extension
新建一个Element 叫做bamEndpoinBehavior 名字可以自己随便输入。
Type 是Microsoft.BizTalk.Bam.Interceptors.Wcf.BamEndpointBehavior, Microsoft.BizTalk.Bam.Interceptors, Version=3.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
当然你可以点击Browser，定位到Gac中的Microsoft.BizTalk.Bam.Interceptors 程序集。
接下来新建一个EndpointBehavior叫做bamBehavior。把新建好的Element拖进去。配置
BAM数据连接字符串：指向本地BAM数据库
以及Polling的时间，写5，代表没5秒查询数据库看有没有新的IC定义。
然后配置service和client endpoint使用该behavior
此时完整的App.config
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.serviceModel>
<extensions>
<behaviorExtensions>
<add name="bamEndpointBehavior" type="Microsoft.BizTalk.Bam.Interceptors.Wcf.BamEndpointBehavior, Microsoft.BizTalk.Bam.Interceptors, Version=3.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />
</behaviorExtensions>
</extensions>
<behaviors>
<endpointBehaviors>
<behavior name="bamBehavior">
<bamEndpointBehavior ConnectionString="Data Source=.;Initial Catalog=bamprimaryimport;Integrated Security=True"
PollingIntervalSec="5" />
</behavior>
</endpointBehaviors>
<serviceBehaviors>
<behavior name="enableWSDL">
<serviceMetadata httpGetEnabled="true" />
</behavior>
</serviceBehaviors>
</behaviors>
<services>
<service behaviorConfiguration="enableWSDL" name="SingleWCF.POServiceImpl">
<endpoint address="ws" binding="basicHttpBinding" bindingConfiguration="basicBindingNoSecurity"
contract="SingleWCF.IPOService" behaviorConfiguration="bamBehavior" />
<host>
<baseAddresses>
<add baseAddress="http://localhost:8888/service" />
</baseAddresses>
</host>
</service>
</services>
<client>
<endpoint address="http://localhost:9999/service/ws"
behaviorConfiguration="bamBehavior" binding="basicHttpBinding"
bindingConfiguration="basicBindingNoSecurity"
contract="SingleWCF.IPOService" name="clientendpoint" />
</client>
<bindings>
<basicHttpBinding>
<binding name="basicBindingNoSecurity">
<security mode="None"/>
</binding>
</basicHttpBinding>
</bindings>
</system.serviceModel>
</configuration>
大功告成了,Run 一下应用程序。然后打开BAM portal， http://localhost/bam 就可以看到数据进去了。
beginorder，endorder之间相差3秒左右。应为我们程序休息了3秒。 state是WA，amount是120.这些都是WCF 提供的数据。
如何调试知道Event有没有被命中呢？ wcf intercepotr 采用.net标准的Trace模型。在App.config中加入
<system.diagnostics>
<sources>
<source name="Microsoft BizTalk Bam Interceptors" switchValue="All">
<listeners>
<add name="consolelistener" type="System.Diagnostics.ConsoleTraceListener"/>
</listeners>
</source>
</sources>
</system.diagnostics>
注意SourceName必须是Microsoft BizTalk Bam Interceptors
我上次写成Microsoft Biztalk Bam Interceptors，结果什么也没有。debug了半天，hoho
再运行程序就看到结果了。一堆日志消息。
这样。WCF程序通过定义个interceptor模型，就可以把业务关键数据喂给bam了。
这里是完整的模型文件。
<?xml version="1.0" encoding="utf-8" ?>
<bam:InterceptorConfiguration xmlns:bam="http://schemas.microsoft.com/BizTalkServer/2004/10/BAM/InterceptorConfiguration"
xmlns:bamwcf="http://schemas.microsoft.com/BizTalkServer/2004/10/BAM/WcfInterceptorConfiguration">
<bam:EventSource
Manifest="SingleWCF.IPOService, SingleWCF, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null"
Name="wcfSource" Technology="WCF">
</bam:EventSource>
<bam:BamActivity Name="HelloBamActivity">
<bam:OnEvent Name="BeginOrder" IsBegin="true" IsEnd="false" Source="wcfSource">
<bam:Filter>
<bam:Expression>
<bamwcf:Operation Name="GetServiceContractCallPoint">
</bamwcf:Operation>
<bam:Operation Name="Constant">
<bam:Argument>ClientRequest</bam:Argument>
</bam:Operation>
<bam:Operation Name="Equals">
</bam:Operation>
<bamwcf:Operation Name="GetOperationName">
</bamwcf:Operation>
<bam:Operation Name="Constant">
<bam:Argument>SubmitPo</bam:Argument>
</bam:Operation>
<bam:Operation Name="Equals">
</bam:Operation>
<bam:Operation Name="And"></bam:Operation>
</bam:Expression>
</bam:Filter>
<bam:CorrelationID>
<bam:Expression>
<bamwcf:Operation Name="XPath">
<bamwcf:Argument>
//*[local-name(.)='Id']
</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:CorrelationID>
<bam:Update DataItemName="BeginOrder" Type="DATETIME">
<bam:Expression>
<bamwcf:Operation Name="GetContextProperty">
<bamwcf:Argument>EventTime</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:Update>
<bam:Update DataItemName="State" Type="NVARCHAR">
<bam:Expression>
<bamwcf:Operation Name="XPath">
<bamwcf:Argument>//*[local-name(.)='State']</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:Update>
<bam:Update DataItemName="Amount" Type="FLOAT">
<bam:Expression>
<bamwcf:Operation Name="XPath">
<bamwcf:Argument>//*[local-name(.)='Amount']</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:Update>
</bam:OnEvent>
<bam:OnEvent Name="EndOrder" IsBegin="false" IsEnd="true" Source="wcfSource">
<bam:Filter>
<bam:Expression>
<bamwcf:Operation Name="GetServiceContractCallPoint">
</bamwcf:Operation>
<bam:Operation Name="Constant">
<bam:Argument>ServiceReply</bam:Argument>
</bam:Operation>
<bam:Operation Name="Equals">
</bam:Operation>
</bam:Expression>
</bam:Filter>
<bam:CorrelationID>
<bam:Expression>
<bamwcf:Operation Name="XPath">
<bamwcf:Argument>
//*[local-name(.)='SubmitPoResult']
</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:CorrelationID>
<bam:Update DataItemName="EndOrder" Type="DATETIME">
<bam:Expression>
<bamwcf:Operation Name="GetContextProperty">
<bamwcf:Argument>EventTime</bamwcf:Argument>
</bamwcf:Operation>
</bam:Expression>
</bam:Update>
</bam:OnEvent>
</bam:BamActivity>
</bam:InterceptorConfiguration>