進階網格的內容
根據您是透過 Mashup Builder (靜態組態) 還是服務 (動態組態) 配置網格而定，Mashup Builder 設計檢視中的進階與樹網格內容可能會有所不同。下表列出了當從 Mashup Builder 配置網格時可用的所有內容。
只能從 Mashup Builder 配置而無法透過動態組態進行配置的內容會在表格中以星號 * 標記。
|
屬性名稱
|
描述
|
基礎類型
|
預設值
|
是否可繫結 (Y/N)？
|
適用於網格還是樹網格？
|
||||
|---|---|---|---|---|---|---|---|---|---|
|
Id*
|
ThingWorx 在內部使用的唯一識別元。
|
INTEGER
|
Gridadvanced-<id>或
Treegridadvanced--<id>
|
N
|
二者
|
||||
|
Type*
|
小器具類型。
|
n/a
|
Grid-Advancedor Tree-Grid-Advanced
|
N
|
二者
|
||||
|
DisplayName*
|
用來在顯示時識別網格的使用者定義名稱。
|
STRING
|
gridadvanced-nor treegridadvanced-n
|
N
|
二者
|
||||
|
Description*
|
使用者定義的描述。
|
STRING
|
n/a
|
N
|
二者
|
||||
|
Data*
|
啟動網格時載入的資料來源。 如果將網格繫結至子資料來源，會顯示實心箭頭：  如果沒有資料來源，則會顯示  。 |
INFOTABLE
|
n/a
|
Y
|
二者
|
||||
|
ChildData*
|
展開節點時動態載入之子資料的來源。 如果將網格繫結至子資料來源，會顯示實心箭頭： 如果沒有子資料來源，則會顯示 。 |
INFOTABLE
|
n/a
|
Y
|
僅限樹網格
|
||||
|
ParentIDFieldName
|
識別父 ID 欄位名稱。若要建立階層樹狀結構，必須使用此內容。
|
STRING
|
parentId
|
N
|
僅限樹網格
|
||||
|
IDFieldName
|
網格的主索引鍵欄。此欄中的值可作為每個資料列的唯一識別元使用。此內容對於進階網格為選用內容，對於樹網格為必要內容。
如果未指定欄位，或者如果指定的欄位不存在，則網格會建立它自己的內部列 ID。
|
STRING
|
id
|
N
|
二者
|
||||
|
IDPathSeparator
|
可讓您配置路徑分隔符號字元。
|
STRING
|
:;
|
N
|
僅限樹網格
|
||||
|
HasChildrenFieldName
|
指定欄名稱，以指示列是否有可用的子資料。
若要指示列沒有子項，請輸入下列其中一項：'0'、0、'false'、false、empty string 或 undefined。
其他任何值都表示列有子項。
|
STRING
|
hasChildren
|
N
|
僅限樹網格
|
||||
|
Configuration*
|
如果將網格繫結至組態服務，會顯示實心箭頭： 如果沒有組態服務，則會顯示 。
|
STRING
|
n/a
|
Y
|
二者
|
||||
|
IsEditable
|
決定當網格在執行時間顯示時，您是否可以編輯網格儲存格中的值。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
|
EnableEditButtons
|
啟動網格工具列中的「編輯」、「儲存」及「取消」，以手動儲存編輯。
如果您要自動儲存變更，請設定上述的 IsEditable 內容。如果您要手動儲存變更，請設定 EnableEditButtons 內容。
若設定此內容，EnableAddDeleteButtons 內容會顯示在混搭內容面板中。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
|
EnableAddDeleteButtons
|
若您將此內容設定為 True，「新增」與「刪除」會顯示在格點工具列中，以便您可以新增或刪除網格中的列。
|
BOOLEAN
|
False
|
N
|
僅限進階網格
|
||||
|
EditedTable
|
在執行時間編輯儲存格時，為已更新值指定輸出位置的可繫結內容。此內容必須繫結至資料負載更新服務，才能儲存更新的值。例如，繫結至資料表物件上的 AddOrUpdateDataTableEntries 服務。
|
INFOTABLE
|
n/a
|
Y
|
二者
|
||||
|
DeletedTable
|
此內容可指定在執行時間從網格刪除之列的輸出位置。
此內容必須繫結至資料負載更新服務，才能儲存更新的值。例如，將內容繫結至資料表物件上的 AddOrUpdateDataTableEntries 服務。
|
INFOTABLE
|
n/a
|
Y
|
僅限進階網格
|
||||
|
DefaultSelectedRows
|
定義當顯示網格時預設會反白哪些列編號。值可以包含逗號分隔的數值與範圍。
範例：1,2,4-5 此內容也可以由繫結服務定義。如果繫結服務，會顯示 。如果沒有服務，則會顯示 。
|
STRING
|
n/a
|
Y
|
二者
|
||||
|
SelectedRows*
|
透過 INFOTABLE 來源定義當顯示網格時，預設會反白哪些列。
在樹網格中使用時，進行列選取時只需要「列 ID」欄，但您也可以包括其他欄。
在進階網格中，會透過將服務中 SelectedRows 參數的輸出繫結至網格上的輸入 SelectedRows 內容，來處理列選取。
此內容在輸出或輸入方向為可繫結，以便一個實體可以控制在另一個實體中的列選取。例如，一個表格可以控制第二個表格中的列選取，或者您也可以使用 3D 圖像來選取表格中的列。 如需控制實體，請將服務繫結為輸出 INFOTABLE  如需實體被控制，請將服務繫結為輸入 INFOTABLE: 
|
INFOTABLE
|
n/a
|
Y
|
二者
|
||||
|
IncludeRowExpansionParents*
|
決定當選取或展開子列時，是否包括未包括在預先載入用戶端資料中的父列。若為 True，會擷取包含子列的父列，以便可以重新建立階層。
|
BOOLEAN
|
False
|
N
|
僅限樹網格
|
||||
|
ExpandRows*
|
網格中應展開之任何頂層或子列的 ID。選取列以展開時，只需要「列 ID」欄。
|
INFOTABLE
|
n/a
|
Y
|
僅限樹網格
|
||||
|
ExpandLoadedRows*
|
啟動網格時，會自動展開所有預先載入的資料。
|
BOOLEAN
|
False
|
Y
|
僅限樹網格
|
||||
|
ExpandRowOnDoubleClick
|
當您連按兩下列或按一下節點圖示時，會展開包含子項的列。
在 JSON 組態服務中，內容名稱為：treeSettings.expandRowOnDoubleClick。
|
BOOLEAN
|
False
|
N
|
僅限樹網格
|
||||
|
PreserveRowExpansion
|
|
BOOLEAN
|
False
|
N
|
僅限樹網格
|
||||
|
RowSelection
|
控制可以配置哪一個列選取。選項：none、single 或 multi。
|
STRING
|
無
|
N
|
僅限網格
|
||||
|
AutoScroll
|
控制當重定網格大小或重新整理服務時，網格是否自動捲動至所選列。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
|
CookiePersistence*
|
可針對某些欄設定 (順序、大小、可見度與排序順序) 啟動用戶端持續性。
|
BOOLEAN
|
True
|
N
|
二者
|
||||
|
EnableContextMenu*
|
啟用或禁用網格前後關聯選單在執行時間的顯示，終端使用者可用來顯示或隱藏特定欄。與 CookiePersistence 搭配使用：
• 如果同時設定這兩個內容 - 使用者可以顯示及隱藏欄，且這些選取會持續。
• 如果未設定 EnableContextMenu 而設定了 CookiePersistence - 使用者無法顯示或隱藏欄，但之前的選取會保持不變。
• 如果已設定 EnableContextMenu 但未設定 CookiePersistence - 您可以顯示及隱藏欄，但僅適用於目前請求。
在 JSON 組態服務中，您可將內容設定為頂層參數，方式如下：
var config = {“enableContextMenu”: false,...}
|
BOOLEAN
|
True
|
N
|
二者
|
||||
|
EnableSorting
|
必須設定才能進行任何類型的欄排序，包括在標題、MultiColumnSortOrder 內容或繫結排序服務的遞增與遞減之間切換。若設定此選項，內容面板中的下列內容會變為可用：
• QueryFilter - 與資料服務搭配使用的可繫結篩選器查詢
• Filter - 用來觸發查詢資料服務的可繫結事件內容
|
BOOLEAN
|
False
|
N
|
二者
|
||||
|
MultiColumnSortOrder
|
設定預設欄排序順序。語法：column name:order,column name:order
範例：office:asc,title:des
|
STRING
|
n/a
|
N
|
二者
|
||||
|
EnableGridSearch
|
在網格上放置具有全域搜尋方塊的工具列。若設定此選項，內容面板中的下列內容會變為可用：
• QueryFilter - 與資料服務搭配使用的可繫結篩選器查詢
• Filter – - 用來觸發查詢資料服務的可繫結事件內容
|
BOOLEAN
|
False
|
N
|
二者
|
||||
|
GridSearchLocation
|
定義放置搜尋方塊的位置。只有在設定 EnableGridSearch 內容後，此選項才會變為可用。
|
STRING
|
n/a
|
N
|
二者
|
||||
|
QueryFilter*
|
這是一個可繫結的查詢內容，用來將查詢服務繫結為輸入查詢參數，以控制資料的排序、搜尋與篩選。開啟 EnableSorting 或 EnableGridSearch 內容後，此內容會變為可用。您可以從內容面板或網格本身的前後關聯選單中設定此內容。 如果您要在混搭中使用資料篩選器小器具，可以從進階網格或樹網格小器具將輸出 QueryFilter 內容繫結至輸入查詢內容。網格會組合所有查詢參數，以建立繫結至指定服務的單一輸出篩選器。當在兩個方向以這種方式繫結查詢篩選器時，會顯示實心箭頭：  如果沒有資料篩選器小器具，且繫結僅在輸出方向，則一個箭頭為實心，另一個箭頭為空心： |
QUERY
|
n/a
|
Y
|
二者
|
||||
|
EnableGridReset
|
放置具有網格「重設」按鈕的工具列。按一下「重設」可清除儲存在 cookie 中的所有網格使用者設定，並將網格恢復為其預設組態。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
|
EnableFilterEventOnConfigChange*
|
可在從服務更新組態時，開啟或關閉事件觸發。
若設定此內容，且已變更繫結組態，會觸發篩選器事件來同時更新資料。如果未設定此內容，在更新繫結組態時，不會觸發篩選器事件。
|
BOOLEAN
|
True
|
N
|
二者
|
||||
|
EnableFooter
|
在網格中啟用頁尾部份。若將此內容設定為 True，會設定另外兩個名為 FooterData 與 TableFooterStyle 的內容。
頁尾部份的資料使用 FooterData 內容進行繫結。
|
BOOLEAN
|
False
|
N
|
二者
|
||||
|
FooterData
|
包含顯示在網格頁尾的資料。
|
INFOTABLE
|
n/a
|
Y
|
二者
|
||||
|
GridResetButtonLocation
|
定義放置網格重設按鈕的位置。
|
STRING
|
n/a
|
N
|
二者
|
||||
|
RowFormat
|
可開啟一個對話方塊，您可在其中定義選用的以列為基礎的規則，來套用動態「狀態格式」。這些以列為基礎的規則可由以儲存格為基礎的狀態格式取代，可從網格前後關聯選單的「配置格點欄」選項中找到此功能。
|
STATE FORMATTING
|
狀態格式
|
N
|
二者
|
||||
|
TableWrapperStyle
|
定義網格背景樣式。這會在整個表格周圍新增輪廓顏色，並設定背景顏色。支援的屬性包括線條顏色、線條粗細、線條樣式、背景顏色以及替代背景顏色。
|
STYLEDEFINITION
|
DefaultTableWrapperStyle
|
N
|
二者
|
||||
|
TableHeaderStyle
|
定義網格標題樣式。
|
STYLEDEFINITION
|
DefaultTableHeaderStyle
|
N
|
二者
|
||||
|
FocusStyle
|
定義在網格中具有焦點之列的樣式。
|
STYLEDEFINITION
|
DefaultFocusStyle
|
N
|
二者
|
||||
|
RowBackgroundStyle
|
定義列背景樣式。這會新增背景顏色、字型顏色以及粗細樣式，但不會將線條樣式新增至每一列。
|
STYLEDEFINITION
|
DefaultRowBackgroundStyle
|
N
|
二者
|
||||
|
RowAlternateBackgroundStyle
|
為替代列定義另一個列背景樣式。這會新增字型顏色與粗細樣式，但不會新增線條樣式。
|
STYLEDEFINITION
|
DefaultRowAlternateBackgroundStyle
|
N
|
二者
|
||||
|
RowHoverStyle
|
定義當您將指標置於列上時列的樣式。這會將背景顏色與字型新增至每個儲存格。線條顏色、粗細與類型只會套用至放置指標的列。
|
STYLEDEFINITION
|
DefaultRowHoverStyle
|
N
|
二者
|
||||
|
RowSelectedStyle
|
定義當選取列時的列樣式。這會將背景顏色與字型新增至每個儲存格。線條顏色、粗細與類型只會套用至所選列。
|
STYLEDEFINITION
|
DefaultRowSelectedStyle
|
N
|
二者
|
||||
|
RowBorderStyle
|
定義列邊框樣式。這會將線條顏色、線條粗細與線型新增至儲存格的水平側。
|
STYLEDEFINITION
|
DefaultRowBorderStyle
|
N
|
二者
|
||||
|
CellBorderStyle
|
定義儲存格邊框樣式。這會將線條顏色、線條粗細與線型新增至儲存格的垂直側。
|
STYLEDEFINITION
|
DefaultCellBorderStyle
|
N
|
二者
|
||||
|
ToolbarStyle
|
定義工具列的樣式。
|
STYLEDEFINITION
|
DefaultToolbarStyle
|
N
|
二者
|
||||
|
TableFooterStyle
|
定義網格中頁尾部份的樣式。這包括背景顏色、邊框樣式及字型樣式。
|
STYLE DEFINITION
|
DefaultGridAdvancedFooterStyle
|
N
|
二者
|
||||
|
TooltipStyle
|
定義工具提示的樣式。
|
STYLEDEFINITION
|
DefaultTooltipStyle
|
N
|
二者
|
||||
|
SortAscendingStyle
|
定義遞增排序圖示的樣式。
|
STYLEDEFINITION
|
DefaultSortAscendingStyle
|
N
|
二者
|
||||
|
SortDescendingStyle
|
定義遞減排序圖示的樣式。
|
STYLEDEFINITION
|
DefaultSortDescendingStyle
|
N
|
二者
|
||||
|
CellValidationErrorStyle
|
定義發生驗證錯誤時儲存格的樣式。
|
STYLE DEFINITION
|
DefaultCellValidationErrorStyle
|
N
|
二者
|
||||
|
CellValidationErrorTooltipStyle
|
定義發生驗證錯誤時儲存格工具提示的樣式。
|
STYLE DEFINITION
|
DefaultCellValidationErrorTooltipStyle
|
N
|
二者
|
||||
|
RowIconStyle
|
定義樹節點之資料夾圖示的樣式。
|
STYLEDEFINITION
|
DefaultRowIconStyle
|
N
|
僅限樹網格
|
||||
|
RowExpansionIconStyle
|
定義樹節點之展開圖示的樣式。
|
STYLEDEFINITION
|
DefaultRowExpansionIconStyle
|
N
|
僅限樹網格
|
||||
|
RowCollapseIconStyle
|
定義樹節點之摺疊圖示的樣式。
|
STYLEDEFINITION
|
DefaultRowCollapseIconStyle
|
N
|
僅限樹網格
|
||||
|
HeaderOverflow
|
提供用來處理溢出之標題儲存格文字的選項。選項：
• fitted - 文字會配合欄寬度，然後換行，甚至會使字詞斷開。
• wrapped - 文字會在空格或破折號的地方換到另一行。
• clipped - 會裁切掉標題儲存格結尾的文字。
• ellipsis - 會裁切掉文字，但會用省略號 (...) 表示還有更多文字。
• tooltip - 會裁切掉文字但會顯示省略號 (...)，並會在工具提示中顯示完整文字
|
STRING
|
tooltip
|
N
|
二者
|
||||
|
DataOverflow
|
為溢出的資料儲存格文字提供選項。HeaderOverflow 內容也提供相同的選項。
|
STRING
|
clipped
|
N
|
二者
|
||||
|
MaxHeaderHeight
|
在垂直捲軸顯示前標題列可以展開至的最大高度 (以像素為單位)。
|
NUMBER
|
100
|
N
|
二者
|
||||
|
MinRowHeight
|
網格中列的最小高度設定 (以像素為單位)。
假設您未針對所顯示圖像大於預設列高度下限 (30 像素) 的欄使用圖像轉譯器。範例為套用包含圖像之樣式的狀態定義。在此情況下，請務必放大列高度設定以容納圖像高度。
|
NUMBER
|
0
|
N
|
二者
|
||||
|
MaxRowCacheSize
|
您可在用戶端網格中展開的最大列數。達到限制時，會產生一則警告，而且必須先摺疊節點，才能進一步展開。
|
NUMBER
|
5000
|
N
|
僅限樹網格
|
||||
|
DoubleClicked*
|
連按兩下網格時會觸發的可繫結事件內容。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
|
Filter*
|
這是一個可繫結的查詢內容，用來將查詢服務繫結為輸入查詢參數，以控制資料的排序、搜尋與篩選。開啟 EnableSorting 或 EnableGridSearch 內容後，此內容會變為可用。您可以從內容面板或網格本身的前後關聯選單中設定此內容。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
|
EditCellStarted
|
您開始編輯儲存格值時可以觸發的可繫結事件內容。只有在設定 IsEditable 參數後，此內容才處於使用中狀態。
您可使用此事件來在編輯時變更混搭中其他小器具的狀態。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
|
EditCellCompleted
|
您編輯儲存格然後再按下 ENTER 鍵、TAB 鍵或已編輯儲存格之外的任何位置時可以觸發的可繫結事件內容。按下 ESC 鍵可使值保持未編輯狀態。重新整理網格時，已編輯的值會顯示。
此事件的兩個用法如下：
• 您可將其繫結至資料負載更新服務，以使 EditedTable 資料負載的已編輯值保持不變。
• 您可將其繫結至會在混搭中啟用「儲存」按鈕小工具的服務。「儲存」按鈕可以再繫結至資料負載更新服務，以使 EditedTable 資料負載的已更新值保持不變。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
|
EditStarted
|
當您在網格工具列中按一下「編輯」時，會觸發此事件。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
|
EditCompleted
|
當您在網格工具列中按一下「儲存」時，會觸發此事件。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
|
EditCancelled
|
當您在網格工具列中按一下「取消」時，會觸發此事件。
|
EVENT
|
n/a
|
Y
|
二者
|
||||
|
Z-index*
|
分層小器具的排序。Z 索引較低的網格小器具會移至 Z 索引較高的另一個小器具後方。
|
NUMBER
|
10
|
N
|
二者
|
||||
|
Visible*
|
若設定，網格會在執行時間顯示。此內容可由繫結至網格的服務定義。如果可見服務繫結至網格，會顯示實心箭頭：  如果沒有可見服務，則會顯示  。 |
BOOLEAN
|
True
|
Y
|
二者
|
||||
|
SelectedRowsChanged*
|
當您在網格中選取或取消選取一或多列時，可用來觸發另一個小器具或服務的可繫結事件內容。
欲使用此事件內容，請遵循下列步驟：
• 將 RowSelection 內容設定為 single 或 multi。
• 將 SelectedRows 內容繫結至另一個實體 (小器具或服務)。
• 將 SeletedRowsChanged 事件繫結至其他實體，以便在 SelectedRows 變更時會將其觸發。
|
EVENT
|
n/a
|
Y
|
二者
|
* 當將組態服務繫結至網格時，只有加星號的內容會顯示在 Mashup Builder 的「內容」面板中。其他所有內容都會隱藏起來，不顯示在檢視中，這是因為這些參數是從 JSON 服務所傳入。
 |
網格樣式的優先順序如下所列，TableWrapperStyle 的優先順序最低，RowHoverStyle 的優先順序最高。
1. TableWrapperStyle
2. RowBackground/RowAlternateBackgroundStyle
3. CellBorder/RowBorderStyle
4. FixedRowFormatter/State Definition
5. RowSelectedStyle
6. RowHoverStyle
|