使用命令設計師自訂命令列

發行項
10/16/2024

本文將引導您使用命令設計師和 Power Fx 來建立和編輯新式命令。

在應用程式設計師中開啟

使用現代應用程式設計器創建新的模型驅動應用或使用應用程式設計器打開現有模型驅動應用。

使用新式應用程式設計工具來建立或新的模型導向應用程式

登錄 Power Apps 。
在左瀏覽窗格中，選取解決方案。如果該專案不在側面板窗格中，請選擇 ...More (更多 )，然後選擇所需的專案。
打開或建立解決方案以包含新的模型導向應用程式。
選擇新建>應用>模型驅動應用。
輸入應用的名稱 ，然後選擇創建。詳細資訊：構建您的第一個模型驅動應用

使用應用程式設計器打開現有的模型驅動應用

登錄 Power Apps
在左瀏覽窗格中，選取解決方案。如果該專案不在側面板窗格中，請選擇 ...More (更多 )，然後選擇所需的專案。
打開包含現有模型導向應用程式的解決方案。
選擇模型驅動應用，然後選擇 ...>Edit 以打開現代應用程式設計器。

建立或編輯新式命令

進入應用程式設計師後，使用命令設計師自定命令列。

注意

目前，只能透過新式應用程式設計工具或在現有命令的解決方案中，才能存取命令設計工具。
目前，無法在命令設計工具中編輯傳統命令。

編輯命令列

開啟命令設計工具以編輯命令列

從 應用程式設計器的 Pages 區域中選擇任何表。
選擇 ...，然後選擇 編輯命令列。
選擇所需命令列的位置，然後選擇編輯。詳細資訊：命令欄位置

建立新命令

與傳統命令不同，新式命令只會顯示在您正在編輯的應用程式中。這樣可防止將不需要的命令傳送至其他應用程式，並改善執行階段效能。

首次為應用程式打開命令設計器時，將顯示僅使用 JavaScript 的提示 或 Power Fx 提示。如果需要，選擇 Power Fx 還允許您使用 JavaScript。在對話框中選擇 Power Fx 將創建一個用於存儲 Power Fx 公式的命令元件程式庫。

打開命令設計器以編輯命令列，然後選擇新建>命令。
在右窗格中，輸入或選取下列選項：
- 標籤 (可選)。 輸入顯示在命令按鈕上的標籤。
- 圖示。選取命令按鈕的圖示。您可以從任何系統圖示或 Web 資源 SVG 檔案中進行選擇。要上傳您自己的圖示，請選擇 Web 資源，然後上傳 SVG 格式檔。然後，選擇 Save and Publish the web resource. 有關如何為所需圖示圖像創建 Web 資源的詳細資訊，請轉到創建或編輯模型驅動應用 Web 資源以擴展應用。
- 操作。請從下列選取：
  - 運行公式。輸入 Power Fx 公式以執行命令動作。詳細資訊：用於 Power Fx 操作和可見性
  - JavaScript 的 JavaScript 中。提供 JavaScript 程式庫和命令來執行命令動作。詳細資訊：將 JavaScript 用於操作
- 可見性。選擇是 Show the command button 還是 Show on condition from formula。
- 工具提示標題。（可選）輸入工具提示標題。當使用者將滑鼠懸停在命令上方時，就會顯示標題。
- 工具提示說明。（可選）輸入工具提示描述。當使用者將滑鼠懸停在命令上方時，說明會出現在使用者的工具提示標題下方。
- 輔助功能文本。（可選）輸入螢幕閱讀器將朗讀的文字。
- 訂單號。命令在運行時相對於同一命令欄中其他命令的顯示順序。
將命令拖放到所需位置。您可以在傳統命令中排列新式命令。
選擇 Save and Publish (保存併發佈 ) 以使命令可供應用程式使用者使用。
選擇 Play 以運行應用程式並測試您的更改

注意

發佈 Power Fx 公式可能需要幾分鐘的時間才能發佈命令元件庫。在命令設計器完成請求並解鎖設計器后，此後台操作可能仍在進行中。

針對動作和可見度使用 Power Fx

您可以將 Power Fx 用於動作 (選取命令按鈕時會發生的情況) 和可見度 (控制按鈕何時可見的邏輯)。 Power Fx 在 Classic 命令中不受支援。

您會發現模型導向應用程式命令具有類似於畫布應用程式的公式列體驗。對於數據處理 Dataverse ，您可以像在畫布應用中一樣使用 Power Fx 公式。詳細資訊：使用 Power Fx with 命令

注意

Dataverse 目前是模型導向應用程式中唯一支援命令的資料來源。
您目前無法直接從命令設計師將其他資料表新增為資料來源。但是，您可以在 Canvas Studio 中打開命令元件程式庫，並將其他表添加為數據源，然後在命令設計器中使用它們。
模型導向應用程式命令目前並不支援畫布應用程式中的所有可用功能。此外，我們還引入一些特定於模型導向應用程式命令的新功能。
有關現代命令的更多限制，請轉到現代命令的已知限制。

使用 JavaScript 進行動作

傳統和新式命令都支援 JavaScript。不過，使用新式命令設計師建立命令和關聯 JavaScript 會更簡單。

對於 Action (操作)， 選擇 Run JavaScript ( 運行 JavaScript )。
選擇 Add library 或從清單中選擇另一個庫 。清單會填入目前命令列所使用的任何程式庫。
選擇 「添加」 並搜索現有的 JavaScript Web 資源，或者您可以添加自己的 JavaScript Web 資源。
輸入 Function name ( 函數名稱)。例如，選擇 Main_system_library.js 庫，然後調用此函數： XrmCore.Commands.Open.opennewrecord。
新增要傳遞給函數的參數。