金蝶EAS_V8.1_移动商务配置指南金蝶EAS_V8.1_移动商务配置指南适用7.58.08.18.2版本金蝶软件（中国）有限公司发布日期：2015年8月版权所有©金蝶软件（中国）有限公司i金蝶EAS_V8.1_移动商务配置指南前言概述金蝶EAS的移动商务功能主要用于支持短信和邮件的功能。本手册主要介绍EASV8.1版本移动商务的主要特性、实施步骤、短信和邮件功能的具体配置方法以及日常使用过程中的一些常见问题的处理方案，用于更好的指导该功能的应用。读者对象本手册适用于金蝶EAS的应用用户，特别是需要在系统中应用短信或邮件功能的用户。约定本处对文中通用信息作如下约定$EAS_HOME表示EAS服务器安装的根目录，即安装过程中输入的本地路径。$BOS_HOME表示BOS工具的安装根目录，即安装过程中输入的本地路径。修订记录（可选）本文以《金蝶EAS移动商务升级指南》以EASV7.5更新基础，主要针对EASV8.1版本环境中的移动商务（消息集成）平台的应用进行介绍。版权所有©金蝶软件（中国）有限公司ii金蝶EAS_V8.1_移动商务配置指南目录1移动商务介绍.................................................................................................................11.1产品特性...........................................................................................................................................................11.2实施步骤...........................................................................................................................................................11.2.1注意事项..................................................................................................................................................11.2.2补丁安装..................................................................................................................................................11.2.3开通网络及短信账号..............................................................................................................................21.2.4集群环境下的配置..................................................................................................................................22短信和邮件功能配置........................................................................................................42.1菜单说明...........................................................................................................................................................42.2配置同时使用短信和邮件功能.......................................................................................................................42.2.1短信业务配置..........................................................................................................................................42.2.2邮件帐号配置说明..................................................................................................................................62.3配置仅使用邮件功能.......................................................................................................................................82.3.1短信业务配置..........................................................................................................................................82.3.2邮件账户配置........................................................................................................................................102.3.3邮件发送验证........................................................................................................................................112.4配置仅使用短信功能.....................................................................................................................................122.5短信记录查询.................................................................................................................................................143常见问题解答...............................................................................................................143.1短信审批如何配置？.....................................................................................................................................143.2为什么收不到工作流邮件（短信）？.........................................................................................................143.3如何配置EAS与通讯平台的自动连接？....................................................................................................153.4如何设置将移动商务日志单独输出？.........................................................................................................163.5如何检测短信平台网络是否通畅？.............................................................................................................163.6如何设置若干天后未发送的短信和邮件不再发送？.................................................................................173.7如何修改审批邮件中的链接地址？.............................................................................................................173.8如何清除审批邮件中的链接地址？.............................................................................................................18版权所有©金蝶软件（中国）有限公司iii金蝶EAS_V8.1_移动商务配置指南1移动商务介绍1.1产品特性EAS移动商务主要支持系统短信和邮件的集成功能，其平台特性如下：实现整合维那多短信平台[推荐使用]，增加了平台的稳定性；友商网旧通讯平台（即金蝶通讯平台3.1）由于友商网停止维护，请暂停使用；移动商务模块内置支持邮件发送，不支持工作流邮件回复审批。不支持接入其他第三方短信平台。1.2实施步骤1.2.1注意事项在第三方短信网关（新友商网或维那多）平台开的帐户，简称短信网关帐号，一个短信网关帐号只能用于一个数据帐套，若多个帐套想同时用移动商务发送短信，需分别开通多个短信网关帐号，因为短信回复有相应的帐套数据信息如短信记录的ID，所以不能一个短信网关帐号用于多个数据帐套。也不要把一个帐号放在多个数据帐套中测试，因会影响回复短信的接收。短信支持多帐套时，需要指定具体的实例：即一个帐套对应一个实例，每个实例单独进行短信业务配置，不支持一个实例多个帐套的情况。EASV8.1版本请先购买“消息集成”模块的License。1.2.2开通网络及短信账号如需使用短信功能，必须开通与第三方短信网关平台（维那多平台）的网络连接，并申请对应的账号和密码。需开通EAS服务端部署环境的外网访问权限，EAS服务端需要和第三方短信网关平台进行通信。访问外网的域名和IP见后面说明。维那多平台账号开通和短信冲值请找金蝶系统集成部胡芳（邮箱：fang_hu@kingdee.com办公电话：0755-86071436），可直接发送公司名称、公司简称（6个字以内，作为短信后缀）、产品版本，找胡芳邮件申请。版权所有©金蝶软件（中国）有限公司1金蝶EAS_V8.1_移动商务配置指南1.2.3集群环境下的配置此处的配置仅针对短信支持单个帐套的集群环境配置。移动动商务属于基础服务类，并非天然支持集群，如果现场EAS产品的环境为集群环境，则需要进行相应的设置。通过在bosconfig.xml文件中进行相关配置，使得与通讯平台的连接服务成为orm服务，多个从EAS节点作为主节点的客户端，以产生唯一的连接。步骤1停止EAS应用服务，打开文件：eas\Server\server\profiles\实例名称\config\bosconfig.xml进行相关配置。(这个文件非常重要，配置错了可能导致服务器起不来，修改前请备份)步骤2对于EAS主节点（主服务器下的）的bosconfig.xml，在
节点中增加如下部分：其value的值为空。如以下截图：步骤3对于EAS从节点（从服务器下的）的bosconfig.xml，在节点中增加如下部分：其value的值具体为指向主节点(即你主实例的IP和端口信息)，例如：版权所有©金蝶软件（中国）有限公司2金蝶EAS_V8.1_移动商务配置指南又例如以下截图：value值指向主实例的ip和端口步骤4重新启动EAS应用服务。(完)1.2.3配置的补充说明：按文档说明，请仔细看，即所有实例下的这配置文件都要改。主实例(主节点)下，添加这部分配置，其值为【空】的。从节点为除主实例的其他从实例，也要添加这部分配置，从实例的【需要有值】，value指向你主实例的IP和端口信息。-----【看上面的红色字说得很清楚了】，不清楚请看下图的关键信息说明：版权所有©金蝶软件（中国）有限公司3金蝶EAS_V8.1_移动商务配置指南2短信和邮件功能配置2.1菜单说明以administrator用户登录EAS客户端，选择“系统平台->短信邮件管理”进行短信和邮件功能的配置。2.2配置同时使用短信和邮件功能2.2.1短信业务配置此处用于配置与第三方维那多系统的连接，以及系统是否支持短信和邮件功能。步骤1请以administrator用户登录EAS客户端，选择“系统平台->短信邮件管理->短信管理->短信业务配置”，打开配置页面。步骤2参考配置说明进行配置。版权所有©金蝶软件（中国）有限公司4金蝶EAS_V8.1_移动商务配置指南同时使用短信和邮件功能，需要配置好如下列表中的参数：参数名称参数说明设置方法可选通讯平台可支持的移动商务平台请保持默认选项“维那多短信平台”通讯平台实现类通讯平台侧实现的类名无需配置。通讯平台主机名通讯平台侧的主机名，用于连接通讯平台当在“可选通讯平台”中设置好“维那多短信平台”后，系统会默认设置为“kingdee.weinaduo.net”。请保持默认配置。通讯平台端口通讯平台的端口号，用于连接通讯平台自动当在“可选通讯平台”中设置好“维那多短信平台”后，系统会默认设置为空。请保持默认配置。登录用户名/密码与通讯平台连接的用户名和密码。请填写1.2.1节中申请到的用户名和密码。短信功能必须配置。可收发消息类型系统可收发的消息类型，包括SMS（短信）、Email（邮件）根据需要勾选对应的选项。例如如需同时实现短信和邮件通知功能，请勾选SMS和Email两项。配置好的界面如下：版权所有©金蝶软件（中国）有限公司5金蝶EAS_V8.1_移动商务配置指南步骤3点击保存图标，保存配置信息。修改配置信息后，一定要先点击保存图标才能更新配置信息，从而使修改后的信息生效。步骤4点击启动图标，启动平台。启动平台之前，可以通过测试连接按钮，测试与第三方短信网关的连接。如果连接不通，请检查网络是否正常，配置是否正确。版权所有©金蝶软件（中国）有限公司6金蝶EAS_V8.1_移动商务配置指南2.2.2邮件帐号配置说明若需用到邮件发送，需要配置一下邮件帐号信息。步骤1请以administrator用户登录EAS客户端，选择“系统平台->短信邮件管理->短信管理->邮件配置”，打开配置页面。步骤2配置好邮件发送主机地址、用户名、密码、发送者邮箱地址这几项内容。此处配置项和其他常见的邮件客户端配置项是类似的，如outlook中的帐户配置。注意：测试的时候请使用客户自己的邮箱服务器地址，或者也可以使用网易私人邮箱地址，如smtp.163.com，确保EAS应用服务器能访问邮件服务器。必须配置的参数说明如下：版权所有©金蝶软件（中国）有限公司7金蝶EAS_V8.1_移动商务配置指南参数名称参数说明参数设置邮件发送主机地址邮件发送服务器的主机地址。此处配置的邮件发送服务器必须与EAS应用服务器网络相通。可以是客户邮件发送服务器的地址，也可以是公共的邮件发送服务器地址，例如网易邮件发送服务器地址为smtp.163.com。用户名/密码邮件发送管理员的用户名和密码。用户名和密码必须能登录邮件发送服务器。发送者邮箱地址用户名对应的邮箱地址。可以是企业内部注册的邮箱或是有发送邮件权限的外部邮箱，需与配置的用户名和密码一一对应。发送者姓名可任意填写。步骤3点击保存图标，保存配置信息。此界面保存时将配置信息保存到：{EAS_HOME}\server\properties\mailServerConfig.properties中。2.3配置仅使用邮件功能单独使用邮件功能，请参考如下配置方法实现。2.3.1短信业务配置此处用于配置与第三方维那多系统的连接，以及系统是否支持短信和邮件功能。步骤1请以administrator用户登录EAS客户端，选择“系统平台->短信邮件管理->短信管理->短信业务配置”，打开配置页面。步骤2选择通讯平台，并勾选EMail即可。版权所有©金蝶软件（中国）有限公司8金蝶EAS_V8.1_移动商务配置指南仅使用邮件功能，需要配置好如下列表中的参数：参数名称参数说明设置方法可选通讯平台可支持的移动商务平台请保持默认选项“维那多短信平台”可收发消息类型系统可收发的消息类型，包括SMS（短信）、Email（邮件）根据需要勾选对应的选项。如果只需实现邮件发送功能，请勾选EMail。步骤3点击保存图标，保存配置信息。修改配置信息后，一定要先点击保存图标才能更新配置信息，从而使修改后的信息生效。步骤4点击启动图标，启动平台。仅使用邮件功能，无需进行连接测试，只需按照前面的步骤配置并保存好后，启动平台即可。版权所有©金蝶软件（中国）有限公司9金蝶EAS_V8.1_移动商务配置指南2.3.2邮件账户配置步骤1请以administrator用户登录EAS客户端，选择“系统平台->短信邮件管理->短信管理->邮件配置”，打开配置页面。版权所有©金蝶软件（中国）有限公司10金蝶EAS_V8.1_移动商务配置指南步骤2配置好邮件发送主机地址、用户名、密码、发送者邮箱地址这几项内容。此处配置项和其他常见的邮件客户端配置项是类似的，如outlook中的帐户配置。注意：测试的时候请使用客户自己的邮箱服务器地址，或者也可以使用网易私人邮箱地址，如smtp.163.com，确保EAS应用服务器能访问邮件服务器。必须配置的参数说明如下：参数名称参数说明参数设置邮件发送主机地址邮件发送服务器的主机地址。此处配置的邮件发送服务器必须与EAS应用服务器网络相通。可以是客户邮件发送服务器的地址，也可以是公共的邮件发送服务器地址，例如网易邮件发送服务器地址为smtp.163.com。用户名/密码邮件发送管理员的用户名和密码。用户名和密码必须能登录邮件发送服务器。发送者邮箱地址用户名对应的邮箱地址。可以是企业内部注册的邮箱或是有发送邮件权限的外部邮箱，需与配置的用户名和密码一一对应。发送者姓名可任意填写。步骤3点击保存图标，保存配置信息。此界面保存时将配置信息保存到：{EAS_HOME}\server\properties\mailServerConfig.properties中。2.3.3邮件发送验证在EAS客户端中，打开某个序事簿界面，在列表中选择任意列后右键选择发送邮件，可以验证邮件发送功能是否正常。验证通过后在其他界面勾选发送邮件才能发送邮件出去。版权所有©金蝶软件（中国）有限公司11金蝶EAS_V8.1_移动商务配置指南2.4配置仅使用短信功能仅使用短信功能，只需进行短信业务的配置。步骤1请以administrator用户登录EAS客户端，选择“系统平台->短信邮件管理->短信管理->短信业务配置”，打开配置页面。步骤2参考配置说明进行配置。同时使用短信和邮件功能，需要配置好如下列表中的参数：参数名称参数说明设置方法可选通讯平台可支持的移动商务平台请保持默认选项“维那多短信平台”通讯平台实现类通讯平台侧实现的类名无需配置。通讯平台主机名通讯平台侧的主机名，用于连接通讯平台当在“可选通讯平台”中设置好“维那多短信平台”后，系统会默认设置为“kingdee.weinaduo.net”。请保持默认配置。通讯平台端口通讯平台的端口号，用于连接通讯平台当在“可选通讯平台”中设置好“维那多短信平台”后，系统会默认设置为空。请保持默认配置。版权所有©金蝶软件（中国）有限公司12金蝶EAS_V8.1_移动商务配置指南登录用户名/密码与通讯平台连接的用户名和密码。请填写1.2.1节中申请到的用户名和密码。短信功能必须配置。可收发消息类型系统可收发的消息类型，包括SMS（短信）、Email（邮件）根据需要勾选对应的选项。只需实现短信发送功能，请勾选SMS。配置好的界面如下：步骤3点击保存图标，保存配置信息。修改配置信息后，一定要先点击保存图标才能更新配置信息，从而使修改后的信息生效。步骤4点击启动图标，启动连接。启动连接之前，可以通过测试连接按钮，测试与第三方短信网关的连接。如果连接不通，请检查网络是否正常，配置是否正确。版权所有©金蝶软件（中国）有限公司13金蝶EAS_V8.1_移动商务配置指南2.5短信记录查询EAS发送出去的短信及接收到的短信，在第三方短信网关平台上保留有记录，可以通过第三方短信网关平台提供的网址登录后进行查询。仅供查询使用。维那多平台http://121.52.221.108:8090或者http://kingdee.weinaduo.net:8090登录用的用户名和密码为“短信业务配置界面”中的用户登录名和密码。维那多平台账号开通和短信冲值请找金蝶系统集成部胡芳（邮箱：fang_hu@kingdee.com办公电话：0755-86071436）。3常见问题解答3.1短信审批如何配置？打开eas服务器安装目录下的eas\Server\server\profiles\server{n}\config\bosconfig.xml文件，最好用支持xml文件的文本编辑器打开，例如EditPlus或UltraEdit，找到这句话，版权所有©金蝶软件（中国）有限公司14金蝶EAS_V8.1_移动商务配置指南如果要eas的工作流审批功能支持短信，则这里的isAllowMobile后面的value值一定要设置为true。3.2为什么收不到工作流邮件（短信）？收不到工作流邮件：步骤1系统平台->个人信息及设置->个人外部消息设置查看是否配置邮件步骤2打开“短信业务配置”菜单，查看界面是否勾选了Email步骤3检查““系统平台->短信邮件管理->短信管理->短信业务配置”界面是否点击了“启动”按钮，只有启动了才能使用。步骤4检查流程定义，检查对应节点是否启用工作流邮件步骤5打开用户管理（可以是任意的序事薄），右键发送邮件，查看是否可以手工发送邮件步骤6登录EASPortal，打开流程中心，发送催办邮件，查看是否可以正常发送如果①②③都正常，收集此时段日志，并附加④⑤的测试结果。收不到工作流短信：针对短信，进行上面的操作【第③步，手工发送短信】。3.3如何配置EAS与通讯平台的自动连接？重启EAS服务器后，EAS自动连接通讯平台，而不需要去“短信业务配置”界面去启动。需要做如下的步骤：步骤1停止EAS服务器；步骤2修改EAS服务器端配置文件Server\server\profiles\server1\config\listenerconfig.data，查找名称为“com.kingdee.eas.mobile.app.AutoStartMobileListener”的配置项，修改设置如下：如果没有，在最后增加一项配置如下图：版权所有©金蝶软件（中国）有限公司15金蝶EAS_V8.1_移动商务配置指南步骤3修改EAS服务器端配置文件Server\server\profiles\server1\config\bosconfig.xml，在顶级下增加一项配置，其中value为数据中心的id(即：BOS管理平台专业版-[数据中心]页签-代码，详见：)如下图：步骤4启动EAS服务器在EAS与通讯平台的连接时，若退出通讯平台，然后重启，EAS会自动重连通讯平台，不需要另外的配置。这里需要注意的是，只有在EAS与通讯平台的连接处于正常连接时，意外断开了通讯平台的连接，那么，后续在通讯平台正常后，EAS才会自动去重连；若EAS与通讯平台处于非连接状态（例如手工去“短信业务配置”界面中断开连接），那么哪怕再重启通讯平台，EAS都不会自动重连，而是需要重启EAS服务器，或者去“短信业务配置”界面去连接。请特别注意自动重连的适用情况。3.4如何设置将移动商务日志单独输出？为了日常问题分析和解决，让移动商务的所有日志都独立输出到eas\server\profiles\server{n}\logs\MobileTrace.log中，以方便发送出错时在MobileTrace.log中收集日志，避免统一输出到apusic.log时因整个平台日志过多而收集不到移动商务的日志。请做如下配置：将eas\server\profiles\server{n}\config\log4j.properties日志规则配置文件最后边加上以下配置(注意1：多个EAS实例下要同时修改掉各实例下的配置；注意2：配置中”error”为日志输出的级别，分析报错问题一般用error，记录更详细日志信息输出时才用info或debug，需要根据自身需求修改该配置设置。）#mobilelogsettinglog4j.logger.com.kingdee.eas.mobile=error,mobiletrace版权所有©金蝶软件（中国）有限公司16金蝶EAS_V8.1_移动商务配置指南log4j.additivity.com.kingdee.eas.mobile=falselog4j.appender.mobiletrace=org.apache.log4j.RollingFileAppenderlog4j.appender.mobiletrace.MaxBackupIndex=10log4j.appender.mobiletrace.MaxFileSize=10MBlog4j.appender.mobiletrace.layout=org.apache.log4j.PatternLayoutlog4j.appender.mobiletrace.layout.ConversionPattern=[%t%d{yyyy-MM-ddHH:mm:ss}]%m%nlog4j.appender.mobiletrace.File=${EAS_INSTANCE_HOME}/logs/MobileTrace.loglog4j.appender.mobiletrace.encoding=UTF-83.5如何检测短信平台网络是否通畅？检查客户EAS服务器是否开放访问维那多服务器，可以按照如下两种方式：可以通过浏览器访问：http://sms.kingdee.com/send/getfee.aspx如果返回“id=-1&error=Smsaccountorpasswordiserror&errid=6010”表示正常。直接ping服务器。否则请联系客户网络管理人员检查网络设置。3.6如何设置若干天后未发送的短信和邮件不再发送？工作流通知、审批等短信和邮件发送时，只发送最近N天的数据，N从配置中获取；打开\server\profiles\server1(1、2、、、、N)\config\bosconfig.xml在PortalInfo节点中增加以下内容，5代表5天，可以设置为其他数字配置完后应该如下图：3.7如何修改审批邮件中的链接地址？审批节点配置好邮件内容后，系统发送的邮件内容中会自动添加一段登录链接，如何修改链接地址？版权所有©金蝶软件（中国）有限公司17金蝶EAS_V8.1_移动商务配置指南步骤1停止EAS应用服务。步骤2打开eas服务器安装目录下的eas\Server\server\profiles\server{n}\config\bosconfig.xml文件。最好用支持xml文件的文本编辑器打开，例如EditPlus或UltraEdit，找到这个节点，修改如下粗体部分的内容。步骤3重新启动EAS应用服务。3.8如何清除审批邮件中的链接地址？审批节点配置好邮件内容后，系统发送的邮件内容中会自动添加一段登录链接，此链接只能指向Portal的登录界面，无法直接打开审批任务，作用不大，如何清除此链接？步骤1停止EAS应用服务器。步骤2修改服务器下的eas\server\profiles\server1\config\bosconfig.xml文件，在PortalInfo下增加：步骤3重启服务器生效。版权所有©金蝶软件（中国）有限公司18
