R/3 BAPI DCOM接口简介

SAP R/3的企业目标库BOR(Business Objects Repository)中封装了R/3的功能对象。通过BAPI（Business Application Programming Interface）可以访问BOR。BAPI是R/3平台专用的开发接口，从系统整合的角度看，BAPI只能支持“SAP应用-SAP应用”之间的整合。“SAP应用-非SAP应用”的整合技术中，R/3 DCOM接口应用比较广泛。

一、R/3 DCOM接口简介

R/3的DCOM接口主要用于Windows平台的应用程序访问R/3。R3 DCOM除了可以访问BAPI外，还可以远程调用R/3上的ABAP程序（需要DCOM Connector 4.6D以后的版本支持）。

SAP的 frontend CD中，附带了一个R/3 DCOM的生成和管理工具，叫做DCOM Connector。通过DCOM Connector生成的DCOM包含两个组件，一个是业务代理组件，用于代理调用R/3 BAPI或远程方法；另一个是Session组件，用于管理业务代理组件和R/3系统的交互。

R/3 DCOM组件运行在COM+环境（或者MTS）中。

DCOM通过RFC协议访问R/3应用服务器。RFC是R/3开发接口的基本协议。不仅DCOM使用RFC协议，IDOC和BAPI也使用RFC访问R/3应用服务器。

R/3 DCOM可以被C/C++、VB等开发的桌面应用程序访问，也可以嵌入VB Script、Java Script和ASP页面从而支持Web应用。

R/3 DCOM的体系结构图如下：

  

  

  

  

  

     二、使用DCOM Connector  

1、  安装运行环境。如果是Win2000，那么只需要VC6开发环境。如果是NT/98/95，那么需要IE5.0以上版本，并且安装微软的数据库访问组件MDAC2.5。建议使用Win2000。

2、  安装DCOM Connector。一路默认安装，如果不需要com4abap，那么在configure com4abap属性页中什么都不用填。安装后的DCOM Connector是一个Windows MMC程序。

3、  打开DCOM Connector，转到节点Destination，配置Destination。填入各种参数后保存，然后测试一下连接。

4、  在DCOM Connector中，转到节点Object Builder，选择刚才保存的Destination，输入密码登陆。然后选择BAPI或远程方法，就可以导出或部署DCOM了。

需要注意的是：

1、  如果同一台机器上安装了R/3客户端，并且建立了与DCOM Connector 同名的Destination，那么可能发生冲突。此时用另外的名字重新配置一下Destination即可。

2、  在DCOM Connecctor的Object Builder中，可以选择是否创建Session。关于Session以下会有介绍。

3、  DCOM Connecctor导出COM标准的C代码，包括mak文件，然后用本机编译器nmake.exe进行编译，生成COM标准的dll。因此本机必须安装C/C++编译环境，笔者使用VC6。

4、  在Object Builder中指定一个MTS Package名称，那么可以自动安装部署COM。建议手工在“组件服务”中部署COM。

5、  在DCOM Connector中，可以监控和查找已经部署在本机上的R/3 DCOM 组件，类似Windows的组件服务。

 

 

 

 

 

 

三、使用R/3 DCOM组件

    1、Session组件

Session组件的接口是ISAPSession，包括登陆验证和事务管理两方面功能。

典型的R/3登陆代码：

 

 

 

 

 

         Dim strErr As String

         Dim blnRet As Boolean

 objSAPSession As MyGoodsMvtLib.GoodsMvtSessionComponent

  

  

  

  

  

   

         objSAPSession = CreateObject("SAP.GoodsMvtSessionComponent.1")

     objSAPSession.PutSessionInfo(_destination, _username, _password, _language,_organization)

bResult = objSAPSession.Logon(strErrorMessage)

 

 

 

 

 

  

典型的事务提交代码：

 

 

 

 

 

         Try

            // 业务代理组件的操作

            objSAPSession.CommitWork()

            objSAPSession = Nothing

            objGoodsMvt = Nothing

        Catch

            objSAPSession.RollbackWork()

            objSAPSession = Nothing

            objGoodsMvt = Nothing

        End Try

 

 

 

 

 

 

Session组件能够管理一个或一组业务代理组件。Session能够将多个业务代理组件的业务方法在同一个事务中提交，也可以在多个业务代理组件中共享RFC连接。

然而，Session组件不是必须的。实际上，事务管理的方法封装在ISAPConnector接口中。Session组件的ISAPSession接口由于继承了ISAPConnector才具有事务功能。同样，业务代理组件也继承自ISAPConnector，因此业务代理组件也同样可以单独提交。不同的是，业务代理组件使用各自独立的RFC连接，且不能将多个组件方法在一个事务中提交。

  

  

  

  

  

2、业务代理组件

业务代理组件是R/3 BAPI和R/3远程方法的proxy。应用程序使用这个proxy就能够像在本地一样透明地调用R/3的BO。R/3中不同的业务对象对应不同的业务代理。

业务代理组件可以由Session组件创建：

 

 

 

 

 

      et oOrders = oSession.CreateInstance("sam.GoodsMovement.1")

 

 

 

 

 

      不同的业务代理组件除了包含实现各自功能的业务接口外，都实现了一个共同的接口：ISAPCatalog。DCOM Connector利用了这个接口，对业务代理组件进行管理和监控。

l         PutSeesionInfo()—设定系统一次调用的目标参数

l         AdviceRfcGuiSink()—用于需要SAPGUI或dubugging的场合。

l         CommitWork()-用于数据更新，无implicit commit的场合。

l         InitKeys()-DCOM目标键初始化

l         DimAs()-返回Microsoft ADO(Advanced Data Object) 纪录集(支持游标控制)。

四、总结

R/3 DCOM更适合于小型的R/3外挂程序，或者与基于Windows的小型应用集成。对于大型R/3 EAI，可以考虑Tibco、Webmethod、Biztalk、Crossworld等中间件产品。

作者简介：张昱，可以通过[email protected] 与作者联系。