SharePoint

Windows 憑證驗證類型

如要啟用 Windows 憑證驗證類型，請完成下列步驟：

1. 設定 PSC 並建立端點連結。
2. 在 Google Cloud中指定憑證。

設定 PSC 並建立端點連結

1. 使用 SharePoint 託管的 IP 建立執行個體群組。
2. 建立內部直通式網路負載平衡器，並使用您建立的執行個體群組做為後端。TCP 內部負載平衡器必須啟用全域存取權。
3. 在 Private Service Connect 中發布負載平衡器。發布負載平衡器後，系統會產生服務附件。
4. 發布服務，並指定您建立的負載平衡器。
5. 使用服務連結建立端點連結。
6. 建立端點連結後，請使用端點連結 IP 建立 SharePoint 連線。

如要進一步瞭解如何建立端點連結，請參閱「建立端點連結」。

在 Google Cloud中指定 Windows 憑證詳細資料

在 Integration Connectors 中建立連線時，您必須指定下列詳細資料：

在「Authentication」部分，選取「Windows credentials」做為驗證類型，然後輸入下列詳細資料：

• 使用者名稱：輸入使用者名稱。
• 密碼：選取密碼。
• 密鑰版本：輸入密鑰版本。

Windows 憑證連線類型

下表列出 Windows 憑證連線類型的範例設定值。

Azure AD 驗證類型

如要啟用 Azure AD 驗證類型，請完成下列步驟：

1. 註冊應用程式並取得 OAuthClientId 和 OAuthClientSecret。
2. 在 Google Cloud中指定憑證。
3. 在 Google Cloud中授權連結。
4. 在應用程式中新增重新導向網址。

註冊應用程式，並取得 OAuthClientId 和 OAuthClientSecret

如要註冊應用程式並取得應用程式的 OAuthClientId 和 OAuthClientSecret，請按照下列步驟操作：

1. 登入 Azure 入口網站。
2. 在「Azure services」中，依序選取「App registrations」和「New registration」。
3. 輸入應用程式名稱，然後選取「任何 Microsoft Entra ID 租戶 - 多租戶」。
4. 按一下「註冊」。
5. 建立應用程式後，請前往「Certificates & secrets」部分，為應用程式建立用戶端密鑰，並儲存用戶端密鑰值。
6. 在「API permissions」中，選取必要的應用程式權限和委派權限。如要啟用連結，您必須授予以下最低權限：Sites.Read.All。

   下表列出在應用程式中執行作業所需的權限。

   委派權限	應用程式權限
   ConsentRequest.Read.All	AllSites.FullControl
   ConsentRequest.ReadWrite.All	AllSites.Manage
   DelegatedAdminRelationship.Read.All	AllSites.Read
   DelegatedAdminRelationship.ReadWrite.All	AllSites.Write
   DelegatedPermissionGrant.Read.All	EnterpriseResource.Read
   DelegatedPermissionGrant.ReadWrite.All	EnterpriseResource.Write
   Files.Read.All	MyFiles.Read
   Files.ReadWrite.All	MyFiles.Write
   Group.Create	Project.Read
   Group.Read.All	Project.Write
   Group.ReadWrite.All	ProjectWebApp.FullControl
   Sites.FullControl.All	ProjectWebAppReporting.Read
   Sites.FullControl.All	Sites.FullControl.All
   Sites.Manage.All	Sites.Manage.All
   Sites.Read.All	Sites.Read.All
   Sites.ReadWrite.All	Sites.ReadWrite.All
   Sites.Selected	Sites.Search.All
   User.Export.All	Sites.Selected
   User.Read	TaskStatus.Submit
   User.Read.All	TermStore.Read.All
   User.ReadWrite.All	TermStore.Read.All
   	TermStore.ReadWrite.All
   	TermStore.ReadWrite.All
   	User.Read.All
   	User.Read.All
   	User.ReadWrite.All
   	User.ReadWrite.All

7. 儲存變更。
8. 如果您選取需要管理員同意的權限，可以在「API 權限」頁面，從目前的租戶授予權限。
9. 如要新增範圍，請前往「Expose an API」(公開 API) 部分，新增 AllSites.Manage, Sites.FullControl.All 範圍並選取可控管的使用者 (管理員和使用者)。
10. 按一下 [儲存]。

