IMEX.mes.wcf/WCF.Service/WCF.Contracts/IHRModule.cs

/*******************************************************************************
 * Copyright(c) 2014 DongkeSoft All rights reserved. / Confidential
 * 类的信息：
 *      1.程序名称：IHRModule.cs
 *      2.功能描述：人力资源模块服务契约
 * 编辑履历：
 *      作者            日期                版本            修改内容
 *      张国印          2014/09/04          1.00            新建
 *******************************************************************************/

using System;
using System.Collections.Generic;
using System.Data;
using System.ServiceModel;

using Dongke.IBOSS.PRD.WCF.DataModels;
using Dongke.IBOSS.PRD.WCF.DataModels.HRModule;

namespace Dongke.IBOSS.PRD.WCF.Contracts
{
    /// <summary>
    /// 人力资源模块服务契约
    /// </summary>
    [ServiceContract(ConfigurationName = "HRModuleService.IHRModule",
    Name = "IHRModule",
    Namespace = "Dongke.IBOSS.PRD.WCF.Contracts")]
    public interface IHRModule
    {
        #region 查询逻辑

        [OperationContract]
        string GetData();

        /// <summary>
        /// 员工当案一览
        /// </summary>
        /// <param name="pSearchStaff">员工档案实体类/param>
        /// <returns>DataSet</returns>
        [OperationContract]
        DataSet SearchHrStaff(SearchStaffEntity pSearchStaff);

        /// <summary>
        /// 是否存在相同的员工编码
        /// </summary>
        /// <param name="staffCode">员工编码</param>
        /// <returns>DataSet</returns>
        [OperationContract]
        DataSet IsExistsStaffCode(string staffCode);

        /// <summary>
        /// 获取员工行数据
        /// </summary>
        /// <param name="staffid">员工ID</param>
        /// <returns>DataSet</returns>
        [OperationContract]
        DataSet GetRowData(int staffid);

        /// <summary>
        /// 获取员工和员工履历信息
        /// </summary>
        /// <param name="staffEntity">员工实体类</param>
        /// <returns>DataSet</returns>
        [OperationContract]
        DataSet SearchHrStaffAndRecord(SearchStaffEntity staffEntity);

        /// <summary>
        /// 获取员工信息中审批信息
        /// </summary>
        /// <param name="staffEntity">员工实体类</param>
        /// <returns>DataSet</returns>
        [OperationContract]
        DataSet SearchHrStaffApprove(SearchStaffEntity staffEntity);

        /// <summary>
        /// 获取员工图片
        /// </summary>
        /// <param name="staffId">员工ID</param>
        /// <returns></returns>
        [OperationContract]
        DataSet GetImageByStaffId(int staffId);

        /// <summary>
        /// 获了员工履历行数据
        /// </summary>
        /// <param name="staffrecordid">员工履历ID</param>
        /// <returns>DataSet</returns>
        [OperationContract]
        DataSet GetStaffRecorsRowData(int staffrecordid);

        /// <summary>
        /// 根据工号查询员工档案信息
        /// </summary>
        /// <param name="userId">员工ID</param>
        /// <returns>DataSet</returns>
        /// <remarks>
        /// 作者                  日期                  内容
        /// 冯雪                  2014-9-23       新建
        /// </remarks>
        [OperationContract]
        DataSet SearchHrStaffInfo(int userId);

        /// <summary>
        /// 根据查询非工号下的员工档案信息
        /// </summary>
        /// <param name="searchStaffEntity">员工查询实体</param>
        /// <returns>DataSet</returns>
        [OperationContract]
        DataSet SearchStaffInfo(SearchStaffEntity searchStaffEntity);

        /// <summary>
        /// 根据传入的查询实体获取员工考勤表中的数据
        /// </summary>
        /// <param name="searchAttendanceEntity">查询实体</param>
        /// <returns>DataSet员工考勤数据集集合</returns>
        [OperationContract]
        DataSet SearcStaffAttendance(SearchAttendanceEntity searchAttendanceEntity);

        /// <summary>
        /// 获取员工员工考勤编辑信息
        /// </summary>
        /// <param name="searchAttendanceEntity">查询实体</param>
        /// <returns>DataSet员工考勤数据集集合</returns>
        [OperationContract]
        DataSet SearcStaffAttendanceForEdit(SearchAttendanceEntity searchAttendanceEntity);

        /// <summary>
        /// 将导入Excel中的数据转换为GridView显示的数据集
        /// </summary>
        /// <param name="pStaff">Excel中的数据员工集合</param>
        /// <returns>DataSet员工考勤信息表</returns>
        [OperationContract]
        DataSet GetStaffAttendanceInfoForExcel(DataTable pStaff);

