SmartTable 控制元件根據 OData 後設資料和指定的配置建立一個表。 必須指定 entitySet 屬性才能使用該控制元件。 此屬性用於從 OData 後設資料中獲取欄位，從中生成列； 它還可以用於獲取實際的表資料。
基於 tableType 屬性，此控制元件執行時將被渲染成標準、分析、樹或響應表等實際控制元件。

SmartTable 控制元件支援相關實體集引用的貨幣和單位自定義。SAP UI5 框架會自動請求這些相關的程式碼列表，然後用於格式化貨幣和單位單元格模板。

SmartTable 控制元件提供了一個名為 preserveDecimals 的全域性 customData 設定，可用於配置 preserveDecimals 格式選項。

customData 的預設值為 preserveDecimals=true。 然後，此 customData 用於格式化 Edm.Decimal 型別以及貨幣和單位單元格模板。

如果小數位數與程式碼列表返回的值不同，則無法保證貨幣和單位值的小數點對齊。
包含空白字元的字串型別的單元格資料被替換為 unicode 字元，以在 UI 上視覺化空白。 這是預設啟用的。

有朋友諮詢：

> 如何為自定義列啟用個性化，它們與常規列有何不同，尤其是在與個性化設定或電子表格匯出一起使用時？

You can specify custom data for the personalization of the columns in your table as shown in the examples.

可以透過指定 `custom data` 的方式，來實現 table column 的定製化。

```xml
<column id="Ledger" minscreenwidth="Tablet" demandpopin="true">
    <customdata>
        <customdata key="p13nData" value="\{"columnKey": "Ledger", "leadingProperty":"Ledger",
            "additionalProperty":"LedgerName", "sortProperty": "Ledger",
            "filterProperty": "Ledger", "type":"numeric"}"></customdata>
    </customdata>
    <label text="Ledger"></label>
    <template>
        <text text="{Ledger}"></text>
    </template>
</column>
```

為了使用 `SAPUI5 shortcut notation`, 將下列名稱空間片段新增到 XML view 裡:

```xml
xmlns:customData="http://schemas.sap.com/sapui5/extension/sap.ui.core.CustomData/1"
```

使用 `shortcut notation` 之後的版本:

```xml
<column id="CompanyCode" minscreenwidth="Tablet" demandpopin="true" customdata:p13ndata="\{"columnKey": "CompanyCode", "leadingProperty":"CompanyCode", "additionalProperty":"CompanyName","sortProperty": "CompanyCode", "filterProperty": "CompanyCode", "type":"numeric", "maxLength":"4"}">
    <label text="Company Code"></label>
    <template>
        <text text="{CompanyCode}"></text>
    </template>
</column>
```

在 `p13nData object` 裡可以指定下列屬性：

- columnKey：用於儲存、檢索或應用列個性化的唯 一鍵。
- leadingProperty：當列可見時，從後端系統檢索此處指定的 OData 屬性的資料。 必須使用 OData 模型屬性名稱。
- additionalProperty：如果列可見，則必須請求屬性。 必須使用 OData 模型屬性名稱。 可以在此處將多個屬性名稱指定為逗號分隔值 (CSV)。
- sortProperty：根據指定的列對錶進行排序。 必須使用 OData 模型屬性名稱。 此屬性類似於網格表的 sap.ui.table.Column 的 sortProperty，只有在後者不支援此功能時才必須使用。
- filterProperty：使用已定義的條件過濾表。 必須使用 OData 模型屬性名稱。 此屬性類似於網格表的 sap.ui.table.Column 的 filterProperty，只有在後者不支援此功能時才必須使用。
- isGroupable：自動在“檢視設定”對話方塊的“組”皮膚中顯示一個欄位； 否則，只有在表（行）繫結後，欄位才可能變得可見。 只有 AnalyticalTable 型別需要此屬性。如果欄位可排序、可篩選和維度，則 SmartTable 會自動將此屬性設定為 true。
- type：確定控制元件的型別； 它的值可以是日期、時間、布林值、數字、字串日期、字串或未定義。 控制元件將根據型別進行調整。 stringdate 用於匯出帶有 IsCalendarDate 註釋的欄位。
- maxLength：用於限制輸入欄位中的條目數的數值
- precision：精度的數值
- scale：比例的數值
- nullable：定義一個欄位是否可以沒有值（然後與空值過濾相關）。 控制元件的使用者可以使用字串值 false 來指示該欄位不可為空。 預設值可以為空。

SAP UI5 SmartTable column 的個性化設定使用概述

相關文章