[{TableOfContents }]

!!!MAINTAIN FUNCTIONS

Functions are those user interface components or features which provide the business functionality of the  product. As a result, they may be screen forms, processes, reports, utilities, menus, capabilities, tools, or procedures. 

The Maintain Functions (IMFN) form describes each function within the system as well as defaults that are used elsewhere.   

This screen allows you to control the individual functions within the application. All functions must have their execution rights defined for users or roles in order for those functions to be accessed. You can indicate whether a specific user or role may create, retrieve, update or delete data within a function.  

This screen also allows you to indicate the purpose of the function, attach HTML files and control other features such as print orientation and function type. 

There are two categories of functions: 
|Internal Function|The main purpose of an internal function is to allow you to create, view, edit and delete your company’s information within the application.   For example, all the individuals who will be using the application are maintained as a list of users through the Maintain Users ([IMUS]) screen.\\In addition, these internal functions allow you to customize some of the structure of the application to suit your company’s needs.  You can indicate how information will be presented and who will be able to access or edit this information. 
|External Function |External functions are links to either external web pages or to documents stored outside of the application.   For example, you may have a company policy that you would like to have accessible on the application.   You can create a new function which points the application to that document so that users may view it online. 
Through the IMFN screen, you will be able to modify the internal functions and also create and modify external functions. 

The function table data is system provided, although certain options may be tailored by the system administrator, and new custom functions (e.g. procedures) may be added.  Typically, there is no modification of provided functions and they should not be changed unless directed to do so by Support. 

Security is defined at the function level. A user must be granted execution rights to the function to be able to access it. 

!Functions in Self Service
There are several function types, however only three apply to Self Service:
* Screen
* External
* Manual

;Screen: This is a supplied function, which looks to a pre-loaded screen. e.g. [WEBEL] (Other Benefit Options in [ESS| MODULE-ESS]). You may only alter Screen functions in Self Service if the original function has been copied. This leaves the original function intact and allows you to make changes to the new version. 
%%information Please note that all copied functions will become your responsibility. Any and all changes could be lost during system upgrades as old functions may become obsolete due to technology changes in an upgrade. 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.%%
;External:External functions are links to either external web pages or to documents stored outside of the Self Service application. These functions will be placed on a menu and when accessed by a user, a separate window will open displaying the link. For example, you may have a company policy that you would like to have accessible through the Self Service application. You can create a new function which points the application to that document so that users may view it online.
;Manual:Manual functions are the same as external functions, however, when placed on a menu and accessed by a user, the link will open within the Self Service application.

The definition data for the Maintain Functions screen is stored in the [P2K_AM_FUNCTIONS], [P2K_AM_EXECUTION_RIGHTS], [P2K_AM_PREFERENCE_VALUES] and [P2K_CM_CHANGE_REASON_USAGES] tables

;[Product|PRODUCT_CODE]:This field identifies the product against which the function is applied.  Every function must belong to a product of one type or another. 
;[Function Name|FUNCTION_NAME]:This field displays the name of the function. This is the shortcut code that you can type in the Command window.  For system supplied functions, this should not be changed. Report-producing functions should start with R, U, L or X.
;[Description|DESCRIPTION]:This field provides a short description of the function and its role within the system. It also describes what the associated screen allows a user to do, for example, viewing or managing information in the screen. This field also controls the text that appears on the screen's heading (found at the upper left-hand corner of the screen).
;[Description (FRE)|DESCRIPTION_TRANSLATE]:This field provides the description in an secondary language. (On the example screen, the second language is identified as French -(FRE)’.)
;[Function Type|FUNCTION_TYPE]: This field identifies the function as a screen, menu, procedure etc.  
;[Usage|FUNCTION_USAGE]:The Usage field indicates where the function originates.  The function may be system supplied or user defined. 
;[Computer Language|COMPUTER_LANGUAGE]:Specifies the computer language in which the function has been developed. 
;[PA Type|PA_TYPE_CODE]:** THIS FIELD HAS BEEN REMOVED FROM THIS FORM AND MOVED TO THE [ISFPT] FORM (as of the 5.05 release).
;[Destination Format|DESTINATION_FORMAT]:This indicates the type of output to be generated, e.g PDF. 
;[Function Style |FUNCTION_STYLE]:This is used to indicate if the function is java orientated or a screen. 
;[Subject Table|TABLE_NAME]: This is sometimes used to identify the subject of the data used in the form. 
;[Find LOV|LOV_CODE]:If an LOV is used to display the data for find blocks, the LOV code is held here. 
;[Extends|FUNCTION_NAME]: If a function has been copied, the original function name will display here. 
;[PL/SQL Logic|PLSQL_BLOCK]: This may be used to indicate a PL/SQL program that must be called by the function.  In order to have the Application Server launch this function successfully, it must start with P2K_ or CV_ 
;[Web Address|WEB_ADDRESS]:If the function is to call up a web page or document on a server, the URL for that page or document will be provided in this field.
;[Implementation Name|IMPLEMENTATION_NAME]:This is be used for software purposes and should not be filled in by the user. 
;[Where Run |WHERE_RUN]:Determines that if function runs using Oracle or Windward, this is typically used for reports. 
;[Function Level|FUNCTION_LEVEL]:Describes the level of complexity of the function, from low to high. This may be used to restrict a function from being called by the Command Line in the application. This is often used for dialogs.  

