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