> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 跨表格引用
> DingTalk Sheets 跨表格引用：基于 IMPORTRANGE function，将其他表格指定范围的数据导入当前表格，源表更新后自动同步，无需手动复制，实现多表格数据互通与汇总。
跨表格引用数据，基于 IMPORTRANGE 函数，可以实现从指定的表格中，将目标范围内的单元格数据导入，并自动同步源表格的更新。借助跨表格引用，一步即可实现多表格数据互通，让数据处理更加高效。
**使用帮助目录**
1. 场景应用介绍1
2. 如何创建引用数据1
3. 查看/编辑已有引用1
4. 取消引用1
5. 跨表格关联引用失败情况说明1
6. 常见问题1
## 1. 场景应用介绍
钉三多是钉钉 coffee 全国总店店长，每天需要实时汇总「**全国各地门店销售情况**」。钉三多希望能够在一份总表里可以自动引用\*\*「不同地区门店的销售数据」\*\*，而不是手动复制，既能保障效率，也能保障后续人员信息更新后，所有引用这份数据的表格可以同步更新。最终效果如下图所示：
## 2. 如何创建引用数据
**方式一：通过功能菜单入口**
选中单元格后，在工具栏点击【菜单】【数据】-【跨表格引用】-【新建引用】，在弹窗中选择或搜索需要引用的表格文件，在右侧框选数据范围，点击【引用数据】即可完成。
**方式二：使用 IMPORTRANGE 函数**
选中单元格输入“=IMPORTRANGE”，可唤出函数面板，点击【选择表格】，在弹窗中选择或搜索需要引用的表格文件，在右侧框选数据范围，点击【引用数据】即可完成。
如果你对函数十分熟悉，可以直接输入公式：=IMPORTRANGE(在线表格链接, 区域范围)
例如：=IMPORTRANGE("[https://docs.dingtalk.io/](https://docs.dingtalk.io/)","'项目管理'!G21:G22")
**方式三：通过函数菜单入口**
选中单元格，点击工具栏【菜单】-【插入】-【公式】-【全部函数】，在【查找与引用】中找到 IMPORTRANGE 函数点击【插入】-【选择表格】，在弹窗中选择需要引用的表格文件，点击【引用数据】完成引用。
\*\* 温馨提醒\*\*
最后在确认引用后，会有小窗口提示授权信息，需要点击允许，否则无法成功生效。**如右图所示**
## 3. 查看/编辑已有引用
**有当前表格「可编辑」及以上权限的用户**，可以查看当前工作表中的跨表格引用。
**查看方式：**
* **查看全部引用**：通过主功能【菜单】-点击【数据】-【跨表格引用】-【查看全部引用】
* **查看选区内引用**：在选区范围右键唤出菜单，下滑到底选择【跨表格引用】
**同步数据源**
方式一：打开查看界面，在右侧点击表格卡片上的 
更新按钮
方式二：右键引用选区，在菜单中下滑到底选择【跨表格引用】-【刷新引用数据】
**修改引用区域**
方式一：打开查看界面，在右侧点击表格卡片上的 
修改按钮，在弹窗中重新选择引用表格及区域
方式二：右键引用选区，在菜单中下滑到底选择【跨表格引用】-【修改引用数据】，在弹窗中重新选择引用表格及区域
**打开引用源**
> （**注：有当前表格「可编辑」权限及以上的用户，可点击「打开」入口**）
方式一：打开查看界面，在右侧点击表格卡片上的引用表格，即可跳转
方式二：右键引用选区，在菜单中下滑到底选择【跨表格引用】-【打开源表格】
## 4. 取消引用
> **注：有当前表格「可编辑」权限及以上的用户，可取消引用**
方式一：打开查看界面，在右侧点击表格卡片上的 
取消按钮
方式二：右键引用选区，在菜单下滑到底选择【跨表格引用】-【取消引用】数据
## 5. 跨表格关联引用失败情况说明
1. **名词解释**
节点：“跨表格引用节点”是指被关联引用的文档或者数据单元，当跨表格引用时，每个独立的文档、表格、数据表等可以被视为一个“节点”，这些节点通过引用关系相互连接，形成一个网络或图状结构。
2. **跨表格引用失败分类及原因**
当在表格中进行跨表格引用数据时，常常会遇到无法成功引用数据的情况，其主要原因有以下几点：
1. **节点数量限制**
* **失败提示：**
* \*\*节点数量限制说明：\*\*指的是在这个引用网络中，所有直接或间接通过引用相连的文档总数，目前跨表格引用节点数量限制为不超过 10 个，当跨表格引用总数超过 10 个时，则会提示授权失败，超过节点数量限制，例如：
* A 引用 B、C，B 引用 D、E、F，此时这些文档的关联总数是6；
* 当总数达到10时，这十篇文档中的任意一篇都无法再引用第11篇文档、也无法被第11篇引用。
* 如果两组关联文档数加起来超过10，也无法把这两组引用关联起来。
1. **节点层数限制**
* **失败提示：**
* \*\*节点层数限制：\*\*则是指单一路径上文档引用的深度，即一个文档被另一个文档引用，后者又被第三个文档引用，以此类推，目前跨表格引用的文档深度不得超过 3 层，例如：
* A引用B、B引用C、C引用D，此时这四个文档间存在3层引用关系，D 中无法再继续引用第5篇文档、第5篇文档也无法引用 A。
1. **循环引用**
* **失败提示：**
* \*\*循环引用：\*\*指的是如果文档A引用了文档B，而文档B又直接或间接地引用回文档A，形成了一个闭环，这种情况目前跨表格引用不支持，避免数据处理时无限循环或者逻辑上的混乱，例如：
* A引用B，B引用C，此时C无法再引用A或B了，当然，文件引用自身也是不允许的。
3. **跨表格关联引用使用注意事项**
4. 关联引用文档数量不超过 10 篇；
5. 关联引用的文档不支持在线编辑；
6. 引用内容太多或包含复杂公式，引用数据超时也可能导致失败；
## 6. 常见问题
1. 跨表格引用功能暂不支持引用本地表格；
2. 暂不支持引用包含了「锁定-禁止查看」规则的表格；
3. 引用区域内，不能有其他数据，因为跨表格引用实现是基于「数组公式」实现的，展开的时候，需要保障展开的区域没有数据。如下图所示：
***