NCV5-二次开发框架技术红皮书

1、数控二次开发框架技术红色资料簿NC 5.0用友数控-整体设计部、平台技术部2020-06-22目录第一章前言1第二章认证21 .概要22 .实现说明22.1后台认证接口22.2前台预处理接口32.3前台认证结果信息接口32.4配置任务33系统登录认证相关软件包和第4类第三章单点登录方式(V5.0)61概要62流程说明63URL形式74轮廓7第4章功能按钮和UI事件扩展方案(V5.011)81 .概要82 .菜单扩展按钮的关联类83 .扩展类FuncMenuExtends94 .配置文件funcMenuExtConfig.xml12五.发展进程概述135.1创建funcmenumextends子

2、类135.2在funcmenumextconfig.XML文件中配置155.3执行程序156 .附录：供应链产品按钮扩展17剧本介绍17支持辅助开发按钮扩展的文档列表(复盖了所有核心文档) 18劣势分析19第5章UI接口API的公开规格(V5.02以上，仅供参考) 201 .概要20公开UI-API接口的步骤212.1定义接口212.2接口21的实现2.3填写配置文件222.4提供了接口手册23第六章业务组件服务扩展开发(V5.0)241 .概要242 .财务产品文档组件的重要方法扩展接口方案242.1领取产品方案242.2财务开发部的改进24第七章UAP开发资源(V5.0)261.UI侧环境

3、变量262 .发送邮件273 .发送待办事宜28第一章前言NC作为平台化的ERP产品，在提供完整的系统管理和应用功能的同时，还设计了开放的实现框架，以满足本地化、行业化乃至企业化的个性应用程序目前该框架包括系统管理安全方案、UI末端按钮扩展和事件方法扩展方案、业务组件服务扩展方案三个部分，主要内容是一系列插件界面和API。该框架结合了二次开发产品的安装引进方案(详细见NCV5-安装盘配置与升级技术红皮书相关内容)，共同构成了NC二次开发解决方案。 该方案定位于实现三个目标：降低二次开发的难度，减少标准产品源代码的修改，最终达到零的二次开发产品和标准产品的开发和成果引进中的分层隔离标准产品升级与

4、二次开发成果兼容。NC二次开发解决方案需要在今后的版本中持续完善，现在，各详细方案分章节说明如下。 注意，在该框架发布之前，NC可以基于项目要求提供若干中间方案，基本情况记录在相关章节的附录中。 这些计划是为了兼容的项目的成果而保留的，但在新项目的二次开发中无法使用，在今后的版本中支持将逐渐取消。注：本文对二次开发的描述也在行业开发过程中，根据标准产品适用于行业定制。第二章身份证1 .概要为NC系统的高端企业集团ERP应用定位产品决定了系统安全的重要性，系统安全包括登录身份的认证和各种数据的安全。 虽然这里不说明由NC系统进行的数据安全的处理，但是这里主要对系统注册的身份认证的安全和认证方式的

5、实现进行说明。NC系统的默认认证方式是基于静态密码的认证方式。 现在，在身份认证领域中，能够提供CA认证、动态密码认证等更安全且可靠性高的认证方式的制造商也很多。 为了提高NC系统自身的登录认证的安全性，NC系统可以提供用于集成第三方认证方案的接口，以方便地将更安全的认证方案集成到NC系统中，以增强NC系统在登录时的认证安全性。2 .实现说明数控系统的认证集成接口主要包括：l后台认证接口： nc.bs.sm.identityverify.IAModel前端工作装置预处理接口： NC.bs.sm.identity verify.iloginpretreatmentl正面认证结果消息界面： NC.

