[{TableOfContents }]

!!!DEFINE PREFERENCE TYPES

The Define Preference Types (IMPF) is used to define the supplied [preferences|PREFERENCE] to be used within the application.  [Preferences|PREFERENCE] are site wide items that control the manner that both the application is presented to the users. They provide some also control as to how the application will execute in various areas when run.

There are two types of [preferences|PREFERENCE]: global and field insert. Global [preferences|PREFERENCE] are defined here in IMPF and field insert [preferences|PREFERENCE] may be defined in [IMPRF]. 

The page [System Preference|SYSTEM PREFERENCE] provides a list of all available global [preferences|PREFERENCE]. 

The definition data for the Define Preference Types screen is stored in the [P2K_AM_PREFERENCES] and [P2K_AM_PREFERENCE_VALUES] tables.

\\

The user may select the preference to review from the find block described below:
 
;[Preference|PREFERENCE_CODE]: This field is used to uniquely identify the preference within the system.

;[Description|DESCRIPTION]: A short description of the preference may be provided in this field.

;[Category|PREFERENCE_CATEGORY]: This field is used to associate the preference to a specific category. 
\\  \\
----
!!Details tab 
 
;[Preference|PREFERENCE_CODE]: This field identifies the preference.
;[Description|DESCRIPTION]: This field provides a short description of the preference.
;[Data Type|DATA_TYPE]: This field indicates the data type of the field. (i.e. numeric, date, alphanumeric) 
;[Length|VALUE_LENGTH]: This field indicates the length of the field.
;[Category|PREFERENCE_CATEGORY]: This field associates the preference to a specific category. 

!Site
;[Applies to Site|APPLIES_TO_SITE]: If this toggle is checked, the preference is applied to the sites identified.
;[Sequence|SEQUENCE_SITE]: This field indicates the order in which the preference will be applied to the site.
;[Mandatory|MANDATORY_SITE]: If this toggle is checked, the preference is mandatory for the site.

!User  
;[Applies to User|APPLIES_TO_USER]: If this toggle is checked, the preference is applied to the users identified. 
;[Sequence|SEQUENCE_USER]: This field indicates the order in which the preference will be applied to the user. 
;[Mandatory|MANDATORY_USER]: If this toggle is checked, the preference is mandatory for the user.

!Function 
;[Applies to Function|APPLIES_TO_FUNCTION]: If this toggle is checked, the preference is applied to the functions identified.
;[Sequence|SEQUENCE_FUNCTION]: This field indicates the order in which the preference will be applied to the function.
;[Mandatory|MANDATORY_FUNCTION]: This toggle was used in previous versions of the application to indicate that a preference was mandatory. However, with the current version of the application this is no longer used. 

!Identity 
;[Applies to Identity|APPLIES_TO_IDENTITY]: If this toggle is checked, the preference is applied to the identities listed. 
;[Sequence|SEQUENCE_IDENTITY]: This field indicates the order in which the preference will be applied to the identity.
;[Mandatory|MANDATORY_ROLE]: This toggle was used in previous versions of the application to indicate that a preference was mandatory. However, with the current version of the application this is no longer used. 
!Role 
;[Applies to Role|APPLIES_TO_ROLE]:If this toggle is checked, the preference is applied to the roles identified.  
;[Sequence|SEQUENCE_ROLE]: This field indicates the order in which the preference will be applied to the role.
;[Mandatory|MANDATORY_ROLE]: This toggle was used in previous versions of the application to indicate that a preference was mandatory. However, with the current version of the application this is no longer used. 
!Candidate 
;[Applies to Candidate|APPLIES_TO_CANDIDATE]:If this toggle is checked, the preference is applied to the candidates identified.  
;[Sequence|SEQUENCE_CANDIDATE]: This field indicates the order in which the preference will be applied to the candidate. 
;[Mandatory|MANDATORY_CANDIDATE]: This toggle was used in previous versions of the application to indicate that a preference was mandatory. However, with the current version of the application this is no longer used. 

\\
\\
;[Format|VALUE_FORMAT]: This field was used to indicate the format required for the value. This field is no longer used by any of the current preferences.
;[Error Code|ERROR_CODE]: This field was used to indicate an error code to be used by the preference, however; this is no longer used by any of the current preferences. 
;[Usage|PREFERENCE_USAGE]: Usage indicates if the preference is pre-loaded, user-defined, etc.
\\  \\
----
!!Site tab 
;[Site|SITE_CODE]: The preference will be applied to the site indicated in this field.
;[Value|PREFERENCE_VALUE]: The preference value for the site will be displayed in this field.
\\ \\ 
----
!!Role tab
;[Role|ROLE_NAME]: The preference will be applied to the role indicated in this field.
;[Value|PREFERENCE_VALUE]: The preference value for the role will be displayed in this field.
\\ \\  
----
!! Function tab
;[Function|FUNCTION_NAME]: The preference will be applied to the function indicated in this field.
;[Value|PREFERENCE_VALUE]: The preference value for the site will be displayed in this field. 
\\ \\  
----
!!User tab
;[User|USER_NAME]: The preference will be applied to the user indicated in this field.
;[Value|PREFERENCE_VALUE]: The preference value for the user will be displayed in this field. 
\\ \\  
----
!!Identity tab
;[Person Code|PERSON_CODE]:The preference will be applied to the person indicated in this field.
;[From Date|FROM_DATE]\ [To Date|TO_DATE]:These fields identify the dates the preference will apply to the person.
;[Value|PREFERENCE_VALUE]:The preference value for the person will be displayed in this field. 
\\ \\ 
----
!!Candidate 
;[Candidate|CANDIDATE_CODE]: The preference will be applied to the candidate indicated in this field.
;[Value|PREFERENCE_VALUE]:The preference value for the candidate will be displayed in this field.