Microsoft SharePoint Online 模組
在Adobe Workfront Fusion案例中,您可以自動化使用Microsoft SharePoint Online的工作流程,並將其連結至多個協力廠商應用程式和服務。
關於建立情境的說明,請參閱建立情境:文章索引之下的文章。
關於模組的資訊,請參閱模組:文章索引之下的文章。
存取權要求
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 封裝 |
任何 Adobe Workfront Workflow 封裝及任何 Adobe Workfront Automation and Integration 封裝 Workfront Ultimate Workfront Prime 和 Select 封裝,以及額外購買的 Workfront Fusion。 |
| Adobe Workfront 授權 |
標準 工作或更高層級 |
| Adobe Workfront Fusion 授權 |
作業型:適用於擁有作業型授權的組織 連接器型 (舊版):Workfront Fusion for Work Automation and Integration |
| 產品 | 如果您的組織擁有 Select 或 Prime Workfront 封裝,但不包括 Workfront Automation and Integration,則您的組織必須購買 Adobe Workfront Fusion。 |
若要詳細了解此表格中的資訊,請參閱🔗文件中的存取權要求。
關於 Adobe Workfront Fusion 授權的資訊,請參閱 Adobe Workfront Fusion 授權。
先決條件
若要使用Microsoft SharePoint Online模組,您必須擁有Microsoft SharePoint Online帳戶。
SharePoint API資訊
SharePoint聯結器會使用以下專案:
將Microsoft SharePoint Online連線至Workfront Fusion connect-microsoft-sharepoint-online-to-workfront-fusion
使用Microsoft帳戶將Microsoft SharePoint Online連線至Workfront Fusion
使用進階設定將Microsoft SharePoint Online連線至Workfront Fusion
若要在連線中包含認證,請啟用「顯示進階設定」選項。 對於這類連線,您需要使用者端ID、使用者端密碼和租使用者ID。
-
在任何SharePoint模組中,按一下[連線]欄位附近的**[新增]以開啟[建立連線]**方塊。
-
按一下顯示進階設定。
-
填寫下列欄位:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 連線類型 若要使用使用者端認證,請選取Microsoft 365電子郵件。 連線名稱 輸入此連線的名稱。 用戶端 ID 輸入您要連線之SharePoint應用程式的使用者端ID。 使用者端密碼 輸入您要連線之SharePoint應用程式的使用者端密碼。 租使用者ID 輸入您要連線之SharePoint應用程式的租使用者ID。 -
按一下「繼續」,儲存連線並返回模組。
使用憑證授權將Microsoft SharePoint Online連線至Workfront Fusion
您可以使用憑證授權來連線至SharePoint。
| note important |
|---|
| IMPORTANT |
| 若要使用憑證授權,您必須先在Microsoft Entra中建立應用程式,然後上傳憑證。 |
| 如需指示,請參閱Microsoft檔案中的如何設定Microsoft Entra憑證式驗證的憑證授權單位。 |
-
在任何SharePoint模組中,按一下[連線]欄位附近的**[新增]以開啟[建立連線]**方塊。
-
按一下顯示進階設定。
-
填寫下列欄位:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 連線類型 若要使用憑證授權,請選取Microsoft SharePoint Online (憑證驗證)。 連線名稱 輸入此連線的名稱。 用戶端 ID 輸入您要連線之SharePoint應用程式的使用者端ID。 指紋 輸入您要連線的SharePoint應用程式指紋。 私密金鑰 輸入在Microsoft中建立憑證時產生的憑證或私密金鑰。
若要擷取您的私密金鑰或憑證:
-
按一下「擷取」。
-
選取您要擷取憑證或私密金鑰。
-
選取要擷取的檔案類型。
-
選取包含私密金鑰或憑證的檔案。
-
輸入檔案的密碼。
-
按一下「儲存」,擷取檔案並返回連線設定。
-
-
按一下「繼續」,儲存連線並返回模組。
使用服務主體將Microsoft SharePoint Online連線至Workfront Fusion
您可以建立使用服務主體(應用程式API連線)而不是個人帳戶的連線。 如果您希望連線以應用程式或服務身分執行,而非以特定人員執行(例如,如果該人員離開公司或變更其密碼,整合不會中斷),則此功能會很有用。
| note important |
|---|
| IMPORTANT |
| 此連線型別僅適用於進行API呼叫模組。 其他SharePoint模組需要本文所述的其他連線型別之一。 |
- 使用服務主體將Microsoft SharePoint Online連線到Workfront Fusion的先決條件
- 在Microsoft Entra ID中建立應用程式註冊
- 建立使用者端密碼
- 授予API許可權
- 收集您的連線詳細資料
- 建立連線
使用服務主體將Microsoft SharePoint Online連線到Workfront Fusion的先決條件
您需要Microsoft Entra ID中的全域管理員、應用程式管理員或 有特殊許可權的角色管理員 存取權,才能註冊應用程式並授予其許可權。 如果您沒有此存取權,請要求您IT或身分團隊中的某人為您完成這些步驟。
繼續在Microsoft Entra ID中建立應用程式註冊。
在Microsoft Entra ID (服務主體)中建立應用程式註冊
- 登入Microsoft Entra系統管理中心。
- 移至應用程式註冊 > 新註冊。
- 為應用程式提供一個清晰且可辨識的名稱。 例如
Make - SharePoint Integration。 - 將 重新導向URI 保留空白。 此連線不涉及任何人透過瀏覽器登入。
- 選取註冊。
- 繼續建立使用者端密碼。
建立使用者端密碼(服務主體)
- 在您的新應用程式註冊中,移至憑證與密碼。
- 選取新增使用者端密碼、新增說明,並選擇到期期間。
- 選取新增。
- 立即複製密碼的值。 它只會顯示一次。 如果您在複製它之前瀏覽離開,則必須建立一個新的專案。
- 繼續授予API許可權。
授予API許可權(服務主體)
- 在您的應用程式註冊中,移至API許可權。
- 選取新增許可權,然後選取Microsoft圖表。
- 選取應用程式許可權。
- 選取API呼叫所需的許可權或許可權,然後選取新增許可權。
- 選取 為您的組織 授予管理員同意,然後確認。
- 繼續收集您的連線詳細資料。
收集您的連線詳細資料(服務主體)
從應用程式註冊的 總覽 頁面,請注意下列值。 在模組中建立連線時,請輸入這些連線。
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| 租使用者ID | 在概觀頁面上,標示為目錄(租使用者) ID。 |
| 用戶端 ID | 在概觀頁面上,標示為應用程式(使用者端) ID。 |
| 用戶端密碼 | 您在中複製的值建立使用者端密碼。 |
繼續建立連線。
建立連線(服務主體)
-
在進行API呼叫模組中,按一下[連線]欄位附近的 新增 以開啟 建立連線 方塊。
-
按一下顯示進階設定。
-
在連線型別欄位中,選取服務主體。
-
輸入下列:
- 租使用者識別碼
- 使用者端識別碼
- 使用者端密碼
-
按一下「繼續」,儲存連線並返回模組。
如果一切設定正確,連線都會成功驗證。
使用同盟連線將Microsoft SharePoint Online連線至Adobe Workfront Fusion
同盟連線的運作方式與服務主體連線類似,只是它不使用使用者端密碼。
與其儲存秘密,不如告訴Microsoft Entra ID信任Workfront Fusion針對某個特定連線所發行的權杖。 連線執行時,Fusion會提供短暫的身分證明,且Microsoft Entra ID會傳回存取權杖。 因為沒有使用者端密碼,所以沒有到期的專案,也沒有要輪換或儲存的密碼。
| note |
|---|
| NOTE |
| 設定此連線需要兩次造訪Microsoft Entra管理中心。 您先註冊應用程式,然後在Workfront Fusion中建立連線,然後返回Microsoft Entra ID以新增同盟認證。 這是因為同盟認證會識別一個特定連線,而該識別碼在建立連線之前並不存在。 |
- 使用同盟連線將Microsoft SharePoint Online連線至Workfront Fusion的必要條件
- 在Microsoft Entra ID (同盟連線)中建立應用程式註冊
- 授予API許可權(同盟連線)
- 收集您的連線詳細資料(同盟連線)
- 在Workfront Fusion (同盟連線)中建立連線
- 在Microsoft Entra ID (Federated連線)中新增同盟認證
- 驗證連線(同盟連線)
- 疑難排解
使用同盟連線將Microsoft SharePoint Online連線至Workfront Fusion的必要條件
您需要Microsoft Entra ID中的全域管理員、應用程式管理員或特殊許可權角色管理員存取權,才能註冊應用程式、授予其許可權並新增同盟認證。 如果您沒有此存取權,請要求您IT或身分團隊中的某人為您完成這些步驟。
在Microsoft Entra ID (同盟連線)中建立應用程式註冊
- 登入Microsoft Entra管理中心。
- 前往「應用程式註冊>新註冊」。
- 為應用程式提供一個清晰且可辨識的名稱。 例如
Workfront Fusion SharePoint Integration。 - 將重新導向URI保留空白。 此連線不涉及任何人透過瀏覽器登入。
- 選取註冊。
請勿建立使用者端密碼。 同盟連線不使用。 - 繼續授予API許可權。
授予API許可權(同盟連線)
- 在您的應用程式註冊中,移至API許可權。
- 選取新增許可權,然後選取Microsoft圖表。
- 選取應用程式許可權。
- 選取API呼叫所需的許可權或許可權,然後選取新增許可權。
- 選取為您的組織授予管理員同意,然後確認。
- 繼續收集您的連線詳細資料。
收集您的連線詳細資料(同盟連線)
-
從應用程式註冊的「概觀」頁面,請注意下列值。 在模組中建立連線時,請輸入這些連線。
table 0-row-2 1-row-2 layout-auto html-authored no-header 租使用者ID 在概觀頁面上,標示為目錄(租使用者) ID。 用戶端 ID 在概觀頁面上,標示為應用程式(使用者端) ID。 -
繼續在Workfront Fusion中建立連線。
在Workfront Fusion (同盟連線)中建立連線
-
在「進行API呼叫」模組中,按一下「連線」欄位附近的b ,以開啟「建立連線」方塊。
-
按一下(同盟連線)。
-
在連線型別欄位中,選取同盟連線型別。
-
輸入下列:
- 租使用者ID
- 用戶端 ID
-
選取「建立」。
Workfront Fusion會顯示三個值。 您可以在下一個程式中使用它們。table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Issuer 一律為 https://oidc.automations.adobe.com。主旨 識別這個連線。 它看起來像 fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964。 您建立的每個連線都不同。對象 一律為 api://AzureADTokenExchange。 -
讓此面板保持開啟狀態,並複製 主旨 值。
note NOTE 請勿關閉面板或選取「取消」。 連線要等到您完成其餘程式後才會完成。 如果關閉面板,您必須刪除連線並重新開始,因為新的連線會收到新的主旨。 -
繼續在Microsoft Entra ID中新增Federated認證。
在Microsoft Entra ID (Federated連線)中新增同盟認證
此程式會取代使用者端密碼。 它會通知Microsoft Entra ID接受Workfront Fusion針對這個連線所發行的代號。
-
在新的瀏覽器標籤中,返回Microsoft Entra管理中心並開啟您的應用程式註冊。
-
移至憑證與密碼 > 同盟認證。
-
選取新增認證。
-
在Federated認證案例中,選取其他簽發者。
-
輸入下列:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Issuer https://oidc.automations.adobe.com.主體識別碼 您從Workfront Fusion複製的主體。 完全貼上,不新增空格。 名稱 可識別此連線的名稱,以便您稍後尋找。 例如 workfront-fusion-connection-28964。對象 api://AzureADTokenExchange. 這通常會為您填入。 保留預設值。 -
選取新增。
-
繼續驗證連線。
驗證連線(同盟連線)
-
返回Workfront Fusion瀏覽器索引標籤,其中連線面板仍處於開啟狀態。
-
選取「儲存」。
- 如果所有專案皆已正確設定,連線將會成功驗證,您可以繼續設定模組。
- 如果驗證失敗,面板會保持開啟並顯示錯誤。 請更正Microsoft Entra ID中的問題,然後再次選取「儲存」。 您不需要重新建立連線,而且主旨不會變更。
疑難排解
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| 連線驗證失敗,發生無效的使用者端或無效的請求錯誤 | Microsoft Entra ID無法比對權杖與同盟認證。 檢查簽發者是否剛好是https://oidc.automations.adobe.com,沒有結尾斜線,而且主旨識別碼與Workfront Fusion中顯示的主旨完全相同(字元對字元)。 從不同連線複製的主體是最常見的原因。 |
| 連線會驗證,但API呼叫會傳回403 | 身分值得信任,但應用程式沒有您呼叫所需的Microsoft Graph許可權。 返回授予API許可權、新增所需的應用程式許可權並授予管理員同意。 |
| 您無法新增其他同盟認證 | 您已達到該應用程式註冊的20個同盟認證限制。 註冊其他應用程式並針對其建立進一步的連線。 |
Microsoft SharePoint模組及其欄位
當您設定Microsoft SharePoint Online模組時,Workfront Fusion會顯示下列欄位。 除此之外,可能還會顯示其他Microsoft SharePoint Online欄位,視您應用程式或服務中的存取層級等因素而定。 在模組中,粗體標題表示那是必要欄位。
若在欄位或函式上方看到對應按鈕,可以使用按鈕設定該欄位的變數和函式。 如需詳細資訊,請參閱將資訊從一個模組對應到另一個模組。
磁碟機專案
建立檔案
此模組會傳回在SharePoint中建立檔案。 此模組的效能優於建立檔案(舊版)模組。
建立檔案(舊版)
此模組會在SharePoint中建立檔案。
為獲得更好的效能,建議您使用建立檔案模組。
建立資料夾
此動作模組會在SharePoint中建立新資料夾。
取得檔案
此動作模組會擷取指定的SharePoint檔案。
取得資料夾
此模組已擷取有關指定資料夾的詳細資料
更新資料夾或檔案
此動作模組會更新資料夾或檔案的中繼資料
監視資料夾專案
當您選取的資料夾中有專案更新時,此觸發模組就會啟動案例。
項目
複製專案
此動作模組會複製SharePoint清單中的現有專案。
建立專案
此動作模組會在SharePoint清單中建立新專案。
刪除專案
此動作模組會刪除SharePoint清單中的現有專案。
取得專案
此動作模組會傳回指定專案的資料。
取得詳細資料
此模組從指定的URL取得專案詳細資料。
清單專案
此動作模組會擷取指定清單中所有專案的清單。
移動專案
此動作模組會複製SharePoint清單中的現有專案。
更新專案
此動作模組會更新SharePoint清單中的現有專案。
觀看專案 (已排程)
此觸發模組會在建立或修改專案時啟動案例。
清單
建立清單
此動作模組會在SharePoint中建立新清單。
取得清單
此動作模組會傳回指定清單的資料。
清單清單
此動作模組會擷取指定網站中所有專案的清單。
觀看清單
此觸發模組會在建立或修改清單時啟動案例。
頁面(Beta)
beta版本的API可能會變更。 不支援在生產應用程式中使用這些API。取得頁面
此動作模組會傳回指定頁面的資料。
清單頁面
此模組會擷取所有頁面的清單。
發佈頁面
此動作模組會發佈所選頁面的最新版本。
觀看頁面
此觸發模組會在指定網站上修改頁面時啟動案例。
網站
取得網站
此動作模組會傳回指定網站的資料。
搜尋網站
此動作模組會依您指定的引數搜尋網站。
其他
取得變更
此模組會擷取SharePoint資料夾中的新增、更新和刪除專案。
進行API呼叫
您可以透過此模組進行自訂的 API 呼叫。
監視事件
在SharePoint中新增、更新或刪除專案時,此即時觸發模組就會啟動案例。