6、bs.sm.identity verify.iloginresultmessage通过实现某种认证方式，一般实现上述的接口.2.1后台认证接口后台认证接口是为了实现认证方案而必须实现的接口，但是在实际的代码中，继承了NC.bs.sm.identity verify.abstractiamode抽象类，并使用NC.bs.sm 程序员必须实现验证方法，以对用户进行身份验证。int verify (NC.VO.sm.log in.loginsessionbeanlsb，NC.VO.sm.user VO用户VO )参数：loginsessionbeanlsb主要存储登录用户的信息(用户代码、用户密码等

7、) (loginsessionbean.put ()和loginsessionbean.get ()方法可以访问UserVO userVO使用lsb内的公司信息和用户代码信息，在数据库中找到的nc用户对象中包含nc用户的信息。返回值int表示认证的结果，如果认证成功，则返回NC.VO.sm.log in.iloginresult.log in _ lega identity。 如果错误，则返回自定义int值，但自定义int值必须大于200 (小于200的返回值被分配给系统自己使用的值)NC.bs.sm.identity verify.abstractiamode类包含一个对象getparame

8、ter (string key )方法，它返回在配置文件中定义的参数，如下所述。2.2前台预处理接口前台预处理接口在前台运行，它提供了在调用后台认证功能之前执行预处理操作的机会。 例如，为了实现某个CA认证方式，需要从usbkey读取用户信息、签名挑战码等操作等，把这些挑战码传输给后台用于认证，就可以实现该接口。接口定义了以下方法：void pretreatment (loginsessionbeanlsb ) throws exception使用此方法执行上述操作，并使用lsb传递需要传输到背景的信息。 例如，需要使用用户代码、LSB.setuser代码方式进行设定。 挑战代码等用于外部系统

9、认证的其他数据必须使用lsb.put方法设置为lsb，并在后台使用的双曲馀弦值voidprtreatment (NC.VO.sm.log in.loginsessionbeanlsb ) throws exception参数： loginsessionbeanlsb这里的lsb主要用于存储后台认证所需的数据，可以使用lsb的相关方法进行配置。 此lsb对象传递给后台验证方法verify (NC.VO.sm.log in.loginsessionbeanlsb，nc.vo.sm.UserVO userVO )的参数lsb。例外：发生需要结束操作的例外，可以抛出如果认证方案不需要前台预处理过程，则

10、可以不实现该接口。2.3前台认证结果信息接口前端认证结果消息接口NC.bs.sm.identity verify.iloginresultmessage的角色是此接口，因为我们的认证方法返回的是int类型的数据，无法直接反馈给用户这个接口方法是如下定义的：stringgetresultmessage (intintintintresult )参数： intintintresult此值从后台认证接口方法返回返回值String返回返回给用户的相应intResult提示文本2.4构成作业在代码开发中，通过实现上述接口，开发就完成了。 然后，必须将新的认证方法设置为可以在NC系统上使用。nc3x版本配

11、置文件为./ierp/bin/IAConfig.xml，典型格式如下： (例)nc.bs.uap.ca.CAModeCA认证nccauseridmodeusercodetrunc.ui.uap.ca.caloginpreetreatmentnc.ui.uap.ca.caloginkresult对于nc5x版本配置文件为./ierp/bin/IAConfig.xml，典型格式如下： (例)nc.bs.uap.ca.CAModeCA认证nccauseridmodeusercodetrunc.ui.uap.ca.caloginpreetreatmentnc.ui.uap.ca.caloginkres

12、ult时，如果程序不需要其他参数配置，则可能不需要配置如果认证方案不需要前台预处理过程，则可以不设置该项时，如果没有返回附加信息，也可以不配置此项3系统登录认证相关软件包和类NC.bs.sm.identity验证|AbstractIAMode#身份认证方式抽象类一般要实现某种认证方式就必须实现|iacconfigtool#读写认证配置文件的工具类|IAConfSetupDlg#和IASetupFrame类构成认证配置文件| ia模式#认证方式接口类由AbstractIAMode实现|IAModeFactory#系统运行时，根据认证配置文件构建认证方式对象|IASetupFrame#配置认证配置

13、文件的工具|IASetupPanel#认证配置式的设置|staticpaasswordmode#系统默认的静态密码认证方式类实现了AbstractIAModeNC.ui.sm.identity验证| defaultloginpretreatment #默认的注册预处理类| 注册iloginpretreatment #预处理接口类。 登录前应该做的工作，可以实现这个班注册|IloginResultMessage #回复消息类。 根据返回的int值获取字符串值。NC.VO.sm.identity验证|IAConfigFilevo#对应于认证方法配置式的VO类|IAConfvo#支持身份认证方式的VO类|IAContext#认证上下文类。 可以取得认证方式所需的参数|IAParametervo #支持身份认证方式的参数VO类与NC.VO.sm.log in.logins ession bean相关的方法：方法名称方法的说明get (字符串)获取在put方法中设置的属性值put (字符串，Object )设置key-value属性值对getPk_crop ()获取公司的主键值setpk _ corp (字符串)公司的主键值的设定获