定义应用中使用的额外数据存储的名称。

在所有标准的 blocks 中都可以使用。

示例：

启用通用过滤器的级联过滤模式。参考 级联查询（Sequential Queries）。

默认值： true

保存在数据库。

配置接口： GlobalConfig

可以在 Web 客户端和 Middleware 这两个 block 使用。

用来创建匿名用户会话的用户名称。（参考 cuba.anonymousSessionId）。

默认值： anonymous

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

定义匿名用户会话的 UUID，此会话可以在没有用户登录的状态下使用。在服务启动的时候，会自动创建这个匿名会话。参考 cuba.anonymousLogin。

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

定义服务器是否在应用程序启动时运行数据库更新脚本。

默认值： false

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

支持的用户界面语言列表。

属性格式： {language_name1}|{language_code_1};{language_name2}|{language_code_2};…​

示例：

{language_name} – 显示在可用语言列表中的语言名称。比如这个列表会被用在登录界面提供给用户选择系统语言，也在用户编辑界面，编辑用户的语言。

{language_code} – 对应于 Locale.getLanguage() 方法返回的语言代码。用来作为语言包文件名称的后缀，比如，messages_fr.properties。

如果语言列表中没有跟用户操作系统语言相匹配的条目，那么 cuba.availableLocales 属性定义的语言列表的第一个语言将被用来作为默认语言。否则，即会选择跟用户操作系统语言相匹配的做为默认语言。

默认值： English|en;Russian|ru;French|fr

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

活跃的后台任务的最大值。

默认值： 100

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义检查后台任务超时的间隔，单位是毫秒。

默认值： 5000

配置接口： ClientConfig

可以在 web 客户端使用。

启用针对野蛮破解密码的保护措施。

默认值： false

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

超过最大失败登录尝试次数之后屏蔽登录的时间间隔，单位是秒，需要先启用 cuba.bruteForceProtection.enabled。

默认值： 60

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

针对用户名和登录 IP 设定的最大失败登录尝试次数，需要先启用 cuba.bruteForceProtection.enabled。

默认值： 5

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

当设置为 false（默认值）时，客户端块 block 的 LoginPasswordLoginProvider 将用户密码明文发送给中间件的 AuthenticationService.login() 方法。在客户端和中间件 block 共同位于同一 JVM 中的情况下，这是合适的处理方式。对于客户端块(block)位于网络上的其它计算机上的分布式部署的情况，客户端和中间件之间的连接应使用 SSL 加密。

如果设置为 true，LoginPasswordLoginProvider`本身将通过输入的登录名加载 `User 实体并检查密码。如果密码与加载的密码哈希匹配，则提供程序使用cuba.trustedClientPassword 属性中指定的密码作为可信客户端执行登录。此模式使您无需在受信任网络中的客户端和中间件之间设置 SSL 连接，同时不会向网络公开用户密码：仅传输哈希值。但请注意，可信客户端密码仍然通过网络传输，因此受 SSL 保护的连接仍然更加安全。

默认值 ： false

接口： WebAuthConfig, PortalConfig, RestApiConfig

可在 Web 和 Porta block 使用。

启用 Middleware 服务集群中各个服务之间的互相交互。参考 配置多个 Middleware 服务交互。

默认值： false

可以在 Middleware block 使用。

JGroups 配置文件的路径。平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

示例：

默认值： jgroups.xml

可以在 Middleware block 使用。

限制 Middleware 集群中消息队列的长度。当消息队列超过了最大长度，新消息会被拒绝。

默认值： Integer.MAX_VALUE

可以在 Middleware block 使用。

设置节点启动时从集群接收最新状态的超时时间。单位是毫秒。

默认值： 10000

可以在 Middleware block 使用。

为应用程序 block 设置配置文件目录的位置。

对于 Tomcat 快速部署，默认值：${catalina.home}/conf/${cuba.webContextName}，指向 tomcat/conf 目录下 web app 名称的目录，比如 tomcat/conf/app-core。

对于 WAR 和 UberJAR 部署情况：${app.home}/${cuba.webContextName}/conf，指向应用程序根目录下的一个目录。

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

在客户端 block 设置连接 Middleware 读取超时的时限。平台会将非负值传递给 URLConnection 的 setReadTimeout() 方法。

也可参考 cuba.connectionTimeout。

默认值： -1

可以在 Web 客户端，Web Portal blocks 使用。

在客户端 block 设置连接 Middleware 超时的时限。平台会将非负值传递给 URLConnection 的 setConnectTimeout() 方法。

也可参考 cuba.connectionReadTimeout。

默认值： -1

可以在 Web 客户端，Web Portal blcoks 使用。

为客户端 blocks 设置连接 Middleware 服务的 URL。

此属性的值应该包含多个用英文逗号分隔 URL http[s]://host[:port]/app-core，host 是服务器名称，port 是服务器端口，app-core 是 Middleware web app 的名称。比如：

当使用 Middleware 服务集群的时候，这些服务的地址需要用英文逗号分隔：

细节参考 配置连接 Middleware 集群。

也可参考 cuba.useLocalServiceInvocation。

配置接口： ClientConfig

可以在 Web 客户端，Web Portal blcoks 使用。

累加属性定义 credits.xml 文件。此文件包含应用程序使用的软件组件信息

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

可以在 Web 客户端 block 使用。

示例：

DataManager 从不同数据存储批量加载关联实体的最大值。

