跳到主要内容

「Airtable 导入」小程序

「Airtable 导入」小程序支持从 Airtable 导入数据到维格表中,快速开始使用维格表发展你的业务。

cover

官方小程序 开源

安装小程序

打开「小程序中心」选择安装「Airtable 导入」小程序即可。

img1

使用小程序

在使用小程序前,需要先获取 Airtable 账号下的 Personal Access Token ,然后在小程序填入即可开始获取原始数据并导入。

1. 获取 Personal Access Token

您可以通过此链接创建和管理 Personal Access Token。需要注意的是,Personal Access Token 与此前的 API Key 不同。Airtable 已宣布将于 2024 年 1 月底停用 API Key,请参阅此文章以获取更多详细信息。

当你进入创建和管理个人访问令牌的页面后,点击「Generate new token」按钮即可创建一个新的 Personal Access Token。

generate new token

点击「Generate new token」按钮后,需要输入 Name、Scopes 和 Access。其中,Scopes 需要勾选「data.records:read」和「schema.bases:read」,Access 需要勾选你希望导入数据所在的「Bases 和 workspaces」。设置完成后通常如下图所示:

create new token

设置完成后,点击「Create token」按钮即可创建一个新的 Personal Access Token。创建完成后,你可以点击右侧的复制按钮将 Personal Access Token 复制到剪贴板中。

copy token

2. 使用 Airtable 导入小程序

  1. 点击开始导入按钮,进入导入页面

    start import

  2. 输入 Personal Access Token

    input token

  3. 选择 Base

    select base

  4. 选择 Table

    select table

  5. 输入 View ID(可选)

    如果想要指定从某一个视图中拉取数据,则需要填入 Airtable 的 View ID,Airtable View ID 需要先进入想要导入的视图后再从链接中获取,通常 View ID 是 viw 开头的一串字符串,如下所示:

    img6

  6. 点击下一步后,将进入字段类型选择页面,在这里需要你为待导入的 Airtable 字段选择字段类型,导入完成后将在维格表中创建相应的字段并填充对应的数据。

    select field type

  7. 最后点击「开始导入」按钮即可开始导入数据。

常见问题

1. 鉴权失败

  • unauthorized, invalid authentication token
  • authentication_required
  • Unauthorized: Error Personal Access Token.

错误含义:提供了无效的 Personal Access Token

解决方案:检查使用的 Personal Access Token 是否有效,且 Scopes 和 Access 是否设置正确

2. 权限问题

  • invalid_permissions
  • invalid_permissions (field or table operation limits)

错误含义:没有对应的导入数据的权限

解决方案:检查使用的 Personal Access Token 中的 Scopes 和 Access 是否设置正确

3. 资源问题

  • NOT FOUND
  • MODEL ID NOT FOUND
  • VIEW NOT FOUND

错误含义:Airtable 中没有对应数据

解决方案:检查使用的 Personal Access Token 或 View ID 是否正确

4. 列类型支持情况

  • 附件
  • 单行文本
  • 多行文本
  • 多选
  • 数字
  • 评分。默认属性 icon 为 ‘star’
  • 勾选。默认 icon 为 ‘white_check_mark’
  • 日期。默认格式 ‘YYYY/MM/DD’
  • 网址
  • 货币。默认属性 precision 为 2,symbol 为 ‘¥’
  • 百分比。默认 precision 为 2
  • 电话
  • 邮箱
  • 单选
  • 智能公式
  • 成员
  • 单向关联
  • 双向关联
  • 神奇引用