        /// <summary>
        /// 根据传入的实体获取行政奖惩信息
        /// </summary>
        /// <param name="searchAdminRAPEntity">查询实体</param>
        /// <returns>DataSet行政奖惩信息表</returns>
        [OperationContract]
        DataSet SearcStaffAdminRAPInfo(SearchAdminRAPEntity searchAdminRAPEntity);

        /// <summary>
        /// 获取员工报餐信息
        /// </summary>
        /// <param name="searchDailyMealEntity">员工报餐查询实体</param>
        /// <returns>DataSet员工报餐信息表</returns>
        [OperationContract]
        DataSet SearcStaffDailyMealInfo(SearchDailyMealEntity searchDailyMealEntity);

        /// <summary>
        /// 获取员工报餐编辑信息
        /// </summary>
        /// <param name="searchDailyMealEntity">员工报餐查询实体</param>
        /// <returns>DataSet员工报餐信息表</returns>
        [OperationContract]
        DataSet SearcStaffDailyMealInfoForEdit(SearchDailyMealEntity searchDailyMealEntity);

        /// <summary>
        /// 将导入Excel中的数据转换为GridView显示的数据集
        /// </summary>
        /// <param name="pStaff">Excel中的数据员工集合</param>
        /// <returns>DataSet员工报餐信息表</returns>
        [OperationContract]
        DataSet GetStaffDailyMealInfoForExcel(DataTable pStaff, WCFConstant.FormMode pStatus);

        /// <summary>
        /// 获取管理者或组内员工的数据源
        /// </summary>
        /// <param name="searchStaffEntity">员工查询实体</param>
        /// <returns>DataSet</returns>
        [OperationContract]
        DataSet SearchManagersOrMembers(SearchStaffEntity searchStaffEntity);

        #endregion

        #region 业务逻辑

        /// <summary>
        /// 添加员工档案
        /// </summary>
        /// <param name="staffInfo">员工实体类</param>
        /// <param name="staffPhoto">员工图片集</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
		HRResultEntity AddStaffInfo(StaffEntity requestEntity, List<StaffPhotoEntity> staffPhoto);

		/// <summary>
		/// 导入员工档案
		/// </summary>
		/// <param name="staffInfo">员工档案</param>
		/// <returns>ServiceResultEntity</returns>
		[OperationContract]
		ServiceResultEntity ImportStaffInfo(DataTable staffInfo);

        /// <summary>
        /// 更新员工档案
        /// </summary>
        /// <param name="staffInfo">员工实体类</param>
        /// <param name="staffPhoto">员工图片集</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity EditStaffInfo(StaffEntity requestEntity, List<StaffPhotoEntity> staffPhoto);

        /// <summary>
        /// 设置禁用员工
        /// </summary>
        /// <param name="staffid">员工ID</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity SetValueFlag(int staffid);

        /// <summary>
        /// 添加员工履历
        /// </summary>
        /// <param name="staffrecord">员工履历实体类</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity AddStaffRecord(StaffRecordEntity staffrecord);

        /// <summary>
        /// 编辑员工履历
        /// </summary>
        /// <param name="staffrecord">员工履历实体类</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity EditStaffRecord(StaffRecordEntity staffrecord);

        /// <summary>
        /// 保存工种调整方法
        /// </summary>
        /// <param name="staffRecordEntity">员工履历实体类</param>
        /// <param name="editStatus">状态 1：新增 2：保存</param>
        /// <returns>0 没有数据被修改  -1存在待审批履历  -2员工履历被其他用户修改  -3员工档案被其他用户修改</returns>
        [OperationContract]
        HRResultEntity SaveTargetJobInfo(StaffRecordEntity staffRecordEntity, WCFConstant.FormMode editStatus);

        /// <summary>
        /// 保存员工离职履历信息
        /// </summary>
        /// <param name="pUserId">员工编号</param>
        /// <param name="pOPTimeStamp">员工档案表时间戳</param>
        /// <param name="pStaffRecord">员工履历表实体</param>
        /// <param name="pStatus">窗体是新增还是编辑</param>
        /// <returns>0 没有数据被修改  -1员工档案被其他用户修改  -2存在待审批履历  -3员工履历被其他用户修改</returns>
        [OperationContract]
        HRResultEntity SaveStaffRecordDimission(int pUserId, DateTime pOPTimeStamp, StaffRecordEntity pStaffRecord, WCFConstant.FormMode pStatus);

