在 Power Pages 中設定 Power Automate 雲端流程

發行項
01/29/2025

Power Automate 雲端流程可讓使用者在不同的應用程式與服務之間建立自動化的工作流程。您可以使用 Power Automate 雲端流程來建立邏輯，當事件發生時執行一或多個工作。例如設定一個按鈕，讓使用者選取該按鈕時，可傳送電子郵件或會議要求、更新記錄、收集資料、同步處理檔案和其他工作。

現在，您可以從 Power Pages 安全叫用 Power Automate 雲端流程，與 1000 多個外部資料來源互動，並將其整合至您的商務網站中。

注意

您的 Power Pages 網站版本必須是 9.5.4.xx 或更新版本，才能使用此功能。
入門網站套件版本必須為 9.3.2304.x 或更新版本。

必要條件

若要與 Power Pages 整合，則需要 Power Automate 授權。建議在生產執行個體中使用 Power Automate Process 授權。

整合雲端流程的步驟

建立雲端流程。
將流程新增至網站。
從網站中叫用流程。

建立流程

登入 Power Pages。
選取網站 + 編輯。
導覽至設定工作區，然後選擇整合下的雲端流程。
選取 + 建立新流程。
搜尋 Power Pages，選取當 Power Pages 呼叫流程觸發程序。
定義您的流程步驟並傳回值，然後選取儲存。

注意

只有解決方案感知流程可以附加至 Power Pages 網站。

將流程新增至網站

建立即時雲端流程之後，它必須與 Power Pages 網站相關聯，並使用 Web 角色進行保護。

登入 Power Pages。
選取網站 + 編輯。
導覽至設定工作區，然後選擇整合下的雲端流程。
選取 + 新增雲端流程。
搜尋最近建立的流程。
在角色底下，選取 + 新增角色。
選取可存取流程的角色。
選取儲存。

注意

將流程新增至網站時會產生唯一的 URL，讓您從網站中叫用雲端。

從網頁叫用流程

使用 Power Pages 雲端流程 API 與 Power Automate 互動，以執行外部服務整合。雲端流程 API 作業是由 HTTP 要求和回應所組成。

選用	方法	URI
叫用雲端流程	POST	[Site URI]_/api/cloudflow/v1.0/trigger/<guid>

範例:

Request

POST https://contoso.powerappsportals.com/_api/cloudflow/v1.0/trigger/4d22a1a2-8a67-e681-9985-3f36acfb8ed4
{
    "Location":"Seattle"
}

回應

無回應動作的雲端流程

HTTP/1.1 Accepted
Content-Type: application/json

有回應動作的雲端流程

HTTP/1.1 200 OK
Content-Type: application/json
Body
{
    "conditions":"Rain",
    "humidity":"93",
    "latitude":"47.60620880126953",
    "longitude":"-122.33206939697266"
}

驗證雲端流程 Web API 要求

您不需要包括驗證代碼，因為應用程式工作階段會管理驗證和授權。所有的 API 呼叫都必須包括跨網站偽造要求 (CSRF) 權杖。

將參數傳遞至雲端流程

在雲端流程中，您可以定義類型為文字、布林值、檔案和數字的輸入參數。您在要求本文中定義的參數名稱，必須與雲端流程觸發程序中定義的參數名稱相符。

重要

您必須傳遞雲端流程中定義的要求參數名稱。
不支援將參數傳遞給設定了安全輸入的流程。

用於呼叫流程的 JavaScript 範例

此範例示範如何使用非同步 JavaScript 和 XML (AJAX) 來呼叫流程。

    shell.ajaxSafePost({
        type: "POST",
        url: "/_api/cloudflow/v1.0/trigger/44a4b2f2-0d1a-4820-bf93-9376278d49c4",
        data: {"eventData":JSON.stringify({"Email": "abc@contoso.com", "File":{"name":"Report.pdf", "contentBytes":"base 64 encoded string"} })}
    })
    .done(function (response) {
    
    })
    .fail(function(){
    
    });

注意

如果觸發程序中未定義任何輸入參數，則在要求中傳遞空白承載。
有關雲流限制的資訊，請參閱自動化流程、預定流程和即時流程的限制。

雲端流程的應用程式生命週期管理 (ALM)

當您將包含雲端流程的 Power Pages 網站元件從一個環境移至另一個環境時，必須在目標環境中註冊雲端流程。如果您不註冊雲端流程，從網站叫用它們會導致禁止錯誤。

若要將流程註冊到目標環境，請依照下列步驟操作：

登入 Power Pages ，然後選擇目標環境。
找到該網站，然後選擇編輯。
前往設定工作區，然後選擇整合下的雲端流程。
在此網站的雲端流程清單中，尋找註冊按鈕。
若要註冊流程，請選取該圖示。

共用方式為