MAINTAIN FORM DEFINITIONS#
Forms are the user interface components that allow a user to view and/or maintain data stored in the system tables. The Maintain Form Definitions (IMFD) form is used to manage a form's functionality and details.
Functions provide the rules to access and process the data stored in the tables. Forms are the user interface to view/maintain the data.
Every form is associated with a function, however not every function has a form.
For example, the function ‘C2310_IMADD’ is better known as ‘Create Record’. There is no ‘Create Record’ form, only the action executed when the user selects the F6 function key or the green plus sign.
With the exception of the Menu tab, the data kept in IMFD is normally intended for internal use only.
Changes made to forms without the assistance of a consultant may not be supported.
It is recommended that wherever possible, object security (IMOS), translations (IMLA) and user defined columns be used to modify the appearance of functions, as these changes will not be affected by upgrades.
The definition data for the Maintain Form Definitions screen is stored in the P2K_AM_FUNCTIONS, P2K_AM_FORM_TABLE_USAGES, P2K_AM_FORM_GROUPS, P2K_AM_FORM_ITEMS, P2K_AM_EXECUTION_RIGHTS, P2K_AM_PREFERENCE_VALUES, P2K_AM_MENU_ITEMS and P2K_AM_FORM_DRILL_DOWNS tables.
At the top of the screen, you will see a list of the current forms within the application identified by the following fields:
- Function Name
- This field displays the function associated to form.
- Product
- This field displays the name of the product to which the function belongs.
- Description
- This field provides a short description of the function.
- Usage
- This field identifies whether the form table is pre-loaded or user defined.
Table Usages tab #
The Table Usages tab identifies where the form gathers its data.Data can come from one or more database tables or views. If there is more than one source, the way they are joined and their Where Clauses (or files) may also be defined here.
Where Clauses require familiarity with SQL and databases.- Seq#
- This field indicates the sequential order by which the tables are linked to the function.
- Data Source
- This field will hold the official name of the table.
- Table Alias
- This field provides the abbreviated table identifier.
- Parent Data Source
- If this table has a parent table, that parent table will be listed here.
- Join Clause
- This field indicates the clause that will join two or more tables or views.
- Where Clause
- This field is used to filter information being queried.
- For instance, for an employee driven form, this may indicate that only active employees should be called up.
- Table Usage
- This field identifies whether the form table is pre-loaded or user defined.
- Create/Retrieve/Update/Delete Allowed
- These toggles allow you to defined the privileges allowed for this form.
Form Layout tab #
This Form Layout tab defines the information displayed on the form and the visual details such as layouts, field labels and widths. The layout areas of a form, including the form itself, are referred to as Form Groups.- Seq #
- This field indicates the sequential order that the groups appear on the form.
- Form Group
- This field provides the official name of the group.
- Parent Group
- If the group is part of another group, that parent group will be listed here.
- Layout
- This field indicates the how the group will be presented.
- e.g. as text, table, box or tabs.
- Group Usage
- This field identifies whether the form group is pre-loaded or user defined.
- SS Rows Displayed
- For any layout types of ‘Table’, this field will indicate the numbers of rows to display.
- Title
- This field will show the title of the group which will appear on form.
- In our example of WECT
- The group ‘CONTACT’ has the title ‘Below is the list of contacts from your profile’
- The group ‘BOTTOM’ has the title ‘Contact Details’
- The group ‘CTYPE’ has the title ‘List Multiple Contact Types’
- Title (Lang)
- If your database uses a secondary language, this field allows you provide the title of the group in that language.
- e.g. If the title of the group is ‘Find’ this field may provide the Spanish translation, ‘Buscar’.
- Decoration
- This field is used to identify how the form is to be decorated, for example 'Line Border'.
- Width
- This is the default width (expressed in pixels) of the group when a user first opens the form.
- Height
- This is the default height (expressed in pixels) of the group when a user first opens the form.
- Max W
- This is the maximum width (expressed in pixels) of the group if the user stretches their screen.
- Max H
- This is the maximum height (expressed in pixels) of the group if the user stretches their screen.
- Seq #
- This field indicates the sequential order of the group item.
- Item Name
- This field holds the official name of the group item.
- Type
- This field allows you to categorize the group.
- Width
- This field indicates the width of the area for the group item. The size will default in from Personality, however you may change it.
- Height
- This field indicates the height of the area for the group item. The size will default in from Personality, however you may change it.
- If you change the default size or prompt of a group item and that item is repeated anywhere on the form, those changes will remain. You will not be able to edit the size or prompt of the second occurrence separately.
- LOV
- This field allows LOV’s to be associated with specific types of fields.
- Prompt
- This field shows the name that will appear on form for the item. This name will default in from Personality, however you may change it.
- If a prompt is not specified in IMFD, the 'Field Prompt' from the Column Detail field on IMCD will be displayed as the name of the group item on the form.
- There are screens where a displayed prompt is not necessary or desired. In this case, you will enter two quotation marks (" ") in the prompt field to get a blank title.
- Prompt (Lang)
- If the form is to be displayed in a second language, this field allows you to provide an alternate language name for the group item.
- Dftl Sort Order
- The Default Sort Direction field indicates how the data in the LOV is sorted.
- Format
- This field is used to define the date or numeric format.
- Item Usage
- This field indicates if the item is pre-loaded, user-defined or obsolete.
Function Info tab#
Each form has a function associated with it and when the application calls that function name, the form will appear on the computer screen. The Function Info tab is used to manage certain properties of the form related to its corresponding function.Function details should not be changed without the guidance of your consultant or support person. This form is normally intended for internal use only.
While you can modify function-related properties of a form through this tab, it should NOT be used to add new functions or delete existing ones. You must use the Maintain Functions (IMFN) form to add or delete a function.
For an in depth explanation of the Functions Info tab and its fields refer to Maintain Functions screen.
Menu Info / Drill Downs tab#
This tab allows you to attach the form to a specific menu. A form may be attached to more than one menu within the system.- Seq #
- The number in this field will determine the sequential order in which the functions will appear in the menu.
- Item
- This field displays the unique name of the menu.
- Menu
- This field is the unique abbreviation which identifies the individual menu.
- Type
- This field classifies the menu item into a specific type.
- For example: Call Function, Sub-menu
- Function
- If the menu item is a function, that function will be identified in this field.
- Submenu
- If the menu item calls another menu, identify that sub-menu in this field.
- A menu item may call either a Sub-Menu or a Call Function but not both.
- Action Type
- If the menu is used for a particular action, the action type is displayed here. For example, the HELP menu has an 'OpenWindows' action associated to it as when the Help icon is pressed, a help window is opened.
- Action Value
- The action called by the menu is listed here.
- Label
- This field will display the complete name of the menu item.
- Icon Name
- This field allows you to identify the icon which you would like to use. You need only enter the icon name in this field, not the path.
- e.g. address_ phone.gif
- The file name must be entered with the exact spelling and case as indicated in the icons folder.
- The application will look to the following path for the icon indicated.
- For example:
- D:\ORACLE\ias10g\Apache\Apache\htdocs\HLAppResources\release\images\icons
- Usage
- This field identifies whether the menu item is pre-loaded or user defined.
- A Pre-loaded usage means that the system created and controls the information and it will be overwritten with every update.
- A User-Defined usage means that the user created and controls the information and it will not be overwritten when you receive a software update.
Drill Downs #
- Item
- This field displays the unique name of the drill down.
- Function Name
- This field identifies the function associated with the drill down.
- Drill Down Usage
- This field indicates if the drill down is user-defined or system provided.
- Where Clause
- This field is used to filter information being queried.