共用方式為


從應用程式、流程、程式碼或其他函數呼叫函數 (預覽版)

[本主題是發行前版本文件,並可能在未來變更。]

您可以從畫布應用程式、模型導向應用程式中的自訂頁面、流程、程式碼或其他函數呼叫 Dataverse 中的函數。

重要

  • 這是預覽功能。
  • 預覽功能不供生產時使用,而且可能功能受限。 這些功能是在正式發行前先行推出,讓客戶能夠搶先體驗並提供意見反應。

從畫布應用程式或自訂頁面呼叫函數

  1. 從 Power Apps (make.powerapps.com) 中的函數區域中,選擇要從畫布套用或自訂頁面呼叫的功能。
  2. 選取命令列上的複製程式碼片段
  3. 將複製的公式貼上並儲存到文字編輯器、記事本或您可以輕鬆參考的地方。
  4. 在 Power Apps Studio 中:
    1. 在 Power Apps Studio 中建立或編輯畫布應用程式或自訂頁面。
    2. 在左側導覽窗格中的資料來源標籤下,選擇新增資料,從 Dataverse 連接器中搜尋環境選項,然後選擇它。
    3. 將以下元件插入畫布上:
      • 新增與每個參數的資料類型相對應的輸入控制項,例如數字輸入。
      • 新增一個按鈕來呼叫該函數。
      • 新增與參數資料類型相對應的輸出控制項,例如數位輸入。
  5. 選擇您建立的按鈕,然後在 OnSelect 屬性中輸入您的函數,例如 Environment.new_calculatesum
  6. 對應每個輸入參數 Value 以參照相應的輸入控制項:
    • 如果您的函數是Environment.new_CalculateSum({ X: Value, Y: Value });,則可以重寫為:Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });
    • 若要設定函數「result」輸出,請將公式更新為「Set(result, Environment.new_CalculateSum({X: NumberInput1.value, Y: NumberInput2.value }))」。
  7. 選擇輸出控制項並使用公式「result.z」設定「Value」屬性。

預覽您的應用程式,輸入輸入 1 和 2 的值,然後選擇按鈕。 結果應顯示在輸出欄位中。

從 Power Automate 雲流程呼叫函數

  1. 在雲端流程中,從 Microsoft Dataverse 連接器新增動作。
  2. 選擇名為執行非繫結動作的動作
  3. 選擇您的功能。 該函數具有一個帶首碼的唯一名稱。
  4. 為所有輸入參數提供值 (如果有)。

從 Dataverse Web API 呼叫函數

請按照從 Web API 較用自訂 API 文章中未繫結動作部分的步驟進行操作 (取決於外掛程式的適當範圍)。

在新函數中呼叫現有函數

若要在新函數中呼叫現有函數,請使用下列語法:Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

由於輸出始終是一筆記錄,因此使用點符號來存取輸出參數。 例如,如果函數「ExistingFunction」有兩個輸出參數定義為 out1 和 out2,則您可以透過以下兩種方式之一存取它們:

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Dataverse 中函數的限制

  • 需要重新新增環境語言物件才能存取現有畫布應用程式內的新功能。 對於將環境表資料來源新增至現有畫布應用程式後所建立的任何函數,都必須刪除並重新新增 Power Fx 環境語言物件。 然後您會看到更新的功能動作清單。
  • 嵌入的支援。 函數只能從 Power Fx 運算式呼叫 Microsoft 發佈的 Microsoft 動作。
  • 某些 Collect 案例需要 Patch。 在某些案例中,無法使用 Collect()。 解決方法是使用 Patch(),如此處填入的相關資料欄範例所示。
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

偵錯並獲得有關您的功能的幫助

如果在建立或執行函數時遇到問題,請使用 trace() 函數進行偵錯或前往 Dataverse 中的函數限制,以了解可能出現的常見問題。

使用 trace() 函數進行偵錯

  1. 若要使用追蹤功能進行偵錯,請確保啟用外掛程式和自訂工作流程活動追蹤。
  2. 前往 Power Apps (make.powerapps.com),選擇右上角的設定齒輪圖示,然後選擇進階設定
  3. 選擇設定>稽核>全域稽核設定。
  4. 自訂標籤上,確保啟用記錄記錄到外掛程式追蹤記錄已為全部啟用。

一旦啟用追蹤,您就可以開始使用 trace() 函數來偵錯 Power Fx 公式。 了解有關如何在 Power Fx 運算式中使用 trace() 函數的更多資訊:追蹤函數 - Power Platform

聯絡幫助 + 支援

對於 Microsoft Dataverse 低程式碼外掛程式提示中未涵蓋的功能問題以及已知問題 (例如收到未記錄的錯誤),請使用說明 + 支援體驗並包含以下資訊:

  • 問題類型 - Dataverse Web API 和 SDK。
  • 問題子類型。

範例函數

在 Microsoft Dataverse 中建立和使用函數