YonSuite与U8移动应用集成使用指南一、商务要求1、商务下单机构或伙伴销管在营销一体化下商务单，下单选择产品时，请勾选Yonsuite专业版下的【平台-数字化工作入口】。二、YonSuite注册并激活开通1、注册或登录通过企业服务中心（https://apcenter.yonyoucloud.com）进行登录或注册用友云账号。1）如果客户手机号或邮箱已经使用过用友云产品（比如友报账、友空间、友云采），可以直接用原账号登陆企业服务中心，不需要再次注册。2）如果客户初次使用用友云产品，建议使用客户的手机号或邮箱注册，此账号后续为租户管理员。点击【注册】按钮，按照提示注册账号。3）登录企业服务中心（https://apcenter.yonyoucloud.com）后，点击右上角【账号设置】，在【基本设置-账号管理】下绑定个人邮箱（如果使用手机号注册，请务必绑定个人邮箱，登录U8OpenAPI客户端必须要用邮箱，而且邮箱会作为OpenAPI账号编码），邮箱必须为真实个人邮箱。2、激活在企业服务中心（https://apcenter.yonyoucloud.com）进行YonSuite产品开通激活。请根据YonSuite产品激活指南手册进行YonSuite激活YonSuite_产品激活指南20201204.doc3、登录激活完成之后，通过浏览器进入YonSuite系统网页端（建议通过谷歌浏览器登录）网页端地址：https://yonsuite.diwork.com，登录后界面如下：三、前置条件1、检查U8应用服务器IIS环境友企联集成配置需要IIS支持ASP,集成配置前，请务必检查IIS中是否已经勾选安装。（没有勾选会导致在后面配置友企连时设置保存不上!!!）可在【控制面板-程序和功能-启用或关闭Windows功能】查看是否勾选，如果为勾选，请勾选安装。四、YonSuite与U8移动应用集成配置集成配置流程如下：集成配置必须由租户管理员进行操作配置，租户管理员登录YonSuite后，添加ERP连接，进行U8ERP连接相关配置，配置完毕后，通过应用市场添加U8移动应用并授权后，相关用户在移动端即可使用U8相关移动移动应用1、登录YonSuite网页端租户管理员通过谷歌浏览器登录https://yonsuite.diwork.com/；登录后，在右上角【账号管理】下再次确认是否已经绑定邮箱，务必绑定真实邮箱。2、添加ERP连接配置1）在【连接集成服务-数据集成】菜单下，点击进入【ERP连接配置】2）切换到【添加U8连接】页签，在U8对应的节点上点击【添加】，添加U8对应的友企联服务注意：不要多次添加U8ERP链接设置,一个租户下限添加一个3、下载U8OpenAPI客户端1）点击【添加】后，在弹出的界面，【点击下载】，下载U8OpenAPI客户端2）下载U8OpenAPI客户端后，将下载文件解压缩，并和U8业务服务器安装在同一台机器上，并能访问外网的Windows系统中。注意：U8OpenAPI客户端必须在ERP连接配置中下载，不能使用U8系统自带的客户端，务必注意，此处容易混淆。4、登录U8OpenAPI客户端1、下载成功后，需要用租户管理员的邮箱、密码登录OpenApi客户端（参见下方截图，用客户实际的邮箱登录）（根据系统中蓝色字体显示的邮箱进行登录，一般为租户管理员注册或绑定的个人邮箱）（根据系统中蓝色字体显示的邮箱进行登录，一般为租户管理员注册或绑定的个人邮箱）（根据系统中蓝色字体显示的邮箱进行登录，一般为租户管理员注册或绑定的个人邮箱）2、U8OpenAPI账户必须使用系统默认的账号（如下图所示的邮箱账号,通常是租户管理员邮箱）登录；如果邮箱后缀为@upesn.com，此邮箱不可用，请在【账号管理】下修改绑定个人真实的邮箱，如仍有问题，可再联系线上支持服务部人员修改账号；当在U8OpenAPI客户端找回密码时，尽量使开放平台密码和友户通密码一致；客户端请务必在U8业务服务器本机上进行安装，每个账户注册的服务只允许一台机器在线；5、U8应用服务器配置EAI在U8服务器【开始-程序-用友U8+V16.0-企业应用集成-EAI接口设置】中进行EAI接口设置。6、U8配置并测试连接EAI配置完毕后，再返回到YonSuiet中ERP连接配置中，进行U8配置和连接。配置时，以下几项内容务必仔细核对，千万不能弄错：1）、系统编码（账套编码）、EAI数据源、数据库账套，三者必须匹配例：系统编码001，EAI数据源（default）@001，数据库账套UFDATA_001_20202）、企业服务识别码：企业服务识别码在U8中可以获取3）、数据库账套可以在数据库中查看到4）、服务器地址和数据库地址都使用内网IP注意：EAI配置需要IIS支持ASP,请务必检查IIS中是否已经勾选安装在U8运行openAPI客户端以上信息设置正确后，可以测试连接成功,测试成功后会显示第五步初始化数据同步任务。“设置为主账套”则基础档案数据会从该账套中同步以上信息配置后，分别点击【测试服务器连接】和【测试数据数据连接】，测试通过后，点击【保存】即可。7、初始化任务并进行数据同步1）、完成以上友企连相关设置后，点击【初始化ERP任务】2、在【连接集成服务-数据集成-数据同步任务】中，执行同步任务依次同步的数据包括U8编码方案、部门、职务类别、职务、人员基本信息、任职等。注意：1、Yonsuite中操作员与U8中操作员的关联方式主要是通过邮箱和手机，务必维护好邮箱和手机号8、添加U8移动应用模块1）租户管理员在【数字化建模-系统管理-应用管理】下，点击【我的应用】2）在我的应用界面，点击右侧【应用市场】3）搜素U8或在云ERP下，点击购买U8移动轻应用（免费）。根据客户购买的情况，请分别点击添加U8移动审批、U8移动服务、U8移动营销、U8移动销售、U8移动报表、U8薪资查询4）点击【购买】，免费购买移动应用5）点击【确认订单】，完成所需移动应用的添加6）在我的应用列表下，可以查看添加的U8移动应用注意：应用市场只是添加u8移动应用的产品形态，U8移动应用本身的许可授权，需单独通过商务购买并按移动应用充值流程进行充值。9、U8移动应用授权U8移动应用添加后，默认为全员可以使用，请根据项目情况，单独授权给具体的使用用户。1）租户管理员在【数字化建模-权限管理-授权】下，点击【全员应用授权】，2、在【类别】页签下，找到U8移动应用，选择对应应用，如U8审批-移动审批，修改应用可见范围。3、授权使用的用户，在友空间移动端登录后，可以使用U8移动应用，如下图友空间中U8轻应用五、一些常见报错（持续更新）1、用户名密码错误方法：1、检查U8人员档案上的邮箱和电话必须和YonSuite用户一致。2、检查人员是否已同步到YonSuite、检查友企连是否同步成功、用户管理中是否能看到用户。2、OpenAPI客户端登录不上检查OpenAPI账号是否是通过友企连自动添加的账号，账号密码为YonSuite租户管理员的邮箱和密码。如果账号是用友云默认邮箱（后缀为@upesn.com），请先联系友企连支持人员更改。3、友企连设置保存错误1）“客户端未登录”，检查openAPI客户端是否在应用服务器登录，登录账号用自动生成的openAPI账号。2）Sa密码错误，注意sa密码尽量不要有特殊字符3）“测试成功，保存失败”，检查EAI数据源配置是否正确4）EAI数据源和系统编码需要对应上，如下图所示4、友企连同步错误同步失败可以查看日志，显示失败原因。编码方案同步失败会导致后续其他档案的同步失败。任职信息同步失败会导致人员无法正常显示。
