NC65&友空间集成移动审批操作手册客户成功部2021.01以下为YonBIP旗舰版开通、集成配置说明，Diwork版本与非Diwork版本请参照原操作说明。一、开通激活YonBIP旗舰版订单，通过开通助手创建企业（友空间）并激活开通。如果通过友空间集成NC移动审批，商务下单选择产品时，请务必勾选YonBIP旗舰版下的【平台-数字化工作入口】。同时要单独购买NCV6移动应用租赁产品中的【V6移动应用服务器】和【V6公共应用-移动审批】，移动审批的订单需线下单独开通，可参考移动审批充值开通章节。实施前请务必与商务核对清楚，以下订单内容是否已选购，并提醒销管下单时，移动审批的订单和BIP-数字化入口的订单需要分开下2个不同的订单，不能在同一个订单里包含移动审批和BIP两个不同的产品！（一）登录开通助手1、打开开通助手，开通地址如下：https://ecos.yonyoucloud.com/assist/activation?resCode=diwork&productLineCode=diwork2、如果没有用友云账号，请根据提示注册账号如果已有账号或注册完毕，请输入员手机号或邮箱登录（二）新建企业1、登录开通助手后，点击【新建企业账号】2、录入企业名称、联系人、联系电话后，点击【确定】，完成企业创建。（三）开通激活1、在开通助手列表下，找到刚创建的企业账号2、点击企业账号名称右侧的【激活】，输入邮件中的激活码（必须是BIP旗舰版）3、点击【确定】后，等待产品开通（点击确定后，可以关闭当前窗口即可）（四）登录BIP1、开通后，浏览器中打开https://yonbip.yonyou.com/，或www.diwork.com，使用已注册的账号登录YonBIP。2、登录后https://yonbip.yonyou.com/或www.diwork.com，，在【数字化建模-系统管理-应用许可看板】下，可以查看开通激活情况，确认订单是否开通正确。3、如果确认无误，再进行友企联集成配置二、购买友企联（一）购买友企联（免费）1、登录https://yonbip.yonyou.com/，或www.diwork.com，后，在【数字化建模】-【系统管理】菜单下，点击【我的应用】。2、在我的应用页面下，点击【应用市场】。3、在应用市场中，搜素‘友企联’，选择并点击【友企联（免费）】。4、在友企联购买界面，选择规格为【友企联-NC】的友企联，点击【购买】。5、点击【确认订单】，友企联服务购买成功。三、ERP连接配置重新登陆系统或刷新后，在【连接集成服务】-【数据集成】菜单中，会增加系统配置节点，包含【ERP连接配置】和【数据同步任务】。（一）添加ERP连接1、在【连接集成服务】-【数据集成】菜单下，点击【ERP连接配置】。2、在【ERP连接配置】页面下，切换至【添加ERP连接】页签，点击【添加】按钮。注：该页面的【帮助文档】维护了常见操作指导和常见问题的解决方案，有问题可以查看帮助文档（二）友企联设置在弹出的设置页面，根据设置指南进行友企联的相关配置。注：以下为新页面的配置逻辑，如果是旧页面，建议在登陆空间之后，同一浏览器打开新页面，输入以下地址使用：ERP连接配置https://ubl.diwork.com/ublinker-fe/connector/erp/index.html?from=diwork数据同步任务https://ubl.diwork.com/ublinker-fe/data/sync-task/index.html?from=diwork第一步、设置NC连接器名称：1、输入连接器名称，并选择NC对应的版本，点击【确认】。2、在弹出的确认NC版本窗口，点击【提交】。注意：请务必选择好NC对应的版本，目前支持的NC版本为NC63和NC65。第二步、下载补丁点击【下载补丁】，将下载的补丁打到NC中，并重启NC服务。第三步、下载网关根据服务器操作系统版本，选择对应的操作系统版本，点击【请下载网关】；下载后将网关解压（不需要修改文件名称），建议放置在根目录下，比如放置到D盘或F盘下必须保证网关所在服务器可以访问外网（或者开通对外访问云服务ublws.yonyoucloud.com的权限）。第四步、下载秘钥网关解压完毕后，点击【下载秘钥】，将下载的秘钥文件gateway.config.json放置在网关config文件夹中。如果是Windows环境:将下载的密钥文件复制到网关所在目录的config文件夹下；如果是Linux环境:将下载的密钥文件复制到网关所在目录的config文件夹下。第五步、启动网关Windows环境启动网关：在config的同级文件夹找到bin文件夹，例如：F:\gateway\nccpub-gateway-client-1.0.0-SNAPSHOT\bin，运行startup.bat。Linux环境启动网关：在config的同级文件夹找到bin文件夹，例如：F:gatewayccpub-gateway-client-1.0.0-SNAPSHOTin，运行startup.bat。第六步、网关健康检查1、点击【健康检查】，验证网关是否可以正常连通。第七步、NC配置并测试连接1、在NC服务器地址中，先录入NC服务器地址，点击【获取参数】，根据获取的参数，输入账套编码、集团编码、用户编码2、点击【测试连接】，再【保存修改】，完成NC相关配置。第八步、网关配置并测试连接1、输入网关所在的服务器ip地址、端口，点击【测试网关连接】，并保存。第九步、修改并保存自定义档案根据项目实际情况，来确定是否需要修改自定义档案，一般不需要要单独配置自定义档案。如果不需配置自定义档案如果不需配置自定义档案，直接点击【保存自定义档案】按钮，完成保存。如果需要配置自定义档案1、如需配置自定义档案，在列表中找到需要配置的档案，点击【编辑】按钮。2、在弹窗中选择对应的YonBIP档案，点击【保存】。3、在列表中勾选需要配置的档案，点击【保存自定义档案】按钮。第十步、初始化任务1、点击【初始化ERP任务】，进行任务初始并进行数据同步任务。注1：如果有特殊需求，如限制人员上云或者不需要同步过多的档案数据，则点击初始化任务之后，不要点击执行同步任务，点击之后会立即执行所有的同步任务，然后同步所有符合系统级同步条件的数据（如果同步过多数据，删除数据会很麻烦，该问题请提高警惕）。注2:简版任务和HR版任务存在差异性，最主要的是：同步人员任职信息的任务，简版为[任职]，HR版为[工作信息],其他任务的差异性和有无如果没有特殊需求，可以不关注。注3:数据同步任务页面的初始化任务为特殊需求保留按钮，正常情况不需要点击该按钮如果已经启用HR模块如果已经启用了HR模块，需要选择“职级体系标准”来源于NC的哪个档案，可以选择来源于NC的“职务类别”或“岗位序列”，只能选择一次，务必确认仔细。如果未启用HR模块如果未启用HR模块，直接点击【初始化任务】按钮，再点击【执行同步任务】。同步任务将转入后台执行，也可以直接在【连接集成服务】-【数据集成】-【数据同步任务】下的数据同步任务页面查看任务执行情况注意：在项目交付过程中，务必注意测试环境的搭建：1、在执行同步前，务必确认同步的人员范围，如果不限定同步范围，只要在NC端维护了手机号或邮箱且没有停用的人员都会同步至diwork中；2、如果只同步指定的人员，需要在NC端创建编号为esnuser的角色，将同步的用户添加到角色下，联系梁晓东，单独写sql语句；3、如果当前环境仅用于测试，建议将NC端已维护的人员手机号或邮箱清空，单独维护几个测试手机号或邮箱用于同步，否则测试产生的相关消息、通知等无法清除。慎用客户真实手机号进行测试验证。四、数据同步任务通过数据同步任务，将NC的组织、部门、人员、任职等信息同步到基础数据档案中，必须在NC的人员信息维护了手机号或者邮箱账号才会进行同步。同时要保证使用移动审批的用户必须关联了人员身份。初次使用，同步任务会自动同步（如果初始化任务时点击了执行任务）。如果后续需要调整同步任务或单独同步某个任务，也可以在【连接集成服务】-【数据集成】-【数据同步任务】下单条同步。1、选择要同步的数据视图，点击【执行】同步任务默认为增量同步，如果需要全量同步某个任务，需要取消增量同步。1、先选择某个数据视图下的任务，在【视图管理】下，点击【视图条件定义】2、在弹出的界面，取消勾选【是否启用增量】，点击【确定】3、再从任务管理下，点击【执行】，则会进行全量同步。注意：1、同步到diwork系统中的数据，不可在NC系统中物理删除后再新增相同的数据。原因：由于NC中为物理删除，无法通过同步任务删除diwork中数据。由于NC主键发生变化，导致同步时无法依据NC主键更新原数据。由于编码等其他信息与原数据重复，导致新数据也无法新增。2、员工不可使用公共手机号（离职员工手机号不可重新分配给新员工）。原因：离职员工信息已占用该手机号，且已绑定该手机号对应的用户信息；新员工分配该手机号后，同步时会因手机号重复导致无法同步新员工。3、员工更换手机号时，需要保证新手机号未注册云账号。原因：如果新手机号也注册了云账号，更新手机号会导致员工出现双账号问题，双账号问题目前只能联系友互通同事或运营人员根据员工需求进行手动合并处理。五、安装移动应用补丁在正式使用移动审批前，NC端需要打上移动应用补丁。1请通过用友云盘下载补丁，地址：http://pan.yonyou.com/web/share.html?hash=HoV9ta0HS4c2、登录云盘后，在“友空间交付运营工具包”-“友空间集成用友ERP与移动应用”-“友空间集成用友ERP与移动应用”-diwork版友空间集成NC移动审批”文件夹中下载【path_NC65_移动应用补丁】补丁，并部署到NC端，务必提前做好备份。3、重要说明：Diwork或YonBip下通过友企联集成NC，则需要修改文件esn.properties。在NCHOME/resources文件夹下，打开esn.properties，将esn.nc.push.linkType的值由ma改为ublink六、购买移动审批应用移动审批单独计价收费，需要商务正式购买，此处仅仅是从应用市场为当前租户添加移动审批应用，并非商务订单上的购买。1、在【数字化建模】-【系统管理】菜单下，点击【我的应用】2、在我的应用页面下，点击【应用市场】3、在应用市场中，搜素移动审批，点击【移动审批】4、在移动审批订单购买界面，点击【购买】5、点击【确认订单】，移动审批购买成功。七、移动审批充值开通移动审批单独计费，需要单独下订单并开通激活，将订单编号与租户ID邮件发送给集团陈肖宝chenxbb@yonyou.com充值。租户ID获取方式：1、以租户管理员账号登录企业服务中心，地址为：https://apcenter.yonyoucloud.com/apptenant/cloud，2、切换至【企业账号】，找到对应的企业，点击编辑按钮注意：如果管理员创建了多个租户，请务必核对对应租户信息，是否为充值的租户。3、在基础信息页面，企业账号ID就是为租户ID，将此租户ID复制即可。八、移动审批授权和添加对于使用移动审批的用户，必须进行授权，将应用授权给相关使用者，如果移动审批按月计费，切勿授权全员使用；如果希望在审批中心处理待办，必须将移动审批添加到审批中心。（一）分配移动审批权限1、【数字化建模】-【权限管理】下，点击【全员应用授权】2、在全员应用授权下，查找移动审批，将移动审批分配给对应的使用人员。3、被授权用户，登录友空间可以使用移动审批。（二）审批中心添加移动审批如果希望在审批中心也可以处理移动审批的待办事项，需要在审批中心添加移动审批。1、管理员在【协同服务】-【审批中心】下2、点击右上角的设置按钮3、再点击【增加应用】4、在添加应用页面中，勾选【移动审批】，点击【提交】，完成添加。九、NC端相关处理（一）NC用户权限分配使用移动审批的用户，必须在NC端【权限管理】中分配移动审批的功能节点权限。（二）审批流设置：如果希望推送消息到友空间的待办中心，NC端审批流配置时，需要配置任务消息和模板，并勾选【是否推送】。（三）移动应用模板设置：移动端如果要处理移动审批待办事项，必须要提前在NC端设置移动应用模板，否则无法打开单据详情页。请参考云盘《用友移动审批（nc6）单据及全貌模板配置手册》进行设置云盘地址如下：地址：http://pan.yonyou.com/web/share.html?hash=HoV9ta0HS4c#HoV9ta0HS4c/十、友空间相关操作（一）下载友空间安卓手机在应用市场下载友空间APP并安装；IOS手机在AppStore下载友空间APP并安装。（二）登录友空间，下载安装后，请务必使用NC端人员信息里的手机号登录友空间用户名：预留NC端的手机号初始密码：yonyou@1988切记,所有人员信息由NC同步，不要自己注册!切记,所有人员信息由NC同步，不要自己注册!切记,所有人员信息由NC同步，不要自己注册!（三）修改密码1、在移动端导航栏中，切换到【我】，并点击【设置】2、点击账号与安全3、选择修改密码4、输入旧密码和新密码，设置后点击【完成】按钮，密码修改完毕，请使用新密码重新登录。（四）移动审批处理移动端处理1、移动端【消息】导航页，进入【待办中心】或【审批中心】下处理移动审批待办事项2、或者在移动端【工作台】导航页，打开【移动审批】应用中后进行处理。Web端处理如果已经将移动审批添加到审批中心下，通过web端审批中心也可以进行移动审批待办事项处理。常见问题问题（1）、打开单据后，单据详情页没有附件和审批列表页签解决方案：提交ISM获取对应补丁问题（2）、NC端设置了消息推送，但是没有消息解决方案：参考云盘http://pan.yonyou.com/web/share.html?hash=HoV9ta0HS4c问题检查手册下的《diwork版本移动审批消息检查手册》进行排查。很有可能客户防火墙阻止了，需要进行端口防火墙设置（与客户沟通）执行语句查询selectsysid,GWURLfromgw_tenantinfo，查询出的网址和端口是友企联合NC联通的端口，受限制的一般是此端口问题（3）打开移动审批单据，点击同意按钮后，提示‘鉴权失败’解决方案：移动审批单独计费未充值，需要单独下订单并开通激活，如果已经下过订单，将订单编号与租户ID邮件发送给集团陈肖宝chenxbb@yonyou.com充值。问题（4）打开移动审批单据，点击同意按钮后，提示‘您使用的是免费版本，无法使用审批功能…………’解决方案：NC端分配移动应用-业务流程-移动审批(A04008)功能节点权限
