UI 配置

配置应用程序的菜单是否包含所有已安装的 扩展组件 菜单。

当设置为 true 时，菜单会包含应用中 menu.xml 的内容，以及所有扩展组件中 menu.xml 的内容（如果有的话）。

而设置为 false 时，菜单仅包含应用程序的 menu.xml。

Studio 菜单设计器 可以帮助管理两种模式下的菜单结构。

默认值：true

配置可以加载至 UI 层实体实例的默认最大数量。

默认值：10000

参阅 jmix.ui.entity-max-fetch-size。

对于 simplePagination 组件，配置显示在每页中的默认数据条数。

默认值：50

参阅 jmix.ui.entity-page-size。

定义一个视图，用于在登录后的 主视图 中打开。示例：

参阅 jmix.ui.main-view-id。

对于某个特定实体，配置可以加载至 UI 层实例的默认最大数量。

以下示例展示如何为两个实体配置不同的最大读取数。对其他未配置该属性的实体，按照 jmix.ui.default-max-fetch-size 加载。

对于特定实体的 simplePagination 组件，配置显示在每页中的默认数据条数。

以下示例展示如何为两个实体配置不同的分页数量。对其他未配置该属性的实体，按照 jmix.ui.default-page-size 加载。

配置应用程序 主页面 的视图 ID。

默认值：main。

参阅 jmix.ui.default-view-id。

配置 menu.xml 文件的路径。该文件通过 Resources 接口加载，因此可以位于 classpath 或者配置目录中。

示例：

配置应用程序登录页面的视图 ID。

默认值：login。

配置一个下载缓存的阈值，单位为字节。在通过 ByteArrayDownloadDataProvider 下载时，字节数组会保存在临时文件中，避免 HTTP 会话的内存泄露。

默认值：102400

配置是否在登录后重新初始化用户会话，以确保应用程序不会受到会话固定攻击。

默认值：true

对于 Downloader bean，配置哪些文件后缀类型可以直接展示在浏览器而不下载。

默认值：[htm, html, jpg, png, jpeg, pdf]

定义关闭当前视图使用的键盘快捷键。

定义保存数据更改的键盘快捷键。

配置通过对话框创建的实体是否添加到列表的开头。

默认值：true

当从查找视图选择某个实体后，如果该实体不包含所需的全部实体属性，通过该配置指定 LookupBuilder 是否需要重新加载该实体。

默认值：true

当关闭对话框时，如果 DataContext 包含未保存的改动，通过该配置定义对话框显示的选项。根据该选项的配置，实体详情视图会调用 ViewValidation bean 的 showSaveConfirmationDialog() 或 showUnsavedChangesDialog() 方法。

如果设置为 true，对话框包含三个选项：Save（保存）、Don’t save（不保存）、Cancel（取消）。

如果设置为 false，对话框包含仅包含两个选项：Yes（是） 不保存数据并关闭窗口，以及 No（否），可以继续编辑。

默认值：true。

当用户尝试关闭一个浏览器标签页时，设置是否显示一个确认窗口，需要对应的视图通过 setPreventBrowserTabClosing 设置 true。

默认值：false。

定义视图中数据验证错误通知的显示时间，单位为毫秒。

默认值：3000

设置数据验证通知在页面中的位置。支持：TOP_STRETCH、TOP_START、TOP_CENTER、TOP_END、MIDDLE、BOTTOM_START、BOTTOM_CENTER、BOTTOM_END、BOTTOM_STRETCH。

默认值：BOTTOM_END

配置视图中标准的数据验证错误通知的类型。支持 Notifications.Type 的枚举值：DEFAULT、ERROR、SUCCESS、SYSTEM、WARNING。

默认值：DEFAULT

指定是否使用 Base32 Crockford Encoding 对 UUID URL 参数进行加解密。

默认值：false

定义通知的显示时间，单位为毫秒。

默认值：3000

设置默认通知在页面中的位置。支持：TOP_STRETCH、TOP_START、TOP_CENTER、TOP_END、MIDDLE、BOTTOM_START、BOTTOM_CENTER、BOTTOM_END、BOTTOM_STRETCH。

默认值：MIDDLE

设置 textField 和 textArea 组件 trimEnabled 属性的默认值。

默认值：true

设置 genericFilter 组件应用当前过滤条件的快捷键，可用在过滤器不是 自动应用 时。

例如，可以禁用所有过滤器的自动应用而改用快捷键：

该全局配置可以通过特定 genericFilter 通用过滤器 组件的 applyShortcut XML 属性覆盖。

当设置为 true 时，genericFilter 通用过滤器 组件以“实时”模式工作，所有一旦过滤器参数有改动都会自动重新加载数据。

当设置为 false 时，需要点击 Refresh（刷新） 按钮才会重新加载数据。

该配置可以在 genericFilter 通用过滤器 组件实例的级别通过配置实例的 autoApply XML 属性进行覆盖。

默认值：true

当设置为 true 时，会强制要求运行时的过滤器配置名称唯一。同时，支持 运行时配置 和 设计时配置 具有相同的名称而不会出现冲突。

注意，设计时的配置会带有一个 * 号标记，以便于运行时配置做区分。

默认值：true

定义 genericFilter 通用过滤器 组件中添加条件时显示的实体属性层级深度。例如，如果该值设置为 2，那么可以选择 contractor.city.country，如果设置为 3，可以选择 contractor.city.country.name。

该属性可以在特定 genericFilter 通用过滤器 组件级别通过组件的 propertyHierarchyDepth XML 属性进行覆盖。

默认值：2

配置是否在 过滤器 的配置详情对话框中显示配置id字段。

默认值：false

定义执行 list_add 操作的键盘快捷键。

定义执行 list_create 操作的键盘快捷键。

定义执行 list_edit 操作的键盘快捷键。

默认值：ENTER

定义执行 list_read 操作的键盘快捷键。

默认值：ENTER

定义执行 list_remove 操作的键盘快捷键。

默认情况下，必填字段在视图打开时就高亮显示，不会等待用户输入。

如果该属性设置为 false，对必填字段的验证仅在视图保存时进行。

默认值：true

配置 simplePagination 组件中展示的“每页显示行数”选项。

如需为某个 simplePagination 的具体实例配置自定义的选项列表，请使用 itemsPerPageItems XML 属性。

默认值：[20, 50, 100, 500, 1000, 5000]

定义清空选择器组件输入内容的键盘快捷键。

定义选择器组件中打开选择视图的键盘快捷键。

定义选择器组件中打开已选实体详情视图的键盘快捷键。

异步任务 的默认超时时限，单位为秒。

默认值：300。

异步任务 中 executor service 线程池的大小。

默认值：10。

定义 后台任务 不更新状态时的超时时限。如果达到任务本身的超时时限加上该参数配置的时限，则尝试终止任务。如果没有指定时间后缀（ns、us、ms、s、m、h 和 d），默认单位为 秒。

默认值：60

配置执行 后台任务 的线程数。

默认值：10

配置检查 后台任务 是否超时的间隔。如果没有指定时间后缀（ns、us、ms、s、m、h 和 d），默认单位为 毫秒。

默认值：5000