Page tree
Skip to end of metadata
Go to start of metadata

在此页:

目标用户:

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",

用于在每个登录页显示标题:

默认设置为:

  • cmp.json = 健康仪表盘
  • app.json = 应用层健康仪表盘

请注意,app.json文件位于如下所示的位置(这是cmp.jsonapp.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" }
	]
}

此选项允许对仪表盘右上角的阶段数据的时间段选项进行微调:

这些选项将更详细的解释在健康仪表盘(参见时间周期选择)。

  • shift: (默认情况下为true)如果为true,那么显示的时间周期将在最后一个快照的时间结束(考虑多应用层的所有应用和应用层的所选应用),以帮助集中于可用的最新数据,而不是实际的时间范围。如果为false,则所有时间段过滤器在当前日期/时间结束。
  • periods: 提供配置句点过滤菜单的方法:
    • diff: 表示周期长度的整数值
    • units: 表示与diff关联的时间单位(可能的值为:“天”、“月”、“年”、“所有时间”)。如果设置所有时间,则不考虑差异值。
    • unitsValue: 将用于下拉列表中的文本。可针对特定地区进行修改(例如中文)以提供翻译。
    • selected: (默认为false)在用户打开页面时希望默认选择的时间段设置为true
    • label: 表示要使用的自定义时间段标签。否则标签将基于差异和单元参数。
配置标签过滤选项

过滤

"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": [
...
		]
	}
},
  • No labels