默认值： 50

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

配置在 Middleware 调用 DataManager 时是否启用安全限制。

默认值： false

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

定义应用数据库连接中使用的 javax.sql.DataSource 的 JNDI 名称。

默认值： java:comp/env/jdbc/CubaDS

可以在 Middleware block 使用。

为应用程序 block 设置工作目录的位置。

对于 Tomcat 快速部署，默认值：${catalina.home}/work/${cuba.webContextName}，指向 tomcat/work 目录下 web app 名称的目录，比如 tomcat/work/app-core。

对于 WAR 和 UberJAR 部署情况：${app.home}/${cuba.webContextName}/work，指向应用程序根目录下的一个目录。

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

设置数据库脚本目录的位置。

对于 Tomcat 快速部署，默认值：${catalina.home}/webapps/${cuba.webContextName}/WEB-INF/db，指向 Tomcat 中 web app 的 WEB-INF/db 子目录。

对于 WAR 和 UberJAR 部署情况：web-inf:db，指向 WAR 或者 UberJAR 内的 WEB-INF/db 目录。

配置接口： ServerConfig

可以在 Middleware block 使用。

定义 DBMS 类型。跟 cuba.dbmsVersion 一起作用，影响对于 DBMS 集成接口实现的选取，以及查找数据库初始化和更新脚本。

参考 DBMS 类型 了解细节。

默认值： hsql

可以在 Middleware block 使用。

可选属性，设置数据库版本。跟 cuba.dbmsType 一起作用，影响对于 DBMS 集成接口实现的选取，以及查找数据库初始化和更新脚本。

参考 DBMS 类型 了解细节。

默认值： none

可以在 Middleware block 使用。

定义包含用户默认权限的一组文件。当没有为许可对象设置角色的时候，会使用默认权限值。通常用来为“拒绝”角色使用，参考 default-permission-values.xml 章节了解更多信息。

默认值： cuba-default-permission-values.xml

可以在 Middleware block 使用。

示例：

设置默认的数据库事务超时时限.

默认值： 0 (no timeout).

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

定义一组数据存储，对于这些数据存储，平台会在 filters 中对使用了 LIKE 操作符的 JPQL 查询禁用转义。

保存在数据库。

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

对扩展实体，禁用自动生成 orm.xml 文件的功能。

默认值： false（如果存在扩展实体，则会自动创建 orm.xml）。

可以在 Middleware block 使用。

累加属性，为客户端 block 定义 dispatcher-spring.xml 文件。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

可以在 Web 客户端和 Web Portal blocks 使用。

示例：

定义一组文件目录，Middleware 可以从这些文件目录通过 com.haulmont.cuba.core.controllers.FileDownloadController 下载文件。比如，web 客户端系统菜单的 Administration > Server Log 就是利用这个机制下载 log 文件进行展示。

目录列表需要使用英文分号分隔。

默认值： ${cuba.tempDir};${cuba.logDir} (可以从临时文件夹 and the 日志文件夹目录下载文件)。

可以在 Middleware block 使用。

定义文件存储目录结构的根目录。更多信息，参考 标准文件存储实现。

默认值： null

配置接口： ServerConfig

可以在 Middleware block 使用。

向后兼容的开关。如果设置为 true，在软删除模式开启的情况下，开启为软删除的实体执行 delete from 的 JPQL 语句（软删除开启的情况，对实体只是运行 update 而非 delete）。这样的 delete 语句会被转换成删除所有没有标记为“已删除”的数据。这样的话，有点违反直观理解，所以默认情况下是关闭此功能的。

默认值： false

可以在 Middleware block 使用。

向后兼容的开关。如果设置为 false，在数据源查询过滤器和界面过滤器组件的过滤条件会被应用一次，至少会使用一个参数；会话（session）参数不会起作用。

默认值： true

可以在 web 客户端 block 使用。

如果设置为 true，在 Middleware 开启实体属性权限检查。如果设置为 false，属性权限检查则在客户端层做，比如在 Generic UI 或者 REST API。

默认值： false

保存在数据库。

可以在 Middleware block 使用。

开启实体日志机制。

默认值： true

保存在数据库。

配置接口： EntityLogConfig

可以在 Middleware block 使用。

在执行 Scripting.evaluateGroovy() 方法的过程中，设置资源池中未使用的编译过的 Groovy 表达式的最大值。当需要集中执行 Groovy 表达式的时候，推荐将这个值设置得大一些，比如，按照应用程序目录的数量来设置。

默认值： 8

在所有标准的 blocks 中都可以使用。

在执行脚本的时候，定义一组需要被所有 Groovy 表达式引入的类。

列表中的类名需要使用英文逗号或者分号分隔。

默认值： com.haulmont.cuba.core.global.PersistenceHelper

在所有标准的 blocks 中都可以使用。

示例：

影响的过滤器组件行为。

当设置为 true，不允许执行不指定参数的过滤器。

默认值： false

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

为过滤器组件定义含有过滤条件的列的数量。

默认值： 3

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

定义在过滤器组件中条件面板的位置。两种位置可以选择：top（在过滤器控制器元素之上）和 bottom（在过滤器控制器元素之下）。

默认值： top

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

为过滤器组件的控制器布局设置模板。每个控制器有这样的格式：[component_name | options-comma-separated]，比如，[pin | no-caption, no-icon]。

可用的控制器：

