UpdateEmployeeCompetencyInCache

Update Employee Competency In Performance Appraisal Cache

Minor Business Rule

Object Name: N0800223

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description

Purpose

The purpose of this function is to update an employee competency level everywhere it appears in the 
Gap Analysis Cache.  This will also update the Job Competency levels in the cache as well as 

recalculate the Overall level, which may change as a result of the change to the employee competency level.


Setup Notes and Prerequisites


Special Logic




Technical Specification



Go through the cache to find all instances of the employee competency that is

being changed.


When the employee competency is found in the current Job Competency, incriment the Count of Employee 

Competencies updated for the current Job Competency.


Calculate the percentage achieved for each cache record of the employee competency found


Update the employee competency record with the new level, level description, and percent achieved.



To Calculate for the Option:

Get the option with highest percent for this job competency before the new employee competency level. 

 The highest option percent determines the Job Competency Code Percentage Achieved.  When the new 

option percent is calculated, if it changes the highest option percent, then the Job Competency needs to 

be updated with the new highest Option Percent.


Update the Job Competency record in the cache with the new highest percent, new level, and new level 

description.  Incriment the number of Job Comps with changed levels


Calculate for the Overall Apraisal Rating

Calculate the new Percent Achieved for the overall appraisal


Continue fetching the next record with this employee competency code



Data Structure

D0800223 - Update Employee Competency In Performance Appraisal Cache

Parameter NameData ItemData TypeReq/OptI/O/Both
mnJobNumberGapAnalysisCacheJOBSMATH_NUMERICREQINPUT

Job Number Gap Analysis Cache - The unique number identifying records in the 
B0800213 Gap Analysis Cache.  Get this number using either the Get Internal Next 

Number or X0010 business functions.

szGapAnalysisCacheNamePIDcharREQINPUT

Gap Analysis Cache Name - Get this value by converting the Job Number Gap 
Analysis Cache number into a string.

szOptionCacheNamePIDcharREQINPUT

Option Cache Name - The unique string identifying the B0800222 cache.  Usually 
this is determined by getting a number from either the X0010 or Get Internal Next 

Number business functions, and converting the result into a string.

szCompentencyTypeCMPEcharREQINPUT

Competency Type - The competency type where the level is being updated.

szCompentencyCodeCMPCcharREQINPUT

Competency Code - The competency code where the level is being updated.

mnChangedCompetencyLevelCMPVMATH_NUMERICREQINPUT

Changed Competency Level- The new competency level.

szChangedCompLevelDescCCMPDScharREQINPUT

Changed Competency Level Description - The new competency level description.

mnOverallLevelCMPVMATH_NUMERICOPTBOTH

Overall Level - The overall performance appraisal level.  This new level will be 
returned once the competency type/code level is updated in the cache.

szOverallLevelDescriptionCCMPDScharOPTBOTH

Overall Level Description - The overall performance appraisal level description.  
This new description will be returned once the competency type/code level is 

updated in the cache.

mnOverallPercentAchievedJCPCTRQDMATH_NUMERICREQBOTH

Overall Percent Achieved - The overall percent achieved (the overall level 
divided by the overall required level).  This new percent will be returned once the 

competency type/code level is updated in the cache.

mnOverallRequiredLevelREQLMATH_NUMERICOPTINPUT

Overall Required Level - The required level for the appraisal.

szOverallScaleSCLEcharOPTINPUT

Overall Scale - The scale used to edit the overall level.

cErrorCodeERRCcharOPTOUTPUT

Error Code - Not used at this time.

szCurrentJobCompetencyCodeJCCcharOPTINPUT

Current Job Competency Code - The job competency code where the employee 
competency level is being updated.  This is so that the function can return the number of 

times the employee competency is in the current job competency.  This information 

can then be used to determine how to update the user interface.

mnNumTimesEmpCompInCurJCCMATH01MATH_NUMERICOPTOUTPUT

Num Times Emp Comp In Current JCC - Returns the number of times the updated 
employee competency is attached to different options under this job competency.

mnCountJCCLevelsChangedMATH01MATH_NUMERICOPTOUTPUT

Count JCC Levels Changed - Returns the number of job competency levels that 
changed as a result of this employee competency changing.

Related Functions

None

Related Tables

None