Office365

實體、作業和動作

所有 Integration Connectors 都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化存取應用程式的物件。抽象化會以實體、作業和動作的形式向您公開。

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

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

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

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

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

動作

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

CancelEvent 動作

這項操作可取消活動。

CancelEvent 動作的輸入參數

如要瞭解如何設定 CancelEvent 動作，請參閱動作範例。

MoveMail 動作

這項動作可讓你移動電子郵件。

MoveMail 動作的輸入參數

如要瞭解如何設定 MoveMail 動作，請參閱動作範例。

AssignLicense 動作

這項操作可讓你指派授權。

AssignLicense 動作的輸入參數

如要瞭解如何設定 AssignLicense 動作，請參閱動作範例。

ForwardEvent 動作

這項操作可讓你轉寄活動。

ForwardEvent 動作的輸入參數

如要瞭解如何設定 ForwardEvent 動作，請參閱動作範例。

UploadFile 動作

這項操作可讓你上傳檔案。

UploadFile 動作的輸入參數

如要瞭解如何設定 UploadFile 動作，請參閱動作範例。

DownloadFile 動作

這項操作可讓您下載檔案。

DownloadFile 動作的輸入參數

如要瞭解如何設定 DownloadFile 動作，請參閱動作範例。

CreateFolder 動作

這項動作可讓您建立資料夾。

CreateFolder 動作的輸入參數

如要瞭解如何設定 CreateFolder 動作，請參閱「動作範例」。

SendMail 動作

這個動作可讓你傳送電子郵件。

SendMail 動作的輸入參數

如要瞭解如何設定 SendMail 動作，請參閱「動作範例」。

ForwardMail 動作

這個動作可讓你轉寄電子郵件。

ForwardMail 動作的輸入參數

如要瞭解如何設定 ForwardMail 動作，請參閱「動作範例」。

DownloadEmail 動作

這項動作可供您下載電子郵件。

DownloadEmail 動作的輸入參數

如要瞭解如何設定 DownloadMail 動作，請參閱「動作範例」。

DownloadAttachments 動作

這項操作可讓您下載電子郵件的附件。

DownloadAttachments 動作的輸入參數

如要瞭解如何設定 DownloadAttachments 動作，請參閱「動作範例」。

動作範例

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

範例 - 取消活動

這個範例會取消具有指定 ID 的活動。

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

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-GAAA=",   
   "Comment": "Canceled due to rain"
   }

如果動作成功，CancelEvent 工作項目的 connectorOutputPayload 回應參數值會類似於下列內容：

[{
"Status": "Success"
}]

範例 - 指派及移除授權

這個範例會指派及移除指定使用者的授權。

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

   {
   "UserID": "ee58217f-b22e-4300-a876-53db3c71a87b",   
   "AddLicenseSkuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac",   
   "RemoveLicenses": "c42b9cae-ea4f-4ab7-9717-81576235ccac"
   }

如果動作成功，AssignLicense 工作的 connectorOutputPayload 回應參數值會類似於下列內容：

[{
"Status": "Success"
}]

範例 - 轉送活動

這個範例會轉送事件。

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

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAENAAAhfASdetQfTZ3pESzwWnAbAAA_CxGjAAA=",   
   "Comment": "forwarded due to rain",   
   "ToRecipients": "test99@example.com"
   }

如果動作成功，ForwardEvent 工作項目的 connectorOutputPayload 回應參數值會類似於下列內容：

[{
"Status": "Success"
}]

範例 - 上傳檔案

這個範例會上傳檔案。

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

   {
   "FileName": "Document1234.docx",   
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "Content": "test"
   }

如果動作成功，UploadFile 工作項目的 connectorOutputPayload 回應參數值會類似於下列內容：

 [{
"Id": "01VCU572JX6F3L3NKLQVB2BXETRHLEAUAY",   
"@test.context": "https://example.com/v1.0/$metadata#users('7954f490-5a43-083fc215362a')/drive/items('01VCU5BZO354PWSELRRZ')/test/$entity",   
"@example.downloadurl": "https://example.com/test/admin123/_layouts/15/download.aspx?UniqueId=bd76224r7-4........
"Status": "Success"
}] 

範例 - 下載檔案

這個範例會下載檔案。

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

   {
   "FileId": "01VCU572LDCGQYZOSMHZDZGN5HCXS5P6EP"
   }

如果動作成功，DownloadFile 工作項目的 connectorOutputPayload 回應參數值會類似於下列內容：

[{
"Status": "Success",
"FileData": "UEsDBBQAAAAIAEoTdVdSWj6GTAEAABoFAAATAAAAWNdLnhtbLWUTU7DMBCFr2J"
}]

範例 - 建立資料夾

這個範例會建立資料夾。

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

   {
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "FolderName": "outbox1234"
   }

如果動作成功，CreateFolder 工作項目的 connectorOutputPayload 回應參數值會類似於下列內容：

[{
"Status": "Success"
}]

範例 - 傳送電子郵件

這個範例會將電子郵件傳送給指定收件者。

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

   {
   "ToRecipients": "test097@example.com",   
   "Content": "Testing",   
   "Subject": "Test subject",   
   "FileName": "Google"
   }

如果動作成功，SendMail 工作項目的 connectorOutputPayload 回應參數值會類似於下列內容：

[{
"Status": "Success"
}]

範例 - 轉寄電子郵件

這個範例會轉寄電子郵件。

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

   {
   "MessageId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTpESzwWnAbAAA0sITVAAA=",   
   "ToRecipients": "test097@example.com",   
   "Comment": "forwarded message"
   }

如果動作成功，ForwardMail 工作項目的 connectorOutputPayload 回應參數值會類似於下列內容：

[{
"Status": "Success"
}]

範例 - 下載電子郵件

這個範例會下載電子郵件。

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

   {
   "MessageId": "fTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITVAAA="
   }

如果動作成功，DownloadEmail 工作項目的 connectorOutputPayload 回應參數值會類似於下列內容：

[{
"Status": "Success",   
"FileData": "RnJvbTogRk5VIExOVSA8YWRtaW4xMjNANzNzY21nLm9ubWljcm9zb2Z0LmNvbT4NClRvOiB0ZXN0IDx0ZXN0.......
}]

範例 - 下載附件

這個範例會下載附件。

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

   {
   {"MessageId": "PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITWAAA=",   
   "DownloadTo": "My files/Office355/reports/"}
   }

如果動作成功，DownloadAttachments 工作項目的 connectorOutputPayload 回應參數值會類似於下列內容：

[{
"Id": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGTWAAABEgAQAF3EBDrnTc1Cj8akAYrJjdM=",
"Name": "demoattachment.docx",
"ContentBytes": "UEsDBBQAAAAIALskYlcppqeszQEAAHQJAAATAAAAWAAAI3RyYXNoXS8wMDAwLmRhdP........",
"LastmodifiedDatetime": "2023-11-21T10:09:09Z",
"ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"FileData": null,
"json:repeatelementorder#": null,
"size": "23575",
"isinline": "false
}]