> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/zh-cn/other-features/custom-analytics.md).

# 自定义报表

> 向 AI 助手询问所需的库存数据，构建标准报告之外的自定义报表。您可以将结果可视化为图表、保存以便再次运行，或导出到 Excel。

![自定义报表](https://assets.boxhero.io/docs/images/980a2afbb393abc7edc6b81724d9d79a08cea4cd103ace17bed7e9bc11e34fea-1600x940.png)

---

## 主要亮点

- 使用日常语言**向 AI 助手询问**所需的库存数据。
- 组合商品、属性、价格、日期范围、合作伙伴等条件，**构建自定义报表**。
- **保存常用报表**，随时再次访问。
- 通过内置的版本历史**恢复报表的早期版本**。
- 以图表形式**可视化数据**，或将其导出到 Excel。

## 使用场景

标准的`库存报告`功能可让您快速查看所选期间内的平均库存数量、库存周转率等关键指标。但由于这些报告使用的是预定义的变量和公式，可能无法满足团队所需的所有报告类型。

`自定义报表`让您能够更灵活地处理库存数据。只需向 **AI 助手**说明所需的数据，包括想要的条件和列，几秒钟内即可获得自定义报表。它在以下情况下尤其有用：

- 无法从标准库存报告中获取所需数据时
- 希望按商品、供应商、客户或团队成员等详细条件细分数据时
- 需要比较不同时间段的数据时，例如按月、按季度或同比
- 需要特定数据来支持报告或决策时

[Video](https://customer-0jrbilsa8yt3k758.cloudflarestream.com/962c957b64db1649124faed7790e9ce9/iframe?poster=https%3A%2F%2Fcustomer-0jrbilsa8yt3k758.cloudflarestream.com%2F962c957b64db1649124faed7790e9ce9%2Fthumbnails%2Fthumbnail.jpg%3Fheight%3D1080%26time%3D12s&letterboxColor=transparent)

---

## 如何使用自定义报表

### 1. 打开 AI 助手

前往`报告` > `自定义报表`。

首次使用时，**AI** **助手**会自动打开。否则，请点击`+ 新建报表`开始新的报表，并向 AI 助手询问所需的数据。

![](https://assets.boxhero.io/docs/images/7548249fe4cdac38b1a4e66ef8731ea4bb89577cfbc7d3a7c497a0545496fb09-2800x1508.jpg)

> **Caution**
>
> **管理员**和**成员**均可创建和查看自定义报表。您可以通过设置[自定义角色](https://www.boxhero.io/docs/zh-cn/concepts/members#custom-roles-and-permissions)来限制访问权限。

### 2. 请求数据

使用日常语言向`AI 助手`询问所需的数据。

例如，输入：_“显示上周按类别划分的库存水平”_，助手就会根据您的请求创建报表。

![](https://assets.boxhero.io/docs/images/257d4c464937618ac578fa8f8476293c79e03721cdfb65c80fef10e575c7897b-2800x1500.jpg)

> **Tip**
>
> 请尽可能具体地说明您想要的**条件**和**列**。您提供的细节越多，报表就越符合您的需求。

> “显示上个月的销售数据。”\
> “显示上个月按商品统计的总销量和销售额，按销售额取前 10 名。”

![](https://assets.boxhero.io/docs/images/1c6197501ae47ac9ec59fa963b88c0339cd0c860d4d1386b66832731e8e59bd7-2800x1507.jpg)

如果您需要只更改搜索值、反复运行同一份报表，可以让 AI 助手添加一个 **输入** **字段**。添加后，每次都可以输入新的值，无需重新创建报表。

![](https://assets.boxhero.io/docs/images/75a18087e7509aabe03f19cc1b5c6ab5a60b6337917341181246540f6e6dcc30-2800x1508.jpg)

> **Tip**
>
> 对于商品名称、日期或供应商等经常变化的值，请使用 **输入** **字段**。

### 3. 使用数据

结果会以表格形式显示。点击`导出 Excel`即可下载，或点击`添加图表`将其可视化为图表——支持柱状图、折线图、饼图、堆叠柱状图和堆叠面积图。

![](https://assets.boxhero.io/docs/images/636a62381e6e474216eae3d5e413f6e44ebba7ac4dd1f55d0aed75ad891397f3-2800x1503.jpg)

![](https://assets.boxhero.io/docs/images/03949f5e4294caf9399194bf9c62d2c53144577b0e8365ebabe428535d8bd297-2800x1507.jpg)

结果会自动保存到`我的报表`，您可以随时打开并再次运行。如果做了不想要的更改，可以将报表回滚到早期版本——点击`...`（更多）> `版本历史`。

![](https://assets.boxhero.io/docs/images/0c654c9356739769131e0db53a065e456ab8b4ecd00c00eebd8d04d107b21f37-2800x1636.jpg)

> **Note**
>
> 您的数据会**每天一次**自动同步。要查看最新数据，请在运行报表前点击左下角的**同步按钮**（🔄）。

> **Caution**
>
> 对于具有多种状态的字段（例如[订单状态](https://www.boxhero.io/docs/zh-cn/key-features/purchase-and-sales#purchase-order-status)），AI 的理解可能与您的本意不同。已删除的数据也可能以不同于预期的方式处理。在工作中使用输出结果前，请务必先进行确认。

---

## 模板

自定义报表内置了可立即运行的模板。试着运行一个模板查看结果。如果觉得有用，请点击`保存到我的报表`，并根据需要进行调整。

![](https://assets.boxhero.io/docs/images/5a1435d61d0d1f4d0f295a29677ea5c1d98685289dcb53c843d26de211c73422-2800x1509.jpg)

#### 示例

- 每日总库存
- 每周交易摘要
- 每月采购与销售趋势
- 各商品最后出库日期
- 先进先出（FIFO）库存估值
- 可用库存

---

## SQL 编辑

如果您熟悉 SQL，可以使用 [DuckDB SQL](https://duckdb.org/docs/current/sql/introduction) 语法直接编辑查询，按照您的需要精确定制报表。

选择一个报表，点击右上角的`...`按钮，然后选择`编辑 SQL`。

![](https://assets.boxhero.io/docs/images/1d3e74c9c95497f17d9185ffb7e06f5e287d3a894246c51e89526d7e02509b17-2800x1507.jpg)

您还可以在查询中加入`{{variable_name}}`来添加输入字段。例如：

```sql
select sku, name
from items
where name ilike '%' || {{item_name}} || '%';
```

这会创建一个名为 item_name 的 **输入** **字段**。输入 _sweater_ 等关键词后，结果将显示名称中包含“sweater”的所有商品。

![](https://assets.boxhero.io/docs/images/fccc6947094e4b6f0e085af9cf346e75a5956c4024e76b44dcefb8ebba20134c-2800x1609.jpg)

> **Caution**
>
> 在依赖结果之前，请务必先检查结果。

---

## 常见问题

**还有疑问？** 请查看我们的自定义报表常见问题：

- [自定义报表](https://www.boxhero.io/docs/zh-cn/faq/reporting/custom-analytics)