erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · web...

10
一、准准准准 1 准准 、, ERP 接接接接接接接接接接 ERP 接 接接接接 ERP接 接接接接接接接 ,,一, ERP 接 接接 接接 2 接接接接接接接接接接接接接接接接接接 ERP 接接 接接接 erp 接接接接接接接 1. 接 接 sql 接接接接接接接接); 2. 接接接接 接接接接接接接接接 接 (); 3. 接接接准准准准准准接接接307 接 307 接接接接接接接接接接接 ); 接接 准准准准准准 CTRL+ 准准准准准准准准准准准准准 ,接接接接接接 ERP 接接接接接接接接接 接接接接接 接接接接接接接接接接接 准准准准准准准准准准 接接接接接接接接 win2003 接接64 接 接接 接接 50G 接接接 () 接接 准准准接接 4G 接接接 CPU 接接 接接接接 :, 准准

Upload: others

Post on 28-Oct-2020

12 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

一、 准备工作1、申请外网端口,用于部署接口ERP 接口是明源云产品访问 ERP 服务器或数据库的入口。因为明源 ERP 产品通常部署在客户内网,明源云产品无法直接访问,所以必须通过一个外网可访问的接口程序作为桥梁,来访问 ERP 服务器或数据库的入口。 这套接口程序仍然部署在企业的内网环境,只是映射一个外网可访问的端口2、确认安装步骤

请确认二开项目组发出的更新包已更新到 ERP 环境;微助手 erp 更新包包含内容:1. 数据库更新(按照 sql 编码顺序依次执行);2. 程序更新(更新到工作流站点);3. 其他及移动配置工具执行(307 及 307 以后无移动配置工具修改);

当以上全部更新完后,开始接口管家的部署二、 获取安装程序

CTRL+ 鼠标左键点我下载接口安装包 ,下载完后找到 ERP 接口安装程序并解压,进入目录找到 明源云产品接口安装程序右键以管理员身份运行

附服务器硬件要求操作系统 win2003 以上,64 位硬盘 可用 50G(非系统分区)内存 可使用内存 4G 或以上CPU 不限注:硬件需人工确认,安装程序不做检测三、环境检测

Page 2: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

如上图所示,安装程序运行后,第一步进行安装环境检测,点击【显示详细信息】按钮,可显示具体检查的信息,点击【运行检查】按钮,可开始检查,必须检查全部通过,才能点击【下一步】按钮

检查选项不通过对应的解决方案:1、明源云产品接口更新服务器是否存在接口服务器上访问 http://erpapi.fdccloud.com/站点,如打不开,请联系 IT 检查网络情况2、IIS 安装情况需安装 IIS6.0 以上3、.Net Framework 环境需安装.net framework 3.5 sp1,注意低于或高于这个版本都不行,在 360 软件管家中搜索.net 下载安装下图的包即可

Page 3: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

4、“ISAPI 和 CGI”限制项

上图中红框部分,需要是允许5、是否已经安装过明源云产品接口站点如果之前已经安装过,则点击【下一步】后变成修复模式。使用修复模式检查是否需要修复,如不需修复,则 跳过安装,直接以管理员身份运行目录下移动产品接口配置工

Page 4: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

具.exe,参考五、执行安装配置部分的说明,完成配置即可

注:卸载不要轻易使用,如一定要卸载请先备份站点目录四、配置站点

Page 5: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

企业 ID:点击【通过企业代码获取企业 ID】按钮,在弹出的对话框中输入企业代码,会自动生成企业 ID。企业代码在租户开通时通过邮件发给了登记的项目经理。如下图所示,红框中企业代码一栏。

网站名称:如无特殊需求,默认即可安装目录:选择合适的目录IP/端口:本处填写安装接口管家程序的本机 IP 和 IIS 提供服务的端口。例如 localhost 9001 localhost 代表本机 IP,注意地址不要带 http:://外网访问地址:本处填写通过外网来访问接口的地址和外网端口。例如 120.129.1.2 9001 请确保外网端口已开放,注意地址不要带 http:://举例 :假设客 户 内 网 部 署 接 口 管 家 的 机 器 为 192.168.1.9 , 客 户 外 网 地址为 120.129.1.2,端口 9001 是空闲的,并且可以被外网访问。那么我们将会把接口管家站点部署到 192.168.1.9 上,并设置端口 9001 为站点的端口。最终云端访问接口管家站点将会通过 120.129.1.2:9001 这个地址来访问。

Page 6: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

五、执行安装

点击【执行】按钮,系统会自动依次安装,到操作 5、启动接口管家配置工具时,会弹出配置工具。若接口站点和 ERP 站点在一台服务器上,则可通过【一键设置】按钮,直接选择

ERP主站点地址,系统会自动读取各配置,请务必人工检查一次后,。若不在一台服务器上则根据提示,按需填写数据源,数据库名称,用户名,密码,ERP主站点地址,工作流系统站点地址,报表服务地址及键值以及计划系统站点地址。

