Airtable

连接配置示例

本部分列出了您在创建关联时配置的各种字段的示例值。

个人访问令牌连接类型

实体、操作和动作

所有集成连接器都会为所连接应用的对象提供抽象层。您只能通过此抽象访问应用的对象。抽象作为实体、操作和动作向您展示。

• 实体：实体可以被视为连接的应用或服务中的对象或属性集合。不同连接器的实体定义也会有所不同。例如，在数据库连接器中，表是实体；在文件服务器连接器中，文件夹是实体；在消息传递系统连接器中，队列是实体。

  但可能的情况是，连接器不支持或不具有任何实体，在这种情况下，Entities 列表将为空。

• 操作：操作是指您可以对实体执行的操作。您可以对实体执行以下任一操作：
  • 列表
  • 获取
  • 创建
  • 更新
  • 删除

  从可用列表中选择一个实体，系统会生成该实体可用的操作列表。如需了解操作的详细说明，请参阅连接器任务的实体操作。不过，如果连接器不支持任何实体操作，则 Operations 列表中不会列出此类不受支持的操作。

• 动作：动作是可通过连接器接口提供给集成的头等函数。动作可让您对一个或多个实体进行更改，并且动作因连接器而异。通常，操作会有一些输入参数和一个输出参数。但可能的情况是，连接器不支持任何动作，在这种情况下，Actions 列表将为空。

实体操作示例

本部分介绍如何在此连接器中执行一些实体操作。

示例 - 联系数据（记录）实体的列表操作

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Contact Data。
3. 选择 List 操作，然后点击完成。
4. 连接器任务的任务输入部分中，您可以根据客户要求设置 filterClause。

请务必使用单引号 (') 指定过滤条件子句值。

您还可以对以下实体执行列表操作：
Contacts Data.Main View、Contacts Data.Calendar、Contacts Data.Kanban、Contacts Data.Gallery、Contacts Data.List 和 Contacts Data_Collaborators

示例 - 获取“Contact Data (Records)”实体的记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Contact Data。
3. 选择 GET 操作，然后点击完成。
4. 将实体 ID 设置为“recg7qjPRMa7DBwIb”，即要传递的键。如需设置实体 ID，请在数据映射的数据映射器部分，点击打开数据映射编辑器，然后在输入值字段中输入 "recg7qjPRMa7DBwIb"，并选择 EntityId 作为本地变量。

   在这里，“recg7qjPRMa7DBwIb”是唯一的主键值，必须直接传递。

如果实体具有复合主键，您可以指定过滤子句。

您还可以对以下实体执行 get 操作： Contacts Data.Main View、Contacts Data.Calendar、Contacts Data.Kanban、Contacts Data.Gallery、Contacts Data.List 和 Contacts Data_Collaborators。

示例 - 删除“联系数据（记录）”实体的记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Contact Data。
3. 选择 Delete 操作，然后点击完成。
4. 将实体 ID 设置为“recg7qjPRMa7DBwIb”，即要传递的键。如需设置实体 ID，请在数据映射的数据映射器部分中，点击打开数据映射编辑器，然后在输入值字段中输入 "recg7qjPRMa7DBwIb"，并选择 EntityId 作为本地变量。

如果实体具有复合主键，您可以指定过滤子句。

示例 - 针对“联系数据（记录）”实体执行创建操作

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Contact Data。
3. 选择 Create 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload 作为本地变量。

   {
   "First Name": "Demo4",
   "Last Name": "Alex",
   "Email": "cloudysanfrancisco@gmail.com",
   "DOB": "2000-04-14",
   "Office": "Denver",
   "Phone Number": "1-175-432-1437",
   "Current Brand": "Mercedes"
   }
   

   如果集成成功，连接器任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

   {
   "Internal_Id": "recg7qjPRMa7DBwIb"
   }
     
   <pre>
     function helloWorld() {
       alert('Hello, world! This sentence is so long that it wraps onto a second
         line.');
     }
     
     /n
     <h3>Example title</h3>
     </pre>
   

示例 - 对“Contact Data (Records)”实体执行更新操作

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 ContactData。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。

   {
   "Phone Number": "1-175-432-4312",
   "Current Brand": "Honda"
   }
   

   您也可以将 filterClause 设置为 Internal_Id='reckqGnFusjDlnmvs'，而不是指定 entityId。

如果集成成功，连接器任务的 connectorOutputPayload 输出变量：

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

示例 - 针对“联系人数据（附件）”实体执行更新操作

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Contact Data。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。

   {
   "Attachment": "[{\"url\":\"https://media.istockphoto.com/id/2086323995/photo/global-communication-east-asia.jpg?s=2048x2048&w=is&k=20&c=Z50lesspQQzxWug0m11QrPZMOUzMeTufgnLHh_3COy4=\",\"filename\":\"BMW\"}]"
   }
   

   您也可以将 filterClause 设置为 Internal_Id='reckqGnFusjDlnmvs'，而不是指定 entityId。

   如果集成成功，连接器任务的 connectorOutputPayload 输出变量：

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

示例 - 对“联系信息（复选框）”实体执行更新操作

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 Contact Data。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。

   {
   "Checkbox": true
   }
   

   您也可以将 filterClause 设置为 Internal_Id='reckqGnFusjDlnmvs'，而不是指定 entityId。

   如果集成成功，连接器任务的 connectorOutputPayload 输出变量：

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

示例 - 对“联系数据（电话号码）”实体执行更新操作

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 ContactData。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。

   {
   "Number": 1001.0
   } 
   

   您也可以将 filterClause 设置为 Internal_Id='reckqGnFusjDlnmvs'，而不是指定 entityId。

   如果集成成功，连接器任务的 connectorOutputPayload 输出变量：

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

示例 - 对“联系人数据 (DateField)”实体执行更新操作

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 ContactData。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。

   {
   "DOB": "2000-04-14"
   } 
   

   您也可以将 filterClause 设置为 Internal_Id='reckqGnFusjDlnmvs'，而不是指定 entityId。

   如果集成成功，连接器任务的 connectorOutputPayload 输出变量：

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

示例 - 针对“联系人数据（文本）”实体执行更新操作

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择 ContactData。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。

   {
   "Singlelinetext": "Airtable Application",
   "Long text": "Airtable is a cloud-based collaboration platform that combines the features of a spreadsheet with the capabilities of a database. "
   }
   

   您也可以将 filterClause 设置为 Internal_Id='reckqGnFusjDlnmvs'，而不是指定 entityId。

   如果集成成功，连接器任务的 connectorOutputPayload 输出变量：

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }