This page (revision-21) was last changed on 26-Nov-2021 10:22 by rmorrell

This page was created on 26-Nov-2021 10:22 by Administrator

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version Date Modified Size Author Changes ... Change note
21 26-Nov-2021 10:22 6 KB rmorrell to previous

Page References

Incoming links Outgoing links
NAMING CONVENTION AND STANDARDS
NAMING CONVENTION AND STANDARDS

Version management

Difference between version and

At line 3 removed one line
The intention of this document is to help people understand the discipline used for coming up with function names, etc. as well as show changes or new items.
At line 8 changed 3 lines
The table name is assembled by the prefix (P2K_), the module abbreviation (CM_) and then the entity name in plural (DEPARTMENTS) thus: P2K_CM_DEPARTMENTS.
If the entity name has multiple words then these are separated by underscores (i.e. P2K_PR_PAY_LINE_DETAILS)
If the plural of the entity name is an irregular ending, then the correct pluralization applies (i.e. P2K_HR_IDENTITIES from the IDENTITY entity)
The table name is assembled by the prefix (P2K_), the module abbreviation (CM_) and then the entity name in plural (DEPARTMENTS) thus: [P2K_CM_DEPARTMENTS].
If the entity name has multiple words then these are separated by underscores (i.e. [P2K_PR_PAY_LINE_DETAILS])
If the plural of the entity name is an irregular ending, then the correct pluralization applies (i.e. [P2K_HR_IDENTITIES] from the IDENTITY entity)
At line 13 changed one line
View names are similarly constructed to table names but it is differentiated as a view by the inclusion of a letter "V" at the beginning of the third section. For example, P2K_HR_EMPLOYMENTS is a table name, P2K_HR_VEMPLOYMENTS is a view that references this table and P2K_HR_IDENTITIES together.
View names are similarly constructed to table names but it is differentiated as a view by the inclusion of a letter "V" at the beginning of the third section. For example, [P2K_HR_EMPLOYMENTS] is a table name, [P2K_HR_VEMPLOYMENTS] is a view that references this table and [P2K_HR_IDENTITIES] together.
At line 15 changed one line
!!Function Names
!!Function Names (IMFN)
The standard naming convention is for functions to start with a single character that dictates what type of function it is – see chart below.
At line 17 changed 15 lines
1. First character indicates the type of function
* "C" - Copy screen e.g. [CBCG]
* "D" - Date (Calendar) controlled screen eg [DAAL]
* "E" - Embedded screen e.g. [EALR]
* "F" - Find screen e.g. [FIND_MGREAS]
* "I" - Interactive screen e.g. [IEAS]
* "L" - Load program e.g. [LMTD]
* "M" - Dialog screen e.g. [MAAL]
* "P" - PA screen e.g. [PEAS]
* "R" - Report program (does not normally update data) e.g. [RDEN]
* "U" - Update program (usually produces a report as well) e.g. [UPCALC]
* "V" - View only screen e.g. [VEEP]
* "X" - Extract program e.g. [XMFN]
2. Second letter indicates the module that this function belongs to (.e.g M = Ad[m|]inistration P = [P|]ayroll etc.)\\
3. The rest of the letters are a useful mnemonic of what the function is intended to do. For interactive screens, it is often the [table alias|Table_Alias] of the table primarily maintained (e.g. IEID is an [I|]nteractive screen that maintains the [EID|] table, UPCALC is an [U|]pdate process for [P|]ayroll [CALC|]ulation)
In the professional interface the first character indicates the type of function and what it is used for.
At line 20 added 24 lines
%%information There are some exceptions to the rules when there are one off items but the majority conform to this standard.%%
Screens
||Character||Type of Function
|C|Copy screen e.g. [CBCG]
|D|Date (Calendar) controlled screen eg [DAAL]
|E|Embedded screen e.g. [EALR]
|F|Find screen e.g. [FIND_MGREAS]
|I|Interactive screen e.g. [IEAS]
|M|Dialog screen e.g. [MMRE]
|P|PA screen e.g. [PEAS]
|V|View only screen e.g. [VEEP]
Reports
||Character||Type of Function
|L|Load program e.g. [LMTD]
|R|Report program (does not normally update data) e.g. [RDEN]
|U|Update program (usually produces a report as well) e.g. [UPCALC]
|X|Extract program e.g. [XMFN]
The second letter indicates the module that this function belongs to (.e.g M = Ad(m)inistration P = (P)ayroll etc.)\\
The rest of the letters are a useful mnemonic of what the function is intended to do. For interactive screens, it is often the [table alias|Table_Alias] of the table primarily maintained (e.g. [IEID] is an (I)nteractive screen that maintains the (EID) table, UPCALC is an (U)pdate process for (P)ayroll (CALC)ulation)
At line 35 changed 12 lines
1. First character (W) indicates the function is a Self Service function. \\
2. The second letter indicates the type of Self Service role that would make use of the function.\\
*"WA" - Administrator, and/or Web Site Administrator and/or Human Resource Administrator
*"WC" - Candidate role
*"WE" - Employee role
*"WG" - General e.g [WGDPC] (View Employees By Position)
*"WM" - Manager role
*"WP" - Public e.g [WPRPO] (potential candidate could search for open postings through a link on a client's website)
*"WR" - Recruiter role
*"WS" - Scheduler role
*"WV" - Approver role
3. The third letter references the product the function is found within, for example the 'B' in WEBEN indicates WEBEN is tied to the Benefits module. The rest of the letters are a useful mnemonic of what the function is intended for, for example the 'EN' in WEBEN indicates WEBEN is for enrollments.
In Self Service, the function type character is always ‘W’ for web component.
The second character indicates the type of Self Service role that would make use of the function.\\
|WA|Administrator, and/or Web Site Administrator and/or Human Resource Administrator
|WC|Candidate role
|WE|Employee role
|WG|General e.g [WGDPC] (View Employees By Position)
|WM|Manager role
|WP| Public e.g [WPRPO] (potential candidate could search for open postings through a link on a client's website)
|WR|Recruiter role
|WS|Scheduler role
|WV|Approver role
The third letter references the product the function is found within, for example the 'B' in [WEBEN] indicates [WEBEN] is tied to the Benefits module. The rest of the letters are a useful mnemonic of what the function is intended for, for example the 'EN' in [WEBEN] indicates [WEBEN] is for enrollments.
At line 50 changed 2 lines
Product Modules
!!Product Modules
At line 53 removed one line
Note that technical product modules may vary from license product modules (or business groupings) as they are different views of the world.
At line 55 changed 16 lines
Product Module 2 Char Code 1 Char Code
System Configuration AM M
Attendance Control AT A
Benefits Administration BE B
Common Definitions CM D
Training and Development (TD) CP C
Conversion CV V
Forecasting and Costing FC F
Human Resources HR E
Labor Relations LR L
Payroll PR P
Recruitment RE R
Pension System RX X
Salary Administration SA S
Safety and Health SH H
Time Scheduling TS T
%%information The technical product modules may vary from license product modules (or business groupings) as they are different views of the world.%%
||Product Module||2 Char Code||1 Char Code
|System Configuration| AM| M
|Attendance Control| AT| A
|Benefits Administration| BE| B
|Common Definitions| CM| D
|Training and Development (TD) |CP| C
|Conversion| CV| V
|Forecasting and Costing| FC| F
|Human Resources| HR| E
|Labor Relations| LR| L
|Payroll| PR| P
|Recruitment| RE| R
|Pension System |RX| X
|Salary Administration| SA| S
|Safety and Health| SH| H
|Time Scheduling| TS| T
At line 72 changed one line
Business Roles
!!Business Roles
At line 90 added one line
At line 92 added one line
At line 76 changed 20 lines
Character For Business Role Assigned How
A HR Administrator WWW_HRADMIN Manually
C Candidates WWW_CANDIDATE Manually – 1 user only
E Employees WWW_EMPLOYEE Manually
G General Use N/A
M Managers WWW_MANAGER Manually
P Publicly Available WWW_PUBLIC Manually – 1 user only
R Recruiters WWW_RECRUITER Automatically
S Schedulers WWW_SCHEDULER Automatically
V Approvers N/A
Function Naming Convention (IMFN)
Structure
The standard naming convention is for functions to start with a single character that dictates what type of function it is – see chart below.
Professional
In the professional interface the next 3 or 4 characters (sometimes more) are normally taken as an abbreviation of what the function does or from the alias of the table that drives the function.
Self Service
In self service though the function type character is always ‘W’ for web component. The second character here comes from the section above on Business Roles to dictate where or by whom this function is used.
The remaining characters are similar in nature to that of the professional interface.
Function Types
Supplied functions normally start with one of the characters shown in the chart below which designates what that function is used for. Note that there are some exceptions to the rules when there are one off items but the majority conform to this standard.
||Character||For||Business Role||Assigned How
|A|HR Administrator|[WWW_HRADMIN]|Manually
|C|Candidates|[WWW_CANDIDATE]|Manually – 1 user only
|E|Employees|[WWW_EMPLOYEE]|Manually
|G|General Use| N/A |
|M|Managers|[WWW_MANAGER]|Manually
|P|Publicly Available|[WWW_PUBLIC]|Manually – 1 user only
|R|Recruiters|[WWW_RECRUITER]|Automatically
|S|Schedulers|[WWW_SCHEDULER]|Automatically
|V|Approvers|N/A|
At line 97 changed 17 lines
Type Character Meaning
Screens
* C For deep Copying records
* D Date/Calendar driven screens
I Normal Interactive screens
* M Pop up Dialog screens
* P Personnel Action (PA) based screens
V View only screens
W Self Service designated function
Reports
+ L Load Processes
R Non-Update Reports
U Update Processes
+ X Extract Processes
* - New or meaning change for ePersonality
+ - New or meaning change with Windward Reports project.
Oracle Reports versus Windward
!!Oracle Reports versus Windward
At line 122 removed 2 lines
[{If var='loginstatus' contains 'authenticated'
At line 125 changed 4 lines
![Discussion|Edit:Internal.NAMING+CONVENTION]
[{InsertPage page='Internal.NAMING+CONVENTION' default='Click to create a new discussion page'}]
}]
![Notes|Edit:Internal.NAMING+CONVENTION]
[{InsertPage page='Internal.NAMING+CONVENTION' default='Click to create a new notes page'}]
This page (revision-21) was last changed on 26-Nov-2021 10:22 by rmorrellTop