钉钉在线表-读取表格数据

一、功能描述

获取钉钉在线表单元格属性。目前可以获取单元格内的值、公式、显示值、背景色

运行本组件可获取A1:C4的单元格属性信息，能获取到以下信息

• A1:C4每一个单元格内的显示值，如：[['日期', '已上线组件数量', '新增组件数量'], ['2024-03', 731, ''], ['2024-04', 801, 70], ['2024-05', 809, 8]]
• A1:C4每一个单元格内的公式，如：[['', '', ''], ['', '', ''], ['', '', '=B3-B2'], ['', '', '=B4-B3']]
• A1:C4每一个单元格内带格式的显示值，如：[['日期', '已上线组件数量', '新增组件数量'], ['2024-03', '731', ''], ['2024-04', '801', '70'], ['2024-05', '809', '8']]
• A1:C4每一个单元格的背景色信息，如：[[{'red': 228, 'green': 237, 'blue': 219, 'hexString': '#e4eddb'}, {'red': 228, 'green': 237, 'blue': 219, 'hexString': '#e4eddb'}, {'red': 158, 'green': 195, 'blue': 231, 'hexString': '#9ec3e7'}], [{'red': 0, 'green': 0, 'blue': 0, 'hexString': '#000000'}, {'red': 0, 'green': 0, 'blue': 0, 'hexString': '#000000'}, {'red': 0, 'green': 0, 'blue': 0, 'hexString': '#000000'}], [{'red': 0, 'green': 0, 'blue': 0, 'hexString': '#000000'}, {'red': 0, 'green': 0, 'blue': 0, 'hexString': '#000000'}, {'red': 0, 'green': 0, 'blue': 0, 'hexString': '#000000'}], [{'red': 0, 'green': 0, 'blue': 0, 'hexString': '#000000'}, {'red': 0, 'green': 0, 'blue': 0, 'hexString': '#000000'}, {'red': 0, 'green': 0, 'blue': 0, 'hexString': '#000000'}]]

 

二、属性说明

组件输入

• 钉钉表格对象：字典；钉钉表格连接对象，可使用【钉钉在线表-连接表格对象】组件进行获取
• Sheet页名称或ID：字符串；待删除工作表的sheet页名称/工作表sheet页ID
• 读取范围：字符串；设置需获取数据的表格单元格区域，当为单元格时：A1；当为区域时：A1:C3
• 筛选返回字段：多选下拉框；选择需获取的类型

组件输出

• 执行结果：在此处输出获取的内容

高级属性

• 错误继续执行：组件运行异常时，流程是否继续运行
• 执行前延时(秒)：运行组件前的延时时间
• 执行后延时(秒)：运行组件后的延时时间

 

三、使用实例

实例描述：钉钉在线表-读取表格数据，获取指定钉钉在线表中名为"组件数据"的Sheet页的A1:C4的数据，并将执行结果输出至控制台。

前置环境：

该流程需要使用"钉钉在线表-连接表格对象"组件来获取钉钉表格对象。（关于该组件的具体使用详情可参考其使用文档）

流程编辑：

运行结果：

运行展示：

 

四、常见问题

1、钉钉表格对象过期

组件运行提示：钉钉表格对象过期，请重新获取

解决方案：钉钉表格对象已失效，请重新运行【钉钉在线表-连接表格对象】组件即可

2、依赖包缺少

组件运行提示：No module named 'alibabacloud_dingtalk'

解决方案：点击“python包”-点击“一键安装”，等待安装完成即可