BCA用户手册-常用主体活动分册.docx

BCA使用手册 常用主体活动分册BCA业务变化适应器用户手册(常用主体活动分册)文档标题文档编号起草单位北京华夏软通科技有限公司审阅人起草时间2011-01-02归档时间当前状态受控目 录1、BCA常用主体摘要31.1、本手册描述范围31.2、常用主体介绍32、sys主体及活动43、timer主体及活动54、shell主体及活动65、terminal主体及活动76、wsclient主体及活动86.1、wsclient主体简介86.2、Wsclient建模86.2.1、Webservice连接节点96.2.2、Webservice连接节点126.2.3、动态URL实现方法：146.3、应用案例：157、httpClient主体及活动168、ftp主体及活动179、logtool主体及活动1810、综合案例191、 BCA常用主体摘要1.1、 本手册描述范围本手册描述的主体是：除数据引擎、呼叫中心、狭义工作流等大型主体之外的主体及活动。上述大型主体，在单独手册中有专门描述。1.2、 常用主体介绍2、 sys主体及活动3、 timer主体及活动4、 shell主体及活动5、 terminal主体及活动6、 wsclient主体及活动wsclient主体提供一个WebService客户端的一般性功能：连接、调用、关闭。利用wsclient主体的相关活动，BCA可以用流程调用WebService的相关函数，从而组合出复杂的应用系统功能。6.1、 wsclient主体简介wsclient提供一个webservice的客户端，通过“调用WS”节点获得与服务器的交互，从而在BCA流程中嵌套webservice功能。wsclient所在的主体目录位置为：拖拽进入“主体”窗口之后，形成主体实例：共有：连接、调用、关闭三个活动wsclient主体的运行容器是 BcaUtil。因此，如果建模时使用了wsclient，请确保bca-all.bat中包含下述脚本（在dagent之后）：echo util.start /B java -Djava.rmi.server.useLocalHostname=true -Djava.security.policy=./policy.all com.bca.agent.wfutil.BcaUtil6.2、 wsclient建模wsclient主体在BcaUtil容器中执行。执行代理请选择wfutil:常规的webservice调用顺序为：定制webservice调用之前，请确认有一个可用的服务器，用于提供元数据。请现在ie下打开wsdl的页面，确认webservice有效：6.2.1、 Webservice连接节点将ws地址填入链接栏目。BCA系统对每个webservice服务的调用，需要生成一个存根，然后根据存根进行函数解析及调用。存根包名是系统约定的存放webservice存根的包路径。其缺省路径在bca-util-config.xml中配置。点击“创建存根”：创建存根ok：【注意】：创建存根用wsimport命令进行。它是jdk下的exe程序。请保证jdk的bin目录在os的PATH中。否则可能执行失败。创建后，BcaUtil进程所在的主机下，会有相应的存根文件（一个接口，一个服务）：打开服务文件，将接口类名，以及命名空间填写进入对话框：点击确定，连接定制完毕。6.2.2、 Webservice连接节点定制函数调用：打开节点设计对话框：选择函数：对应的参数清单以及返回值出现表格中。点击“创建”：目标情景变量被创建并绑定：检查绑定情况：回到建模主界面。创建好的情景变量：可以进行静态赋值：也可以通过脚本赋值：执行完毕之后，返回BCA会给返回变量赋值。可通过脚本打印出返回变量：6.2.3、 动态URL实现方法：项目部属到应用现场时，webservice的实际URL可能与设计处不同。动态指定URL的方法：6.3、 应用案例：在某保险客服IVR系统中，要求IVR通过WebService连接保险业务系统，查询到客户保单详细文本后，通过TTS转换成语音，在IVR通道放音。该业务实现流程如下：BCA在：查询到的信息文本，通过脚本传递到，然后通过实现了对客户信息文本的放音。6.4、 注意事项l jdk版本要求因存根为动态生成并装载，因此需要有目录存储存根相关类。BCA中ws存根保存目录为：./flowclasses/ws/classes 。完整实现上述类的动态装载，jdk要求的版本是：不低于 jdk 6u18 。测试中发现 jdk 6u07 以下对类的动态装载存在bug。l 垃圾清理WebService存根类保存目录为：./flowclasses/ws/classes。因此每次生成存根