# 自定义分析
{% hint style="warning" %} **`自定义分析`** 当前处于 **测试版**。\
在正式发布后，它将成为付费功能。
{% endhint %}
***
## 主要亮点
* 使用 SQL 查询你的 BoxHero 数据。
* 组合条件（例如商品、属性、价格、日期范围、合作伙伴）来定义你想作为自定义报表返回的数据。
* 保存你经常使用的查询，并可随时再次打开。
* 将结果导出到 Excel，以便进行进一步分析或报告。
## 何时使用自定义分析
标准的 **`库存报告`** 功能可让你快速查看所选期间的平均库存数量和库存周转率等关键指标。由于这些报告使用预定义的公式和字段，它们可能无法涵盖你团队所需的所有分析类型。
**`自定义分析`** 让你在探索数据时拥有更多控制权。它尤其适用于以下情况：
* 你无法在标准的中找到所需数据 [库存报告](https://www.boxhero.io/docs/documentation/zh/qi-ta-gong-neng/analytics)
* 你想按商品、供应商、客户、团队成员或其他详细条件筛选或分组数据
* 你需要按时间进行分析，例如按月、按季度或同比
* 你想保存自己依赖的报表并再次使用
* 你需要灵活的数据来支持报告或决策制定
***
## 如何使用自定义分析
### 1. 开始使用
前往 **`报表`** > **`自定义分析`**。这将打开一个新的工作区，你可以在其中创建和管理 SQL 查询。然后，选择 **`+ 新建`** 来创建新的查询。
### 2. 编写查询
查询使用 [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction)。你可以下载 **`AI 提示`** 文件以查看所有可用的表和列。
{% hint style="success" %}
如果你正在使用 **AI 工具** ，例如 ChatGPT 或 Gemini，附加“*AI 提示”* 文件有助于生成准确的 SQL。
{% endhint %}
选择 **`执行`** 来测试你的查询。由于结果取决于你编写的条件，请检查输出以确认其符合你的预期。
当查询成功运行后，你可以使用 **`导出到 Excel`**.
### 3. 保存查询
如果你计划重复使用某个查询，请选择 **`保存`** 位于右上角。
已保存的查询会显示在左侧边栏中，你可以随时打开并运行它们。
{% hint style="info" %}
你的数据会自动同步 **每天一次**。\
如需立即同步，请点击侧边栏底部的同步图标（🔄）。
{% endhint %}
***
## 查询变量
如果你在查询中包含 `{{variable_name}}` ，查询运行时会自动生成一个输入字段。该字段中输入的值会应用到 SQL 查询中的该变量。
当你保存查询后，你的团队成员可以在变量字段中输入自己的值，并在需要时运行报表。
#### 示例
1. 要搜索包含特定关键词的商品，请输入以下查询：
```sql
select sku, name
from items
where name ilike '%' || {{item_name}} || '%';
```
2. 当你运行查询时，一个名为 **item\_name** 的输入字段会出现。
3. 输入一个关键词，例如 *`sweater`* ，结果将显示所有名称中包含 *“sweater”* 的商品。
4. 如果你打算再次使用该查询，请保存它。你可以随时从左侧菜单中选择并载入已保存的查询。
***
## 使用场景
自定义分析包含可立即运行的内置模板。先查看模板以了解其工作方式，然后根据你的需求进行调整或创建新的查询。
#### 模板
* 每周库存进出报表
* 每月采购与销售趋势
* 按商品查看最近出库日期
***
## 常见问题（FAQ）
### 我可以合并多个团队的数据吗？
不可以。数据按团队分开，你只能分析当前登录的团队的数据。
### 我可以限制成员使用自定义分析吗？
管理员和成员都可以创建和查看查询。拥有自定义权限的成员 *不能* 使用此功能。
如果你需要限制某个成员的访问权限，请为其分配一个 [自定义权限](https://www.boxhero.io/docs/documentation/zh/she-zhi/members#custom-roles-and-permissions) ，并 **勾选所有权限**。自定义分析 *不* 包含在自定义权限选项中，因此即使勾选了所有权限，该成员也无法访问。
