Power Automate

重要事項： 在繼續之前，請確保您已依照此處的一個使用者一個帳戶說明進行操作。這可確保您不會遇到任何驗證衝突。

Power Automate 是一項雲端服務，讓使用者能自動化應用程式與服務間的工作流程，如同步檔案、接收通知、收集資料等多項功能。Power Automate 的強大之處在於它能在不同平台建立工作流程，無需撰寫程式碼。

Power Automate 的關鍵面向：

1. 客製化連接器

2. 雲流

3. 桌面流程

4. 業務流程流程

先決條件

WXP 使用者必須指定連接器 管理員 角色，才能存取並使用 WXP 平台內的整合與連接器。

有關角色基礎存取控制（RBAC）的資訊，請參閱認證章節。

客製化連接器

Power Automate 中的自訂連接器允許你連接到標準連接器無法提供的外部 API 或服務。自訂連接器可以與 API 互動，無縫自動化跨平台的工作流程。

客製化連接器的關鍵面向：

1. 資料連接性

   客製化連接器可整合外部 API，並允許存取第三方資料服務與操作。

2. 自訂認證

   支援多種認證類型，如 OAuth 2.0、API 金鑰或無認證。

3. 可重複使用動作

   讓你能為 API 端點建立可重複使用的動作，讓你能在不需大量手動設定的情況下整合服務。

4. 回應處理

   自訂連接器允許你處理 API 呼叫的回應，包括解析 JSON 回應以進行進一步處理。

5. 測試與除錯

   內建測試功能，驗證連接器功能如預期般運作。

設定指南

啟用 Power Automate 連接器

1. 在 Workforce Experience Platform 的整合頁面找到 Power Automate。
   

2. 下載Power Automate 中使用的自訂連接器檔案。然後，點擊 連接。  

    

3. 匯入 Power Automate：下載後，將自訂連接器匯入您的 Power Automate 環境。此步驟將自訂連接器加入您的環境，實現與 Workforce Experience Platform 的整合。

   1. 在 Power Automate 中，選擇左側導覽窗格的 「更多 」，然後點選 「全部發現」。

      
      

   2. 進入 資料 小工具並選擇 自訂連接器。你可以選擇將這個自訂連接器固定，讓它永遠在左側導覽窗格中可見。

      
      

   3. 然後，點選 「新的自訂連接器」。

      

   4. 選擇 匯入 OpenAPI 檔案。

      

       

   5. 對於 連接器名稱，請提供你自訂連接器的名稱（例如 HP Workforce Solutions）。對於 匯入 OpenAPI 檔案，請點擊匯 入 ，並在 WXP 整合頁面中選擇你從 Power Automate 卡下載的自訂連接器檔案。點擊 繼續。

      

       

   6. 點擊 建立連接器。建立前不需要做任何更改，因為所有必要資訊都已從你匯入的自訂連接器檔案中填入。

      

       

4. 查看連接器細節：回到 WXP，連接器連接完成後，選擇會出現在連接器卡中的 「檢視鑰匙 」按鈕。

   
   

5. 你現在可以看到並複製你的 API 金鑰、 空間 ID 和 租戶 ID。

   
   

6. 測試自訂連接器：透過測試確保你已成功設定自訂連接器。

   1. 在 Power Automate 中，點選自訂連接器的最後一個分頁： 測試。

      

       

   2. 點擊 「新連線」。會開啟一個新視窗，你可以輸入連接器卡中提供的 API 金鑰 並按下 建立連線。

      

       

   3. 回到原本的 Power Automate 視窗並重新整理頁面。你建立的 API 金鑰連線應該會自動出現在下拉選單中。

      

       

   4. 選擇一個操作進行測試。在必填欄位中插入 空間 ID 和 租戶 ID 。

      1. 空間識別碼應插入 fastn-space-id 欄位。

      2. 租戶識別碼應置於以下欄位：

         1. x-fastn-space-tenantId

         2. input.tenantId

         3. input.tenantIds，將所有你想要資料的租戶的 ID 列為陣列中的項目（例如 [“<tenant-id1>”，“<tenant-id2>”]）。

            

          

   5. 點擊 測試操作。若成功，回應將輸出為狀態 200。
      

測試自訂連接器作為流程中的動作

1. 在 Power Automate 中，請前往 「我的流程」>「新流程」>「即時雲端流程」。

   
   

2. 選擇 手動觸發流程。

   
   

3. 選擇 Plus 按鈕（+） 以在流程中插入新動作。

   
   

4. 搜尋你建立的客戶連接器，並選擇 自訂 以縮小搜尋範圍。找到後，選擇兩個操作之一—— 取得報告資料 或 取得事件 ——作為行動設定。

   

   
   

5. 設定所選操作的參數。類似測試自訂連接器本身，使用 空間 ID 和 租戶 ID 值填入相應欄位。

   

   
   

6. 設定好後，點擊 儲存。

   
   

7. 接著選擇 測試 來測試流量。

   
   

8. 選擇「 手動 」選項來觸發流程。然後，點選 「測試」。

   
   

9. 確認您的自訂連接器已準備好使用時，側邊會顯示綠色勾選。然後，選擇 繼續。

   

   
   

10. 選擇 「運行流程」。

    
    

11. 你的流程應該會開始運行。請導覽到所列的 流程執行頁面 ，查看該流程的狀態及更多相關資訊。

    
    

12. 若成功，狀態將顯示為 測試成功。

    
    

13. 點擊跑步條目以查看更多跑步詳情。

    
    

14. 點擊設定動作後，查看執行結果。你可以往下滑到 輸出 區塊，選擇 「顯示原始輸出」 以查看更多細節。

    
    

故障排除技巧

1. 錯誤：「憑證無效」

   原因：使用者名稱或密碼錯誤。

   解決方法：使用 忘記密碼 的連結重設密碼。

2. 錯誤：連線逾時

   原因：API 端點無法存取。

   解決方法：檢查網路連線。