> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/build/duaer-metrics.md).

# 在 Duaer 里用一张指标表管指标

在 Duaer 里，每个项目都自带一张名为 Duaer metrics 的数据表，指标都写进这张表。定时运行的数字组织负责写数，Duaer 指标目录决定谁能看哪个指标、哪个维度值。
## Duaer 自带的指标表

每个 Duaer 项目（包括个人空间）都自带一张 Duaer metrics 表，不用建。它在数据表列表里带内置标记。

这张表锁定：不能删除、改名，也不能增删或改名列。数字组织照常往里写行。也不能再建一张同名的表。

- metric：指标键，例如 sales.revenue
- period：这一期的开始日期
- value：数值
- dimension_type：维度类型，例如 region；合计行留空
- dimension：维度值，例如 East；合计行留空
- note：可选的一句说明

## 用数字组织写入 Duaer 指标

1. 加 Schedule Trigger，按指标的周期设定时间，例如每天或每月一号。
2. 读源数据：数据表、CRM、金蝶或 HTTP 接口都可以。
3. 用 Summarize 或 Code 算出合计，再按维度各算一行。
4. 加 Data table 节点，选 Duaer metrics，操作选 Upsert。匹配条件用 metric、period、dimension_type、dimension 相等；合计行的两个维度列用 isEmpty。
5. 发布这条数字组织。重跑同一期只会覆盖，不会重复。

```
[
  { "metric": "sales.revenue", "period": "2026-09-01T00:00:00.000Z", "value": 120000, "dimension_type": "", "dimension": "" },
  { "metric": "sales.revenue", "period": "2026-09-01T00:00:00.000Z", "value": 70000, "dimension_type": "region", "dimension": "East" },
  { "metric": "sales.revenue", "period": "2026-09-01T00:00:00.000Z", "value": 50000, "dimension_type": "region", "dimension": "South" }
]
```

也可以直接让 Duaer 设计师来搭：说清楚要跟踪哪个数、从哪里读、按什么维度拆。它会按下面的约定写进 Duaer metrics，并提议补历史数据。

## 设计 Duaer 指标键

- 键用英文小写加点：<领域>.<度量>，例如 sales.revenue、support.tickets_open。上线后不要改键。
- 一行一个数。比率存百分数，例如 12.5 表示 12.5%。
- period 写这一期的开始日期（UTC 零点）。同一个键只用一种周期。
- 每期都写一行合计（两个维度列为空），再按维度各写一行。一行只放一个维度。
- 维度值就是权限的钥匙，写法要始终一致，例如一直写 East，不要有时写 east。

## 决定谁能看哪个 Duaer 指标

1. 在我的指标或 Duaer metrics 表页点指标目录。只有能编辑数据表的人能打开。
2. 成员组：新建组，例如 East sales，选进项目成员。
3. 维度规则：给每个维度值指定成员组或成员，例如 region=East → East sales。规则对所有指标生效。
4. 指标：填显示名和单位，添加可见人，范围选按维度规则或全部维度和合计，再打开已发布并保存。

新写入的指标键默认未发布、没有可见人。按维度规则的人只看到分给自己的维度值，看不到合计，避免倒推出别人的数。还没有规则的维度值，只有全部维度和合计的人能看到。

## 订阅 Duaer 指标

在运营报告的我的指标里点添加指标，选你能看的指标。卡片显示最新值、和上一期相比的变化和走势。被移出可见范围后，卡片会显示无权查看。
## Questions

### 数字组织能改 Duaer 指标的可见范围吗？

不能。Duaer 指标目录、成员组和维度规则在表外，数字组织只能往 Duaer metrics 写数。

### 普通成员能直接打开 Duaer metrics 表吗？

不能。原始行只给能编辑数据表的人看；其他成员在我的指标里只看到分给自己的数。

### 能删掉或改名 Duaer metrics 表吗？

不能。Duaer metrics 是每个 Duaer 项目自带的锁定表；只有删除整个项目时它才会一起删掉。

## 相关

- [在 Duaer 里用数据表留下结果](https://doc.duaer.com/zh/build/data-tables.md)
- [在 Duaer 里用 Schedule Trigger 定时运行](https://doc.duaer.com/zh/build/schedule-trigger.md)
- [在 Duaer 里用 Summarize 汇总字段](https://doc.duaer.com/zh/build/summarize.md)