文档中心

核心指标可以突出显示多个关键数据结果，⽐如同⽐环⽐。

核心指标可以对配色进行一定程度上的自定义：

如果选取「基础」->「图表自定义背景和边框」中选择「本报表页面的主题配色」则核心指标的风格将与整个报表的颜色主题保持一致。 用户也可以自己选择颜色，添加的配置行分别对应每个卡片

效果如下图：

核心指标的数据绑定

下面介绍使用 SQL 方式绑定数据时的配置：

涨跌幅从模型中选取

如果您的数据库里已经存储了计算好的涨跌幅字段, 那么您可能希望像这样进行建模：

同时需要在控制面板里面取消 涨跌幅自动计算 选项的勾选。 在展示项配置中配置变化率字段（不同核心指标的变化率字段肯定不一样，这里为了简单就设置为一样的了）:

这样即可刷新图表，得到正确的核心指标展示。

如果需要展示的涨跌幅不止 1 条怎么办？例如除了展示 PV UV 的日环比 还希望展示 周同比，那么勾选双涨跌幅字段 则可得到一项新的配置第二涨跌幅字段, 只需要和 涨跌幅字段 一样选择对应的模型字段即可：

变化率字段还支持飘红飘绿。

涨跌幅自动计算

如果您的数据库里没有存储计算好的涨跌幅 字段, 那么您可能希望Sugar BI来帮您自动计算出涨跌幅。此时的场景和对比表格比较类似，对数据格式和配置都有一定的要求。

数据格式要求

• 必须存在一列数据类型为 日期 的字段
• 除日期字段外，其他的每个字段表示一个指标（如 PV、UV 等）
• 注意：SQL语句查询出来的数据必须是多天的，并且包含了对应日期的数据（如要计算日环比，SQL 查询结果就必须包含了目标日期的前一天数据，周同比也是类似需要 SQL 查询的数据中有对应的上周同天的数据）

一般情况下 SQL 的建模类似如下：

数据展示配置

需要以下配置，如下图：

• 开启涨跌幅自动计算选项

• 数据日期，用来告诉Sugar BI将什么日期设定为当日（即标准日期，其他的如上周同日、上月等都是以当日作为标准）。这里可以选 昨天、前天以及根据过滤条件中的日期或取最大日期，昨天和前天很简单，就是现实世界中的昨天和前天；根据过滤条件中的日期或取最大日期计算顺序是：

  • Sugar BI会首先从过滤条件进行分析，如果存在类型为日期范围 的过滤条件，那么会以 日期范围条件的结束日期 作为当日；
  • 如果存在类型为日期 过滤条件，那么会以 日期的取值作为当日；
  • 如果不存在这样的过滤条件，那么Sugar BI会将SQL查询结果的最大日期作为当日。
• 可多选需要计算的涨跌幅，再次提醒：SQL语句查询出来的数据必须是多天的，并且包含了对应日期的数据（如要计算日环比，SQL 查询结果就必须包含了标准日期的前一天数据，周同比也是类似需要 SQL 查询的数据中有对应的上周同天的数据）
• 最后绑定要展示的核心指标字段，可以配置飘红飘绿设置（飘红飘绿是针对指标的比率项，如日环比、周同比等。并且Sugar BI还支持一键配置共用的飘红飘绿规则，这样就不必每个指标都单独配置，当然，如果单独配置了，那么单独配置的优先级将高于共用配置）

核心指标格式化方法

如果你传入的数据是想作为时间来处理的一个大数字，例如 987654321 秒，希望可以自动转化成N天N小时N分钟N秒；如果你传入的数据是想作为字节来处理的一个大数字，例如 987654321 字节，希望可以自动转化成TB、GB、MB、KB；如果你传入的数据是想作为数字来处理的一个大数字，例如 987654321，希望可以自动转化成亿、万； 这个时候可以使用格式化方法功能

之后便得到如下效果:

核心指标的下钻配置

如果下钻类型为图表，则与其余图表的下钻配置相同，这里介绍一下下钻类型为超链接时该如果配置超链接字段。

API 方式拉取数据的超链接下钻配置

核心指标的数据 API 应返回如下格式的数据，其中 data 数组的每一项中都可以放入一个 url 字段，并在下钻配置中的「绑定超链接的数据字段」处填写 url 即可。

{ status: 0, // 0表示成功，非0表示失败 msg: '', // 失败时的提示信息 data: [ { name: "访问量", // 指标名称 desc: 

'访问量是指页面被访问的次数', // 指标描述，可不传 unit: '', // 单位，可以不传 value: 17480134, // 指标取值 rate: 3.34,

 // 涨跌率，如果不需要也可不传 rate_level: "green", // 涨跌率字体展示的颜色，可以是green、red，可不传 rate_tip: "周环比",

 // 对涨跌率的说明，可不传 rate2: 14.5, // 第二个涨跌率，如果不需要也可不传 rate2_level: 'green',

 // 第二个涨跌率字体展示的颜色，可以是green、red，可不传 rate2_tip: '日环比' , // 对第二个涨跌率的说明，

可不传 url: "http://www.baidu.com" // 这个字段供超链接类型的下钻使用，在配置下钻时的「绑定超链接的数据字段」

处填写url即可 }, .... ]; }

SQL 方式拉取数据的超链接下钻配置

SQL 方式拉取数据时，在配置的「数据」选项卡中的展示项配置中，每行都可以配置一个「下钻附加数据」：

这里就可以写点击每项核心指标时需要跳转的链接，然后点击刷新图表按钮更新下图表的数据。

然后在「交互」->「下钻」配置中的「打开页面的 url 的数据字段」处填写_sugar_extra：