EOS Platform7远程调用BPS流程引擎

本文介绍在EOS Platform7产品版本中，如何使用EOS构件库中流程的服务构件，或者通过API的方式远程调用BPS服务。
有两台机器，一台机器安装EOS7版本或者EOS Platform7版本，假设为a机器；另外一台机器安装BPS企业版、嵌入式或者Platform7版本，假设为b机器。
用户场景：
场景1：通过a机器的逻辑流访问b机器的BPS服务
实现方案：

登录a机器的Governor，进入配置——服务注册模块，增加两个服务，假设逻辑名称设为other，参见下图：

其中，主机IP，端口号，WEB上下文的根路径是远程流程引擎对应的信息。

说明：通过governor注册的两个服务被保存在eos_service_endpoint表中。

修改a机器的user_local_config.xml（[安装后目录]\apps_config\default\config目录）：

修改DefaultAppName为在Governor中注册的逻辑名，这里对应第一步中的"other"；
修改ServiceLocateMode为 "UDDI_LOCAL"
示例：
<module name="DistributeRuntime">
<group name="DistributeMode"> <configValue key="DefaultAppName">other</configValue> <configValue key="ServerIp">127.0.0.1</configValue> <configValue key="ServerPort">6199</configValue> <configValue key="ServerAppName">default</configValue>  UDDI_LOCAL

确定b机器(BPS引擎端)是否打开了HTTP安全控制，如果打开该开关，只有口令验证通过的用户才可以通过http协议接入访问。

打开b机器的user_local_config.xml（[安装后目录]\apps_config\default\config目录），检查下面的配置：
<group name="http">
<configValue key="needAuthention">true</configValue>
<configValue key="user">bps</configValue>
<configValue key="password">

Unknown macro: {3DES}

fKyjErYbL9XyLCcbvEV/kJ4=</configValue>
</group>
"needAuthention"为true，表示打开了http安全控制，还需要把口令存放在a机器的本地配置文件user-local-config.xml中；如果为false，不需要下面的配置：
<module name="ChannelsSecurity">
<group name="channels2">
<configValue key="protocol">http</configValue>
<configValue key="ip">172.16.55.143</configValue>
<configValue key="port">8080</configValue>
<configValue key="webContext">default</configValue>
<configValue key="user">bps</configValue>
<configValue key="password">

fKyjErYbL9XyLCcbvEV/kJ4=</configValue>
</group>
</module>
其中password可以写明文，EOS Server会自动加密。

重起a机器的EOS Server，即可方便的在逻辑流中实现远程调用b机器的BPS服务。

场景2：通过a机器的Java，即以API的方式调用b机器的BPS服务
实现方案：
开发期访问：需要配置uddi-address.xml文件，可将其创建在EOS项目中任意一个构件包的运算—Java下面，如下图所示：

内容参考如下：

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<uddi_address_list>

<uddi__address id="default">

<name>other</name>
<logicName>default</logicName>
<type>remote</type>
<description>
</description>
<uddiHost>172.16.55.143</uddiHost>

<uddiPort>8080</uddiPort>

<uddiUserID>bps</uddiUserID>

<uddiWebContext>default</uddiWebContext>

<uddiAdminPort>6200</uddiAdminPort>

</uddi__address>
</uddi_address_list>
其中，uddiUserID，uddiPassword要与b机器的user_local_config.xml（[安装后目录]\apps_config\default\config目录）中下面的user，password配置一致：
<group name="http">
<configValue key="needAuthention">true</configValue>
<configValue key="user">bps</configValue>
<configValue key="password">

Unknown macro: {3DES}

fKyjErYbL9XyLCcbvEV/kJ4=</configValue>
</group>
如果"needAuthention"为false，uddiUserID，uddiPassword无需配置。
运行期访问：需要配置uddi-address.xml文件，并将之拷贝到WEB-INF/classes目录。
注意：EOS Platform7的SEE系统中流程默认客户端代码有一些功能是通过API的方式调用BPS服务，所以如果要用这部分功能，以上两个场景都要配置。而且uddi-address.xml中id一定要设置成default：<uddi__address id="default">。

空间快捷链接

页面树结构

EOS Platform7远程调用BPS流程引擎

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<uddi__address id="default">

<uddiPort>8080</uddiPort>

<uddiUserID>bps</uddiUserID>

<uddiAdminPort>6200</uddiAdminPort>

空间快捷链接

页面树结构

EOSPlatform7远程调用BPS流程引擎方案

EOS Platform7远程调用BPS流程引擎

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<uddi__address id="default">

<uddiPort>8080</uddiPort>

<uddiUserID>bps</uddiUserID>

<uddiAdminPort>6200</uddiAdminPort>