在此页:
目标用户:
CAST AI 管理员
摘要: 本页面解释如何配置影响整个健康仪表盘(即它们是有效的,不管仪表盘包含一个或多个应用)。注意,这个页面不处理图块(参见HD - 图块管理)和类别/标签(参见HD - 标签和类别管理)。
除了图块和类别/标签可用的配置可能性之外,还有其它一些高级配置选项,如下所示:
- 配置页面标题
- 配置语言
- 配置在无法登录时请求访问的能力
- 配置滚动方向
- 配置时间段选项
- 配置注销确认
- 配置标签过滤选项
- 配置在演化细节页面中显示的应用的数量
- 配置用户首选项持久性
- 配置图块下拉选项
- 选择默认语言
如何配置选项
上面列出的选项由位于以下位置的.json文件管理
%CATALINA_HOME%\webapps\CAST-Health\portal\resources\cmp.json - this is the same file that is used to configure Tiles (see HD - Tile management) at Multi-application level %CATALINA_HOME%\webapps\CAST-Health\portal\resources\internal\app-navigation.json
选项在哪里?
cmp.json,选项可在文件的最开始:
{ "title": "Health Dashboard", "defaultLanguage": "English", "horizontalScroll": false, "requestAccess": false, "confirmLogout": true, "persistNavigationFilters":true, "filtering":{ "filterTags":true }, "period": { "shift": true, "periods": [ { "diff": 30, "units": "days", "unitsValue": "days" }, { "diff": 3, "units": "months", "unitsValue": "months"}, { "diff": 6, "units": "months", "unitsValue": "months" }, { "diff": 12, "units": "months", "unitsValue": "months", "selected": true }, { "diff": 2, "units": "years", "unitsValue": "years" }, { "diff": 0, "units": "alltime" } ] }, "Evolutions":{ "selectedApplicationCount":10 },
app-navigation.json, 选项位于“id”:“healthFactors”部分:
{ "id": "healthFactors", "plugin": "CriticalQualityRuleRatio", "parameters": { "order": "descending", "mode": null, "title": "Health Measures", "format": "0,000", "description": "", "indicators": [ ... ] } },
修改选项
要修改这些选项,请使用文本编辑器(记事本或其它类似的应用)编辑.json文件。CAST建议创建默认cmp.json文件的副本,如果在编辑过程中发生错误可以用作替换。
在浏览器中查看更改
如果编辑并保存.json文件,则不需要重新启动应用服务器或应用本身:保存文件时立即发生更改。但是可能会发现这些更改在健康仪表盘中并非立即可见。这是因为.json文件被加载到浏览器的缓存中,因此CAST建议清空浏览器缓存以强制更改变得可见。
如果使用的是谷歌Chrome,下面的提示可以用来自动清空浏览器缓存:
- 点击F12打开页面底部的Developer Tools窗口。
- 单击Developer Tools窗口右侧的Settings图标(一个cog) 。
- 勾选禁用缓存(当DevTools打开时)选项并关闭设置窗口。
- 在这种状态下,单击F12和F5刷新页面时,浏览器缓存将自动清空。
选项说明
cmp.json
选项 | 参数 | 示例 | 说明 |
---|---|---|---|
配置页面标题 | 标题 | "title": "Health Dashboard", | 用于在每个登录页显示标题: 默认设置为:
请注意,app.json文件位于如下所示的位置(这是cmp.json和app.json文件中唯一可用的仪表盘范围选项): %CATALINA_HOME%\webapps\CAST-Health\portal\resources\app.json |
选择默认语言 | defaultLanguage | "defaultLanguage": "English", | 默认情况下,仪表盘语言设置为英语。在添加地区时,Change Language下拉列表中将提供其它语言(有关更多信息,请参见HD-ED - 仪表盘本地化)。当使用Change Language选项时,新的语言配置存储在本地浏览器缓存中,因此如果缓存被清空,那么该语言将重置为默认值(即开箱即用英语)。 如果希望为所有用户使用一种不同的语言作为默认值,那么更改此参数以匹配所添加的语言环境的正式名称。需要确保区域设置如HD-ED - 仪表盘本地化中所描述的那样存在)。 |
能够选择所需的语言 | 语言 | "language": "dev", | 默认情况下,工程仪表盘的语言显示设置为英语:仪表盘中显示的所有消息和文本只显示为英语。但是现在可以设置特定的语言环境,并且只要配置了默认英语文本和消息的翻译,仪表盘就会显示所选语言的文本和消息。 有关更多信息,请参见HD-ED - Dashboard本地化。 参见HD-ED - 仪表盘本地化 获得更多信息。 |
配置滚动方向 | horizontalScroll | "horizontalScroll": false, | 用于确定仪表盘页面中区域的滚动方向。默认设置为“false”,因此区域是垂直放置在彼此的顶部,滚动是垂直应用的。 将此值更改为“true”以启用水平滚动—即区域并排放置。 |
配置在无法登录时请求访问的能力 | requestAccess | "requestAccess": false, | 用于确定登录屏幕上是否显示“Can't access”链接。默认设置为“false”,不显示链接。将此值更改为“true”以启用链接。此链接允许无法登录的用户(例如,由于忘记登录凭据或尚未获得访问权限)向仪表盘管理员发送电子邮件,请求访问: 有关用户使用此选项时如何修改发送的模板电子邮件的更多信息,请参见HD-ED - 丢失密码和请求访问配置。 |
配置注销确认 | confirmLogout | "confirmLogout": true, | 当用户退出健康仪表盘时,默认情况下将显示一条确认消息: 如果想停用此确认消息,只需更改即可 "confirmLogout": true, 为 "confirmLogout": false, |
配置用户首选项持久性 | persistNavigationFilters | "persistNavigationFilters":true, | 在使用健康仪表盘跳转期间,可能正在选择过滤器、分组或与默认配置不同的时间段。如果参数persistNavigationFilters设置为true(默认值为false), web应用将尝试在浏览器的缓存中记录首选项。这样下次访问仪表盘时,如果URL中没有设置这些参数,那么将使用缓存中的参数,从而能够使用相同的过滤/分组参数进行跳转。 如果访问一个在URL中已经设置了参数的页面,那么将使用它们。当更改其中一个参数时,这些参数将再次保存在缓存中,以备将来使用。 持久性只适用于
|
配置时间段选项 | 周期 | "period": { "shift": true, "periods": [ { "diff": 30, "units": "days", "unitsValue": "days" }, { "diff": 3, "units": "months", "unitsValue": "months"}, { "diff": 6, "units": "months", "unitsValue": "months" }, { "diff": 12, "units": "months", "unitsValue": "months", "selected": true }, { "diff": 2, "units": "years", "unitsValue": "years" }, { "diff": 0, "units": "alltime" } ] } | 此选项允许对仪表盘右上角的阶段数据的时间段选项进行微调: 这些选项将更详细的解释在健康仪表盘(参见时间周期选择)。
|
配置标签过滤选项 | 过滤 | "filtering":{ "filterTags":false }, | 设置为true时: 用户只能访问与应用的全部作用域匹配的类别/标记(即不显示不适用于用户可访问的任何应用的标记)。 设置为false时: 用户可以看到所有类别和相关的标签,不管是否有任何应用分配。但是过滤没有应用的可见标记将导致空白显示。 |
配置在演化细节页面中显示的应用的数量 | 阶段 | "Evolutions":{ "selectedApplicationCount":10 }, | 此选项定义阶段细节页面中包含的应用的数量(即在多个或单个应用级别单击阶段图块时访问的页面)。默认值设置为10个应用——在配置大量应用时要留意,因为这会显著影响性能。参数可以被插件特定的配置覆盖。 |
app-navigation.json
选项 | 参数 | 示例 | 说明 |
---|---|---|---|
配置图块下拉选项 | failedRatio | "failedRatio": "true", | 默认情况下,不存在此选项(因此将其设置为“false”)。将其添加到“id”:“healthFactors”的parameters部分,将强制从图块向下拉时的“% Compliance”列从“% Compliance”更改为“% Failed”: 点击放大: 示例: { "id": "healthFactors", "plugin": "CriticalQualityRuleRatio", "parameters": { "order": "descending", "mode": null, "title": "Health Measures", "format": "0,000", "description": "",* "failedRatio": "true", "indicators": [ ... ] } }, |