以下这些操作可以在 settings 中作为选项使用：save - 保存, save_as - 另存为, edit - 编辑, remove - 删除, pin - 固定位置, make_default - 设置默认, save_search_folder - 保存搜索目录, save_app_folder - 保存应用目录, clear_values - 清空。

这些操作也可以在 Settings 弹窗外作为单独的控制器使用。这种情况下，它们可以做如下设置：

默认值：

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

影响过滤器组件的行为。

当设置为 true，包含过滤器的界面不会自动加载相应的数据源，需要用户手动点击过滤器的 Apply 按钮。

当使用应用或者查找目录打开界面的时候，cuba.gui.genericFilterManualApplyRequired 的设置会被忽略，因为此时过滤器已经生效了。但是对于某个查找目录如果它的 applyDefault 设置为 false，过滤器不会生效。

默认值： false

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

定义过滤器组件中 Show rows 下拉框中的选项值。

NULL 选项表示这个列表需要包含一个空值。

默认值： NULL, 20, 50, 100, 500, 1000, 5000

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

定义在 Search 按钮的弹窗列表中显示项目的数量。如果过滤器的数量超过了这个值，则会添加 Show more…​ 到列表最后，这个行为会打开一个新的弹窗用来显示其它的过滤器。

默认值： 10

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

定义所有的通用过滤器是否需要去掉输入值两端的空格。当设置为 false，文本过滤器将保留空格。

默认值： true

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

可以禁用主窗口标签页以及模式窗口标题的右键菜单中的界面分析器。

默认值： true

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

定义在下拉框控件和下拉框选择器控件中下拉列表一页显示的选项默认数量。可以通过 XML 属性 pageLength 在具体实例中覆盖这个参数的设置。

默认值： 10

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端使用。

如果此属性设置为 true，界面不会在关闭时自动保存界面设置。在这个模式下，用户可以通过右键点击界面 tab 标签或者弹窗的标题类保存或者重置界面设置。

默认值： false

配置接口： ClientConfig

保存在数据库。

可以在 Web 客户端 block 使用。

启用在 Table 右键菜单和 PopupButton 中显示动作的图标。

默认值： false

保存在数据库。

配置接口： ClientConfig

可以在 web 客户端 block 使用。

启用在 System Information 窗口创建/更新/获取实体实例的时候显示 SQL 脚本。

这些脚本实际上显示的选中实体实例的数据库行内容，而不管是否有安全设置可能禁止显示某些实体属性。所以这就是为什么除了 administrator 用户之外需要取消其它所有用户角色的 CUBA / Generic UI / System Information 特殊权限。也可以通过设置 cuba.gui.systemInfoScriptsEnabled 为 false 在整个应用级别禁止这个功能。

默认值： true

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

当用户关闭带有未保存改动数据源的界面时，定义对话框的布局样式。

true 对应带有三个功能的布局：Save changes - 保存修改, Don’t Save - 不保存修改, Don’t close the screen - 不关窗口。

false 对应带有两个功能的布局：Close the screen without saving changes - 关闭窗口不保存修改, Don’t close the screen - 不关窗口。

默认值： true

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

定义标准的界面验证错误的通知消息类型。

可选值是 com.haulmont.cuba.gui.components.Frame.NotificationType 枚举类型的元素：

默认值： TRAY.

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

针对实体组合采用 JOINED 的继承策略。如果设置为 true，为在数据库插入新实体提供正确的顺序。

默认值： false

定义从应用健康检查 URL 请求返回的文本。

默认值： ok

配置接口： GlobalConfig

可以用在所有 blocks。

定义 HTTP 会话非活动状态的超时时限，单位为秒

默认值： 1800

配置接口： WebConfig

可以在 web 客户端 block 使用。

累加属性用来定义图标集合.

可以在 Web 客户端 block 使用。

示例：

启用基于内存的重复记录过滤，而不使用数据库级别的 select distinct。用在 DataManager 中。

默认值： false

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

定义可以用在系统认证的用户名。

默认值： admin

可以在 Middleware block 使用。

作为实体安全令牌（security token）AES 加密的密钥。当实体通过下面方式在 Middleware 加载的时候，这个令牌会放置在实体实例内发送：

尽管安全令牌不包含任何属性值（只有属性名称和过滤了的实体标识符），仍然高度建议在生产环境中修改默认的加密密钥值。

默认值： CUBA.Platform

配置接口： ServerConfig

可以在 Middleware block 使用。

当继承了 BaseLongIdEntity 或者 BaseIntegerIdEntity 的实体实例通过 Metadata.create() 方法在内存创建的时候，会给创建的实体分配一个唯一标识符。这个值通过从数据序列取下一个值的机制得到的。为了减少对 Middleware 和数据库调用的次数，序列每次的增加值默认是设置的 100，也就是说平台每次从数据库调用一次能获取 100 个 id。也就是说按照这种方式“缓存”了序列值，直到 100 个 id 用完之前都可以直接从内存获取 id。

这个属性定义了每次序列自增的值，以及对应的内存中缓存的大小。

默认值： 100

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

与cuba.passwordEncryptionModule 相同，但这个配置是用于为在旧版本中（版本 7 之前）创建并且 SEC_USER.PASSWORD_ENCRYPTION 字段为空的用户定义用于用户密码哈希的 bean 的名称。

默认值： cuba_Sha1EncryptionModule

用于所有所标准 block。