填写完,检测通过提交成功后,关闭配置工具,若部署工具状态执行全部成功,则安装完成点击关闭按钮。若报错可尝试点击【重新执行】按钮或联系移动交付团队

注:可单独执行目录下移动产品接口配置工具.exe文件,启动配置工具。配置填写说明如下:

Page 7: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

数据库配置信息(必填)示例:数据源:10.5.11.14\SQL2008R2;数据库名称:dotnet_erp305_lianying_jscf_branch1用户名:sa密码:95938 说明:在 ERP 站 点 bin\License.xml 中 查 找 regname 后 的 部 分 例 如

‘dotnet_erp307sp2_lianying_zjld_trunk’,在注册表(运行 regedit)中查找该字段后 , 会 显 示 如 下 图 所 示 信 息 , ServerName 为 数 据 源 , DBNname 为 数 据 库 名 称 ,UserName 为用户名,SaPassword 为加密后的密码,未加密的密码可联系 IT 管理员获取

Page 8: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

若客户 ERP 存在多个数据库,则使用高级模式填写多个数据库信息ERP 站点配置信息ERP主站点地址:(必填)在 IIS 中 找 到 ERP 站 点 , 右 侧 浏 览 网 站 中 的 地 址 , 如 下 图 所 示 , 例

如:192.168.1.9:8080如有内网和外网两个访问地址,请填写内网地址

工作流系统站点地址:(不使用移动审批不用填,使用移动审批则必填)ERP305SP1 之前,工作流和 ERP 是同一站点,地址和 ERP 站点相同,305SP1 以后,独立站点,可在 IIS 中查找对应站点,例如:192.168.1.9:8081如有内网和外网两个访问地址,请填写内网地址说明:根据左侧站点列表,如果有单独带 wf 或 workflow字样的站点,则其为工作流独立站

点,右侧浏览网站中的地址,就是工作流站点地址,如果没有则填 ERP主站点即可或登录 ERP,在系统设置-系统初始化-运行设置中查找工作流站点地址

计划系统站点地址:(不使用移动计划不用填,使用移动计划则必填)一般与 ERP 站点相同,如 PC计划站点单独部署,则在 IIS 中查找对应站点例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址

Page 9: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

说明:同工作流系统站点的判断方法,在 IIS左侧列表中查找是否有独立站点,根据右侧的

浏览网站查看站点地址。没有独立站点则填 ERP主站点报表服务地址和报表服务键值:(不使用移动报表不用填,使用移动报表则必填)IIS 中浏览 ERP 站点文件,主目录下 web.config文件中搜索 MyRptServices字段

value=后面的地址为报表服务站点地址。例如:http://localhost:8002/MyRptServices.asmx,搜索 MyRptAppKey字段 value=后面的部分为报表服务键值。例如:erp256Web.config文件实例如下:

注:在客户的服务器上必须能够访问这个地址 http://www.fdccloud.com这个地址是移动微助手云端后台的地址,接口管家运行的过程中需要与该地址通信。如果该地址无法在接口管家的服务器上访问,那么就意味着接口管家无法正常运行。验证方法:在接口管家所在的服务器上,打开浏览器,在地址栏里输入以上地址。如果能够访问,即是没问题。不能访问,就需要让客户 IT 开放该地址的访问。访问验证如下图:(建议使用谷歌浏览器打开)

七、推送接口待以上步骤都完成后,联系移动产品交付团队刘嵩 QQ:76031561 ,TEL:13871441783

处理移动产品接口初始化八、数据初始化

参考【98 微助手数据初始化指引】完成初始化,文件在【交付工具箱】中,加 QQ群:微助手|审批 报表 计划 162505707 获取1、微助手后台登录信息在租户开通时通过邮件发出,请注意查收发件人为【明源云】,主题为【明源移动企业平台管理账号】的邮件

2、确认客户使用的入口(三选一)

Page 10: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

1)微助手 APP2)全新企业号(为使用微助手而申请的新企业号,企业号中没有通讯录或现有通讯录可以清空)3)已有通讯录的企业号(客户已经在使用的企业号,已有完整的通讯录)3、使用企业代码(租户开通邮件中有),ERP帐号,ERP密码登录微助手4、微助手 3.0 下载二维码

九、常见问题

当出现错误后,可点击消息,查看具体的报错信息

Page 11: erpapi.fdccloud.comerpapi.fdccloud.com/upload/明源云产品接口部署... · Web view例如:192.168.1.9:8080,如有内网和外网两个访问地址,请填写内网地址 说

【无法获取 ACCESS_TOKEN】:此问题是由于外网端口不可用导致附端口的验证方法:1、开通防火墙端口(入口和出口)。具体过程如下: http://jingyan.baidu.com/article/f96699bbadafca894f3c1b7a.html2、向客户 IT申请开通外网端口,IT 会在交换机上做好映射。3、在服务器上创建站点,站点下随意创建个 index.html页面。4、绑定端口,然后外网访问地址,只要页面可以正常访问即可。如客户 IT将 9001绑定

到 120.129.1.2 上,那么访问:http://120.129.1.2:9001/index.html