www.element4solution.com

Package e4s.html.editing

Element that can be used to display values out of an database table and modify values.

See:
          Description

Interface Summary
AEP_EditingDataDescriptor_Intf AEP - Application Exit Point during editing using E4EditingElement.
AEP_UserDefFunction_Intf Application exit point for user defined, additional, functions in the E4EditingElement-Table.
E4EditingFormatter_Intf A formatter enables to distinct between a displayed value and a real value.
 

Class Summary
AEP_EditingDataDescriptor Default implementation AEP - Application Exit Point during editing using E4EditingElement.
E4EditingDataDescriptor Definitions about how data can be modified.
E4EditingDataDescriptor.Descriptor  
E4EditingDataDescriptor.e4sHashDescriptors  
E4EditingDataDescriptor.SimpleFieldName  
E4EditingDefinitionDataField Definition for database table columns, related to the display / layout issues (E4EditingDefinitionTableColumn).
E4EditingDefinitionTableColumn Definition for columns (display, layout) and database contents (E4EditingDefinitionDataField).
E4EditingElement Element that can be used to display values out of an database table and modify values.
E4EditingElement.E4EditingElementAdditionalButton  
E4EditingElement.E4EditingElementOnlyEditing Covers parameters and the editing mode that enable to use ONLY the editing frameset, without having any navigation frames or selection table.
E4EditingFormatterDefault Default implementation for the editing formatter.
E4EditingFrameset Provides a frameset for editing of database table contents, making use of E4EditingElement.
E4EditingPersistance Reading/writing user definitions for editing tables to a XML file.
E4EditingPersistance.TableLayout  
E4EditingSettings System settings for editing elements.
E4FormatterLongText A formatter which cuts off too long text elements.
E4SubEditingBODY Main <BODY>-Element of a webpage for special use within editing userdefined functions.
 

Package e4s.html.editing Description

Element that can be used to display values out of an database table and modify values. Supports changing of sorting columns, layout definitions, next/previous page, search capabilities, adding/modify/delete records. Used within e4s.html.editing.EditingFrameset.

First, start to define a frameset using e4s.html.editing.EditingFrameset. The frameset contains the EditingElement. Some general settings are defined in the property file, using e4s.html.editing.EditingSettings to retrieve them.

When data is displayed out of a database table (using the interface e4s.db.dbSelect_Intf, then it will be displayed using some kind of a table view. Either the data will be displayed as it is contained in the database table, or you can use a Formatter ( e4s.html.editing.EditingFormatter_Intf to distinct between what will be displayed and what is the real data (e.g. real data = "N", "W", "S", "E" but display will be "North", "West", ..). When performing a search, this will be treatened vice versa and the user gets a combo-box selecting "North", "West", .. but the database query results in "N", "W". A Formatter is optional.

The functionality is covered in modules e4s.application.modules.moduleEditingHandling01 and e4s.application.modules.moduleEditingHandling02. The first module contains more or less frame handling and list handling, including searching. The second module contains functionality for modifying records. It is not required to use this functionality of the second module, either because it is not needed or it will be overwritten by your own functions. If the module is used, then you can make use of the AEP ( e4s.html.editing.AEP_EditingDataDescriptor_Intf - Application Exit Point) to become involved before or after an operation such as deleting or inserting. The e4s.html.editing.Editing_DataDescriptor can be used, to define if any and which functions (@link e4s.html.MethodReflection) shall be involved on editing functionality. Those gives you the flexibility to use your own functions. If you use your own functions, the e4s.html.editing.AEP_EditingDataDescriptor_Intf will have no effect. Both, e4s.html.editing.AEP_EditingDataDescriptor_Intf and e4s.html.editing.Editing_DataDescriptor are optional. The e4s.html.editing.Editing_DataDescriptor defines more functionality, such as default values or main index fields - but never any layout issues.

The e4s.html.editing.EditingDefinition_DataField is more or less an internal used class, it is used to hold information about display (layouted) columns and database columns, including label definitions and visibility definitions. These values can be set using the environment at runtime, and they will be stored on the local file system using e4s.html.editing.EditingPersistance.

See related function modules in package e4s.application.sysmodule.editing for implementation details.


www.element4solution.com