登录时禁用用户界面语言选择。

如果 cuba.localeSelectVisible 设置成 false，用户会话的 locale 会按照下面方式选择：

默认值： true

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

为应用程序 block 设置日志目录的位置。

对于 Tomcat 快速部署，默认值：${catalina.home}/logs，指向 tomcat/logs 目录。

对于 WAR 和 UberJAR 部署情况：${app.home}/logs，指向应用程序根目录下的 logs 目录。

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

累加属性，为一个 block 定义主语言包。

属性值可以包含单一语言包，或者用空格分隔的语言包列表。

在所有标准的 blocks 中都可以使用。

示例：

定义可以使用文件上传控件和多个文件上传控件组件能上传的文件大小的最大值，单位是 MB。

默认值： 20

保存在数据库。

配置接口： ClientConfig

可以在 Web 客户端 block 使用。

累加属性，定义 menu.xml 文件。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

可以在 Web 客户端 block 使用。

示例：

累加属性，定义 metadata.xml 文件。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

在所有标准的 blocks 中都可以使用。

示例：

定义用作用户密码 Hash 的 bean 名称。创建新用户或更新用户密码时，将在 SEC_USER.PASSWORD_ENCRYPTION 数据库字段中为该用户存储此属性的值。

参阅 cuba.legacyPasswordEncryptionModule。

默认值：cuba_BCryptEncryptionModule

在所有标准的 blocks 中都可以使用。

启用强制密码策略。如果此属性设置为 true，所有新的用户密码都会按照 cuba.passwordPolicyRegExp 属性定义的策略检查。

默认值： false

保存在数据库。

配置接口： ClientConfig

使用在所有的客户端 blocks：web 客户端，web Portal。

定义一个正则表达式，用来做密码检查策略。

默认值：

((?=.*\\d)(?=.*\\p{javaLowerCase}) (?=.*\\p{javaUpperCase}).{6,20})

上面这个表达式确保密码需要包含 6～20 个字符，使用数字和英文字母，包含至少一个数字，一个小写字母，一个大写字母。更多关于正则表达式语法可以参考 https://en.wikipedia.org/wiki/Regular_expression 和 http://docs.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html 。

保存在数据库。

配置接口： ClientConfig

使用在所有的客户端 blocks：web 客户端，web Portal。

如果需要禁用 PerformanceLogInterceptor，此参数必须要设置为 true。

PerformanceLogInterceptor 通过类或者方法的 @PerformanceLog 注解触发，此拦截器会在 perfstat.log 文件中记录每次方法的调用记录以及执行时间。如果不需要这些日志，建议禁用 PerformanceLogInterceptor 以提高性能。如需重新启用，删除此参数或者设置为 false。

默认值： false

可以在 Middleware block 使用。

应用程序在做性能测试的时候必须设置成 true。

配置接口： GlobalConfig

默认值： false

可以用在 Middleware 和 web 客户端。

累加属性，用来定义 permissions.xml 文件。

可以在 Web 客户端 block 使用。

示例：

累加属性，用来定义 persistence.xml 文件。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

在所有标准的 blocks 中都可以使用。

示例：

定义在 Web Portal block 可以做匿名用户会话的用户名称。

此属性设置的用户名需要在安全子弟痛存在，并且有需要的权限。不需要为此用户设置密码，因为匿名用户会话是通过 loginTrusted() 方法创建的，使用的是 cuba.trustedClientPassword 属性定义的密码。

配置接口： PortalConfig

可以在 Web Portal block 使用。

如果设置为 false，查询缓存功能禁用。

默认值： true

配置接口： QueryCacheConfig

可以在 Middleware block 使用。

设置查询缓存实体数量的最大值。一条缓存记录是通过查询语句文本，查询语句参数，分页参数以及软删除配置确定。

由于缓存大小会慢慢增长到最大值，所以缓存机制会清除掉那些不大可能会被再次使用的记录。

默认值： 100

配置接口： QueryCacheConfig

可以在 Middleware block 使用。

累加属性，用来定义 Middleware block 的 remoting-spring.xml 文件。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

可以在 Middleware block 使用。

示例：

定义英文逗号分隔的可以访问 REST API 的来源。需要开启跨域访问时可以用这个参数。

默认值： *

可以在 Web 客户端和 Web Portal blocks 使用。

对匿名用户启用 REST API 访问。

默认值： false

可以在 Web 客户端和 Web Portal blocks 使用。

为默认的 REST API 客户端定义支持的许可类型列表。需要禁用刷新令牌（refresh token），可以从列表中删除 refresh_token。

默认值： password,external,refresh_token

可以在 Web 客户端和 Web Portal blocks 使用。

定义 REST API 客户端的标识符。客户端，在这里，并不是说平台的用户，而是一个使用 REST API 的应用（某些 web portal 或者手机 app）。使用客户端用户名密码做访问 REST API token 端点的基本认证。

默认值： client

可以在 Web 客户端和 Web Portal blocks 使用。

定义 REST API 客户端的密码。客户端，在这里，并不是说平台的用户，而是一个使用 REST API 的应用（某些 web portal 或者手机 app）。使用客户端用户名密码做访问 REST API token 端点的基本认证。应用程序属性的值需要在具体的密码值（比如 secret）之前包含一个 PasswordEncoder 的标识符（比如 {noop}）。

默认值： {noop}secret

可以在 Web 客户端和 Web Portal blocks 使用。

