应用平台

# 数据魔方

数据魔方接入方式主要有以下2种：

# 1、实现com.seeyon.datamagic.engine.out.service.OutService接口

# （1）接口方法简要说明

方法名 说明
getServiceInfo 获取接口选择页面标签
loadAllServices 加载所有支持的选择器列表左侧树列表
convert 将选择后的树节点信息转换成魔方接口
provider 提供当前节点的实现类
generateMethodContent 代码块生成代码

# （2） 界面和功能入口

# (3)点击确定后会调用convert和provider方法进行接口定义生成。

# (4)目前通过此方法接入的功能列表如下:

| ---------- | -------------------------------------------------------- | | 名称 | 类名 | | 业务生成器/表单应用 | com.seeyon.cap4.magic.generator.cap3.CAP3FormJoinService | | CIP业务接口 | com.seeyon.apps.voucher.cap4.VoucherForCapMagicService | | 报表 | com.seeyon.cap4.magic.manager.impl.MagicReportOutService | | DEE数据交互接口 | com.seeyon.apps.dee.cap4.DeeForCapMagicService |

# 2、通过通用接口实现

# （1）应用应用设计师进入业务包-->管理设置-->接口管理

# (2) 集团管理员/单位管理员进入CIP集成平台-->集成资源库-->CAP应用接口

# (3)新建通用接口，必填以及关键信息如下

# (1) 填写接口名称

# (2) 调用授权，默认是公开，标识所有的业务包都能调用;也可以选择自定义指定某些业务包能够调用，

# (3)点击下一步新建方法，目前只支持关联/触发，注意事项如下

# (1) 关联 返回值必填
# (2) 触发 没有必填项
# (3) 无论是关联和触发，代码名称必须符合java的命名规范，并且不能使用java内置关键字
# (4) 关联和触发的传入参数关联条件不允许使用OA内置的函数名称，比如year,date等

# (4)设置好方法后点击下一步进入接口实现页面先点击下一步将接口定义信息保存入库 然后选中此接口并点击修改 再次进入接口实现。此时接口实现为空需要下载接口代码点击按钮下载接口代码，下载完成后解压后用idea或者eclipse打开

# (1) MagicProviderRegisterImpl 此结果在导入接口实现时由程序调用不能删除
# (2) 修改pom.xml中的版本号，默认是trunk-SNAPSHOT,需要修改为系统当前的版本
# (3) 进入类C372f1c191aaa516db58df5803508499f中编写对应的接口实现。
# (4) 代码编写完成后 执行maven 打包命令package

# (5) 在接口实现页面点击导入实现将打包后的zip文件上传到OA服务器此次接口实现会显示出导入的实现

# (6)确定后页面刷新 这时接口实现就是开发时提供的接口实现

自此 通路已经完成，可以通过表单的业务关系关联/触发选择到自己新建的接口(方法显示名称)后进行业务测试.如果实现类有问题可以修改后重新打包 将之前的实现类删掉 重新导入实现。目前 组织机构是通过此方式接入

# 推荐使用第二种方式

# 注意事项总结如下

** (1)  方法名称可以自定义，只需要满足java命名规范**

** (2)  方法参数名需要满足java命名规范，关联条件不能使用OA自带的函数名称 比如 year ，date**

** (3)  代码源码中有个关键文件  serviceConfig.json  这个文件不能修改，如果有调整必须通过OA接口定义界面调整，然后下载后直接用文件更新。 导入实现时会用此文件重新更新接口定义，因此需要保证OA中的接口定义和工程中的一致，否则会出现覆盖的情况。**

创建人：yinyanting
修改人：het

快速跳转

← 2.1.1 vue开发 →