;[Create Allowed|CREATE_ALLOWED]:This boolean gives general execution rights to create data within the function. If the boolean is “Yes”, individuals with a role that has been granted the same execution rights, may create data in this function.
;[Retrieve Allowed|RETRIEVE_ALLOWED]:This boolean gives general execution rights to retrieve data within the function. If the boolean is “Yes”, individuals with a role that has been granted the same execution rights, may retrieve data in this function.
;[Update Allowed |UPDATE_ALLOWED]:This boolean gives general execution rights to update data within the function. If the boolean is “Yes”, individuals with a role that has been granted the same execution rights, may update data in this function. 
;[Delete Allowed|DELETE_ALLOWED]:This boolean gives general execution rights to delete data within the function. If the boolean is “Yes”, individuals with a role that has been granted the same execution rights, may delete data in this function. 
;[Purpose|PURPOSE]:This field allows you to provide a description of the menu item (either function or sub-menu). 
;:If you are using the web menu instead of the web splash, the text you supply here will appear on the Menu as the description under Label. 
;:The purpose provided here will not be seen on the splash screen. 
;[Copy Function and Form|ACT_EXTEND_FORM]:This button will allow the user to copy the function and form in focus. This will create an exact copy that the user may edit.
\\  \\
----
!!Execution Rights tab 
This tab on Functions (IMFN) serves the same purpose as the Maintain Execution Rights ([IMER]) screen. If you associate a function to a role [IMER], that role will appear in the Execution Rights tab of IMFN and vice versa.

Pre-defined ‘Web Module’ Roles must not be granted execution rights; only the ‘Execution Type’ Roles that you create should be given execution rights.

Through either screen you can determine which roles have access to specific functions and what levels of C.R.U.D. they have
;[Role|ROLE_NAME] or [User|USER_NAME]:These fields allow you to chose the individual or role you wish to assign execution rights to. 
;[Create|CREATE_ALLOWED]:If both role and function execution rights are set to “Yes”, a user with this role may create data in this function.
;:If the boolean for either the Role Execution Rights or the Function Execution ‘Allowed’ Rights are “No”, then the user will not be able to create data in the function.
;[Retrieve|RETRIEVE_ALLOWED]:If both role and function execution rights are set to “Yes”, a user with this role may retrieve data in this function.
;:If the boolean for either the Role Execution Rights or the Function Execution ‘Allowed’ Rights are “No”, then the user will not be able to retrieve data in the function.
;[Update|UPDATE_ALLOWED]:If both role and function execution rights are set to “Yes”, a user with this role may update data in this function.
;:If the boolean for either the Role Execution Rights or the Function Execution ‘Allowed’ Rights are “No”, then the user will not be able to update data in the function.
;[Delete Allowed|DELETE_ALLOWED]:If both role and function execution rights are set to “Yes”, a user with this role may delete data in this function.
;:If the boolean for either the Role Execution Rights or the Function Execution ‘Allowed’ Rights are “No”, then the user will not be able to delete data in the function.

\\  \\
----
!!Preferences tab
The Preferences tab allows you to add features to the function, such as headers or footers. 
 
;[Preference|PREFERENCE_CODE]:If the function has any [preferences|SYSTEM PREFERENCE] associated with it, you may define those [preferences|SYSTEM PREFERENCE] in this field. There are a list of preferences in the drop down menu for you to select from. 
;[Priority|PREFERENCE_SEQUENCE]:This field allows you to define the order in which the preferences will appear. Although at this time none of the preferences would occur at the same time, preferences developed in the future, however, may need a sequential order. 
;[Value|PREFERENCE_VALUE]:You need to specify the details of the preference in this field. 
;:For example:
||Preference|| 	Value 
|FOOTER INFO| 	docs/WEECN_FOOTER.html 
|ALLOW FIND FOCUS| 	N 
|Add OPEN IN SAFEMODE |

\\  \\
----
!!Change Reasons tab 
!Function has these specific Change Reasons
This tab provides clients the ability to restrict the change reasons a function has access to.
;[Change Reason|CHANGE_CODE]:The reason the function has been modified is provided in this field. 
;[Description|DESCRIPTION]:This field full details about the change reason. 


----
![Notes|Edit:Internal.IMFN] 	
[{InsertPage page='Internal.IMFN' default='Click to create a new notes page'}]