定义默认客户端 REST API 访问令牌过期时间的时限，单位是秒。

默认值： 43200 (12 小时)

可以在 Web 客户端和 Web Portal blocks 使用。

定义默认客户端 REST API 刷新令牌过期时间的时限，单位是秒。

默认值： 31536000 (365 天)

可以在 Web 客户端和 Web Portal blocks 使用。

指定用来做定时任务的表达式，从数据库删除过期的令牌。

默认值： 0 0 3 * * ?

可以在 Middleware block 使用。

累加属性，用来定义 REST API 使用的 JSON 转换配置文件，这些文件在客户端请求一些特殊版本数据模型的信息时会用到。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

文件的 XSD schema： http://schemas.haulmont.com/cuba/7.0/rest-json-transformations.xsd.

默认值： none

示例：

可以在 Web 客户端和 Web Portal blocks 使用。

可以使用 REST API 上传的文件大小的最大值，单位是字节。

默认值： 20971520 (20 Mb)

可以在 Web 客户端和 Web Portal blocks 使用。

如果在 JSON 中提供了实体的 version 属性，启用 Versioned 实体的乐观锁。

默认值： false

可以在 Web 客户端和 Web Portal blocks 使用。

如果是 true，会在加载的实体中包含一个特殊的系统属性，并且需要在保存实体的时候给 REST 接口传回一个同样的属性。细节参考 集合属性的安全约束。

默认值： false

可以在 Web 客户端和 Web Portal blocks 使用。

定义是否可以重复使用刷新令牌。如果设置为 false，当使用刷新令牌获取访问令牌的时候，系统会发出一个新的刷新令牌，老的刷新令牌将会失效。

默认值： true

可以在 Web 客户端和 Web Portal blocks 使用。

累加属性，用来定义包含应用 REST API 对应的 services 列表的文件。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

文件的 XSD schema： http://schemas.haulmont.com/cuba/7.0/rest-services-v2.xsd.

默认值： none

示例：

可以在 Web 客户端和 Web Portal blocks 使用。

启用在数据库保存 REST API 安全令牌。默认情况下，令牌只是在内存中存储。

保存在数据库。

配置接口： ServerConfig

默认值： false

可以在 Middleware block 使用。

设置是否在应用程序日志中对 REST API 进行掩码处理。

默认值： true

可以在 Web 客户端和 Web Portal blocks 使用。

累加属性，用来定义包含应用程序 REST API 可用的 JPQL 查询列表的文件。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

文件的 XSD schema： http://schemas.haulmont.com/cuba/7.0/rest-queries.xsd.

默认值： none

示例：

可以在 Web 客户端和 Web Portal blocks 使用。

启用 CUBA 计划任务机制。

默认值： false

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

指定 Serialization 接口的实现类，用来在应用程序 blocks 之间做对象传递时做序列化。平台包含两个实现类：

默认值： com.haulmont.cuba.core.sys.serialization.StandardSerialization

在所有标准的 blocks 中都可以使用。

累加属性，用来为各个 block 定义 spring.xml 文件。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

在所有标准的 blocks 中都可以使用。

示例：

定义一个 email 地址。从默认异常处理界面发送的异常报告，从 Help > Feedback 界面发送的用户消息都会被发送到这个地址。

如果这个属性没有设置，系统会隐藏异常处理界面的 Report 按钮。

为了成功的发送邮件，配置电子邮件发送参数 中描述的参数也必须设置。

默认值： empty string.

保存在数据库。

配置接口： WebConfig

可以在 web 客户端 block 使用。

为应用程序 block 设置临时目录的位置。

对于 Tomcat 快速部署，默认值：${catalina.home}/temp/${cuba.webContextName}，指向 tomcat/temp 目录下 web app 名称的目录，比如 tomcat/temp/app-core。

对于 WAR 和 UberJAR 部署情况：${app.home}/${cuba.webContextName}/temp，指向应用程序根目录下的一个目录。

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

如果在运行自动化用户界面测试，这个属性必须设置成 true。

配置接口： GlobalConfig

默认值： false

可以用在 Web 客户端和 Middleware blcoks。

定义一组 *-theme.properties 文件，存储 theme 变量，比如默认的对话框范围以及文本输入框的宽度。

这个属性的值是一组用空格分隔的文件列表，文件通过使用 Resource - 资源接口来加载。

Web 客户端的默认值： com/haulmont/cuba/havana-theme.properties com/haulmont/cuba/halo-theme.properties com/haulmont/cuba/hover-theme.properties

可以在 Web 客户端使用。

启用对 bean 调用触发器文件的处理。

触发器文件是放在应用程序 block 的临时文件夹的 triggers 子目录。触发器文件命名是包含使用“点“分隔的两部分。前半部分是 bean 名称，后半部分是 bean 中需要调用的方法名称。示例： cuba_Messages.clearCache。触发器文件处理器会监控这个目录是否有新文件，如果有的话，会调用指定的方法，然后删除这些文件。

默认情况下，触发器文件的处理是配置在 cuba-web-spring.xml 文件中，并且只在 Web 客户端配置。在项目级别，其它模块的处理可以通过周期性的调用 cuba_TriggerFilesProcessor bean 的 process() 方法来做。

默认值： true

可以在配置了需要处理的 blocks 中使用，默认是 web 客户端。

定义检查触发器文件的时间间隔，需要开启 cuba.triggerFilesCheck 参数。单位是毫秒。

