Skip to content

SeaTable Python 脚本编程

Javascript 脚本在当前的浏览器中直接运行，适合于对数据进行简单的处理。Python 脚本在服务器端运行，而且可以设置自动周期性运行，适合于更复杂的数据处理场景。

Python 脚本也可以在你的本地机器上运行，也可以上传到 SeaTable 云端运行。本地运行方便你开发调试，也可以方便的把脚本集成到更大的项目中。

如何让脚本同时支持本地云端中运行

脚本在云端运行的时候会提供一个 context 对象，里边包含了系统自动给你生成的服务器的地址和 base 的 API token。如果你在本地运行则需要手工指定这两个变量；其中 API token 可以在表格的下拉菜单 "高级 -> API Token" 中生成。

用以下的写法来支持脚本同时在本地和云端运行

from seatable_api import Base, context

server_url = context.server_url or 'https://cloud.seatable.cn'
api_token = context.api_token or 'c3c75dca2c369849455a39f4436147639cf02b2d'


base = Base(api_token, server_url)
base.auth()

如果你在云端编写的话，可以复制一下内容快速开始编写:

from seatable_api import Base, context

base = Base(context.api_token, context.server_url)
base.auth()

本地运行需要安装的库

脚本在本地运行的时候需要安装 seatable-api。

pip3 install seatable-api

要求

  • Python >= 3.5
  • requests
  • socketIO-client-nexus

一个简单的例子

下面的例子展示怎么在一个 base 中查询数据和更新数据。

base = Base(api_token, server_url)
base.auth()

# 查看行
rows = base.list_rows("Table1")

row_data = {'name': 'Tom', 'age': 18}
# 追加行
base.append_row('Table1', row_data)

# 更新行
base.update_row('Table1', 'U_eTV7mDSmSd-K2P535Wzw', row_data)

# 删除行
base.delete_row('Table1', 'U_eTV7mDSmSd-K2P535Wzw')

编程参考

SeaTable 中对象的数据结构:

SeaTable API 库介绍:

例子

可以通过这个链接找到一些容易理解的例子https://github.com/seatable/seatable-scripts-cn/tree/master/examples/python

具体如下