BWSalesforce Plugin

BWPlugin for Salesforce

1. 首先要到http://developer.salesforce.com上注册一个Salesforce的开发账户, 然后收到一封Salesforce的登陆确认邮件, 让你登陆https://login.salesforce.com/?c=l14m453Kn7zYlPdEXOoJY1MvFqDNubgKMqaw2yC2O_1U7rWWDGCCXsaYMBiuBJvRBH_3uOzkmivHdnD0C4v4Gy

2. 登陆后, 进入我的个人信息 -> 重新设置我的安全标记(security token). 点击"重新设置安全标记"按钮. 就会收到一封安全标记确认邮件. 发给你一个字符串token.

3. 依次安装RV, TRA(包含hawk), BW 注意一个都不能少! 否则plugin无法安装, 最后安装BW Salesforce Plugin.

4. 启动 Desinger. 导入plugin自带的example, 比如GeneralSample.

5. 配置工程. 点击左侧的Global Variables Tab, 选中salesforce.password和salesforce.username, 点击左上角黄色的笔标志, 将第一步中注册的用户名和密码重新填写.注意:密码必须是你注册的密码+security token的形式, 比如你的密码是"passwrod", 发挥的token是"XXXXXX", 那么密码就是"passwordXXXXXX".

6. 在Design Time的时候, 需要在designer.tra文件中添加这个属性:
java.property.com.entrust.toolkit.x509.CertVerifier.ForceV1CertAsCA=true 这一点在TIB_bwpluginsalesforce_2.3.0_relnotes.pdf的Known issues中有说明.

7. 测试工程. 选中工程跟目录, 点击左侧的Tester Tab, 点击load&Start Current. GeneralSample 才会成功运行.如果只想测试连接Salesforce是否成功, 可以双击"Salesforce Connection" icon, 运行Test Connection.

8. 如果想在Runtime(TRA)中运行这个例子, 需要在BW_HOME\lib\com\tibco\deployment\bwengine.xml文件中添加java.property.com.entrust.toolkit.x509.CertVerifier.ForceV1CertAsCA 属性值设为true. 注意这个bwengine.xml文件也和designer在同一个TIBCO_HOME下的.

9. 为运行时创建ear文件. 选中Tools -> Create Project EAR, 会看到在一个Archive的icon在工作区生成. 双击这个icon, 会看到一个Shared Archive和一个Process Archive. 双击Shared Archive, 再点击配置区的"Resource"tab, 点击配置区右上角的望远镜图标, 选中添加这三个资源文件:

/Salesforce Connection.sharedsalesforce
/SalesforceResources
/SalesforceResources/partner_20_0.wsdl

资源文件必须添加, 否在在运行时会报错说找不到wsdl等错误.

Apply Changes, 双击Archive icon ->"Build Archive" 按钮. 提示ear创建成功. 当这个ear创建成功后, 可以用WinRAR打开, 看到里面有"Process Archinve.par", "Shared Archive.sar", TIBCO.xml生成. 再用WinRAR打开"Process Archinve.par", 会看到GeneralSample的流程文件和一个TIBCO.xml 注意, 在这个TIBCO.xml中就有在第8步添加的证书属性和值. 如果没有, 在运行时还是会看到login failed的错误提示.

10. 运行ear包, 登陆Admin, 点击"All Applications" ->New Application, 上传上一步中创建好的ear文件. 点击OK. 选中Deploy on Save checkbox. 在点击save. ear就会在保存的同时部署.

注: 如果需要的property没有打包在ear中, 在部署运行之后想改的话, 可以向这个文件中添加相应的属性<TIBCO_HOME>/domaindata/tra/<Domain_Name>/application/<Project_Name>/<Project_Name>-Process_Archive.tra

有人可能会误以为修改运行时的<TIBCO_HOME>/bw/5.9/lib/com/tibco/deployment/bwengine.xml, 其实是不起作用的. 这个文件也是供设计时读取的. 运行时读取的是打包在ear中的*.par的TIBCO.xml文件. 打包是<TIBCO_HOME>/bw/5.9/lib/com/tibco/deployment/bwengine.xml的值会被添加进ear中的*.par的TIBCO.xml

11. 观察执行日志. 点击"All Service Instances" -> Tracing tab, 点击Search.就可以看到log.

12. 查看ear中打包的属性. Application Management > [hostname] > GeneralSample > Configuration, 点击 Process Archive.par, 点击Advanced, 也能看到在第8步添加的workaround属性.

补充: 在部署时候通常要把ear包放到一个zip文件里, 同时这个zip里要一个相应的xml配置文件, 需要通过下面的命令生成:

C:\tibco\tra\5.7\bin>AppManage.exe -export -out C:\GeneralSample.xml -ear C:/Users/Administrator/GeneralSample.ear
Initializing ...
Finished initialization
Exporting application configuration ...
Finished exporting application
Finished successfully in 9 seconds