默认值： 5000

可以在配置了需要处理的 blocks 中使用，默认是 web 客户端。

定义 LoginService.loginTrusted() 方法要使用的密码。Middleware 层可以使用这个密码而不是用户密码来做用户认证，这些用户通过信任的客户端 block 连接。

这个属性在用户的密码不存在数据库的时候使用，客户端 block 会自己做实际的认证。比如，集成 Active Directory 的时候。

配置接口： ServerConfig, WebAuthConfig, PortalConfig

可以使用的 blocks：Middleware，Web 客户端，Web Portal。

定义一组 IP 地址，从这些地址可以调用 LoginService.loginTrusted() 方法。示例：

默认值： 127.0.0.1

配置接口： ServerConfig

可以在 Middleware block 使用。

正则表达式，用来找出由于数据库违反唯一性约束造成的异常。约束的名称会从表达式的第一个非空组获得，示例：

约束的名称可以用来显示本地化消息，以便找出是什么实体引起的。因此，需要在主语言包中包含为约束名定义的键值。示例：

根据 DBMS locale 和版本的不同，这个属性还可以定义针对违反唯一性约束需要作出的响应。

当前 DBMS 的默认值通过 PersistenceManagerService.getUniqueConstraintViolationPattern() 方法返回。

可以定义在数据库。

可以在所有的客户端 blocks 使用。

对于通过配置接口加载实体实例，如果当前已经有事务了，则使用当前事务加载。这个对性能有提高。否则，会创建一个新的连接，并且做提交，然后会返回游离（detached）的实体实例。

默认值： false

可以在 Middleware block 使用。

如果此属性设置为 true，为 BaseLongIdEntity 和 BaseIntegerIdEntity 子类生成唯一标识符的序列会创建在相应实体存在的数据存储中。否则，这些序列存在主数据存储中。

默认值： false

配置接口： ServerConfig

可以在 Middleware block 使用。

EclipseLink ORM 会在 inner join 中使用 JOIN ON 从句，而不会在 WHERE 从句中使用条件语句。

默认值： false

可以在 Middleware block 使用。

当设置为 true，Web 客户端和 Web Portal blocks 会在本地调用 Middleware 服务，避开网络堆栈，这样有利于系统性能。这个情况在 Tomcat 快速部署和单一 WAR 或者单一 UberJAR 部署的时候可以用到。对于其它的部署形式，这个值需要设置成 false。

默认值： false

可以在 Web 客户端和 Web Portal blocks 使用。

DataManager 中的所有 load 方法都会使用只读事务。

默认值： true

保存在数据库。

配置接口： ServerConfig

可以在 Middleware block 使用。

为用户定义显示全部名称的模式。

默认值： {FF| }{LL}

全名称模式可以用用户的姓，名，和中间名（外国人）来构成。模式需要按照下面的规则：

可以在 Web 客户端 block 使用。

为 User 实体定义显示名称模式。显示名称用在几个不同的地方，包括显示在系统主窗口右上角。

默认值： {1} [{0}]

{0} 会用 login 属性替换, {1} 会用 name 属性替换。

可以在 Middleware，Web 客户端 blocks 使用。

定义用户会话超时的时限。单位是秒。

默认值： 1800

配置接口： ServerConfig

可以在 Middleware block 使用。

开启用户会话日志功能。

默认值： false

保存在数据库。

配置接口： GlobalConfig.

在所有标准的 blocks 中都可以使用。

定义 Middleware block 的 URL 来作为用户登录服务。

这个参数需要在额外的 middleware blcoks 中设置，这些 middleware 可以执行客户端请求，但是不分享用户会话缓存。如果在请求发起的时候，在本地的缓存中没有需要的会话，这个 block 会在指定的 URL 执行 LoginService.getSession() 方法，然后将取到的会话缓存到本地。

配置接口： ServerConfig

可以在 Middleware block 使用。

累加属性，用来定义 views.xml 文件。参考 视图。

平台使用 Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

在所有标准的 blocks 中都可以使用。

示例：

定义 web 客户端应用的 URL。

在特殊情况下，这个属性也用来生成外部应用程序的界面链接，也会被 ScreenHistorySupport 类使用。

默认值： http://localhost:8080/app

保存在数据库。

配置接口： GlobalConfig

在所有标准的 blocks 中都可以使用。

定义如何处理 URL 更改。

可选值为 UrlHandlingMode 枚举类型的元素：

默认值： URL_ROUTES

配置接口： WebConfig

累加属性，用来定义 screens.xml 文件。

Resource - 资源接口来加载此文件，所以这个文件可以放在 classpath 或者配置文件目录。

可以在 Web 客户端 block 使用。

示例：

如果登录界面和/或者主窗口实现了 CubaHistoryControl.HistoryBackHandler 接口的话，用此参数开启对于浏览器 Back - 返回 按钮的处理。如果此属性设置为 true，浏览器标准的行为会替换成调用接口的处理方法。

参考 Web 客户端基础设施。

默认值： true

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义应用程序目录刷新时间间隔，单位是秒。

默认值： 180

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义主应用窗口的初始化模式 - “标签式”还是“单页式”（TABBED 或者 SINGLE）。在“单页式”模式下，当使用 NEW_TAB 参数打开界面时，新界面会完全替换现有界面而不是打开一个新的标签页。

用户之后可以在 Help > Settings 界面更改此模式。