        /// <summary>
        /// 人事审批保存
        /// </summary>
        /// <param name="pUserId">员工编号</param>
        /// <param name="pOPTimeStamp">员工档案表时间戳</param>
        /// <param name="pStaffRecord">员工履历表实体</param>
        /// <param name="pState">审批状态 True 通过 False 不通过</param>
        /// <param name="pMemo">审批意见</param>
        /// <returns>0 没有数据被修改  -1员工档案被其他用户修改  -2存在待审批履历  -3员工履历被其他用户修改</returns>
        [OperationContract]
        HRResultEntity SaveHRDimissionApprovalInfo(int pUserId, DateTime pOPTimeStamp, StaffRecordEntity pStaffRecord, bool pState, string pMemo);

        /// <summary>
        /// 设置禁用员工履历
        /// </summary>
        /// <param name="staffrecordid">员工履历ID</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity SetStaffRecordValueFlag(int staffrecordid);

        /// <summary>
        /// 员工入职审批
        /// </summary>
        /// <param name="pUserId">员工编号</param>
        /// <param name="pOPTimeStamp">员工时间戳</param>
        /// <param name="pStaffRecord">员工履历表实体</param>
        /// <param name="pState">审批状态 True 通过 False 不通过</param>
        /// <param name="pMemo">审批意见</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity SaveHRStaffRecordApprovalInfo(int pUserId, DateTime pOPTimeStamp, StaffRecordEntity pStaffRecord, bool pState, string pMemo);

        /// <summary>
        /// 工种调整审批保存
        /// </summary>
        /// <param name="pUserId">员工编号</param>
        /// <param name="pOPTimeStamp">员工档案表时间戳</param>
        /// <param name="pStaffRecord">员工履历表实体</param>
        /// <param name="pState">审批状态 True 通过 False 不通过</param>
        /// <param name="pMemo">审批意见</param>
        /// <returns>0 没有数据被修改  -1员工档案被其他用户修改  -2存在待审批履历  -3员工履历被其他用户修改</returns>
        [OperationContract]
        HRResultEntity SaveHRStaffJobsApprovalInfo(int pUserId, DateTime pOPTimeStamp, StaffRecordEntity pStaffRecord, bool pState, string pMemo);

        /// <summary>
        /// 保存职务调整方法
        /// </summary>
        /// <param name="staffRecordEntity">员工履历实体类</param>
        /// <param name="sUserInfo">用户基本信息</param>
        /// <param name="editStatus">状态 1：新增 2：保存</param>
        /// <returns>0 没有数据被修改  -1存在待审批履历  -2员工履历被其他用户修改  -3员工档案被其他用户修改</returns>
        [OperationContract]
        HRResultEntity SaveTargetPostInfo(StaffRecordEntity staffRecordEntity, WCFConstant.FormMode editStatus);

        /// <summary>
        /// 职务调整审批保存
        /// </summary>
        /// <param name="pUserId">员工编号</param>
        /// <param name="pOPTimeStamp">员工档案表时间戳</param>
        /// <param name="pStaffRecord">员工履历表实体</param>
        /// <param name="pState">审批状态 True 通过 False 不通过</param>
        /// <param name="pMemo">审批意见</param>
        /// <returns>0 没有数据被修改  -1员工档案被其他用户修改  -2存在待审批履历  -3员工履历被其他用户修改</returns>
        [OperationContract]
        HRResultEntity SaveHRStaffPostApprovalInfo(int pUserId, DateTime pOPTimeStamp, StaffRecordEntity pStaffRecord, bool pState, string pMemo);

        /// <summary>
        /// 保存部门调整方法
        /// </summary>
        /// <param name="staffRecordEntity">员工履历实体类</param>
        /// <param name="editStatus">状态 1：新增 2：保存</param>
        /// <returns>0 没有数据被修改  -1存在待审批履历  -2员工履历被其他用户修改  -3员工档案被其他用户修改</returns>
        [OperationContract]
        HRResultEntity SaveTargetOrganizationInfo(StaffRecordEntity staffRecordEntity, WCFConstant.FormMode editStatus);

        /// <summary>
        /// 部门调整审批保存
        /// </summary>
        /// <param name="pUserId">员工编号</param>
        /// <param name="pOPTimeStamp">员工档案表时间戳</param>
        /// <param name="pStaffRecord">员工履历表实体</param>
        /// <param name="pState">审批状态 True 通过 False 不通过</param>
        /// <param name="pMemo">审批意见</param>
        /// <returns>0 没有数据被修改  -1员工档案被其他用户修改  -2存在待审批履历  -3员工履历被其他用户修改</returns>
        [OperationContract]
        HRResultEntity SaveHRStaffOrganizationApprovalInfo(int pUserId, DateTime pOPTimeStamp, StaffRecordEntity pStaffRecord, bool pState, string pMemo);

