using System; using System.Collections.Generic; namespace HRM.BO { #region EmpHistoricalData /// /// One uploaded historical career row, exactly as it came from the /// "Historical Career Data Upload" Excel sheet. This is a holding table of /// past career data; it is NOT the live career history (EmpLifeCycle) and /// nothing in payroll reads it, so rows can be deleted one by one. /// /// The lookup columns (Designation, Division, Grade, ...) are kept as the /// uploaded text instead of resolved IDs so that no row is ever rejected or /// silently changed because a name does not match a master record. /// EmployeeID is resolved from EmployeeNo on a best-effort basis only. /// public class EmpHistoricalData : BasicBaseObject { #region Constructor public EmpHistoricalData() { _employeeID = null; _employeeNo = ""; _name = ""; _effectDate = null; _eventType = ""; _designation = ""; _employeeType = ""; _division = ""; _department = ""; _section = ""; _subSection = ""; _grade = ""; _costCenter = ""; _location = ""; _subLocation = ""; _pfMember = ""; _basicSalary = null; _grossSalary = null; _payrollTypeID = null; } #endregion #region Properties #region EmployeeID : ID private int? _employeeID; public int? EmployeeID { get { return _employeeID; } set { _employeeID = value; } } #endregion #region EmployeeNo : string private string _employeeNo; public string EmployeeNo { get { return _employeeNo; } set { _employeeNo = value; } } #endregion #region Name : string private string _name; public string Name { get { return _name; } set { _name = value; } } #endregion #region EffectDate : DateTime private DateTime? _effectDate; public DateTime? EffectDate { get { return _effectDate; } set { _effectDate = value; } } #endregion #region EventType : string private string _eventType; public string EventType { get { return _eventType; } set { _eventType = value; } } #endregion #region Designation : string private string _designation; public string Designation { get { return _designation; } set { _designation = value; } } #endregion #region EmployeeType : string private string _employeeType; public string EmployeeType { get { return _employeeType; } set { _employeeType = value; } } #endregion #region Division : string private string _division; public string Division { get { return _division; } set { _division = value; } } #endregion #region Department : string private string _department; public string Department { get { return _department; } set { _department = value; } } #endregion #region Section : string private string _section; public string Section { get { return _section; } set { _section = value; } } #endregion #region SubSection : string private string _subSection; public string SubSection { get { return _subSection; } set { _subSection = value; } } #endregion #region Grade : string private string _grade; public string Grade { get { return _grade; } set { _grade = value; } } #endregion #region CostCenter : string private string _costCenter; public string CostCenter { get { return _costCenter; } set { _costCenter = value; } } #endregion #region Location : string private string _location; public string Location { get { return _location; } set { _location = value; } } #endregion #region SubLocation : string private string _subLocation; public string SubLocation { get { return _subLocation; } set { _subLocation = value; } } #endregion #region PFMember : string private string _pfMember; public string PFMember { get { return _pfMember; } set { _pfMember = value; } } #endregion #region BasicSalary : double private double? _basicSalary; public double? BasicSalary { get { return _basicSalary; } set { _basicSalary = value; } } #endregion #region GrossSalary : double private double? _grossSalary; public double? GrossSalary { get { return _grossSalary; } set { _grossSalary = value; } } #endregion #region PayrollTypeID : ID private int? _payrollTypeID; public int? PayrollTypeID { get { return _payrollTypeID; } set { _payrollTypeID = value; } } #endregion #endregion } #endregion #region EmpHistoricalData column setup (read from the Logic configuration) /// /// One configured department or location tier: its position, the caption the /// sheet must use, and whether the screen marks it mandatory. Read from the /// Logic configuration (department/tiernames, location/tiernames), the same /// source getBasicInfoColumns uses for the System Opening Data upload. /// public class EmpHistoricalDataTier { /// 1-based tier position, which also picks the EmpHistoricalData slot. public int Tier { get; set; } /// Configured caption, e.g. "Division" or "sub-Section". public string Name { get; set; } public bool IsMandatory { get; set; } } /// /// The department/location tiers the sheet must carry. EmpHistoricalData keeps a /// fixed slot per tier (Division/Department/Section/SubSection and /// Location/SubLocation), so a configuration with more tiers than there are /// slots is reported through TierOverflowMessage rather than silently truncated. /// public class EmpHistoricalDataColumnSetup { /// Department slots on EmpHistoricalData: Division, Department, Section, SubSection. public const int MaxDepartmentTier = 4; /// Location slots on EmpHistoricalData: Location, SubLocation. public const int MaxLocationTier = 2; public EmpHistoricalDataColumnSetup() { DepartmentTiers = new List(); LocationTiers = new List(); TierOverflowMessage = string.Empty; } public List DepartmentTiers { get; set; } public List LocationTiers { get; set; } /// When false the sheet carries a Code column per tier as well as a Name column. public bool IsDepartmentCodeAutoGenerated { get; set; } public bool IsLocationCodeAutoGenerated { get; set; } /// /// Empty when every configured tier has a slot. Otherwise it names the tiers /// that cannot be carried, so the screen can say so instead of dropping them. /// public string TierOverflowMessage { get; set; } } #endregion #region IEmpHistoricalData Service public interface IEmpHistoricalDataService { EmpHistoricalDataColumnSetup GetColumnSetup(); List Get(int payrollTypeID); EmpHistoricalData Get(int id, int payrollTypeID); /// /// Saves every row and hands back the tier combinations that do not match an /// existing Department or Location. The rows are still saved - the list is /// information, because a historical department or location may legitimately /// no longer exist in the master data. /// List Save(List items, int payrollTypeID, int userID); void Delete(int id, int payrollTypeID); } #endregion }