Common.config配置原创
金蝶云社区-yaojunsong
yaojunsong
22人赞赏了该文章 8,133次浏览 未经作者许可,禁止转载编辑于2023年04月17日 10:05:13
summary-icon摘要由AI智能服务提供

本文主要介绍了Common.config配置文件的修改和使用方法,该文件位于应用服务器的WebSite/app_data目录下,用于配置站点的全局参数。文章强调了修改文件时需保存为UTF-8 withSign格式,并提供了修改前的备份和格式检查建议。文中列出了多个可在下添加或修改的配置项,包括字体设置、请求重试次数、本地服务检查、资源路径、Cookie安全、请求压缩、日志记录等,每项配置均附有详细说明和参考链接。此外,还涉及了缓存更新通知、登录界面设置、WebApi请求限制、用户权限、上传文件白名单等多个高级配置项。

Common.config配置


1、站点的全局配置参数可以在应用服务器WebSite/app_data/common.config里面添加修改

1.1、  注意保存文件是要保存成UTF-8 withSign的格式

重点提示

    a、修改前请备份好,修改后查看是否正确可以在保存后,重新打开看看是否存在中文乱码现象,如果存在说明格式错误;

    b、确保键值Key只出现一次,不要重复出现;

    c、从论坛拷贝代码注意中文空格问题,详细参考文章末尾的答疑篇:疑问2)。


1.2、  common.config在应用服务器的安装目录下,例如下图位置:

image.png



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="&amp;|&quot;|&gt;|&lt;"/>

    <!--上传白名单文件扩展名-->

    <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"/>

    <!-- 是否接受在线广告消息 -->
    <add key="ReceiveAdvertisement" 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.5HTML5系统版本扩展参数, 启用副版本编号强制更新HTML5资源, 如多次更新前端资源文件,调整为不同的值即可, --> 

    <add key="systemExtensionSubversion" value="20220817" />

    <!-- (PT-146926 [8.0.0.20220922] 发布时间:2022/9/22 构建号:8.0.361.9 不要自动纠正路径的特殊字符xss注入设置为 value="false",  需要纠正则设置为空或默认值 value="['\(\)\&lt;\&gt;]" , value允许正则表达式自定义,例如:强制转义 [`'\(\)\s\<\>\&\=] 为下划线 -->

    <add key="__DirPathXssCharsPattern__" value="[`'\(\)\s\&lt;\&gt;\&quot;\&amp;\=]" />

    <!-- (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

image.png




疑问2】:拷贝出来的配置代码段经常报错

【答】:因为论坛转换为全角空格的原因,具体参考文章的处理方案【从论坛复制的代码,经常导致配置网站报错?】 https://vip.kingdee.com/article/158166130920311808




疑问x】:place holder  

【答】:place holder


。。。。。。

编辑于2021年7月23日 17:04:24

编辑于2021年8月13日 16:06:00

 

图标赞 22
22人点赞
还没有人点赞,快来当第一个点赞的人吧!
图标打赏
0人打赏
还没有人打赏,快来当第一个打赏的人吧!