如何设置K/3 Cloud系统闲置超时时间（timeout hearbeat）

希望客户端超时退出时间变长的普通用户，请参考https://vip.kingdee.com/questions/8255/answers/11755 

希望客户端超时退出时间变长的普通用户，请参考https://vip.kingdee.com/questions/8255/answers/11755 

希望客户端超时退出时间变长的普通用户，请参考https://vip.kingdee.com/questions/8255/answers/11755 

【系统超时】：

1、功能：在非用户操作时间间隔超过设定时间AppTimeOut时，自动退出到登陆界面；

2、逻辑：这个过程中，系统回按AppHearbeat心跳线时间设置进行系统状态检查，发现没有用户操作就累计超时时间，直到超出AppTimeOut设置为止；
（如果心跳线检查中途发现服务端上下文已经被其他进程清除，也会退出登陆，也可能提示其他错误，这时需要检查服务端日志）

3、如果只是单纯想要增大超时时间，可以仅调整AppTimeOut参数即可，这样也会带来服务端的内存占用增加（不能及时释放闲置的内存占用），因此要均衡好这个时间，如果服务器内存很充足，可以适当调大；

【具体设置】：

1、在WebSite下找到Web.Config文件，在文件中找到节点 configuration/appSettings,在该节点下可以设置AppTimeOut和AppHearbeat参数。

1.1、心跳线 AppHearbeat: 设置

改客户端超时时间不需要修改“AppHearbeat”

改客户端超时时间不需要修改“AppHearbeat”

改客户端超时时间不需要修改“AppHearbeat”

算法：心跳线 <= Min( IIS超时,  反向代理超时,  代理服务器超时, ... ) / 2 ；

说明：心跳线必须小于等于iis或代理超时的一半。比如iis为20分钟，代理为10分钟，那么心跳线最大不能超过5分钟。最小不能设置小于10秒。

1.2、超时时长 AppTimeOut：默认为3600秒 = 1小时，比如: 设置为24小时 = 24 * 3600秒 = 86400秒；

（基于安全考虑不建议设置太长，HTML5端最小控制为600秒，GUI和SL端没有最小值控制）；

1.3、设置完成后，注意不要破坏web.config的xml文档格式完整性（可以用 ie浏览器打开这个文档进行初步结构检测）

1.4、cmd命令框中执行 iisreset 指令，来使得设置生效（这个指令会导致站点重启，当前业务操作断开,包括对web.config的修改都会影响正常业务操作，建议在下班空闲时间操作）

2、如果想使用iis默认超时设置替代K/3 Cloud的超时机制，请设置AppTimeOutEnable为False, 重启IIS站点后就停用了整个金蝶云星空的超时机制。

ps: 注意 AppTimeOutEnable 需要设置为 True，大写T开头；（补丁：PT142914 【7.5.1450.1】2019-10-31 之后已经兼容大小写了 ）

 

3、【如何在客户端查看心跳线设置】：
打开httpwatch查看，查看心跳线请求可以看到如下图的 value，enabled， hearbeat三个参数

注意右下的返回数据窗口中，当数据量比较多是，默认只显示前2000个字符。

点击【>】这个按钮，会把所有数据都写入粘贴板，然后可以粘贴到Notepad记事本里查看所有数据。

... 

【经验答疑】：

问1：设置了AppTimeOut为14400后，没有生效，TimeElapsed事件返回的value为1800；

答：经验确认，由于在设置是可能是通过拷贝粘贴方式，导致在14400后面有一个不可见字符，导致系统无法正确识别，从而采用默认1800值。

解决方案：删除设置值包括双引号，然后手工逐个字符敲入"14400"，保存后即可解决。（注意关闭输入法，另外14400仅是一个例子数字）。

操作例子：开启一个空白的Notepad记事本窗口，键盘录入"14400"后键盘ctrl+a，键盘ctrl+c拷贝，然后切换到打开common.config的窗口中通过键盘ctrl+v粘贴覆盖原来的值。（其他设置值可以举一反三，如果没有生效一般都是这个问题）。

问2：设置了AppTimeOutEnable为"true"，后20分钟就超时了。

答：参数在2019-10-01之前的版本都是大小写敏感的，也就是必须设置为"True"才能生效；在PT142914 【7.5.1450.1】2019-10-31发布的以及之后的补丁，都已经兼容了"true"的写法。

解决方案：把值设置为 "True"即可。

问3：设置超时后，提示“长时间未操作，系统退出，请重新登录”，但时间没有到啊！

答：真正闲置超时提示是“系统闲置时间过长，请重新登录”，而不是提问的中的内容。提问的内容是服务端的上下文某些情况下被重置导致session内容被清除，需要检查服务器日志（website/app_data/log）看是否有异常，不是本文讨论范畴。

问4：设置超时后AppTimeOut，实际并不是准确的到点超时？比如设置10分钟，心跳5分钟，实际超时大约是15分钟？

答：超时依据是心跳线请求，如果心跳间隔是5分钟，那么(10+网络时间误差) / 5 > 2,  那么由于网络时延误差，可能要到2~3个心跳周期才能确定超时，也就是 10~15，理论上是实际最大超时时间  ((AppTimeOut / AppHearbeat) +1 ) * AppHearbeat 。 也就是心跳线间隔越短，误差越小，但服务器负担越重，这里用5分钟是一个较好的平衡点。

...