默认值： TABBED

配置接口： WebConfig

可以在 web 客户端 block 使用。

当上一次 非心跳请求之后，会话超时也已经过期，Web 客户端是否可以关闭 UI 和会话。

默认值： false

配置接口： WebConfig

可以在 web 客户端 block 使用。

累加属性，用来定义包含应用程序组件信息的配置文件，这些文件由不同的 Jar 包提供或者在 web 模块的 cuba-ui-component.xml 中描述。

示例：

自定义 HTML 页面的 viewport 宽度。影响 Vaadin HTML 页面上的 "viewport" 元标签(viewport meta tag)。

默认值： -1

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义默认界面是否也可以通过关闭按钮、ESC 按钮或者标签页右键菜单（当使用 TABBED 工作区模式）进行关闭。

默认值： true

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义登录后默认打开的界面。这个设置对所有用户生效。

示例：

配置接口： WebConfig

可以在 web 客户端 block 使用。

Deprecated - 废弃. 使用 web 登录扩展点替代.

通过外部认证机制进行认证，比如 LDAP 或者 SSO IDP。也可参考cuba.web.externalAuthenticationProviderClass以及 IDP 插件 wiki 。

默认值： false

配置接口： WebAuthConfig

可以在 web 客户端 block 使用。

Deprecated - 废弃. 使用 web 登录扩展点替代.

实现了 CubaAuthProvider 接口的类，当 cuba.web.externalAuthentication 设置成 true 的时候会使用这个类做认证。

参考 集成 LDAP 和 IDP 插件 wiki 了解更多示例。

配置接口： WebAuthConfig

可以在 web 客户端 block 使用。

为文件夹面板设置默认的宽度，单位是像素。

默认值： 200

配置接口： WebConfig

可以在 web 客户端 block 使用。

启用文件夹面板功能。

默认值： false

配置接口： WebConfig

可以在 web 客户端 block 使用。

设置是否要默认展开文件夹面板。

默认值： false

配置接口： WebConfig

可以在 web 客户端 block 使用。

在 Web 客户端启用/禁用 LDAP 登录机制。

示例：

配置接口： WebLdapConfig

可以在 web 客户端 block 使用。

设置 LDAP 服务器 URL。

示例：

配置接口： WebLdapConfig

可以在 web 客户端 block 使用。

为在 LDAP 中搜索用户设置基本域名称（DN）。

示例：

配置接口： WebLdapConfig

可以在 web 客户端 block 使用。

系统用户别名，系统用户有权限从目录读取信息。

示例：

配置接口： WebLdapConfig

可以在 web 客户端 block 使用。

cuba.web.ldap.user 属性定义的系统用户的密码。

示例：

配置接口： WebLdapConfig

可以在 web 客户端 block 使用。

LDAP 用户的用来匹配登录名的属性名称。默认是 sAMAccountName （使用于 Active Directory）。

示例：

配置接口： WebLdapConfig

可以在 web 客户端 block 使用。

定义一组可以由 LinkHandler bean 处理的 URL 命令。参考 界面链接 了解更多信息。

值需要用 | 字符分隔。

默认值： open|o

配置接口： WebConfig

可以在 web 客户端 block 使用。

设置默认的用户名称，会在登录窗口自动填充。这个在开发阶段会非常有用。这个属性在生产环境需要设置成 <disabled> 的值。

默认值： admin

配置接口： WebConfig

可以在 web 客户端 block 使用。

设置默认的用户密码，会在登录窗口自动填充。这个在开发阶段会非常有用。这个属性在生产环境需要设置成 <disabled> 的值。

默认值： admin

配置接口： WebConfig

可以在 web 客户端 block 使用。

设置成 false 在登录窗口隐藏 "powered by CUBA Platform"。

默认值： true

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义在主窗口的 标签页模式使用哪个组件管理界面。可以选取 MainTabSheetMode 枚举类型中的一个值：

默认值： DEFAULT.

配置接口： WebConfig.

可以在 web 客户端 block 使用。

如果 cuba.web.mainTabSheetMode 属性设置为 MANAGED，定义主 TabSheet 怎么切换标签页：隐藏还是只卸载它们的组件。

默认值： HIDE_TABS

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义可以在应用程序主窗口打开的标签页的最大数量。0 值表示不限制。

默认值： 7

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义当设置了 cuba.web.customDeviceWidthForViewport 或者 cuba.web.useDeviceWidthForViewport 是 true 的时候 HTML 界面的初始化缩放比。影响 Vaadin HTML 界面的 "viewport" 元标签。

默认值： 0.8

配置接口： WebConfig

可以在 web 客户端 block 使用。

可以完全关闭通过在 URL 中添加 ?debug 打开的 Vaadin 开发者模式。因此，也同时关闭了 JavaScript 调试模式，减少了从浏览器获取的服务器信息。

默认值： false

配置接口： WebConfig

可以在 web 客户端 block 使用。

可以完全禁用服务器推送。但是后台任务机制不受此影响。

默认值： true

配置接口： WebConfig

可以在 Web 客户端使用。

对于服务器推送实现，从 WebSocket 切换成长轮询（long polling）。

默认值： false

配置接口： WebConfig

可以在 Web 客户端使用。

定义服务器推送的超时时限，单位是毫秒。当服务器推送实现切换成长轮询的时候会用到。比如当 cuba.web.pushLongPolling="true" 时。

