本文主要介绍了Common.config配置文件的修改和使用方法,该文件位于应用服务器的WebSite/app_data目录下,用于配置站点的全局参数。文章强调了修改文件时需保存为UTF-8 withSign格式,并提供了修改前的备份和格式检查建议。文中列出了多个可在
Common.config配置
1、站点的全局配置参数可以在应用服务器的WebSite/app_data/common.config里面添加修改
1.1、 注意保存文件是要保存成UTF-8 withSign的格式
(重点提示:
a、修改前请备份好,修改后查看是否正确可以在保存后,重新打开看看是否存在中文乱码现象,如果存在说明格式错误;
b、确保键值Key只出现一次,不要重复出现;
c、从论坛拷贝代码注意中文空格问题,详细参考文章末尾的答疑篇:【疑问2】)。
1.2、 common.config在应用服务器的安装目录下,例如下图位置:
2、以下配置项可以在common.config 的<appSettings>下添加(如果对应key值已经存在,就修改value即可,注意不要重复添加相同的key的配置项):
<!--端应用的字体设置(字体按设置从左到右的顺序优先匹配)<PT134511 [7.3.1260.6] 之后支持>-->
<add key="BrowserFontFamilys" value="{2052:'Arial, SimSun', 1033:'Arial', 3076:'Arial, SimSun, MingLiU, PMingLiU'}" />
<!--例如: <add key="BrowserFontFamilys" value="{2052:'Arial, SimSun, (你的特殊字体写这里)', 1033:'Arial', 3076:'Arial, SimSun, MingLiU, PMingLiU'}" />-->
<!--客户端请求失败重试次数(=-1:客户端本地设置为准[默认];=0:不重试;>0:重试次数)
相关参考:https://vip.kingdee.com/article/10617 -->
<add key="RequestRetryLimit" value="-1" />
<!--登录界面检测启动本地服务情况(=0:不检查;=1:自动启用检查功能,浏览器生成模拟数据后,系统就以模拟的为准,不再实时去尝试获取本地服务的数据了。这样也可以避免启动本地服务后,锁定终端失效。直到浏览器清除本地数据或浏览器恢复出厂设置为止。)-->
<add key="AutoCheckLocalServiceTray" value="1" />
<!--资源使用绝对路径-->
<add key="UseResAbsolutePath" value="False" />
<!--启用HTML5的动态流式配置V2-->
<add key="FluidSeting" value="true" />
<!--强制启用安全的Asp.Net_SessionId的Cookie链接;也可在Web.Config中配置<httpCookies httpOnlyCookies="true" requireSSL="true"/>实现-->
<add key="IsAspNetSecureCookie" value ="True"/>
<!--强制启用安全的Cookie链接;也可在Web.Config中配置<httpCookies httpOnlyCookies="true" requireSSL="true"/>实现-->
<add key="IsSecureCookie" value ="True"/>
<!--启用HTTP请求压缩-->
<add key="SL_Http_Compressed" value="true"/>
<!--参数已经废弃,C端依据数据自动判断-->
<add key="ResponseUnzip" value="true"/>
<!--异常跟踪日志层级:0=业务级/100=程序级;-->
<add key="StackTraceLevel" value ="0"/>
<!--强制用调试模式,只有在AllowDebugMode为True或者不设置的情况下生效-->
<!--<add key="IsDebugMode" value="False" />-->
<!--是否启用新版提示栏风格 false不启用 其他启用-->
<add key="IsEnableNewStyleOfTipbar" value="true" />
<!--允许客户端启用调试模式,目前主要用于HTML5端-->
<add key="AllowDebugMode" value="False" />
<!--启动服务插件(默认登录插件,支持云之家登录,V2 参数协议为JSON格式)-->
<add key ="StartAppPlugin" value="Default" />
<!--默认为操作系统默认编码,例如简体服务器为GB2312编码器,如果需要制定,可以用下面参数指定utf-8-->
<!--如果提示登陆参数的格式或编码异常,如存在双字节字符,请使用UTF8格式对参数编码。可以用下面参数指定utf-8-->
<add key ="StartAppPluginUDConfig" value="{encoding:'utf-8'}" />
<!--启用缓存更新通知机制-->
<add key="IsNoticeUpdateCache" value="false" />
<!-- 公有云WebApi网关请求限制 -->
<add key="RequiredApiGW" value="true" />
<!-- 激活桌面客户端WPF的链式请求 (2019-12-31 PT145060 [7.5.1507.2] )
相关参考:https://vip.kingdee.com/article/170666 -->
<add key="SeqReqEnabled" value="true" />
<!-- 启用通讯隔离队列,(2019-12-31 PT145060[7.5.1507.2] )默认不设置为false,false为不启用 -->
<add key="KDSVCQueueEnabled" value="true" />
<!--元数据是否启用平行扩展支持(false)-true按节点的Seq顺序加载--false按扩展先后顺序加载-->
<add key="IsEnableParallelExtendMetaData" value="False" />
<!--H5新用户登入后是否跳过角色选择界面直接进入主控台 (2019-05-09 PT134511 [7.3.1260.6] )-->
<add key="IsSkipH5RoleSelectionInterface" value="true" />
<!-- 浏览器安全权限限制,JS脚本仅能调用浏览器打印接口window.print()输出html元素,不能设置任何打印机参数-->
<!-- 强制HTML5使用浏览器打印机打印 (2019-05-23 PT136143 [7.3.1275.3] )-->
<add key="SpecH5PrintDrv" value="KDHTMLPrinter" />
<!--登录界面不显示二维码 2019-06-27 PT136657 [7.3.1310.2] -->
<add key="IsShowQRCodeLogin" value="false" />
<!--登录后不显示已有的登录信息,也就是不提示踢人 kickout-->
<add key="IsShowLoggedInMessage" value="false" />
<!--显示不同地址登录提示消息 2020-4-2 -->
<add key="IsShowDiffLoginAddressRemind" value="false" />
<!--是否预加载二开插件-->
<add key="IsEnableLoadPlugsDLL" value="false" />
<!-- 登录界面选择数据中心是否手工录入 配置1和0,是=1 否=0 ; PT116278 [7.0.352.16]-->
<add key="IsLoginManualInputDC" value="1" />
<!-- locked terminal-->
<add key="AutherCfg" value="App_Data\AutherCfg.config" />
<!--禁用WebAPI非第三方登陆接口, 2020-08-27 BOS -->
<add key="IsDisableNoThirdLogin" value="true" />
<!--定制化登录界面-->
<add key ="CustomLoginUI" value="Kingdee.XPF.CustomControlPlugins.CustomLoginUI, Kingdee.XPF.CustomControlPlugins" />
<!--当定制化登录界面构建失败时,允许使用默认的登录界面代替-->
<add key ="AllowCustomUseDefLoginUI" value="true" />
<!--设置X-Frame-Options 默认值,website/web.config下的customheaders子项x-frame-options相关项需要移除才能生效 2020-08-27 BAS -->
<add key="DefaultFrameOptions" value="SAMEORIGIN" />
<!--设置X-Frame-Options 白名单,注意多个域名要用分号隔开,同时 Web.config的customheaders子项x-frame-options相关项要去掉相关设置, 2020-08-27 BAS -->
<add key="FrameOptionsWhiteList" value="yunzhijia.com;kingdee.com" />
<!-- off permission log-->
<add key="_perActionCreateDebuggerLog" value="off" />
<!-- 设置value="true" 来屏蔽默认进行社区搜索的功能, 2020-10-15 [7.5.1.202010] -->
<add key="UnCommunitySolutionSearchMode" value="true" />
<!-- 关闭外网服务 send ubd off 2017-10-19 PT117342 -->
<add key="SendUserBehaviorData" value="false" />
<!--HTML5页面退出时提示,true提示,false不要提示, 2020-11-12 --->
<add key="IsUnloadConfirm" value="true" />
<!--BOS平台参数,检查应用服务器服务是否存在死循环参数,<=0不检查,>0为检查层级,默认配置值可能为80-->
<add key="EndlessLoopMaxTimes" value="0" />
<!--列表过滤行-->
<add key="ListShowFilterRow" value="true" />
<!--Sql关键字黑名单-->
<add key="SqlKeys" value="select|insert|delete|from|drop|update| |count|chr|char|mid|truncate|exec| |net user|or|and|xp_cmdshell"/>
<!--脚本关键字黑名单-->
<add key="ScriptKeys" value="&|"|>|<"/>
<!--上传白名单文件扩展名-->
<add key="UploadWhiteList" value="txt,pdf,doc,docx,xls,xlsx,ppt,pptx,rft, ,jpg,png,bmp,gif,jpeg,rar,zip,dat, ,key,msg,cad,btw,avi,rmvb,wps,et,dps,vsd" />
<!--上传白名单支持文档扩展名-->
<add key="DocSuffix" value="doc|docx|xls|xlsx|pdf|ppt|pptx|txt|wps|rtf|et|dps|vsd" />
<!--上传白名单支持图片扩展名-->
<add key="ImageSuffix" value="jpeg|jpg|png|gif|bmp|cur" />
<!--上传白名单支持视频扩展名-->
<add key="VideoSuffix" value="wmv|avi|swf|wav|mpeg|aif|mdi|mpg|rmvb|flv|mkv" />
<!--上传白名单支持补丁包扩展名-->
<add key="PackageSuffix" value="kdpkg" />
<!-- 记录日志开关 -->
<add key="OpenLogModel" value="true"/>
<!--WebApi Log-->
<add key="OpenWebApiLogModel" value="true"/>
<!--单据是否支持块选择,默认True支持-->
<add key="AllowCellSection" value="false" />
<!--不启用NLP后台更新job服务 (2021-04-22)-->
<add key="EnableNLPJob" value="false"/>
<!--true 登陆主控的时屏蔽公有云链接以及产品端不触发MQ服务,不获取线上课程-->
<add key="ERPCloudDebug" value="true" />
<!--显示不同地址登录提示消息 2020-4-2 -->
<add key="IsShowDiffLoginAddressRemind" value="false" />
<!--禁用登录后右下角浮动提示-->
<add key="AllowUserLoginTopTip" value="false"/>
<!--启动机器人轮询秒数,小于等于0则不启动,h5界面上也不显示-->
<add key="RobotCycle" value="0" />
<!-- url 跳转DForm页面连接参数敏感信息进行压缩编码。(PT-146867 2021-03-11) -->
<add key="plainTextUrlCtxParam" value="True"/>
<!--HTML5端默认编码了apx参数,采用GZIP+URLEncode编码,=false则恢复为明文参数模式 (PT-146884 [7.7.0.202108] 2021/8/6 build:7.7.2256.5)-->
<add key="compressedapx" value="false"/>
<!--返回数据纯文本格式指定,不配置默认为true(PT-146899 [7.7.0.202112], 2021/12/16, build:7.7.2388.8)-->
<add key="UseKDSVCTextPlain" value="true"/>
<!-- 启用输入校验WAF,(7.x) -->
<add key="IsInputBlock" value="True"/>
<!-- 2022-09-29 强制更新客户端所有组件 -->
<add key="CheckHashCode" value="1" />
<!-- (PT-146884 [7.7.0.202108] 发布时间:2021/8/6 构建号:7.7.2256.5) HTML5系统版本扩展参数, 启用副版本编号强制更新HTML5资源, 如多次更新前端资源文件,调整为不同的值即可, -->
<add key="systemExtensionSubversion" value="20220817" />
<!-- (PT-146926 [8.0.0.20220922] 发布时间:2022/9/22 构建号:8.0.361.9) 不要自动纠正路径的特殊字符xss注入设置为 value="false", 需要纠正则设置为空或默认值 value="['\(\)\<\>]" , value允许正则表达式自定义,例如:强制转义 [`'\(\)\s\<\>\&\=] 为下划线 -->
<add key="__DirPathXssCharsPattern__" value="[`'\(\)\s\<\>\"\&\=]" />
<!-- (V7.7 PT-146884 [7.7.0.202108] 构建号:7.7.2256.5) 通过系统参数开关控制是否自动填充历史登录用户名称 -->
<add key ="IsNotLoginUserByHistory" value="true" />
<!-- (PT-146903 [8.0.0.202202] ,2022/2/17 build:8.0.144.1) 启用金蝶自研HTML5列表表格KDVGrid Beta v1.0 试用版本,支持大数据基本功能展示,-->
<add key="enableListKDVGrid" value="true" />
3、答疑篇
【疑问1】:如何关闭BizTips 业务提示语服务配置:
【答】:可配置提示语功能开关参数为关闭状态即可;
<!--启用提示语中心, false关闭提示语服务-->
configuration/packageConfig/bizTipsServerSetting/Enabled = false
<!--启用 远程提示语中心, false 关闭远程提示语中心服务-->
configuration/packageConfig/bizTipsServerSetting/CenterEnabled = false
【疑问2】:拷贝出来的配置代码段经常报错?
【答】:因为论坛转换为全角空格的原因,具体参考文章的处理方案【从论坛复制的代码,经常导致配置网站报错?】 https://vip.kingdee.com/article/158166130920311808
【疑问x】:place holder
【答】:place holder
。。。。。。
编辑于2021年7月23日 17:04:24
编辑于2021年8月13日 16:06:00
推荐阅读