Airtable

連線設定範例

本節列出您在建立連線時設定的各種欄位範例值。

個人存取權杖連線類型

實體、作業和動作

所有整合連接器都為已連結應用程式的物件提供一層抽象層。您只能透過這個抽象層存取應用程式的物件。抽象概念會以實體、作業和動作的形式提供給您。

• 實體： 實體可視為已連結應用程式或服務中的物件或屬性集合。實體的定義與連接器至連接器的定義不同。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可對實體執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體後，系統會產生可用於該實體的作業清單。如需作業的詳細說明，請參閱連接器工作中的實體作業。不過，如果連接器不支援任何實體作業，則 Operations 清單中不會列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合項目的一流函式。動作可讓您變更實體或多個實體，而這些變更會因連接器而異。通常，動作會包含一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，在這種情況下，Actions 清單會為空白。

實體操作範例

本節說明如何在這個連接器中執行部分實體作業。

範例：聯絡資料 (記錄) 實體的列出作業

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Contact Data。
3. 選取 List 作業，然後按一下「Done」。
4. 在「Connector」工作中的「Task Input」部分，您可以根據客戶需求設定「filterClause」。

請一律在單引號 (') 內指定篩選器子句值。

您也可以對下列實體執行清單作業：
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. 選取 GET 作業，然後按一下「Done」。
4. 將實體 ID 設為「recg7qjPRMa7DBwIb」，這是要傳遞的 Key。如要設定實體 ID，請在「資料對應」的「資料對應」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "recg7qjPRMa7DBwIb"，並選擇「EntityId」做為區域變數。

   其中，實體 ID：「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 作業，然後按一下「Done」。
4. 將實體 ID 設為「recg7qjPRMa7DBwIb」，這是要傳遞的鍵。如要設定實體 ID，請在「資料對應」的「資料對應」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "recg7qjPRMa7DBwIb"，並選擇 EntityId 做為本機變數。

如果實體具有複合式主鍵，您可以指定篩選器子句。

範例：建立聯絡資料 (記錄) 實體的作業

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Contact Data。
3. 選取 Create 運算，然後按一下「Done」。
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>
   

範例：聯絡資料 (記錄) 實體的更新作業

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 ContactData。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

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

   您也可以將 entityId 設為 Internal_Id='reckqGnFusjDlnmvs'，而非指定 entityId。

如果整合成功，連接器工作 connectorOutputPayload 的輸出變數會：

{
"Internal_Id": "reckqGnFusjDlnmvs"
}

範例 - 聯絡人資料 (附件) 實體的更新作業

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Contact Data。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

   {
   "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 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

   {
   "Checkbox": true
   }
   

   您可以將 filterClause 設為 Internal_Id='reckqGnFusjDlnmvs'，而非指定 entityId。

   如果整合成功，連接器工作 connectorOutputPayload 的輸出變數會：

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

範例：聯絡資料 (電話號碼) 實體的更新作業

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 ContactData。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

   {
   "Number": 1001.0
   } 
   

   您可以將 filterClause 設為 Internal_Id='reckqGnFusjDlnmvs'，而非指定 entityId。

   如果整合成功，連接器工作 connectorOutputPayload 輸出變數會：

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   } 
   

範例：聯絡人資料 (DateField) 實體的更新作業

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 ContactData。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

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

   您可以將 filterClause 設為 Internal_Id='reckqGnFusjDlnmvs'，而非指定 entityId。

   如果整合成功，連接器工作 connectorOutputPayload 輸出變數會：

   {
   "Internal_Id": "recoGHHp8y11aSx0E"
   }
   

範例 - 聯絡資料 (文字) 實體的更新作業

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 ContactData。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

   {
   "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"
   }