在 Power Pages 中使用 Power Fx (預覽版)

發行項
10/16/2024

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

Power Fx 是用於在 Microsoft Power Platform 中表達邏輯的低程式碼語言。這是一種通用、強型別、聲明性和函數式程式設計語言。

Power Fx 會以人性化的文字表示。這是一種低程式碼語言，製作者可以直接在類似 Excel 的公式列中使用。低階代碼中的「低階」是由於該語言的簡潔性和簡單性，使得製造商和開發人員都可以輕鬆執行常見的編程任務。

注意

您可能會發現創作 Power Fx 公式的語法與您在 Power Apps 或 Power Automate 中可能習慣的語法略有不同。若要啟動 Power Fx 表達式，它必須以「=」(等號) 開頭，就像在 Excel 中一樣。如需詳細資訊，請參閱重要考量。

Power Fx 實現從沒有任何程式設計知識的無程式碼開發人員到專業開發人員的專業程式碼的全方位開發。它促進了不同團隊之間的協作，幫助他們節省時間和精力。

重要

這是預覽功能。
預覽功能不供生產時使用，而且可能功能受限。這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。
該功能在 Power Pages 9.6.5.x 版本中可用。

在 Power Pages 中使用 Power Fx

在 Power Pages 網站中， Power Fx 可作為表達式語言與以下元件及其屬性一起使用。此功能有助於根據 Power Fx 表達式的結果動態分配值。

組件	內容
文字	文字
Image	圖像 URL、替代文本
Button	按鈕 URL、按鈕文本
iFrame	iFrame URL

使用 Power Fx 公式欄

工具列包含一個新的 fx 命令，用於支援 Power Fx以下各項的元件：

文本控制項命令列中命令的 Power Fx 螢幕截圖。

選擇 fx 以存取 Power Fx 公式列。

公式欄組件

以下螢幕截圖突出顯示編輯欄的一些重要元件：

Power Pages 中 Power Fx 公式列的螢幕擷取畫面。

下拉功能表允許您從可用的元件屬性中進行選擇。
多行可展開文本框允許編寫 Power Fx 公式。
重置按鈕將元件屬性設置為其預設值。
儲存按鈕保留元件屬性的公式和運算式。如果結果值可用且可以顯示在文字屬性中，則工作室畫布會立即更新。

公式欄體驗

以下是一些以提高工作效率的以開發人員為中心的功能：

自動完成輔助：建議公式、參數、表格和物件。選擇 Ctrl + 空格手動存取此功能。
查看問題功能：有助於公式和表達式的早期驗證和偵錯。
未儲存的變更對話方塊：如果您在公式有未儲存的變更時離開編輯欄，則會顯示該對話方塊。

選擇返回以繼續編輯公式，或放棄以放棄更改。

重要考量

在 Power Pages 中使用 Power Fx 編輯欄時請考慮以下準則：

以等號開頭：可以直接輸入文本作為值。要啟動 Power Fx 表達式，它必須以「=」(等號) 開頭，如下例所示：
```
=Concatenate("Hello, ", User.FullName)
```
安全地存取資料表：可以使用公式安全地存取 Dataverse 資料表。首先驗證是否正確配置了表許可權。此外，可以使用使用者物件來獲取網站使用者的上下文。例如，以下表達式檢索當前經過身份驗證的使用者的 DataverseUserId 值。
```
=Concatenate("Hello, ", First(Filter(Contacts,Contact = User.DataverseUserId)).'First Name' & "!")
```
注意

使用者物件表示使用者，Power Pages 因此不支援與使用者函數的相同屬性集。

在文字中插入值：若要在文字中插入值，請使用以下語法。

This text ${variable/ expression} includes a dynamic value.

例如:

The total number is ${Sum(10, 20)}

可用的 Power Fx 函數

關於 Power Pages 中所有可用功能的完整列表，前往公式參考 – Power Pages。

已知問題與限制

Power Pages 目前不支援透過 IntelliSense 提供的某些 Power Fx 功能。這些函數在使用時會顯示以下設計時錯誤：

Parameter 'Value': PowerFx type is not supported.
系統不會為匿名使用者初始化使用者，這會導致在任何表單上使用它時出現以下錯誤，包括檢查空白。此問題將在未來版本中修正。

UserInfo object was not added to service
當使用包含雙引號的 Power Fx 公式或表達式設定值時，某些使用者可能會遇到「按鈕」和「影像 URL」屬性不起作用的問題。僅當您擁有版本 9.6.3.x 時，才會發生此問題，並在網站 Power Pages 升級到版本 9.6.5.x 時修復此問題。

常見問題

我應該用 Power Fx 代替 Liquid 嗎？

Power Fx 以低程式碼方式滿足某些動態資料場景，也可以透過使用專業開發人員工具的 Liquid 程式碼來實現。 Power Fx 目前處於公開預覽版階段，建議用於試用或開發網站的評估。我們歡迎您在此階段提供反饋。 Liquid 是一項普遍可用 (GA) 功能，相對而言提供了更多功能。將 Liquid 用於您的生產網站，尤其是在關鍵和複雜的場景中。

共用方式為