Mashup Builder > 小器具 > 標準小器具 > 格點小器具 > 在格點小器具中編輯資料
在格點小器具中編輯資料
欲在格點小器具中啟用編輯,請執行下列步驟:
1. 在 Mashup Builder 中,選取畫布上的「格點」小器具或使用「檔案總管」面板。
2. 「內容」面板中,將 IsEditable 設定為 True,然後按一下 配置小器具按鈕,開啟小器具組態對話方塊。
3. 在左側窗格中,選擇一欄,然後選中右側窗格中的「可編輯」核取方塊。
或者,配置下列選項:
選取「必填」核取方塊,以在編輯儲存格內容時始終要求輸入值。
「驗證運算式」方塊中定義驗證運算式,以將驗證規則套用至儲存格內容。
定義要針對驗證顯示的訊息與詳細資訊。
4. 針對您要編輯的任何欄重複上一個步驟。
5. 按一下「完成」關閉對話方塊,然後儲存混搭。
選擇編輯模式
欲控制在執行時間格點的編輯方式,請將小器具 EditLevel 內容設定為下列選項之一:
「整個格點」- 編輯個別儲存格並使用按鈕或服務手動儲存變更。
「單列」- 使用表單個別編輯列。
「單個儲存格」- 個別編輯儲存格,並在編輯完成後自動儲存變更。
當您對已啟用驗證的欄進行編輯時,系統會評估輸入,以確保您輸入的資料有效。當驗證失敗時,會顯示一則錯誤訊息,且不會儲存變更。如需有關驗證的詳細資訊,請參閱驗證格點內的輸入
您還可以啟用 EditButton 內容而非 IsEditable 內容。如果您將此內容設定為 true,則系統會在格點工具列新增編輯按鈕。您可以在執行時間按一下此按鈕來開啟或關閉編輯模式。
格點編輯模式
格點編輯模式可讓您更新多個儲存格,然後按一下「儲存」按鈕來同時儲存所有變更。
下圖顯示了編輯整個格點時,小器具左上方區域中的編輯按鈕。
當您按一下「編輯」時,會顯示「儲存」「取消」按鈕。會針對在格點上啟用編輯的每個儲存格顯示編輯控制項。您可以編輯一或多個儲存格的資料,然後按一下「儲存」來儲存編輯。若要反白包含未儲存編輯的儲存格,請將 HighlightDraftState 內容設定為 True。會使用不同的背景顏色來指示包含編輯的儲存格。
下列編輯事件適用於此模式:
EditStarted - 當您按一下「編輯」時觸發。
EditCompleted - 當您按一下「儲存」時觸發。
EditCancelled - 當您按一下「取消」時觸發。
列編輯模式
列編輯模式可一次編輯一列。當您啟用此模式時,會將包含編輯控制項的欄新增至格點的左側。下圖顯示了設定為列編輯模式的格點小器具。
欲編輯列,請按一下編輯圖示或連結。會顯示包含該列中儲存格的編輯表單。對值進行編輯之後,按一下「更新」來儲存對目前列所做的任何變更。
下列編輯事件適用於此模式:
EditRowStarted - 當您按一下編輯圖示或連結,以使用表單開始編輯列時觸發。
EditRowCompleted - 當您按一下「更新」時觸發。
EditCancelled - 當您按一下「取消」時觸發。
儲存格編輯模式
下列編輯事件適用於此模式:
EditCellStarted - 當您按一下編輯圖示或連結,以開始編輯儲存格時觸發。
EditCellCompleted - 當您按 Enter 鍵時,或在變更值後按一下儲存格外部時觸發。
EditCancelled - 當您取消儲存格編輯時觸發。
您可以按一下儲存格的編輯圖示或連結來編輯它。當編輯方塊處於使用中狀態時,會顯示未設定任何格式的原始值。完成編輯之後,會套用欄轉譯器來設定值的格式。如需有關轉譯器的詳細資訊,請參閱格點欄轉譯器與格式
* 
若要取消編輯而不儲存變更,請按下 Esc 鍵。
配置編輯控制項
使用 EditControlType 內容顯示編輯控制項的圖示或連結。您可以使用 EditControlIcon 內容將圖示取代為伺服器上的任何媒體實體。欲變更連結的預設編輯標籤,請使用 EditControlLabel 內容。依預設,當您將指標放置在儲存格上時,會顯示編輯控制項。您可以使用 EditControlVisibility 內容來配置編輯控制項的可見度。
使用 JSON 組態資料啟用編輯
新增下列頂層全域內容,以在 JSON 組態中啟用儲存格編輯。
var config = { “cellEditingEnabled”: true, “columns”: ... } };
欲針對欄啟用編輯,請新增下列 JSON 資料:
...
“ColumnFormatter”: {
“type”: “boolean”,
“format”: “notext”,
“cellEditor”: {
“enabled”: true, // *{boolean} to indicate whether cell editing is enable for this column
},
}
...
這是否有幫助?