在 Google Cloud中指定憑證

在 Integration Connectors 中建立連線時，您必須指定下列詳細資料：

在「Authentication」(驗證) 部分中，選取「AzureAD」做為驗證類型，然後輸入下列詳細資料：

• 用戶端 ID：輸入用於要求存取權杖的用戶端 ID。
• 範圍：輸入以半形逗號分隔的所需範圍清單。例如：Sites.FullControl.All
• 用戶端密鑰：輸入包含您所建立已連結應用程式用戶端密鑰的密鑰。
• 密鑰版本：上述所選密鑰的密鑰版本。
• 授權網址：建立 OAuth 用戶端時產生的授權網址。 請按照下列格式輸入網址：https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent。 例如 https://login.microsoftonline.com/9byyyyyyyyy8112/oauth2/v2.0/authorize?prompt=consent。

在 Google Cloud中授權連線

1. 在「連線」頁面中，找出新建立的連線。

   新連結器的「狀態」會顯示「需要授權」。

2. 按一下「需要授權」。

   系統隨即會顯示「編輯授權」窗格。

3. 將「重新導向 URI」值複製到外部應用程式。詳情請參閱「將重新導向網址新增至應用程式」。
4. 驗證授權詳細資料。
5. 按一下 [授權]。

   授權成功後，「連線」頁面的連線狀態會設為「有效」。

在應用程式中新增重新導向網址

1. 在 Azure 入口網站中，依序點選「Azure 服務」>「應用程式註冊」。
2. 按一下應用程式名稱。
3. 按一下「新增重新導向 URI」。
4. 按一下「新增平台」。
5. 在「Web」對話方塊中，貼上您在 Google Cloud授權連線時複製的重新導向 URI。

Azure AD 連線類型

下表列出 Azure AD 連線類型的範例設定值：

OAuth 2.0 - 用戶端憑證，JWT 持有人驗證類型

如要啟用 OAuth 2.0 - 用戶端憑證搭配 JWT 持有人驗證類型，請完成下列步驟：

1. 建立憑證。
2. 將憑證上傳至 Azure 入口網站。
3. 取得私密金鑰。
4. 完成設定。
5. 在 Google Cloud中指定 OAuth 2.0 JWT 持有人憑證。

建立憑證

1. 在電腦上建立空白資料夾。
2. 在資料夾中建立文字檔案。
3. 從「透過 Azure AD 僅限應用程式頁面授予存取權」 複製 PowerShell 指令碼，然後貼到文字檔中。
4. 將文字檔重新命名為 Create-SelfSignedCertificate.ps1。
5. 在資料夾中執行 Windows PowerShell。
6. 前往包含文字檔的目錄。
7. 複製下列指令： .\Create-SelfSignedCertificate.ps1 -CommonName "CERTIFICATE_NAME" -StartDate 2022-09-25 -EndDate 2023-10-25

   輸入 CERTIFICATE_NAME 的專屬名稱。將 StartDate 變更為目前日期，EndDate 則變更為您選擇的日期。

8. 將複製的指令連同變更貼到 Windows PowerShell，然後按下 Enter 鍵。

   Windows PowerShell 會提示您輸入密碼，以保護私密金鑰。請務必儲存密碼，以供後續使用。

   Windows PowerShell 會建立兩個檔案：MyCertificate.pfx 和 MyCertificate.cer。

將憑證上傳至 Azure 入口網站

1. 登入 Azure 入口網站，指定下列詳細資料來註冊新應用程式：
   • 名稱：輸入應用程式名稱。
   • 支援的帳戶類型：選取「Accounts in this organizational directory only (Account name only - Single tenant)」。
2. 依序前往「API Permissions」>「Add permission」>「Request API permissions」>「SharePoint」。
3. 選取「應用程式權限」，然後新增所需權限。
4. 選取「授予管理員同意聲明」，然後選取「是」。
5. 建立應用程式後，請前往「Certificates & Secrets」部分。
6. 選取「上傳憑證」，然後從電腦上傳 CER 憑證。上傳完成後，選取「新增」。

   請勿在應用程式中新增用戶端密鑰，因為這會干擾以憑證為準的驗證流程。

