BuildOptionCacheForJobComp

Update Competency Levels for Active Appraisals

Minor Business Rule

Object Name: N0800226

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description

Purpose

The purpose of this function is to build in cache the options for a particular job competency in a 

particular competency-based performance appraisal.  Building the options in cache provides quicker 

calculation of the job competency percent achieved when one of the employee competencies changes.


Setup Notes and Prerequisites

This function should not be called externally.  It is intended to be used by N0800226 - Update 

Competency Level In Active Appraisals

Special Logic




Technical Specification


Go through the gap analysis file (F0800609) for the job competency passed.  Calculate the job 

competency percent achieved for each option in the job competency.  Write the final percent achieved for each 

option to the cache.


Data Structure

D0800226A - Build The Option Cache For Job Competency

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICOPTNONE

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or 
location.

szJobCompetencyCodeJCCcharOPTNONE

A code that uniquely identifies each job competency. Competencies are high-level human attributes that help an employee achieve the 
goals and objectives of the company. These competencies are also the foundation of an employee's job and job description.

jdDateEffectiveRatesEFTJDEDATEOPTNONE

The date that identifies when a date is first valid. The effective date is used generically. It can be a lease effective date, a price or cost 
effective date, a currency effective date, a tax rate effective date, or whatever is appropriate.

szOrganizationTypeOTPScharOPTNONE

A user-defined code (00/TS) that identifies the type of organization structure, such as financial or responsibility. Each type of organization 
structure can have a separate hierarchy.  

szGapReasonGAPRcharOPTNONE

A user defined code (08/GN) indicating the reason that a Gap Snapshot is done. For example, a Gap Snapshot may be done at the end of 
every fiscal year (Gap Reason = "Fiscal Year End"). A Gap Snapshot may also be used when there is a major organizational change and 
management wants to make a snapshot (Gap Reason = "1999 Organizational Changes").

cTypeIncreaseNextRevwTINCcharOPTNONE

A user defined code (06/RV) that specifies the type of performance review to be completed for the next review period.

szCurrentOptionCacheNamePIDcharOPTNONE

The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry 
interactive program is P4210, and the number of the Print Invoices batch process report is R42565. The program ID is a variable length value. 
It is assigned according to a structured syntax in the form TSSXXX, where: T The first character of the number is alphabetic and identifies the 
type, such as P for Program, R for Report, and so on. For example, the value P in the number P4210 indicates that the object is a 
program. SS The second and third characters of the number are numeric and identify the system code. For example, the value 42 in the number P4210 
indicates that this program belongs to system 42, which is the Sales Order Processing system. XXX The remaining characters of the numer are 
numeric and identify a unique program or report. For example, the value 10 in the number P4210 indicates that this is the Sales Order Entry 
program.

szPerfOptionCacheNamePIDcharOPTNONE

The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry 
interactive program is P4210, and the number of the Print Invoices batch process report is R42565. The program ID is a variable length value. 
It is assigned according to a structured syntax in the form TSSXXX, where: T The first character of the number is alphabetic and identifies the 
type, such as P for Program, R for Report, and so on. For example, the value P in the number P4210 indicates that the object is a 
program. SS The second and third characters of the number are numeric and identify the system code. For example, the value 42 in the number P4210 
indicates that this program belongs to system 42, which is the Sales Order Processing system. XXX The remaining characters of the numer are 
numeric and identify a unique program or report. For example, the value 10 in the number P4210 indicates that this is the Sales Order Entry 
program.

szSelfOptionCacheNamePIDcharOPTNONE

The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry 
interactive program is P4210, and the number of the Print Invoices batch process report is R42565. The program ID is a variable length value. 
It is assigned according to a structured syntax in the form TSSXXX, where: T The first character of the number is alphabetic and identifies the 
type, such as P for Program, R for Report, and so on. For example, the value P in the number P4210 indicates that the object is a 
program. SS The second and third characters of the number are numeric and identify the system code. For example, the value 42 in the number P4210 
indicates that this program belongs to system 42, which is the Sales Order Processing system. XXX The remaining characters of the numer are 
numeric and identify a unique program or report. For example, the value 10 in the number P4210 indicates that this is the Sales Order Entry 
program.

