@cityssm/worktech-api/queries/employees/getEmployeePayCodes.js

Integrations with the WorkTech (Pearl) work order management system.

import NodeCache from '@cacheable/node-cache';
import { connect } from '@cityssm/mssql-multi-pool';
import { cacheTimeToLiveSeconds } from '../../apiConfig.js';
const cache = new NodeCache({
    stdTTL: cacheTimeToLiveSeconds
});
/**
 * Retrieves employee pay codes.
 * @param mssqlConfig - SQL Server configuration.
 * @param employeeNumber - The employee number.
 * @param effectiveDate - The effective date.
 * @returns The employee pay codes.
 */
export async function getEmployeePayCodes(mssqlConfig, employeeNumber, effectiveDate) {
    const cacheKey = `employeePayCodes-${employeeNumber}-${effectiveDate?.toISOString() ?? 'all'}`;
    let employeePayCodes = cache.get(cacheKey);
    if (employeePayCodes !== undefined) {
        return employeePayCodes;
    }
    const pool = await connect(mssqlConfig);
    let query = /* sql */ `
    SELECT
      Item_ID AS employeeNumber,
      rtrim(epc.EPCode) AS payCode,
      isnull(pc.level, epc.level) AS level,
      rtrim(epc.POS_ID) AS positionId,
      p.[Desc] AS position,
      isnull(pc.effectiveDateTime, epc.effectiveDate) AS effectiveDate,
      cast([Primary] AS BIT) AS isPrimary
    FROM
      WMEPCI epc
    WITH
      (NOLOCK)
      LEFT JOIN WMEPD pc
    WITH
      (NOLOCK) ON epc.EPCode = pc.EPCode
      AND (
        pc.EffectiveDateTime IS NULL
        OR pc.EffectiveDateTime >= epc.EffectiveDate
      )
      AND pc.NotUsedForOverride = 0
      LEFT JOIN WMPOD p
    WITH
      (NOLOCK) ON epc.POS_ID = p.POS_ID
      AND p.Status <> 1
      AND (
        p.EndDateTime IS NULL
        OR p.EndDateTime >= epc.EffectiveDate
      )
    WHERE
      epc.Item_ID = @employeeNumber
  `;
    if (effectiveDate !== undefined) {
        query += ' AND epc.effectiveDate <= @effectiveDate';
    }
    query += ' ORDER BY isPrimary DESC, effectiveDate DESC';
    const result = (await pool
        .request()
        .input('employeeNumber', employeeNumber)
        .input('effectiveDate', effectiveDate)
        .query(query));
    employeePayCodes = result.recordset;
    cache.set(cacheKey, employeePayCodes);
    return employeePayCodes;
}