> ## Documentation Index
> Fetch the complete documentation index at: https://rpa.bazhuayu.com/helpcenter/llms.txt
> Use this file to discover all available pages before exploring further.

# 读取表格数据

## 指令说明

**描述：** 读取钉钉表格的单元格数据或区域数据

## 参数说明

<Tabs>
  <Tab title="常规">
    <img src="https://mintcdn.com/bazhuayu-rpa-docs/W742rR5fGwXr1akA/helpcenter/commands/dingtalk/images/readdingtalksheetcommand-04.png?fit=max&auto=format&n=W742rR5fGwXr1akA&q=85&s=f004e46b4d6f531380629e38858ce920" alt="读取表格数据指令参数面板" width="643" height="583" data-path="helpcenter/commands/dingtalk/images/readdingtalksheetcommand-04.png" />

    | 参数          | 说明                                          |
    | ----------- | ------------------------------------------- |
    | **钉表格对象**   | 选择需要读取的钉钉表格对象                               |
    | **Sheet名称** | Sheet名称或ID，可直接输入或通过获取Sheet页名称获取             |
    | **读取方式**    | 请选择读取方式，可以读取指定单元格、指定行、指定列或指定区域的内容           |
    | **行号**      | 读取方式选中指定行之后需要选择，选择要读取的行的行号，从1开始             |
    | **列名/列号**   | 读取方式选中指定列之后需要选择，选择要读取的列的列名/列号，从A或1开始        |
    | **开始行号**    | 读取方式选中指定区域之后需要选择，选择要读取区域的开始行，输入行号，从1开始      |
    | **结束行**     | 读取方式选中指定区域之后需要选择，选择读取结束行，从1开始               |
    | **开始列**     | 读取方式选中指定区域之后需要选择，选择要读取区域的开始列，输入列名/列号，从A或1开始 |
    | **结束列**     | 读取方式选中指定区域之后需要选择，选择读取结束列，输入列名/列号，从A或1开始     |
  </Tab>

  <Tab title="高级">
    | 参数       | 说明                                                      |
    | -------- | ------------------------------------------------------- |
    | **读取格式** | 值：单元格的真实值，如果是公式则显示公式计算后的结果、 公式：单元格的公式、 显示值：在表格界面上所看到的结果 |
  </Tab>
</Tabs>

## 使用示例

<img src="https://mintcdn.com/bazhuayu-rpa-docs/W742rR5fGwXr1akA/helpcenter/commands/dingtalk/images/readdingtalksheetcommand-01.png?fit=max&auto=format&n=W742rR5fGwXr1akA&q=85&s=8eb6b1b5771db1c093a44099557fe00e" alt="读取表格数据使用示例" width="1064" height="193" data-path="helpcenter/commands/dingtalk/images/readdingtalksheetcommand-01.png" />

**该流程执行逻辑：**

1. 使用【连接钉钉表格】连接目标表格并生成钉钉表格对象。
2. 执行【读取表格数据】，选择 `Sheet1` 第 1 行第 1 列的单元格。
3. 将读取到的单元格内容保存到结果变量，供后续判断、计算或日志输出使用。

### 效果展示

<img src="https://mintcdn.com/bazhuayu-rpa-docs/W742rR5fGwXr1akA/helpcenter/commands/dingtalk/images/readdingtalksheetcommand-03.png?fit=max&auto=format&n=W742rR5fGwXr1akA&q=85&s=33546b316e1866e0d98237f367522944" alt="读取表格数据效果展示" width="722" height="499" data-path="helpcenter/commands/dingtalk/images/readdingtalksheetcommand-03.png" />

<img src="https://mintcdn.com/bazhuayu-rpa-docs/W742rR5fGwXr1akA/helpcenter/commands/dingtalk/images/readdingtalksheetcommand-02.png?fit=max&auto=format&n=W742rR5fGwXr1akA&q=85&s=d63f0075f50e38cb7994530eaf215258" alt="读取表格数据效果展示" width="1067" height="231" data-path="helpcenter/commands/dingtalk/images/readdingtalksheetcommand-02.png" />

<Info>
  使用指令过程中遇到问题？前往 [八爪鱼RPA 开发者社区问答板块](https://rpa.bazhuayu.com/community/questions) 提问，获取官方与社区帮助。
</Info>