在此页：

目标用户：

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.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" } ] }	此选项允许对仪表盘右上角的阶段数据的时间段选项进行微调：这些选项将更详细的解释在健康仪表盘（参见时间周期选择）。 shift：（默认情况下为true）如果为true，那么显示的时间周期将在最后一个快照的时间结束（考虑多应用层的所有应用和应用层的所选应用），以帮助集中于可用的最新数据，而不是实际的时间范围。如果为false，则所有时间段过滤器在当前日期/时间结束。 periods：提供配置句点过滤菜单的方法： diff：表示周期长度的整数值 units：表示与diff关联的时间单位（可能的值为：“天”、“月”、“年”、“所有时间”）。如果设置所有时间，则不考虑差异值。 unitsValue：将用于下拉列表中的文本。可针对特定地区进行修改（例如中文）以提供翻译。 selected：（默认为false）在用户打开页面时希望默认选择的时间段设置为true label：表示要使用的自定义时间段标签。否则标签将基于差异和单元参数。
配置标签过滤选项	过滤	"filtering"：{ "filterTags"：false },	设置为true时：用户只能访问与应用的全部作用域匹配的类别/标记（即不显示不适用于用户可访问的任何应用的标记）。设置为false时：用户可以看到所有类别和相关的标签，不管是否有任何应用分配。但是过滤没有应用的可见标记将导致空白显示。
配置在演化细节页面中显示的应用的数量	阶段	"Evolutions"：{ "selectedApplicationCount"：10 },	此选项定义阶段细节页面中包含的应用的数量（即在多个或单个应用级别单击阶段图块时访问的页面）。默认值设置为10个应用——在配置大量应用时要留意，因为这会显著影响性能。参数可以被插件特定的配置覆盖。

选项	参数	示例	说明
配置图块下拉选项	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"： [ ... ] } },

Page tree

HD - json中的仪表盘宽配置选项