1NCCloud2021.05移动应用配置指南2021年7月版权所有(c)2021用友网络科技股份有限公司21前言NCCloud2021.05移动应用支持在友空间移动端使用，也支持在NCCloud移动独立入口使用。仅NCCloud在线注册模式支持移动应用，并且在配置移动应用之前，必须先完成NCCloud激活。激活过程请参考NCCloud2021.05金盘中《NCCloud2021.05产品激活操作指南.pdf》NCCloud移动应用需要配置UCG网关。2UCG网关2.1UCG网关说明UCG网关由核心网（协议转换、路由、限流熔断）、管理端（api生命周期管理、配置、监控、预警、系统设置等）、管理前端（管理端的前端页面）。NCCloud2021.05版本的UCG网关可以在金盘/Tools/移动应用文件夹获取。2.1.1软件要求nginx、redis2.8+、mysql5.6、jdk1.8、tomcat82.1.2配置要求2.1.2.1操作系统平台应用服务器操作系统版本(补丁)Windows2008R2(x64，多核)Windows2008R2Enterprisex64R2WindowsServer2012x64WindowsServer2012Enterprisex64WindowsServer2016x64WindowsServer2016Enterprisex642.1.2.2应用规模硬件配置配置建议配置CPU4核(或更高)内存8GB(或更高)硬盘(剩余空间)100GB(或更高)3注意:上述是最低配置要求。关闭服务日志，可达到最佳性能。2.1.2.3数据库支持状况数据库类型WindowsLinuxORACLEEnterprise/StandardEdition11.2.0.4.0YYORACLEEnterpriseEdition12.1.和12.2.YYMysql5.6YY2.1.2.4网络相关要求⚫用户使用UCG网关时,请务必确保安装机器外网通畅。⚫注意在防火墙上开放相应端口，并保证相关端口不被其他应用占用。应用服务器的网卡正确设置很重要,要保证网卡驱动、物理连线、地址、网关、路由等被正确配置，在此建议禁用不使用的网卡。2.2UCG网关配置NCC移动轻应用基于UCG的总体安装部署过程如下：1：NCC激活完成后，租户管理员登录diwork，下载网关秘钥文件。2：安装UCG，并配置下载的网关秘钥文件，将NCC轻应用的前端静态页面安装至UCG的静态服务器（nginx），启动UCG网关3：租户管理员在diwork上配置UCG地址信息2.2.1网关秘钥下载1.租户管理员登录diwork（www.diwork.com），选择数字化建模->系统管理->集成配置->ERP连接配置由于NCC激活成功时，已经添加过一个ERP连接配置。后面配置UCG网关有两种选择，一个是继续使用原来的ERP连接配置，一个是再建立一个单独的ERP连接配置给UCG网关。下面的说明，先以新建单独的EPR连接配置进行说明，最后会单独对使用原有的ERP连接配置进行说明。2、点击添加ERP链接，并选择NCCloud行的添加按钮43、设置NCCloud连接器名称，选择ncc_2021.05版本。4、点击下载秘钥按钮下载秘钥文件，秘钥文件名为gateway.config.json，先保存到本地。2.2.2UCG网关安装及启动1、打开启动脚本，开始安装网关52、设置服务端口。包括管理端、核心网关、nginx3、更新配置。打开安装目录，把下载的gateway.config.json文件，拷贝至UCG安装目录\nccpub-gateway-client\config下4、双击桌面快捷方式iUAP-UCG-NCC，启动服务，服务启动后，会有三个命令窗口，第一个框会暂时停止，等完全初始化成功以后会自动重启，如下图：672.2.3移动轻应用安装网关安装完成后，将NCC移动轻应用的静态资源包上传至至nginx的html/ncc_mobile目录下。NCC移动轻应用的静态资源包，可从金盘/Tools/移动应用文件夹获取。2.2.4应用初始化网关启动后，浏览器打开网关管理端访问地址（http://10.11.64.46:18080/open），配置数据库地址，选择测试连接按钮，测试通过后，再次配置网关地址，选择预置产品（NCC，IUAP），最后初始化按钮，进行数据初始化，初始化完成后弹出成功提醒，点击确认即可登录网关管管理端。82.2.5UCG网关云端配置由于轻应用是在友空间访问，公网，而网关是在客户现场安装，专属网，因此需要在云端设置租户和网关的映射关系，具体步骤如下：1、登录diwork（www.diwork.com），打开数字化建模->系统管理->ERP连接配置2、选择新创建的ERP连接，例如刚才创建的“NCC轻应用测试”3、点击健康检查，通过之后输入NCC配置信息，例如NCC服务器地址、账套、集团编码、用户编码9设置完成后，点击链接测试，测试通过后，会给出结果提醒，然后保存修改；点击获取IP地址，IP地址会自动填入网关服务器IP，测试网关连接通过之后，点击保存。4、设置轻应用网关地址（要为外网可访问的地址），以及nginx监听端口（默认80），点击获取混合云秘钥，获取秘钥，然后点击保存修改按钮，看到成功提示，完成云端配置。如果UCG所在服务器是内网机器，申请不了外网IP，可以联系申请外网端口转发，将请求转发到UCG所在的服务器的nginx端口。（比如申请了外网地址123.5.6.202:99，UCG所在服务器内网IP是192.168.10.11，UCG安装时填写的nginx端口是80，则需要将99端口映射到80，轻应用网关地址填写http://123.5.6.202:99）102.2.6使用原有ERP连接配置说明如果使用原有激活NCC时使用的ERP连接配置，可以在原有的ERP连接进行如下配置：把已有的友企联网关秘钥，放入UCG网关。停掉原有友企连网关，启动UCG网关。UCG网关启动完成后，在原有ERP连接配置的高级设置，配置轻应用网关地址，并获取混合云秘钥，点击修改保存按钮，看到成功提示。2.2.7UCG网关卸载如不再使用UCG网关，可以进行卸载，卸载步骤如下：1.打开安装目录112.进入bin3.双击shutdown.bat4.双击uninstall.bat5.进入安装目录6.选中nginx和redis目录并尝试删除7.如果出现如下情况说明nginx目录被占用，nginx程序依然在运行解决办法：12右击底部栏，启动任务管理器，选择进程。找到nginx.exe服务右击，结束进程务必全部结束nginx和redis-server服务然后重新成功删除nginx和redis文件夹。138.进入安装目录，点击uninstall.exe进行卸载。3移动应用购买开通用户在云商务购买“NCC移动应用租赁产品”后，会收到激活邮件。14企业账号管理员登录邮件中的激活地址，选择对应企业账号输入激活码进行移动应用开通。登录diwork（http://www.diwork.com），打开数字化建模->系统管理->应用管理-模块看板，查询应用使用的计量计费情况。4移动应用使用设置移动应用使用时会检查NCCloud移动API网关授权，客户购买NCCloud时要购买这个授权。154.1NCCloud用户人员同步用户必须关联人员，并且人员手机或者电子邮件不能同时为空：用户在NCCloud轻量级必须完成云注册NCC移动应用在友空间使用时，需要校验用户的NCC身份，因此用户在NCC完成人员绑定和云注册后，需要往Diwork同步相关数据。选择人员进行同步，即可同步完相关数据。另外，使用供应商/客户协同移动应用时，也要同步供应商客户信息。164.2友空间移动端使用如果在友空间移动端使用NCC移动应用产品，企业账号管理员需要在Diwork给用户分配应用的权限，用户登录友空间移动端后才能看到相关的应用。首先在Diwork角色管理页签，建立角色，并关联应用。然后在Diwork授权页签，选择用户，分配角色。17完成以上配置后，用户即可登录友空间移动端，在工作台即可看到有权限的移动应用，并且正常使用。4.3NCC移动独立入口使用如果在NCC移动独立入口使用NCC移动应用产品，NCC的权限管理员需要在NCC产品给用户分配移动应用权限。用户在手机移动端安装APP后，即可使用。4.3.1启用移动独立入口系统管理登录，在系统参数设置应用，修改启用移动独立入口为：是。4.3.2分配移动应用权限权限管理员给用户关联的职责，分配相关的移动应用权限。184.3.3NCC移动独立入口安装ios手机从AppStore搜索NCC移动应用进行安装，Android手机从应用宝上搜索NCC移动应用进行安装。4.3.4NCC移动APP登录支持两种登录方式：用户密码登录、手机号密码登录。并在登录前需要先设置服务地址。用户密码登录时，使用的为NCCloud的用户编码和密码，并且会要求用户关联的人员档案要有手机号。手机号密码登录时，使用的是友空间对应的手机号和密码。194.3.5NCC移动APP使用登录后，首页可以添加应用，也可以切换下方应用页签，直接使用用户有权限的移动应用。首页支持处理NCCloud待办消息、预警消息和通知消息。待办消息包含审批消息，需要在云商务购买移动审批才能显示出来进行处理。205网关常见问题解决方案5.1当前回调地址不在登录白名单里，请联系管理员处理提供IP+PORT，发邮件或者提工单给友户通，此提示不会影响轻应用的正常使用5.2获取混合云秘钥失败或21解决方案：1.检查是否正确输入网关外网ip2.检查核心网关iuap-ucg-core服务是否正常启动3.如果没有正常启动请检查是否是端口占用问题，核心网关端口默认为180885.3获取友空间用户信息失败：parametervalidationerror:invalidcode出现此问题一般情况为友空间版本与网关配置的友空间版本不一致导致22解决方案：打开网关安装目录下core/config/ClientConfig.json中找到upesn.url这个属性配置值例如然后替换友空间环境地址，具体对应如下环境地址测试环境http://172.20.1.177:6059外⽹网:http://123.103.9.204:6059daily环境https://openapi-daily.yyuap.com预发布环境https://open.esn.ren正式环境https://openapi.yonyoucloud.com5.4获取友空间用户信息失败：operationfailed：invalidesnIpSignoripaddress,requestid:xxxxx错误示例图2324解决方案:1.请登录diwork.com找到ERP连接配置中点击混合云密钥，然后保存修改2.检查当前环境是否一致如友空间正式=diwork正式=UCG配置正式5.5License问题：mobileApilicense失效。LicenseCount为0问题分析：UCG网关有两种鉴权模式模式1:NCC模式，此模式是调用NCC的license模块需要在diwork.comERP连接配置中配置您当前的NCC信息然后配置正确的UCG网关信息,也就是轻应用网关然后保存。25示例如下：模式2：UCG网关License26此模式下需要您申请UCG网关的Licenseserver，并且配置正确的Licenseserver地址。目前配置的位置有2个第一个在网关初始化页面中配置第二个，如果需要更换自己的License地址需要打开网关安装目录下core/config/ClientConfig.json中找到licenseUrl项然后替换为您自己的LicenseServer地址配置正确后，请重启网关服务。5.6计量计费失败：未找到该应用。请检查应用编码解决方案：检查此应用的appcode是否已经在diwork，友空间预置。275.7替换应用地址失败：{“ERROR-0”:”您没有权限”}当在diwork.comERP连接配置中点击保存时，出现如下错误。解决方案：请联系友空间预置应用负责人周敏，将您预置的应用开通替换应用信息的权限。5.8替换应用地址失败：{“ERROR-0”:”用户不在此空间”}解决方案：请联系友空间预置应用负责人周敏和友户通部门相关，检查当前登录用户问题。5.9网关绑定失败：errorcode:500UCGSERVER绑定失败:Tenanthandlertogatewayerror.当在ERP连接配置，高级设置，保存出现errorcode:500UCGSERVER绑定失败:Tenanthandlertogateway28error.Thetenanthasbeenregisteredtoanothergateway,pleaseunregisterit.目前UCG目前的绑定策略是：一个租户只能绑定一个网关。一个网关可以绑定多个租户。解决方案：如果您需要更换绑定网关，请您先申请提出解绑。解绑联系人提工单给开放平台。5.10轻应用网关操作超时：确认轻应用网关地址填写的值为外网可以访问到的地址，注意是外网可以访问到的地址，不是本机的外网出口地址，通过填写的地址可以访问到UCG所在服务器。295.11网关绑定失败：500UCGSERVER绑定失败:Gatewayisnotregistered.核心网关ClientConfig.json中Server环境未对应