        /// <summary>
        /// 员工转正审批
        /// </summary>
        /// <param name="pUserId">员工编号</param>
        /// <param name="pOPTimeStamp">员工档案表的时间戳</param>
        /// <param name="pStaffRecord">员工履历表实体</param>
        /// <param name="pState">审批状态 True 通过  False 不通过</param>
        /// <param name="pMemo">审批原因</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity SaveHrStaffPositiveApprovalInfo(int pUserId, DateTime pOPTimeStamp, StaffRecordEntity pStaffRecord, bool pState, string pMemo);

        /// <summary>
        /// 根据DataTable中的考勤数据更新数据表
        /// </summary>
        /// <param name="pStaffAttendance">考勤数据表</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity SaveStaffAttendanceInfo(DataTable pStaffAttendance);

        /// <summary>
        /// 根据传入的实体保存 行政奖惩记录
        /// </summary>
        /// <param name="pAdminRAPEntity">行政奖惩实体</param>
        /// <param name="pStatus">新增还是编辑枚举</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity SaveStaffAdminRAPInfo(HRAdminRAPEntity pAdminRAPEntity, WCFConstant.FormMode pStatus);

        /// <summary>
        /// 行政奖惩审批
        /// </summary>
        /// <param name="pAdminRAPEntity">行政奖惩实体</param>
        /// <param name="pState">审批状态 True 通过  False 不通过</param>
        /// <param name="pMemo">审批原因</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity SaveStaffAdminRAPApprovalInfo(HRAdminRAPEntity pAdminRAPEntity, bool pState);

        /// <summary>
        /// 设置行政奖惩停用
        /// </summary>
        /// <param name="pRAPID">行政奖惩编号</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity SetStaffAdminRAPValueFlag(int pRAPID);

        /// <summary>
        /// 员工报餐保存
        /// </summary>
        /// <param name="pStaff">待保存的数据表</param>
        /// <param name="pStatus">窗口状态枚举</param>
        /// <returns>HRResultEntity</returns>
        [OperationContract]
        HRResultEntity SaveStaffDailyMealInfo(DataTable pStaff, WCFConstant.FormMode pStatus);

        #endregion

        #region 工资结算

        /// <summary>
        /// 根据结算时间获取各基础信息
        /// </summary>
        /// <param name="gsEntity">时间信息实体</param>
        /// <returns>基础信息数据集</returns>
        [OperationContract]
        DataSet GetSalaryData(GetSalaryEntity gsEntity);

        /// <summary>
        /// 工资结算记录一览
        /// </summary>
        /// <param name="gsEntity"></param>
        /// <returns></returns>
        [OperationContract]
        DataSet GetSettlementMain(GetSalaryEntity gsEntity);

        /// <summary>
        /// 工资结算汇总数据集
        /// </summary>
        /// <param name="MainId"></param>
        /// <returns></returns>
        [OperationContract]
        DataSet GetSettlementDetail(int MainId);

        /// <summary>
        /// 添加工资结算信息
        /// </summary>
        /// <param name="salaryEntity">总结算信息实体</param>
        /// <param name="dsStaffSalary">各明细结算信息数据集</param>
        /// <param name="dsProductionData">结算用生产数据</param>
        /// <param name="dsStaffAttendance">结算用考勤数据</param>
        /// <param name="userInfo">当前操作用户</param>
        /// <returns>结果值</returns>
        [OperationContract]
        int AddSalarySettlement(GetSalaryEntity salaryEntity, DataSet dsStaffSalary,
            DataSet dsBase);

        /// <summary>
        /// 根据员工工资ID以及员工ID，获取员工工资各明细数据集
        /// </summary>
        /// <param name="StaffSalaryID">员工工资ID</param>
        /// <param name="StaffID">员工ID</param>
        /// <returns>各明细集合</returns>
        [OperationContract]
        DataSet GetStaffSalaryDetail(int StaffSalaryID, int StaffID);

        /// <summary>
        /// 调整工资结算信息
        /// </summary>
        /// <param name="salaryEntity">调整工资总体信息</param>
        /// <param name="dtStaffSalary">各员工工资信息集合</param>
        /// <returns>影响行数</returns>
        [OperationContract]
        int EditSalarySettlement(GetSalaryEntity salaryEntity, DataTable dtStaffSalary);

        /// <summary>
        /// 审批工资结算信息
        /// </summary>
        /// <param name="dtStaffSalary">各员工工资信息集合</param>
        /// <returns>影响行数</returns>
        [OperationContract]
        int AuditSalarySettlement(DataTable dtStaffSalary);

        #endregion
    }
}