7. 前往資訊清單，找出 KeyCredentials，然後將 customKeyIdentifier 複製為 Thumbprint。稍後會用到這項資訊。您已註冊應用程式並連結憑證。

取得私密金鑰

您可以使用 OpenSSL 將 PFX 檔案轉換為 PEM 檔案，取得私密金鑰。

1. 在命令提示字元中，前往 PFX 檔案所在的資料夾，然後執行下列指令： openssl pkcs12 -in MyCertificate.pfx -out MyCertificate.pem -nodes
2. 輸入您在憑證建立程序中使用的 PFX 密碼。
3. 在文字編輯器中開啟 PEM 檔案，然後複製私密金鑰的下列部分：

       -----BEGIN PRIVATE KEY----- 
   
       -----END PRIVATE KEY----- 
       

完成設定

1. 從 Azure 入口網站中新註冊的應用程式複製用戶端 ID 和租戶 ID。
2. 使用下列憑證，透過 SharePoint 清單服務主體驗證登入：
• 用戶端 ID
• 用戶群 ID
• 私密金鑰
• 指紋 (私密金鑰密碼)

在 Google Cloud中指定 OAuth 2.0 JWT 持有人憑證

在 Integration Connectors 中建立連線時，您必須指定下列詳細資料：

在「Authentication」(驗證) 專區中，選取「OAuth 2.0 client credentials with JWT bearer」(OAuth 2.0 用戶端憑證搭配 JWT 持有人) 做為驗證類型，然後輸入下列詳細資料：

• 在「Client ID」欄位中，輸入用於要求存取權杖的用戶端 ID。這是您在 Azure 入口網站中註冊應用程式時產生的消費者金鑰。
• 在「私密金鑰」欄位中，選取包含 PEM 格式私密金鑰檔案內容的 Secret Manager 密碼。私密金鑰應與提供給連接器的公開金鑰/憑證相符。
• 在「Secret version」(密鑰版本) 欄位中，選取上方所選密鑰的版本。
• 在「私密金鑰密碼」欄位中，選取含有私密金鑰檔案密碼 (同義詞) 的 Secret Manager 密碼。
• 在「Secret version」(密鑰版本) 欄位中，選取上方所選密鑰的版本。
• 在「Azure Tenant」(Azure 租戶) 欄位中，輸入用於存取資料的 Microsoft 線上租戶。

JWT Bearer 憑證連線類型

下表列出 OAuth 2.0 JWT 持有人憑證連線類型的範例設定值。

OAuth 2.0 - 用戶端密鑰連線類型

如要啟用 OAuth 2.0 用戶端密鑰連線類型，請完成下列步驟：

1. 註冊增益集。
2. 授予增益集權限。
3. 在 Google Cloud中指定 OAuth 2.0 用戶端憑證
4. 授權碼重新授權

註冊增益集

1. 使用以下網址前往「Register Add-In」(註冊外掛程式) 頁面： https://<SITE_NAME>.SharePoint.com/_layouts/15/appregnew.aspx。
2. 在「應用程式資訊」部分，產生用戶端 ID 和用戶端密鑰。
3. 指定「名稱」、「應用程式網域」和「重新導向 URI」的值。
4. 按一下「建立」。外掛程式已註冊，SharePoint 應用程式會顯示建立的資訊。

授予增益集權限

1. 使用下列網址前往 SharePoint 網站： https://<SITE_NAME>-admin.sharepoint.com/_layouts/15/appinv.aspx。系統會將您重新導向至「授予權限」頁面。
2. 在「應用程式 ID」欄位中，輸入您先前產生的用戶端 ID，然後按一下「查詢」。系統會填入「名稱」、「應用程式網域」和「重新導向網址」的值。
3. 以 XML 格式輸入下列權限要求：

         <AppPermissionRequests AllowAppOnlyPolicy="true">
         <AppPermissionRequest Scope="http://sharepoint.com/content/tenant" Right="FullControl"/>
         </AppPermissionRequests>
           

4. 按一下「建立」，Sharepoint 應用程式會顯示權限同意對話方塊。
5. 按一下「信任」。

在 Google Cloud中指定 OAuth 2.0 用戶端憑證

在 Integration Connectors 中建立連線時，您必須指定下列詳細資料：