默认值： -1

配置接口： WebConfig

可以在 Web 客户端使用。

在 web 客户端的登录界面显示 Remember Me - 记住我 复选框。

默认值： true

配置接口： WebConfig

可以在 Web 客户端使用。

启用是否缓存 web 资源。单位是秒。0 值表示不做缓存。示例：

默认值： 60 * 60 (1 小时).

配置接口： WebConfig

可以在 Web 客户端使用。

启用是否缓存 WebJar 资源。单位是秒。0 值表示不做缓存。示例：

默认值： 60 * 60 * 24 * 365 (1 年).

配置接口： WebConfig

可以在 Web 客户端使用。

设置用来显示 Embedded 组件的文件目录。示例：

默认值： null

配置接口： WebConfig

可以在 Web 客户端使用。

如果设置为 true，在 Web 客户端创建用户的时候需要密码。如果是使用 LDAP 认证的话，建议将此参数设置为 false。

默认值： true

配置接口： WebAuthConfig

可以在 web 客户端 block 使用。

设置是否在主窗口的工作区显示面包屑（breadcrumbs）面板。

默认值： true

配置接口： WebConfig

可以在 web 客户端 block 使用。

启用文件夹面板图标。当启用时，会使用下面这些样式文件：

默认值： false

配置接口： WebConfig

可以在 web 客户端 block 使用。

以英文逗号分隔的用户列表，这些用户不允许使用外部认证（比如 LDAP 或者 IDP SSO），需要使用标准认证登录系统。

空列表表示所有用户都可以用外部认证来登录系统。

默认值： <empty list>

配置接口： WebAuthConfig

可以在 web 客户端 block 使用。

调整网页浏览器中的 Table 缓存。缓存行的数量是由 cacheRate * pageLength 的值决定。

默认值： 2

配置接口： WebConfig

可以在 web 客户端 block 使用。

当 Table 刷新第一次渲染的时候，设置从服务端获取数据的行数。也可参考 cuba.web.table.cacheRate。

默认值： 15

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义 web 客户端使用的默认主题的名称。也可参考 cuba.themeConfig。

默认值： halo

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义 Web 客户端用户界面心跳请求的间隔。如果没设置，则会使用 cuba.httpSessionExpirationTimeoutSec / 3。

默认值： HTTP-session 非活动状态超时时限 / 3，单位为秒

配置接口： WebConfig

可以在 web 客户端 block 使用。

如果在 Halo 主题中开启了这个属性，Font Awesome 的象形图标会被用来作为平台界面标准行为的图标，而不是使用图片。

可视化组件或者操作的 icon 属性和字体元素之间的关联关系通过平台的 halo-theme.properties 文件定义。以 cuba.web.icons 为前缀的键值对应图标名称，然后它们的值，用 com.vaadin.server.FontAwesome 枚举类型常量定义。比如，标准 create 动作的字体元素定义如下：

默认值： true

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义HTML 界面的路径，这个界面用来在应用程序不支持当前浏览器版本时显示。

默认值： /com/haulmont/cuba/web/sys/unsupported-page-template.html

配置接口： WebConfig

可以在 web 客户端 block 使用。

控制使用了 Halo 主题和它的扩展主题的 Web 客户端应用程序的 header。如果是 true，header 会使用暗色调（反色），如果是 false，header 采用主程序背景色。

这个熟悉忽略大小写。

属性在应用的主题内设置。如果用户能选择亮色和暗色主题的话，这个选项对于暗色主题有效。此时，在暗色主题中，header 会作为亮色主题的反色，主程序的背景也会相应的作反色处理。

默认值： true

配置接口： WebConfig

可以在 web 客户端 block 使用。

Defines whether a user is able to choose the default screen. If the false value is set, the Default screen field in the Settings screen is read-only.

默认值： true

配置接口： WebConfig

可以在 web 客户端 block 使用。

处理 viewport 的宽度。如果需要使用设备宽度作为 viewport 宽度时设置为 true。这个属性影响 Vaadin HTML 界面 viewport 的元标签。

默认值： false

配置接口： WebConfig

可以在 web 客户端 block 使用。

当使用 ExportDisplay.show() 方法下载文件时，定义一组浏览器直接显示的文件后缀名的列表。使用 | 字符来分隔列表中的后缀名。

默认值： htm|html|jpg|png|jpeg|pdf

配置接口： WebConfig

可以在 web 客户端 block 使用。

定义 web 应用的上下文（context）名称。通常跟包含此应用程序 block 的目录或者 WAR 文件同名。

配置接口： GlobalConfig

可以使用的 blocks：Middleware，Web 客户端，Web Portal。

比如，对 Middleware block 来说，如果放置的目录是 tomcat/webapps/app-core，并且可以通过 http://somehost:8080/app-core 访问，则此属性应该设置为：

定义运行应用程序 block 的机器主机名称。

默认值： localhost

配置接口： GlobalConfig

可以使用的 blocks：Middleware，Web 客户端，Web Portal。

比如，对 Middleware block 来说，可以通过 http://somehost:8080/app-core 访问，则此属性应该设置为：

定义运行应用程序 block 的端口。

默认值： 8080

配置接口： GlobalConfig

可以使用的 blocks：Middleware，Web 客户端，Web Portal。

比如，对 Middleware block 来说，可以通过 http://somehost:8080/app-core 访问，则此属性应该设置为：