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://wenku.my7c.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://wenku.my7c.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"/>

    <!--启动机器人轮询秒数，小于等于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="['\(\)\&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

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

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

【疑问x】：place holder  

【答】：place holder

。。。。。。

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

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

<!--关闭消息实时配置 7.7（ 5号） 2021-12-02--> 

<add key="_isEnabledMessage" value="false" /> 

<!--关闭预警消息实时配置--> 

<add key="_isEnabledRealTimeWarn" value="false" /> 

<!--关闭跨站点消息实时提醒配置--> 

<add key="OpenCrossProMessage" value="false" />

2023-04-17之后统一转《知识》板块的下面链接进行维护：

【Common.config配置】 https://vip.kingdee.com/article/435743306681839104 

IsCloudExperienceEvn 体验环境参数

<add key="IsOpenCloudRegion" value="False"/>

IsNotShowCharacteristicGate 

你好，为什么我修改过common之后，打开客户端会卡在正在装载组件的界面

http://xxx.xxx.xxx.xxx/K3Cloud/Clientbin/K3CloudClientPortal.exe

下载引导程序

客户端的代理配置：

在对应用的配置文件(e.g:桌面客户端为：Kingdee.BOS.XPF.App.exe.config) 

的 <appSetting> 中添加 <add key="HostProxy" value="{代码服务器地址:http://localhost:8888}"/>

二次开发代码需遵守二次开发规范性要求，详细说明参考链接：https://open.kingdee.com/K3Cloud/Open/DevelopSpecs.html

一般操作系统字体名称：

https://vip.kingdee.com/article/147746