在「Authentication」部分，選取「OAuth 2.0 client credentials with client secret」做為驗證類型，然後輸入下列詳細資料：

• 在「用戶端 ID」欄位中，輸入連接器為您建立的應用程式提供的用戶端 ID。
• 在「Client Secret」(用戶端密鑰) 欄位中，選取包含您所建立已連結應用程式用戶端密鑰的 Secret Manager 密鑰。
• 在「Secret version」(密鑰版本) 欄位中，選取用戶端密鑰版本。

授權碼重新授權

如果您使用 Authorization code 驗證類型，且已在 SharePoint 應用程式中進行任何設定變更，則必須重新授權 SharePoint 連線。如要重新授權連結，請按照下列步驟操作：

1. 在「連線」頁面中，按一下所需連線。

   系統隨即會開啟連線詳細資料頁面。

2. 按一下「編輯」即可編輯連結詳細資料。
3. 在「驗證」部分中，確認「OAuth 2.0 - 授權碼」詳細資料。

   視需要進行必要變更。

4. 按一下 [儲存]。系統會將您帶往連線詳細資料頁面。
5. 在「驗證」部分中，按一下「編輯授權」。系統會顯示「Authorize」(授權) 窗格。
6. 按一下「Authorize」。

   如果授權成功，「連線」頁面的連線狀態會設為「有效」。

用戶端憑證連線類型

下表列出 OAuth 2.0 用戶端憑證連線類型的設定值範例。

動作

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

DeleteAttachment 動作

這項操作會刪除附件。

DeleteAttachment 動作的輸入參數

CheckInDocument 動作

這個動作可讓您在文件中查看。

CheckInDocument 動作的輸入參數

CheckOutDocument 動作

這項操作可讓您簽出檔案。

CheckOutDocument 動作的輸入參數

DiscardCheckOutDocument 動作

這項操作可讓你還原檔案簽出作業。

DiscardCheckOutDocument 動作的輸入參數

CopyDocument 動作

這項動作可將檔案從一個位置複製到另一個位置。

CopyDocument 動作的輸入參數

UploadDocument 動作

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

UploadDocument 動作的輸入參數

DownloadDocument 動作

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

DownloadDocument 動作的輸入參數

MoveAttachmentOrDocument 動作

這項操作可將檔案從一個資料夾移至另一個資料夾。

MoveAttachmentOrDocument 動作的輸入參數

CreateFolder 動作

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

CreateFolder 動作的輸入參數

AddAttachments 動作

這項動作可讓你新增附件。

AddAttachments 動作的輸入參數

DownloadAttachments 動作

這項操作可下載附件。

DownloadAttachments 動作的輸入參數

動作範例

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

範例 - 刪除附件

這個範例會刪除指定檔案。

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

   {
   "ListTitle": "My lists",
   "ItemId": "1",
   "FileName": "sitepages.txt"
   }

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

[{
"Status": "Success"
}]

範例 - 在文件中簽入

這個範例會在文件中簽入。

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

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.txt",
   "Comment": "Comment test"
   }

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

[{
"Status": "Success"
}]

範例 - 簽出檔案

這個範例會簽出檔案。

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

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.txt"
   }

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

[{
"Status": "Success"
}]

範例 - 捨棄結帳

這個範例會還原檔案簽出作業。

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

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.docx"
   }

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

[{
"Status": "Success"
}]

範例 - 複製檔案

這個範例會將檔案從一個位置複製到另一個位置。

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

   {
   "SourceFileRelativeUrl": "/Shared Documents/Document.docx",
   "DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
   }

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

[{
"Status": "Success"
}]

範例 - 上傳文字檔案

這個範例會將文字檔上傳至指定位置。

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

   {
   "FileName": "test.txt",
   "RelativeUrl": "/Shared Documents/TestFolder",
   "Content": "abcd"
   }

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

[{
"Status": "Success"
}]

範例 - 上傳二進位檔案

這個範例會將二進位檔案上傳至指定位置。上傳二進位檔案時，請將要上傳的內容指定為 Base64 編碼字串。

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

   {
   "FileName": "test.txt",
   "RelativeUrl": "/Shared Documents/TestFolder",
   "ContentBytes": "SGVsbG8gd29ybGQK",
   "HasBytes": "true"
   }

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

[{
"Status": "Success"
}]