szGapStatusGAPScharOPTNONE

A user defined code (08/GT) that indicates the status of the Gap Snapshot.

szEmpSelfAppraisalStatusESAScharOPTNONE

A user defined code that defines the employee self appraisal status.  Valid codes are:   1  Active 2  Complete When a new appraisal is 
created that requires an employee self appraisal to be completed, this flag is set to Active.  While the self appraisal is in the Active status, it can 
be changed by the employee and cannot be viewed by management. When the employee finishes the self appraisal and submits it, the 
status is changed to Complete.  While the self appraisal is in the Complete status, it cannot be changed by the employee and it can be viewed 
by management. Managers can return the self appraisal to the employee after it has been submitted, which returns the status flag back to 
Active.

Related Functions

None

Related Tables

None
UpdateCompetencyLevelInActiveApp

UpdateCompetencyLevelInActiveApp

Update Competency Levels for Active Appraisals

Minor Business Rule

Object Name: N0800226

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description

Purpose


The purpose of this function is to update the gap analysis for active performance appraisals when the 

employee competency is changed outside the performance management process.


Setup Notes and Prerequisites


Special Logic




Technical Specification


'b7Read through all open competency- based performance appraisals for this employee (where 
the Gap Status is less than 3)

'b7Look for the changed employee competency in the gap analysis for the performance 

appraisal.

'b7If the employee competency is in the gap analysis, update competency level and its 

description.

'b7Recalculate the highest option for the job competency based on the changed employee 

competency level.  If the job competency level has changed as a result, update it and the overall appraisal 

level as well.

'b7Continue cycling through the gap for other occurrences of this employee competency.

• If there are no other occurrences for this appraisal, fetch the next active competency-based 
performance appraisal and repeat the steps to calculate levels.

'b7'b7'b7'b7'b7

Data Structure

D0800226 - Update Competency Levels for Active Appraisals

Parameter NameData ItemData TypeReq/OptI/O/Both
mnAddressNumberAN8MATH_NUMERICREQINPUT

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or 
location.

szCompentencyTypeCMPEcharREQINPUT

A code that identifies a competency table or category for which you can track employee competencies. Valid values 
are: 01 Training 02 Skill 03 Accomplishment 04 Certification 05 Degree 06 Language  It is a user defined code (05/CY), but the values are hard-coded and cannot be 
changed. Therefore, each of the competencies that you track must pertain to one of these competency types. Adding additional values to this 
list requires system customizations.

szCompentencyCodeCMPCcharREQINPUT

A code that specifies a competency within a competency type. For example, a competency for the competency type "Skill" might be "C 
programming" or  "Driving a forklift."

mnCompetencyLevelCMPVMATH_NUMERICREQINPUT

A code that refers to the level of proficiency that a person or asset has demonstrated for a specific competency type and competency 
code.

szCurrentEmployeeCompetencCCMPDScharREQINPUT

A description that refers to the level of proficiency a person or asset currently demonstrates for a particular competency type or 
competency code.

cErrorCodeERRCcharOPTOUTPUT

This error code indicates if any errors occurred during the creation of the Trip Document Detail (F4914) records by the Delivery Document 
Set Server program (XT4914).

szProgramIdPIDcharOPTINPUT

The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry 
interactive program is P4210, and the number of the Print Invoices batch process report is R42565. The program ID is a variable length value. 
It is assigned according to a structured syntax in the form TSSXXX, where: T The first character of the number is alphabetic and identifies the 
type, such as P for Program, R for Report, and so on. For example, the value P in the number P4210 indicates that the object is a 
program. SS The second and third characters of the number are numeric and identify the system code. For example, the value 42 in the number P4210 
indicates that this program belongs to system 42, which is the Sales Order Processing system. XXX The remaining characters of the numer are 
numeric and identify a unique program or report. For example, the value 10 in the number P4210 indicates that this is the Sales Order Entry 
program.

Related Functions

None

Related Tables

None