GENERIC EMPLOYEE INTERFACE#

The UEEF provides the capability to generate an interface file from the employee basic information such as Personals, Employments, prime Assignments, Entities, Locations, Jobs, Positions, Departments, Units, Groups etc and additional information for Benefit plans with Contacts information.

Required Set Up#

Step 1 - Define Lexicons in IMLN#

The following list of lexicons are provided and are used by the UEEF Employee Generic Interface.

Step 2 - Define Interface Format in IDIF Fixed File Format The following set up instructions for a Fixed File format using the interface HL$BE-ELIGTOTAL

The interface does not need to be manually entered in IDIF it is loaded through seed data during an install or upgrade.

You should use (Copy Definition) to copy into a different Interface code and then enter your own company data.

XML File Format The following instructions are for building an XML format for the UEEF using the format HL$BE-ELIG-XML.

Defining UserCalcs#

The file format for the UEEF can be defined to call a UserCalc function at each Record Number, each Field Number.

The Variable Name must equal 'UserCalc' and the UserCalc name must be specified in the Constant Value field.

The Field Type must be defined with Char, Number or Date, the UserCalc function on IMUC screen Return Value must match the values (Char, Number or Date) with the IMUC RET command to return the corresponding Char, Number or Date.

The data base tables available for UserCalc are:

  • at company level: DEN / DLN / DDP / DDD / DUN / DGR / DGD / DGV
  • at employee level: EID / EPS / EEM / EAS / EASD / PPRU / PPRC / ECT
  • for BE only: BPT / BPN / BCG / BCGD / BCGD / BCGR / BEND / BBR / ECT

Update Record Set Up#

During the UEEF run, you may update certain User Defined Fields (UDF) to indicate theInterface File has been generated and mark the records as being processed. You may reference these UDFs in IDIF to prevent the same information from being processed again.

On IDIF screen, Record Type '92-Update Record' should be defined at the end of the IDIF definition.

The Variable Name should contain the UDF (xxx) that is to be Updated or Inserted, e.g.'358043 - UDF (ECT) (35)'.

The Constant Value field should contain the Name of the UDF, e.g 'UEEF by BEN'. Please note that it will be up shifted.

If this UDF name does not exist on the IMUF screen, UEEF will create the UDF with this name on IMUF screen for the Data Base Table to be updated.

The Derivation Expression field should contain the expression that is evaluated to the value to be updated for the UDF.

The following Derivation Expression features can be used to derive the value to be updated:

  • multiple fields processing, DECODE, BYPASS, String manipulation,concatenation, function calls etc

When UEEF is run in non-trial mode, Record Type '92-Update Record' will be processed at the appropriate levels to check if the UDF should be updated for the associated Data Base tables.

From above example:

  • Rec#200 Field#10 indicates to update 'UDF (ECT)', this will be processed at the end of each qualified Contact
  • Rec#200 Field#15 indicates to update 'UDF (BPN)', this will be processed at the end of each qualified Benefit Plan
  • Rec#200 Field#20 indicates to update 'UDF (BEN)', this will be processed at the end of each qualified employee IBEN Benefit plan
  • Rec#200 Field#30 indicates to update 'UDF (BEND)', this will be processed at the end of each qualified employee IBEN Benefit plan
  • Rec#200 Field#40 indicates to update 'UDF (EPS)', this will be processed at the end of each qualified employee

Using the Returned Value of the Derivation Expression, UEEF finds if the UDF already exists.

If the UDF exists and the new value is different than the existed UDF value, it will be updated; if the UDF does not exist, it will be inserted.

List of UDF supported in UEEF from X_INF_VARIABLE_NAME are:

  • 358030 - UDF (EID) (35)
  • 358031 - UDF (EEM) (35)
  • 358032 - UDF (EASD) (35)
  • 358033 - UDF (EASD) (35)
  • 358034 - UDF (EPS) (35)
  • 358035 - UDF (DED) (35)
  • 358036 - UDF (DDD) (35)
  • 358037 - UDF (DLN) (35)
  • 358038 - UDF (DUD) (35)
  • 358039 - UDF (DGD) (35)
  • 358043- UDF (ECT) (35)
  • 358044- UDF (BEN) (35)
  • 358045- UDF (BEND) (35)

After UDFs are updated or inserted in UEEF, the Number of Records Updated for each Data Base Table will be displayed on the UEEF report.

Note that these Number of UDF Updated represents the number of times the tables are being touched, these may not necessarily be the exact number of UDF for that Table, e.g. UDF (EEM) may be touched 2 times if an employee has 2 Contacts to update the same EEM but with a different Value