NCV61协同配置技术红皮书.docx
- 文档编号:5493850
- 上传时间:2022-12-17
- 格式:DOCX
- 页数:35
- 大小:727.53KB
NCV61协同配置技术红皮书.docx
《NCV61协同配置技术红皮书.docx》由会员分享,可在线阅读,更多相关《NCV61协同配置技术红皮书.docx(35页珍藏版)》请在冰豆网上搜索。
NCV61协同配置技术红皮书
协同配置
第一章简介
基础配置包括组织权限、基础数据、用印、模板等产品模块,提供了平台级档案等基础数据的访问接口。
第二章基础服务器类
2.1持久化
上图是持久化服务现有的组件结构,抽象服务中提供了基本的数据持久化功能(如增删改),但是校验、事件分发等业务应用没有,需要继承组件自行实现。
目前,在协同持久化服务层面,实现了校验器、事件分发等机制。
如果想直接利用NC现有机制,可以采用OA的持久化方案。
自行实现抽象服务,并调用NC现有的业务锁、事件、校验等机制。
抽象服务类如下:
类名
说明
nc.uap.cpb.baseservice.SingleBaseService
简单服务,针对独立单据的操作
nc.uap.cpb.baseservice.MtBaseService
基本服务,可针对启用、停用等做批量操作
nc.uap.cpb.baseservice.MmtBaseService
批量操作服务
nc.uap.cpb.baseservice.AggVOBaseService
针对聚合VO的服务
第三章组织权限
3.1抽象多组织模型
协同组织模型提供了一种抽象的组织模型,该模型是一种弹性的组织架构。
不同的业务产品可以根据自己产品的特性定义自己的产品组织模型。
系统默认提供的是NC组织适配器,也就是说在NC产品中定义了组织之后,会自动同步到协同组织中。
第四章基础数据
4.1模板管理
4.1.1查询模板
查询模版包括新增、编辑、删除、查询条件编辑和模版分配功能;
新增:
选择某个模版,点击“新增”(包括模版编号、模版名称、节点编码、模版分配节点、元数据主体、是否显示高级搜索);
点击“确定”保存。
编辑:
选中模版,点击“修改”,修改模版编号、模版名称、节点编码、模版分配节点、元数据主体、是否显示高级搜索;(注:
修改了模板名称)
点击“确定”更新;
删除:
选中模版,点击“删除”,弹出删除对话框,点击“确定”,删除选中模板;
查询条件编辑:
选中模版,点击“查询条件编辑”按钮,打开查询条件编辑窗口,根据添加的元数据主体数据,在左侧树中全部显示元数据结构,通过中间按钮“向右”、“向左”按钮添加、删除查询条件,也可以通过添加系统变量菜单添加自定义变量作为查询条件;
点击“确定”,保存选择的查询编辑条件。
模版分配:
选择某个模版,点击“模版分配”,可以有角色、用户、组织三个部分;选择角色、用户、组织中一个或多个;
点击“确定”保存,分配模版权限;
快速查询配置:
点击“OK”,引用公共片段pubview_simplequery,在pagemeta.pm中
添加了refId=”../pubview_simplequery”,widget中id可以修改;
在文件的uimeta.um中添加UI设计
公共片段pubview_simplequery是通过配置文件动态添加的,在文件中:
通过类SimpleQueryWidgetProvider.java生成控件,通过SimpleQueryWidgetUIProvider.java设计UI,通过SimpleQueryController.java控制该公共片段:
点击搜索,触发SimpleQueryController.java中
PublicvoidonQryBtOk(MouseEvent
PlugoutDescplugoutDesc=newPlugoutDesc();
plugoutDesc.setId("qryout");
widget.addPlugoutDescs(plugoutDesc);
是动态添加的,因此在引用的view中要添加一个pluginDesc和Connector,如:
才能够触发添加的plugin,如:
如果不需要直接用拼写的wheresql,也可以通过((FromWhereSQLImpl)keys.get(“wheresql”)).getFieldAndMap()得到查询条件的键值对,用于其它。
4.1.2规则模板
规则模版包括新增、编辑、删除、规则条件编辑和模版分配功能;
新增:
选择某个模版,点击“新增”(包括模版编号、模版名称、节点编码、模版分配节点、元数据主体、是否显示高级搜索);点击“确定”保存;
编辑:
选中模版,点击“修改”,修改模版编号、模版名称、节点编码、模版分配节点、元数据主体、是否显示高级搜索;点击“确定”更新;
删除:
选中模版,点击“删除”,删除模版;
规则条件编辑:
选中模版,点击“查询条件编辑”按钮,打开查询条件编辑窗口,根据添加的元数据主体数据,在左侧树中全部显示元数据结构,通过中间按钮“向右”、“向左”按钮添加、删除查询条件,也可以通过添加系统变量菜单添加自定义变量作为条件,设计规则条件
模版分配:
选择某个模版,点击“模版分配”,可以有角色、用户、组织三个部分;选择角色、用户、组织中一个或多个,点击“确定”保存,分配模版权限
使用规则模板的方法:
配置文件:
在使用的窗体中应用文件application.app中应用规则模板窗体并添加一个Connector,如
并在当前使用的widget中添加一个pluginDesc,如
并添加
Map.put(GzConstant.$NODECODE,”E06204”);
Map.put(GzConstant.$PK_GROUP,”001”);
Map.put(GzConstant.$PK_RULESCHEME,”001001001”);
Map.put(GzConstant.BEANID,”0000000000000000011”);
AppLifeCycleContext.current.getApplicationContext.navgate(“cp_gztemplate”,”企业分组条件”,”800”,”600”,map,null,true);
弹出规则模板:
4.1.3打印模板
新增:
选择某个模版,点击“新增”(包括模版编号、模版名称、节点编码、模版分配节点、元数据主体、是否显示高级搜索);点击“确定”保存;
编辑:
选中模版,点击“修改”,修改模版编号、模版名称、节点编码、模版分配节点、元数据主体、是否显示高级搜索;点击“确定”更新;
删除:
选中模版,点击“删除”,删除模版;
打印条件编辑:
选中模版,点击“查询条件编辑”按钮,打开查询条件编辑窗口,根据添加的元数据主体数据,在左侧树中全部显示元数据结构,通过中间按钮“向右”、“向左”按钮添加、删除查询条件,也可以通过添加系统变量菜单添加自定义变量作为查询条件;
导出:
选择模版,点击“导出”,根据模版编辑的打印条件,生成xml文件,保存在本地;
模版上传:
在本地设计一个word文档,讲生成的xml文件作为数据源导入到word模版中,设计模版,点击“模版上传”,选择设计好的模版上传到文件服务器上,并将上传的文件PK_FILE回写到模版打印表(CP_PRINT_TEMPLATE)中;
模版下载:
选择模版,点击“模版下载”,获取已上传的文件PK_FILE,并下载文件到本地;
模版分配:
选择某个模版,点击“模版分配”,可以有角色、用户、组织三个部分;选择角色、用户、组织中一个或多个,点击“确定”保存,分配模版权限
4.1.4表单配置
表单配置是指在选择的功能节点基础上进行定制业务的个性化,可以对功能节点进行个性化改造后进行使用,不影响原先功能节点的正常使用。
主要功能有:
新增个性化,修改,删除,个性化设置,模板分配,重置等。
4.1.4.1新增个性化
选择模板使用的设备名称,目前支持的设备有:
手机、pc、pad。
设置模板的名称,优先级等。
新增的模板在列表中的位置。
4.1.4.2修改个性化
对增加的模板进行修改,可以修改名称、优先级、和设备。
4.1.4.3个性化设置
个性化设置可以对模板中的所有组件进行样式内容的设置,在视图模式下进行可见即可得的操作。
如:
上图中对显示字段“用户名称”个性化修改为“用户名称test”。
4.1.4.4模板分配
模板分配是把个性化之后的模板分配给使用者,这里的使用者包括三个类型:
角色、用户、组织。
Ø角色:
是指个性化模板分配给一个角色后,该角色下的用户将可以使用该个性化模板。
Ø用户:
分配给一个用户,该用户即可见该模板。
Ø组织:
分配给一个组织,则该组织对该模板有权限。
4.1.4.5重置模板
当个性化设置对模板修改的比较混乱时,可以通过“重置模板”还原该模板到初始状态。
也可以通过“删除”功能把该模板删除后新建一个原始模板。
4.2参数
4.2.1参数模板(cp_sysinittemp表)
参数模板表中的字段如上图所示。
其中上图中标红字段“domainflag”外键关联模块分组表(cp_appscategory)的“id”字段(非pk字段),标识参数具体属于哪个节点下。
对应元数据实体文件路径:
uapcp\cpb\METADATA\cpb_mgr\cpb_sysinittemp.bmf
4.2.2参数设置(cp_sysinit表)
参数设置表中的字段如上图所示。
其中标红字段:
“sysinit”外键关联上面的参数模板表的pk“pk_sysinittemp“。
“pk_org”所属组织的pk,标识当前参数具体属于哪个组织。
对应元数据实体文件路径:
uapcp\cpb\METADATA\cpb_mgr\cpb_sysinit.bmf
4.2.3参数设置页面操作
目前只提供对参数的修改和查询操作。
●只能修改“参数值”,“是否控制下级”字段如上图。
当修改时,会根据上图中的“取值范围”字段限定取值范围。
限定规则:
Ø取值范围字段以“-”分隔,如“0-8“,则输入值限定为数字,且在限定的范围之内。
Ø取值范围以“/”或者“,”分隔,如“总部统一制定/集团统一制定/各个单位自行维护”,修改时会渲染为下拉列表的形式,如上图所示。
Ø其它修改时为文本框输入,对值不做限制。
●查询:
根据组织单元参照查询:
对应cp_sysinit参数设置表中的pk_org字段。
根据树子节点查询:
对应参数模板表cp_sysinittemp表中的domainflag字段。
4.2.4参数设置预置脚本
涉及表:
参数模板表cp_sysinittemp和参数设置表cp_sysinit。
●cp_sysinittemp表中设置domainflag字段值为参数所属模块节点的id,id字段为cp_appscategory表的“id”字段,非pk字段。
●cp_sysinittemp表中设置pk_orgtype字段值为参数所属管控模式类型(全局,集团等)。
其具体值参考SysinitConstants类中定义常量
4.2.5调用服务
服务接口:
ICpSysinitQry服务实现类:
CpSysinitQry
该接口中定义了提供获取参数值的方法,具体方法见接口中。
调用方法:
ICpSysinitQryqs=NCLocator.getInstance().lookup(ICpSysinitQry.class);
//组织时才需要传pk_org
CpSysinitVOvo=qs.getSysinitByCodeAndPkorg(initcode,pk_org);
4.3代理人
代理人分为流程代理人、单据代理人两种类型。
流程代理是用在审批中,代理人可代替被代理人执行审批任务。
单据代理是代理人可替代被代理人填写单据。
4.3.1代理人注册
代理人是依据业务类型设定的,设置代理人需要先注册业务类型。
代理人的设置有两个入口。
集团管理员可以在系统管理->代理人中为集团内所有人设置代理人。
个人用户可以在任务中心->代理人中设置。
4.3.2代理人获取
接口:
nc.uap.wfm.agent.FlowAgentHelper.doFind(FlowAgentContextctx)
调用时需要定义FlowAgentContext对象,
privateStringpk_user;//被代理人用户pk,传入类型
privateStringpk_agent;//WfmFlowAgentVO代理对象pk,返回类型
privateStringpk_flowtype;//业务类型pk,传入类型
privateStringagenttype;//代理类型,WfmFlowAgentVO.BILL_AGENTTYPE单据代理
WfmFlowAgentVO.USER_AGENTTYPE流程代理
4.4上机日志
现在已经提供了默认的日志记录机制,如果在此基础上还不能满足需求的话,可以根据下面的接口自行调用;台日志支持登录日志、操作日志、业务日志三种形态;接口如下:
4.4.1登陆日志
类:
LoginLogHelper登录日志接口类
LoginLogVO登录日志VO类
LoginLogVO包括以下属性的get和set方法:
Stringpk_loginlog登录日志主键
Stringclientip客户端ip
Stringlogingrop登录集团
Stringusername用户名
Stringtruename真实姓名
UFDateTimelogintime登录时间
UFDateTimelogouttime注销时间
UFBooleanloginresult登录结果
Stringdetail详细信息
Stringpk_logingrop登录集团主键
Stringpk_user用户主键
Stringlogingropcode登录集团编码
StringsessionidsessionID
Integerdr
UFDateTimets
登陆:
publicstaticStringlogin(LoginLogVOvo)throwslfwBusinessException;
/**
*插入登陆信息(登录时调用)
*@paramvo要插入的登陆日志VO无主键
*@return成功则返回随机生成的主键
*@throwsLfwBusinessException
*/
注销:
publicstaticintlogout(Stringsessionid,UFDateTimelogouttime)throwslfwBusinessException;
/**
*更新登出信息(注销时调用)
*@paramsessionid当前sessionid
*@paramlogouttime注销时间
*@return如操作成功则返回正数否则返回-1
*@throwsLfwBusinessException
*/
4.4.2操作日志
类:
OperatorLogHelper操作日志接口类
OperatorLogVO操作日志VO类
OperatorLogVO包括以下属性的get和set方法:
Stringpk_funcoperlog操作日志主键
Stringbuttonname按钮名称
Stringclientip客户端ip
Stringpk_logingrop登录集团主键
Stringfuncnodename功能节点全名
Stringusername用户名称
Stringtruename真实姓名
UFDateTimeopertime操作时间
Stringlogingropcode登录集团编码
Stringfuncnodecode功能节点编码
Stringpk_user用户主键
Stringpk_funcnode功能节点主键
Stringdetail详细信息
StringsessionidSessionid
Integerdr
UFDateTimets
操作:
publicstaticStringdoOperator(OperatorLogVOvo)throwsLfwBusinessException
/**
*插入操作日志(记录操作日志时调用)
*@paramvo待插入的日志VO无主键
*@return成功则返回随即生成的主键
*@throwsLfwBusinessException
*/
4.4.3业务日志
类:
DataLogHelper业务日志接口类
DataLogVO业务日志VO类
DataLogVO包括以下属性的get和set方法
Stringpk_businesslog业务日志主键
Stringdetail详细信息
Stringclientip客户端ip
Stringbusobjtype业务对象类型
UFDateTimeopertime操作时间
Stringoperate操作
Stringbusinessobject业务对象
UFBooleanoperresult操作结果
Stringbusobjcode业务对象编码
Stringbusobjorganization业务对象组织
Stringlogingrop登录集团
Stringusername用户名称
Stringtruename真实姓名
Stringpk_busobj业务对象主键
Stringpk_logingrop登录集团主键
Stringlogingropcode登录集团编码
Stringpk_user用户主键
StringsessionidSessionID
Integerdr
UFDateTimets
执行业务:
publicstaticStringdoTask(DataLogVOvo)throwsLfwBusinessException
/**
*插入业务日志(记录业务日志时调用)
*@paramvo要插入的日志VO无主键
*@return插入成功则返回随机生成的主键
*@throwsLfwBusinessException
*/
第五章文档与用印
5.1前言
Office编辑在OA领域是不可获取的控件,在集成了相关控件的基础上提供开发相关接口,并屏蔽开发对第三方开发控件的直接调用
控件分为Office、电子签名、上传的等三类;其中Office控件中继承了电子印章。
Office控件目前可以支持word、excel、wps、et等四种类型的文档
5.2Office控件
5.2.1调用接口
${root}/core/word.jsp?
pageId=officeedit&url={wordpk}
必选参数:
pageId:
控件基础参数,不可修改
url:
后台存储PK
其他参数:
TrackRevisions:
是否留痕,默认true
autoSave:
是否自动保存,默认true
saveTTL:
自动保存时间,默认180秒
readonly:
是否只读,默认false
showRevisions:
是否显示痕迹,默认true
occupymsg:
打开文档后的提示消息,默认空
filenew:
新建文档,默认false
loadbookmarkclass:
替换标签实现类
sysid:
系统编码(获取filemanager用)
5.2.2主要功能
5.2.2.1痕迹
痕迹目前支持word、wps两种文档类型,只要传入参数TrackRevisions即可。
可通过接受修订或者拒绝修订来清除痕迹;目前没有对清除痕迹的操作做权限控制,如果需要,将来提供接口。
接受修订:
acceptAllRevision()
拒绝修订:
rejectAllRevisions()
5.2.2.2手写批注
目前手写批注有两个功能节点,一个是在留痕菜单中,另一个是在签章菜单中。
实现方式不同,前一种只是在office中增加了一个浮动图片,没有痕迹,无法查到图片来源。
另一种,则是利用手写签章机制,去除签章的保护功能
在前期无法对这两种功能做出取舍,暂时全部提供,将来再定去留。
5.2.2.3套红
套红功能,将头部套红、底部套红分开,暂使用同一套模板,如有需要将来可以分开。
第三方控件中提供了头部、底部、选择替换三种模板插入接口,从前期需求来看,只提出了头部和底部两种场景,因此暂不提供选择替换这种方式。
套红、模板可利用下面的方法直接调用insertTemplete(file,filetype)。
file的创建过程如下:
varfile={};
file.url=文件的相对地址
filetype是指模板类型包括:
redhead、redend、templete、sign四种(头部套红、尾部套红、正文模板、服务器印章)
5.2.2.4模板
通过选择可直接使用现有模板
5.2.2.5电子签章
电子签章分为手写签名、本地签章、服务器签章、Ukey签章的部分几种形态,这部分开发使用即可。
可通过维护界面新增
Ukey签章JS函数,系统会自动选择Ukey并进行
doSign()
签章成功后,会调用传入的signmethod参数,回调执行
5.2.2.6变量替换
控件变量替换机制,该机制是利用ntko控件的标签替换机制。
可通过传递参数loadbookmarkclass实现,需继承nc.uap.portal.ctrl.office.core.IBookMarkLoader。
系统提供了一个默认实现DefaultBookMarkLoader;仅仅提供了当前用户信息;将来可根据需要增加,但只可添加系统级字段
也可直接调用JS函数替换:
functionreplaceMarks(bookmarks);
bookmarks的创建过程示例如下:
varbookmarks=newHashMap();
bookmarks.Put(“标签名称”,”标签内容”)
标签替换文件接口
replaseBookMarkToFile(markname,url)
markname:
标签名称
url:
路径
5.2.2.7其他接口
打开文件
PK:
需要打开的正文Pk,如果不传则是打开当前PK;注意,该操作只打开指定PK的文档,当前正文对应的PK
Load(pk)
保存文件
保存到新的pk
saveFileToURL(pk)
获取文件内容
Start:
开始位
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- NCV61 协同 配置 技术 红皮书
![提示](https://static.bdocx.com/images/bang_tan.gif)