Enterprise RTView® 
User Guide


Table Edits

In the Standard Table (class name: obj_table02), it is possible to add or remove rows and columns or edit the value of existing cells. To utilize table editing features, a Custom Message Handler must be implemented. Once the Custom Message Handler has been created, anyone can use Enterprise RTView to easily update data throughout the enterprise.

Enable Editing
To enable editing, you must set a variable and attach the table to data.

The editDataEnabledFlag allows you to control whether a table can be edited. In the Object Properties window when you select the editDataEnabledFlag, the editDataLocalVarName property will appear. In the Property Value field of editDataLocalVarName enter the name of the variable you would like to update with changes made to the editable table. This will allow you to identify the table in the Custom Message Handler as well as attach other objects in this display to your edited data. NOTE: The property editDataLocalVarName cannot be changed while the table is in Edit mode.

Attach data to the valueTable property to populate the table with initial data in order to enable editing. The table will not display data updates while in Edit mode, however once you save or cancel table edits current data for the valueTable attachment will be displayed.

Edit Table
To put the table in Edit mode, right-click on the table and select Edit Table from the popup menu. If the Edit Table option is not listed, the editDataAllowFlag has not been selected. If Edit Table is listed in the menu but is not active, the valueTable property is not attached to data.

To indicate your table is in Edit mode, the background rectangle of the table as well as the column headers will switch foreground and background colors.
To edit an existing cell value, double-click within a cell and enter a new value. When you are finished editing within a cell, you must press <Enter> or click on another cell before saving your edits. If the data entered is not the correct type (int, double, etc.) for that cell, the cell border will turn red and you will not be able to continue editing until the correct type of value is entered.

Right-click to access the following menu options:
Copy Cell Value Select a cell and right-click to Copy Cell Value.
Paste Cell Value Select a cell and right-click to Paste Cell Value.
Insert Row Select a cell in the row that is immediately above or below where you want to insert a new row and right-click to Insert Row. A dialog will appear asking you to enter a row name and specify whether to insert the new row above or below the selected row. Click OK to exit the dialog and add the new row. NOTE: If the Property Value of rowLabelMode is 0, row names will not appear in the table.
Insert Column Select a cell in the column that is immediately to the right or left of where you want to insert a new column and right-click to Insert Column. A dialog will appear asking you to enter a column name, column type, and specify whether to insert the new column to the right or left of the selected column. Click OK to exit the dialog and add the new column.
Remove Row(s) Select one or more cells and right-click to Remove Row(s) containing the selected cell(s).
Remove Column(s)    Select one or more cells and right-click to Remove Column(s) containing the selected cell(s). NOTE: The column that contains row names cannot be deleted. The table will only contain a column with row names if the Property Value of rowLabelMode is greater than 0.
Save/Cancel Edits  Right-click on the table to Save or Cancel Edits.

Save or Cancel Edits
If you exit a display while tables are in Edit mode without saving or cancelling changes, a dialog will appear (for each table with unsaved changes) asking if you would like to save your table edits.

Once you save or cancel your changes, the table will display current values for the valueTable data attachment and return to its original color scheme to indicate you are out of Edit mode.

If you edit a table within an applet and do not save your changes, you will not be prompted to save when exiting.  


 
SL, SL-GMS, GMS, Enterprise RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2008 Sherrill-Lubinski Corporation. All Rights Reserved.

 
JMS, JMX and Java are trademarks and/or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only.