SendGrid

設定驗證機制

實體、作業和動作

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

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

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

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

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

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

動作

本節列出連接器支援的部分動作。如要瞭解如何設定動作，請參閱「動作範例」。

SendMail2 動作

這項動作會傳送電子郵件和附件。

「傳送電子郵件」動作的輸入參數

傳送電子郵件動作的輸出參數

無論郵件是否傳送成功，這項動作都會傳回確認訊息。

動作範例

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

範例 - 傳送電子郵件

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 SendMail2 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
       "FromName": "Name",
       "FromEmail": "cloudysanfrancisco@gmail.com",
       "Subject": "[{\"value\": \"cymbalgroup.com\",\"type\": \"text/plain\"}]",
       "TemplateId": "d-c4bc730a0b094a3a9d9cabb7347b5edc",
       "Personalizations": "[{\"subject\": \"Test Subject3\",\"send_at\": 1698659820,\"from\": {\"name\": \"hi\",\"email\": \"email@gmail\"},\"to\":      
       [{\"email\": \"email@gmail.com\",\"name\": \"test\"}\n ]}]",
       "Content": "[{\"value\": \"abc@cdata.com\",\"type\": \"text/plain\"}]"
   }

這項操作會傳回確認訊息。如果動作成功，工作 connectorOutputPayload 回應參數的值會類似於下列內容：

[{
"Success": "True"
}]

實體作業範例

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

範例 - 列出所有聯絡人

這個範例會列出 NMCContacts 實體中的所有聯絡人。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 NMCContacts。
3. 選取「List」作業，然後按一下「完成」。
4. (選用) 在「連結器」工作的「工作輸入」部分，您可以指定篩選子句，篩選結果集。 例如：City='Bangalore'。您也可以使用邏輯運算子指定多個篩選條件。例如：City='Bangalore' and region='asia-south2'。

範例 - 取得記錄

這個範例會從 NMCSegments 實體取得具有指定 ID 的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 NMCSegments。
3. 選取「Get」作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，按一下「EntityId」，然後在「預設值」欄位中輸入 0d44bb3f-d28e-4bcf-aba2-c77be831ad46。

   其中 0d44bb3f-d28e-4bcf-aba2-c77be831ad46 是 NMCSegments 實體中的主鍵值。

範例 - 建立記錄

這個範例會在 NMCSenders 實體中建立記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 NMCSenders。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "Nickname": "Test",
   "FromEmail": "test1@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test1@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

   {
   "Id": 5360940.0
   }

範例 - 建立記錄

這個範例會在 NMCLists 實體中建立記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 NMCLists。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "Name": "TEST_CON_LIST1699262238224",
   "ContactCount": 3.0}

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

   {
   "Id": "d927f128-b718-447a-affe-417f1a8b3abd"}

範例 - 更新記錄

這個範例會更新 NMCSenders 實體中的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 NMCSenders。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "Nickname": "Test",
   "FromEmail": "test2@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test2@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

5. 按一下「entityId」，然後在「Default Value」欄位中輸入 5360940.0。

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

   {
   "Id":"5360940.0"
   }

範例 - 刪除記錄

這個範例會刪除 NMCSegments 實體中具有指定 ID 的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 NMCSegments。
3. 選取「Delete」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 c58b9151-7279-428a-bac2-12b4bf2b48b0。