跳到主要内容

「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
  • 电话
  • 邮箱
  • 单选
  • 智能公式
  • 成员
  • 单向关联
  • 双向关联
  • 神奇引用
最后于 更新