3.9.9.1. 应用程序文件夹
创建或编辑应用程序文件夹需要特殊的权限(cuba.gui.appFolder.global
)。
可以通过文件夹面板右键菜单创建一个简单的应用程序文件夹。这类文件夹不会链接到系统界面,只用于对文件夹树中的其它文件夹进行分组。
打开带有过滤器界面的文件夹可以按以下方式创建:
-
打开界面并根据需要过滤记录。
-
在 Filter… 按钮菜单中选择 Save as application folder 选项。
-
在 Add 对话框中填写文件夹属性:
-
Folder name。
-
Screen Caption – 从文件夹中打开窗口时要添加到窗口标题的字符串。
-
Parent folder – 确定新文件夹在文件夹树中的位置。
-
Visibility script – 确定文件夹可见性的 Groovy 脚本,在用户会话建立时执行。
该脚本应该返回一个
Boolean
值。如果未定义脚本或脚本执行结果为true
或者null
,则文件夹可见。Groovy 脚本的示例:userSession.currentOrSubstitutedUser.login == 'admin'
-
Quantity script – 一个用于定义文件夹上显示的记录数和样式的 Groovy 脚本。在用户会话建立时、计器调用时执行。
该脚本会返回一个数值,其整数部分将用作记录数。如果未定义脚本或脚本执行返回
null
,则不会显示记录数。除了返回值之外,该脚本还可以设置style
变量,该变量将用作文件夹显示样式。Groovy 脚本的示例:def em = persistence.getEntityManager() def q = em.createQuery('select count(o) from sales$Order o') def count = q.getSingleResult() style = count > 0 ? 'emphasized' : null return count
要显示样式,应该在程序主题中定义
cuba-folders-pane
的v-tree-node
元素样式,例如:.c-folders-pane .v-tree-node.emphasized { font-weight: bold; }
-
Order No – 文件夹的在树中的顺序。
-
脚本可以使用 groovy.lang.Binding
上下文中定义的以下变量:
-
folder
– 执行脚本的AppFolder
实体的实例。 -
persistence
– Persistence接口的实现。 -
metadata
– Metadata接口的实现。
在更新文件夹时,平台对所有脚本使用相同的 groovy.lang.Binding
实例。因此,可以在它们之间传递变量,这样可以消除重复的请求并能提高性能。
脚本源代码可以存储在 AppFolder
实体的属性中,也可以存储在单独的文件中。如果要存储在单独文件中,属性值设置为扩展名为 ".groovy" 的文件路径,这是Resources接口需要的。如果属性值是以".groovy"结尾的字符串,则将从相应的文件加载脚本;否则,将属性内容本身将用作脚本。
应用程序文件夹是 AppFolder
实体的实例,存储在相关的 SYS_FOLDER 表和 SYS_APP_FOLDER 表中。