Office365

實體、作業和動作

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

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

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

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

  從可用清單中選取實體後，系統會產生可用於該實體的作業清單。如需作業的詳細說明，請參閱連接器工作中的實體作業。不過，如果連接器不支援任何實體作業，則 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 動作，然後按一下「Done」。
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 動作，然後按一下「Done」。
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 動作，然後按一下「Done」。
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 動作，然後按一下「Done」。
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 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "FileId": "01VCU572LDCGQYZOSMHZDZGN5HCXS5P6EP"
   }

如果動作成功，DownloadFile 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

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

範例：建立資料夾

這個範例會建立資料夾。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 CreateFolder 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

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

如果動作成功，CreateFolder 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
"Status": "Success"
}]

範例：傳送電子郵件

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

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 SendMail 動作，然後按一下「Done」。
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 動作，然後按一下「Done」。
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 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "MessageId": "fTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITVAAA="
   }

如果動作成功，DownloadEmail 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

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

範例：下載附件

本範例會下載附件。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 DownloadAttachments 動作，然後按一下「Done」。
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
}]