範例 - 下載檔案

這個範例會下載檔案。

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

   {
   "RemoteFile": "/TestFolder/test.txt",
   "Library": "Shared Documents"
   }

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

[{
"Success": "True",
"Content": "Test File",
}]

範例 - 下載二進位檔案

這個範例會下載二進位檔案。

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

   {
   "RemoteFile": "/TestFolder/test1.png",
   "Library": "Shared Documents"
   "HasBytes": "true"  
   }

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

[{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

範例 - 從特定網站下載檔案

這個範例會從特定網站下載檔案。

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

   {
     "RemoteFile": "	http://z8**.sharepoint.com/sites/SharepointGCS/Docs/SharpointGCS.docx",
     "Library": "Docs",
     "HasBytes": true
   }
   

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

[
  {
    "Success": "True",
    "ContentBytes": "UEsDBAoAAAAAAAAAIQD/////TwEAAE8BAAAQAAAAW3RyYXNoXS8wMDAwLmRhdP////nFmjQeC1QbGmk9o7n0xjiLgudAMOrYQBpOZdZp5/OrWkWbudVPccasL5uVSKun3URrHAxow7iMUm2WSi7nlGy2Mr+sjJxQSrYFcFtDQyo/QSutWhbNcAODEWh14mklzxCS9C5CW3Fmwme/gMKGjGoXlSVyvtDoB+u0A6XtA8bkWTnPNHSvxcepoAKIdsR96imCvxe4MxOWqHWnQkLDyjNMOMrrQeMDF7nOMCCvPlVn5Vd6KlDYnHlW1zLOcQf6WmKl2xN4Z8WBXZfkrJZqPv6yNdWyp8ADRmgTdRSqDkPpQqzvqWj3qpdiRZqSwyBRtfr2kHBumkTNjSi6drBMFMxZEgrktw6ZxuEXcx3v16cXd6k5JVO3kOXMg/HFnH"
  }
]

如要從特定網站下載檔案，請提供遠端檔案的完整地址。

範例 - 移動附件

這個範例會將附件從一個位置移到另一個位置。

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

   {
   "SourceFileURL": "/Shared Documents/test.txt",
   "DestinationFolderURL": "/Shared Documents/TestFolder"
   }

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

[{
"Result": "Success"
}]

範例 - 建立資料夾

這個範例會在指定位置建立資料夾。

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

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "FolderName": "TestFolder123"
   }

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

[{
"Id": "110842b7-2393-4f11-9391-3d75214e9fb8",
"Status": "Success"
}]

範例 - 新增附件

這個範例會將附件新增至指定清單。

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

   {
   "ListTitle": "My Lists",
   "FileName": "TestAttachment2",
   "Content": "abcd text",
   "ItemId": "1"
   }

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

[{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment2",
"Status": "Success"
}]

範例 - 新增二進位附件

這個範例會將二進位附件新增至指定清單。

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

   {
   "ListTitle": "My Lists",
   "FileName": "TestAttachment3",
   "ContentBytes": "VGVzdCBGaWxl",
   "HasBytes": "true",  
   "ItemId": "1"
   }

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

[{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment3",
"Status": "Success"
}]

範例 - 下載附件

這個範例會下載附件。

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

   {
   "RemoteFile": "/Shared Documents/Document.txt"
   }

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

[{
"Success": "True",
"Content": "Test File",
}]

範例 - 下載二進位附件

這個範例會下載二進位附件。

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

   {
   "RemoteFile": "/Shared Documents/Document.docx",
   "HasBytes": "true"
   }

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

[{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

實體作業範例

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

範例 - 列出所有檔案

這個範例會列出 Files 實體中的所有檔案。

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

範例 - 取得清單

這個範例會從 My Lists 實體取得具有指定 ID 的清單。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 My Lists。
3. 選取「Get」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入) 區段中，按一下「EntityId」，然後在「Default Value」(預設值) 欄位中輸入 3。

   其中 3 是 My Lists 實體中的主鍵值。

範例 - 建立記錄

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

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

   {
   "AuthorId": 11.0, 
   "BaseName": "3_",
   "Attachments": false,
   "Title": "Created List New"
   }

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

   [{
   "ID": 3.0
   }]

範例 - 刪除記錄

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

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