元件可以接收輸入值,以使用自訂輸入屬性發出或處理資料。 在本文中,您將了解如何使用這樣的元件,這類元件會需要一個或多個具有指定資料表或記錄之特定結構描述的輸入屬性,以及如何將元件輸入欄位對應至資料來源的資料行。
小提示
若要瞭解元件中的自訂輸入和輸出屬性是什麼,請參閱 元件中的自訂屬性。
地圖欄
使用 RenameColumns() 函數重新命名表格的一個或多個欄,以符合選取輸入欄所需的輸入屬性架構。
例如,假設一個元件需要具有下列格式的資料表輸入:
| Flavor | UnitPrice | QuantitySold |
|---|---|---|
| 草莓 | 1.99 | 20 |
| 巧克力 | 2.99 | 45 |
input 屬性需要表格資料類型:
輸入屬性的結構描述如下所示:
Table({Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold:20})
使用此元件的應用程式具有下列與元件結構描述不相符的 IceCreams 資料表:
| 風味名稱 | 價格 | 銷售編號 |
|---|---|---|
| 草莓 | 1.99 | 20 |
| 巧克力 | 2.99 | 45 |
若要對應正確的欄位,請使用 RenameColumn() 函數重新命名需要的欄。
RenameColumns(IceCreams,"cra56_flavorname","Flavor","cra56_price","UnitPrice","cra56_salenumber","QuantitySold")
元件預期的輸入欄位現在會與資料來源中的相符欄對應。
地圖記錄
使用 With() 函數來對應單一記錄。
例如,承續先前的欄位對應範例,應用程式中的元件自訂輸入屬性需要一種具備以下結構描述的記錄類型:
{Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold: 20}
由於 IceCreams 資料來源預期欄名稱為 FlavorName、 Price 和 SaleNumber,因此一旦將元件新增至應用程式,我們就必須變更記錄的對應。
使用 With() 函數選取 IceCreams 表格的欄,並將它們對應至元件的輸入欄位:
With(Gallery3.Selected,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})
下列動畫顯示新增至應用程式的元件範例,其中顯示資源庫中選取的記錄 (元件上方):
地圖表格
使用 ForAll() 函數將記錄表與新增至應用程式的元件所期望的記錄對應。
例如,在對應資料行範例中,您可以使用 ForAll() 函數,將整個資料表對應至特定資料行,並指向元件中欄位的各資料列:
ForAll(IceCreams,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})
使用 ForAll() 函數將表格對應到所有記錄。
使用下拉式清單繪製地圖(已棄用)
您可以對新增到所需資料表或記錄類型輸入屬性之應用程式的元件使用進階索引標籤,並使用下拉式清單選項選擇欄位對應。 預設情況下,此對應會被指派,且除非您手動選取適當的對應欄位,否則對應可能無法達到預期的結果。
例如,下列動畫顯示正在更新公式以便對資料行進行重新命名。 畫面上的元件不會變更欄位對應,因為使用此下拉式清單的預設欄位選取需要手動更新。
這種使用下拉式清單選取對應的方法已被取代。 請改用欄、記錄或表對應方法,如本文稍早所述。
您仍可以使用下拉式清單選項來選擇現有應用程式的對應,但不建議這樣做。 對於新應用程序,此選項預設不可用。 若要開啟或關閉此已棄用的功能,請移至 設定>即將推出的功能>已淘汰,然後選擇 允許元件輸入的自動欄位指派。
開啟設定時,請確定您在 Power Apps Studio 中儲存並重新開啟應用程式。 重新開啟後,更新輸入屬性公式以觸發公式驗證,以便下拉式選項開始出現在 [進階屬性] 窗格中。