指标管理
指标库支持以卡片块形式和列表形式展示所有指标，并通过左侧的领域、视角、来源分类，以及上方搜索功能快速定位目标组件，实现对组件的统一预览，也可以进行新组件的添加。
查看指标
- 登录CodeArts首页，单击导航栏“效能洞察”。
如果登录用户第一次进入效能洞察，页面将显示新特性限时免费弹框，单击“同意并试用”即可继续。
- 在页面左侧导航栏中单击“指标库”。
- 默认显示全部指标，可根据需要查找/查看指标。
表1 查找/查看指标 操作
说明
搜索指标
在搜索框中输入指标关键字，敲击回车，页面中显示搜索结果。
分类查看指标
服务提供三种分类方式：
- 按指标所属领域，分为：工作项、测试用例、代码检查、部署、代码合入、构建、工时。
- 按指标体现的统计视角，分为：项目、组织、个人、团队。
- 按指标的来源，分为：系统预置、自定义。
切换指标显示方式
显示方式包括卡片、列表，单击
即可切换。
自定义指标
自定义指标所需角色权限请参考权限设置。
- 登录CodeArts首页，单击导航栏“效能洞察”。
如果登录用户第一次进入效能洞察，页面将显示新特性限时免费弹框，单击“同意并试用”即可继续。
- 在页面左侧导航栏中单击。
- 单击“新建指标”。
- 配置指标基本信息。
单击页面左上角
，在弹框中编辑指标的基本信息，单击“确定”。
表2 编辑指标 配置项
是否必填
说明
标题
是
指标的显示名称。支持中英文、数字、中划线、下划线，只能以中英文字符开头。
视角
是
指标的度量视角，可选择项目、组织、个人、团队。
描述信息
否
指标的描述信息。在报表中，当鼠标悬停在指标名称后的
时，将显示该描述信息。图1 指标信息
计算口径
否
指标的计算口径。在报表中，当鼠标悬停在指标名称后的
时，将显示该计算口径信息。备注
否
指标的备注信息，根据需要编辑即可。
- 配置数据源。
在页面左侧单击
，在弹框中选择数据集，单击“确定”。 - 配置展示方式。
- 在页面中间选择指标的展示方式，可选项包括：曲线图、柱状图、双轴图、条形图、饼图、面积图、指标卡、表格。
- 用户参考表3根据需要选择图表中的展示内容，将被选中的字段从页面左侧拖拽到文本框中。
表3 指标展示类型 类型
说明
曲线图
X轴：选中维度字段中需要展示的字段，拖拽至X轴的文本框内；单击“时间序列”。按照时间顺序进行展示。选择“时间序列”后，无法再拖拽字段。
Y轴：选中指标字段和维度字段中需要展示的字段，拖拽至Y轴的文本框内；用户也可以单击“自定义指标”，使用函数方法来创建自定义指标。
Y轴分组：选中维度字段中需要展示的字段，拖拽至Y轴分组的文本框内，Y轴中的数据将按照所选的字段进行分组展示。
柱状图
X轴：选中维度字段中需要展示的字段，拖拽至X轴的文本框内。
Y轴：选中指标字段和维度字段中需要展示的字段，拖拽至Y轴的文本框内；用户也可以单击“自定义指标”，使用函数方法来创建自定义指标。
Y轴分组：选中维度字段中需要展示的字段，拖拽至Y轴分组的文本框内，Y轴中的数据将按照所选的字段进行分组展示。
双轴图
X轴：选中维度字段中需要展示的字段，拖拽至X轴的文本框内。
Y轴（左）：选中指标字段和维度字段中需要展示的字段，拖拽至Y轴（左）文本框内；用户也可以单击“自定义指标”，使用函数方法来创建自定义指标。
Y轴（右）：选中指标字段和维度字段中需要展示的字段，拖拽至Y轴（右）文本框内；用户也可以单击“自定义指标”，使用函数方法来创建自定义指标。
条形图
X轴：选中维度字段中需要展示的字段，拖拽至X轴的文本框内。
Y轴：选中指标字段和维度字段中需要展示的字段，拖拽至Y轴的文本框内；用户也可以单击“自定义指标”，使用函数方法来创建自定义指标。
X轴分组：选中维度字段中需要展示的字段，拖拽至X轴分组的文本框内，X轴中的数据将按照所选的字段进行分组展示。
饼图
分类：选中维度字段中的字段，拖拽至分类的文本框内，饼图将展示该字段的数据分布情况。
指标：选中指标字段和维度字段中需要展示的字段，拖拽至指标的文本框内；
用户也可以单击“自定义指标”，使用函数方法来创建自定义指标。
面积图
X轴：选中维度字段中需要展示的字段，拖拽至X轴的文本框内。
Y轴：选中指标字段和维度字段中需要展示的字段，拖拽至Y轴的文本框内；用户也可以单击“自定义指标”，使用函数方法来创建自定义指标。
Y轴分组：选中维度字段中需要展示的字段，拖拽至Y轴分组的文本框内，Y轴中的数据将按照所选的字段进行分组展示。
指标卡
选中指标字段和维度字段中需要展示的字段，拖拽至指标的文本框内；用户也可以单击“自定义指标”，使用函数方法来创建自定义指标。
表格
行：选中指标字段和维度字段中需要展示的字段，拖拽至行的文本框内。
列：选中指标字段和维度字段中需要展示的字段，拖拽至列的文本框内；用户也可以单击“自定义指标”，使用函数方法来创建自定义指标。
燃尽图
X轴：默认为时间序列，无法将字段拖拽至X轴。
实际趋势：用户单击“自定义指标”，使用函数方法来创建自定义指标。
理想起点：选中指标字段和维度字段中需要展示的字段，拖拽至理想起点的文本框内。
完成配置后，页面中将显示图表结果。
- 配置更多信息。
- 在页面右侧“数据筛选”页签中，单击“新增筛选条件”，根据需要选择筛选条件。完成设置后，页面中将显示符合筛选条件的图表。
- 在页面右侧“图表配置”页签中，可以配置图表的显示样式，例如色板、是否显示数据标签、图例在图表中的位置等。
指标卡没有“图表配置”。
- 在页面右侧“交互配置”页签中，可以选择是否支持下载。勾选“是否支持下载”后，用户可以在驾驶舱或指标库下载自定义指标。用户创建自定义指标后，可以勾选“是否下钻”，勾选后，可以在指标库内单击自定义指标，查看该指标下的详细数据，若按照条件查看可参考新增筛选条件。
- 完成全部配置后单击“保存”。
- 保存成功后单击“发布”。
- 发布成功，页面中显示新增的指标。
对于自定义指标，可以完成以下操作。
使用函数方法创建自定义指标
用户可以使用系统内置的函数方法在不同指标类型中创建自定义指标。
- 在支持创建自定义字段的文本框内，单击“自定义指标”。
- 在弹框中可以选择以下自定义函数：
表5 自定义函数 分类
函数名称
函数用法
参数说明
示例
返回值类型
聚合函数
avg（平均数）
avg(number)
number: 数字类型的字段
avg(预计工时)
数字
avgIf（条件计算平均数）
avgIf(number, boolean)
number: 数字类型的字段，boolean: 条件表达式或者布尔常量
avgIf(预计工时, 创建人 = '张三')
数字
count（计数）
count(filed)
filed: 所有类型
count(预计工时)
数字
countDistinct（去重计数）
countDistinct(filed)
filed: 所有类型字段
countDistinct(预计工时)
数字
countDistinctIf（条件去重计数）
countDistinctIf(filed,boolean)
filed: 所有类型字段，boolean: 条件表达式或者布尔常量
countDistinctIf(工作项标题 , 创建人 = '张三')
数字
countIf（条件计数）
countIf(filed,boolean)
filed: 所有类型字段，boolean: 条件表达式或者布尔常量
countIf(工作项标题 , 创建人 = '张三')
数字
cumulativeSum（累计求和）
cumulativeSum(datetime,number)
datetime: 时间类型字段，number: 数字类型的字段或者数字常量或聚合函数
cumulativeSum(创建时间,count(工作项编号))
数字
max（最大值）
max(number)
number: 数字类型的字段
max(预计工时)
数字
min（最小值）
min(number)
number: 数字类型的字段
min(预计工时)
数字
sum（求和）
sum(number)
number: 数字类型的字段
sum(预计工时)
数字
sumIf（条件求和）
sumIf(number, boolean)
number: 数字类型的字段，boolean: 条件表达式或者布尔常量
sumIf(预计工时, 创建人 = '张三')
数字
逻辑函数
and（且）
boolean1 and boolean2
boolean1 : 条件表达式或者布尔常量 boolean2: 条件表达式或者布尔常量
countIf(1,创建人 = '张三' and 关闭人 = '张三')
布尔
if（条件计算）
if(boolean,number1,number2)
boolean: 条件表达式或者布尔常量 ，number1: 数字类型的字段或者数字常量，number2: 数字类型的字段或者数字常量
if(创建人 = '张三', 1, 0)
数字
isNotNull（非空）
isNotNull(field)
filed: 所有类型
countIf(1,isNotNull(创建人))
布尔
isNull（为空）
isNull(filed)
filed: 所有类型
countIf(1,isNull(创建人))
布尔
or（或）
boolean1 or boolean2
boolean1 : 条件表达式或者布尔常量 boolean2: 条件表达式或者布尔常量
countIf(1,创建人 = '张三' or 关闭人 = '张三')
布尔
算数函数
*（乘）
number1*number2
number1: 数字类型的字段或者数字常量，number2: 数字类型的字段或者数字常量
预计工时*0.5
数字
+（加）
number1+number2
number1: 数字类型的字段或者数字常量，number2: 数字类型的字段或者数字常量
预计工时+实际工时
数字
-（减）
number1-number2
number1: 数字类型的字段或者数字常量，number2: 数字类型的字段或者数字常量
预计工时-实际工时
数字
/（除）
number1/number2
number1: 数字类型的字段或者数字常量，number2: 数字类型的字段或者数字常量
预计工时/8
数字
abs（绝对值）
abs(number)
number: 数字类型的字段或者数字常量
abs(预计工时 - 实际工时)
数字
关系运算符
!=（不等于）
filed1 != filed2
filed1: 所有类型，filed2: 所有类型
sumIf(预计工时, 创建人 != '张三')
布尔
<（小于）
filed1 < filed2
filed1: 所有类型，filed2: 所有类型
sumIf(预计工时, 预计工时 < 0)
布尔
<=（小于等于）
filed1 <= filed2
filed1: 所有类型，filed2: 所有类型
sumIf(预计工时, 预计工时 <= 0)
布尔
=（等于）
filed1 = filed2
filed1: 所有类型，filed2: 所有类型
sumIf(预计工时, 创建人 = '张三')
布尔
>（大于）
filed1 > filed2
filed1: 所有类型，filed2: 所有类型
sumIf(预计工时, 预计工时 > 0)
布尔
>=（大于等于）
filed1 >= filed2
filed1: 所有类型，filed2: 所有类型
sumIf(预计工时, 预计工时 >= 0)
布尔
时间函数
addTime（返回日期增加时间间隔后的值）
addTime(datetime,timeInterval,unit)
datetime:时间类型的字段或者时间常量，timeInterval:时间间隔常量(负数为减法，正数为加法)，unit:单位：year,month,day,hour,minute,second
addTime(2023-04-26 07:10:33，1，day)= 2023-04-27 07:10:33 addTime(2023-04-26 07:10:33，1，year)= 2024-04-26 07:10:33 addTime(2023-04-26 07:10:33，1，month)= 2023-05-27 07:10:33
日期
diffDays（返回两个日期值之间的差值，以天为单位）
diffDays(datetime1,datetime2)
datetime1:时间类型的字段或者时间常量，datetime2:时间类型的字段或者时间常量
diffDays(2023-04-26 07:10:33, 2022-12-05 18:31:48) = -141
数字
diffHours（返回两个日期值之间的差值，以小时为单位）
diffHours(datetime1,datetime2)
datetime1:时间类型的字段或者时间常量，datetime2:时间类型的字段或者时间常量
diffHours('2023-04-26 07:10:33', '2022-12-05 18:31:48')= -3396
数字
diffMinutes（返回两个日期值之间的差值，以分钟为单位）
diffMinutes(datetime1,datetime2)
datetime1:时间类型的字段或者时间常量，datetime2:时间类型的字段或者时间常量
diffMinutes(2023-04-26 07:10:33, 2022-12-05 18:31:48) = -203798
数字
diffMonths（返回两个日期值之间的差值，以月为单位
）
diffMonths(datetime1,datetime2)
datetime1:时间类型的字段或者时间常量，datetime2:时间类型的字段或者时间常量
diffMonths(2023-04-26 07:10:33, 2022-12-05 18:31:48) = -4
数字
diffSeconds（返回两个日期值之间的差值，以秒为单位）
diffSeconds(datetime1,datetime2)
datetime1:时间类型的字段或者时间常量，datetime2:时间类型的字段或者时间常量
diffSeconds(2023-04-26 07:10:33, 2022-12-05 18:31:48) = -12227925
数字
toDay（返回日期）
toDay(datetime)
datetime：时间类型的字段或者时间常量
toDay('2023-04-26 07:10:33')= '2023-04-26'
日期
toMonth（返回日期所在的月份
）
toMonth(datetime)
datetime：时间类型的字段或者时间常量
toMonth('2023-04-26 07:10:33') = '2023-04'
日期
toMonthFirstDay（返回日期所在月份第一天）
toMonthFirstDay(datetime)
datetime：时间类型的字段或者时间常量
toMonthFirstDay('2023-04-26 07:10:33') = '2023-04-01'
日期
系统参数
ME（当前登录人）
ME()
-
当前登录人 = ME()
文本
NOW（当前时间）
NOW()
-
关闭时间 < NOW()
日期
参数
START DATE（开始日期）
__START_DATE__
保存时需要选择__START_DATE__和__END_DATE__默认值，如果选择近七天则__START_DATE__为七天前日期，__END_DATE__为当天日期
开始日期 < __START_DATE__
日期
END DATE（结束日期）
__END_DATE__
结束日期 <__END_DATE__
日期
START TIME（开始时间）
__START_TIME__
保存时需要选择__START_TIME__和__END_TIME__默认值，如果选择自定义2024-12-01 01:01:01 到2024-12-10 10:10:10 则__START_TIME__为2024-12-01 01:01:01，__END_TIME__为2024-12-10 10:10:10
开始时间 < __START_TIME__
日期
END TIME（结束时间）
__END_TIME__
结束时间 < __END_TIME__
日期
- 在数据下，单击需要添加到方法里的指标字段或维度字段。用户可以参考结果提示的报错信息调整字段。
打开“自定义SQL”开关，用户可以在结果文本框输入自定义方法。
- 用户可以为明细数据添加筛选条件（非必选）：在查看明细数据的筛选条件下单击“新增筛选条件”，根据需要在下拉栏中选择目标条件并配置条件信息。用户需要在勾选“下钻”后，单击自定义指标查看配置条件后的信息。
- 单击“确定”。
