Employee (Bropen Framework 4.8.1 API)

bropen.framework.core.osm.Employee

All Implemented Interfaces and Traits:

DomainTrait, Comparable, java.io.Serializable
```
class Employee
extends Object
```
员工

Field Summary

Fields
Modifiers	Name	Description
`static String`	`GENDER_FEMALE`
`static String`	`GENDER_MALE`
`static Byte`	`TYPE_FORMAL`
`static Byte`	`TYPE_LIMITED`
`static Byte`	`TYPE_SECONDED`
`static Byte`	`TYPE_TRIAL`

Properties Summary

Properties
Type	Name and description
`Date`	`birthdate` 出生日期
`String`	`code` 工号
`static Object`	`constraints`
`String`	`createdBy`
`Date`	`dateCreated` 时间戳...
`String`	`degree` 学历
`String`	`dingtalkId` 钉钉客户端用户 ID
`Boolean`	`disabled` 是否禁用（含逻辑删除）
`String`	`email` 邮箱
`Date`	`entryDate` 入职日期
`String`	`ext1` 扩展属性
`String`	`ext2`
`String`	`gender` 性别
`Date`	`graduateDate` 毕业时间
`String`	`graduateSchool` 毕业院校
`Set<Group>`	`groups` 所属群组
`static Object`	`hasMany`
`String`	`idNumber` 证件号（身份证号）
`String`	`idType` 证件类型
`Set<EmployeeIdentity>`	`identities` 包含身份
`Date`	`lastUpdated`
`BigDecimal`	`level` 主职级别 - 冗余
`static Map`	`listFields`
`String`	`location` 员工属地（工作地）
`Long`	`mainIdentityId` 主职身份 ID - 冗余
`String`	`major` 专业
`static Object`	`mapping`
`String`	`mobile` 手机号码
`String`	`name` 名称
`String`	`nation` 民族
`String`	`nativePlace` 籍贯
`String`	`notes` 描述
`Organization`	`organization` 所属主职机构 - 冗余
`String`	`payrollPlace` 发薪地
`String`	`professionalTitle` 职称
`String`	`qualification` 资质
`String`	`rank` 职级
`String`	`religion` 政治面貌
`Integer`	`sequence` 所属主职机构中的排序号 - 冗余
`String`	`syncId` 同步ID
`String`	`syncSequence` 同步序号
`String`	`telephone` 电话号码
`String`	`title` 头衔/岗位
`static Object`	`transients`
`Byte`	`type` 员工性质
`String`	`updatedBy`
`User`	`user` 关联用户
`String`	`wechatId` 微信客户端用户的 openid
`Date`	`workingDate` 参加工作日期
`BigDecimal`	`workingYears` 工龄基数：入职前的工龄，可以精确到2位数

Methods Summary

Methods
Type	Name and description
`static Float`	`annualLeaveDays(Employee emp, Date untilDate)` 根据员工的开始工作日期、工龄基数、入职日期，计算法定年假数，结果四舍五入到整数。
`static Float`	`annualLeaveDays(Employee emp, Integer untilYear)`
`static Float`	`annualLeaveDays(Date workingDate, BigDecimal workingYears, Date entryDate, Integer untilYear)`
`static Float`	`annualLeaveDays(Date workingDate, BigDecimal workingYears, Date entryDate, Date untilDate)`
`static List`	`availableList(Map options = null)` 可用的员工列表
`Object`	`beforeValidate()`
`int`	`compareTo(Object obj)`
`static List<Employee>`	`findAllByGroup(Object group, Object organization = null)` 根据群组获得员工列表
`static List<Employee>`	`findAllByGroupName(Object groupName, Object organization = null)` 根据群组名称获得员工列表
`static List<Employee>`	`findAllByPosition(Object position, Object organization = null, Map organizationOptions = null)` 根据岗位获得员工列表
`static List<Employee>`	`findAllByPositionName(Object positionName, Object organization = null, Map organizationOptions = null)` 根据岗位名称获得员工列表
`static List<Employee>`	`findAllByRole(Object role, Object domainOrApplication = null)` 根据角色获得员工列表：仅限直接关联的
`static List<Employee>`	`findAllByUsernameInList(List<String> usernames)` 根据用户登录名列表获得员工列表
`static Employee`	`findByUserId(Long userId)` 根据用户 ID 获得员工
`static Employee`	`findByUsername(String username)` 根据用户登录名获得员工
`static List<Employee>`	`getAllKeepOrder(List ids)` 根据ID获得员工列表，并保持ID的顺序
`static List<Employee>`	`getAllKeepOrderByUserIds(List userIds)` 根据用户ID获得员工列表，并保持ID的顺序
`String`	`getDisplayIdType()` 获取证件类型显示值
`static String`	`getDisplayIdType(String idType)` 获取证件类型显示值
`String`	`getDisplayNation()` 获取民族显示值
`static String`	`getDisplayNation(String nation)` 获取民族显示值
`String`	`getDisplayReligion()` 获取政治面貌显示值
`static String`	`getDisplayReligion(String religion)` 获取政治面貌显示值
`static List<Map>`	`getIdTypes()` 获取证件类型数据字典
`EmployeeIdentity`	`getMainIdentity()` 主职身份
`String`	`getNameAndMail()` 名称 + 邮件
`static List<Map>`	`getNations()` 获取民族数据字典
`String`	`getOrgAndName()` 主职机构全名 + 名称
`static List<Map>`	`getReligions()` 获取政治面貌数据字典
`String`	`getUserAndName()` 登录名 + 名称
`List<EmployeeIdentity>`	`identities()` 未被禁用的员工身份列表
`EmployeeIdentity`	`identity(Object organization, boolean defaultMain)` 根据所属机构计算员工身份
`Boolean`	`isDeleted()` 是否被逻辑删除
`Number`	`level(Integer levelType = null)` 员工主职身份的最高级别
`String`	`toString()`

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class Object`	`Object#wait(long, int), Object#wait(long), Object#wait(), Object#equals(Object), Object#toString(), Object#hashCode(), Object#getClass(), Object#notify(), Object#notifyAll()`

- Field Detail
  - public static final String GENDER_FEMALE
  - public static final String GENDER_MALE
  - public static final Byte TYPE_FORMAL
  - public static final Byte TYPE_LIMITED
  - public static final Byte TYPE_SECONDED
  - public static final Byte TYPE_TRIAL
- Property Detail
  - Date birthdate
    
    出生日期
  - String code
    
    工号
  - static Object constraints
  - String createdBy
  - Date dateCreated
    
    时间戳...
  - String degree
    
    学历
  - String dingtalkId
    
    钉钉客户端用户 ID
  - Boolean disabled
    
    是否禁用（含逻辑删除）
  - String email
    
    邮箱
  - Date entryDate
    
    入职日期
  - String ext1
    
    扩展属性
  - String ext2
  - String gender
    
    性别
  - Date graduateDate
    
    毕业时间
  - String graduateSchool
    
    毕业院校
  - Set<Group> groups
    
    所属群组
  - static Object hasMany
  - String idNumber
    
    证件号（身份证号）
  - String idType
    
    证件类型
  - Set<EmployeeIdentity> identities
    
    包含身份
  - Date lastUpdated
  - BigDecimal level
    
    主职级别 - 冗余
  - static Map listFields
  - String location
    
    员工属地（工作地）
    在数据字典中定义，这里保存的是字典中的 key。
  - Long mainIdentityId
    
    主职身份 ID - 冗余
  - String major
    
    专业
  - static Object mapping
  - String mobile
    
    手机号码
    有些场景下，组织架构都是同步过来的，但是出于保密原因不允许同步手机号，但是应用又要支持短信功能；此时可以将短信接口的用户标识（如用户名、同步ID等）同步到本字段，在应用的 SmsService 中自行处理。
  - String name
    
    名称
  - String nation
    
    民族
  - String nativePlace
    
    籍贯
  - String notes
    
    描述
  - Organization organization
    
    所属主职机构 - 冗余
  - String payrollPlace
    
    发薪地
  - String professionalTitle
    
    职称
    职称最初源于职务名称，在理论上职称是指专业技术人员的专业技术水平、能力，以及成就的等级称号，反映专业技术人员的学术和技术水平、工作能力的工作成就。
    就学术而言，它具有学衔的性质；就专业技术水平而言，它具有岗位的性质。专业技术人员拥有何种专业技术职称，表明他具有何种学术水平或从事何种工作岗位，象征着一定的身份。
  - String qualification
    
    资质
  - String rank
    
    职级
    可以在数据字典中定义，这里保存的是数据字典中的 val，而不是 key；
    职级就是一定职务层次所对应的级别。职级是体现职务、能力、业绩、资历的综合标志，同时也是确定员工薪资待遇及其他待遇的重要依据。
    职级是对不同类别职务进行平衡比较的统一标尺。以职务层次为横轴，以级别为纵轴构成的“坐标系”，可以衡量、标识担任不同类别职务的员工在组织中所处的位置。
    也可能按照管理、专业、技工等不同分类（序列），再配合层次、级别组成一个立体的三维坐标系。
  - String religion
    
    政治面貌
  - Integer sequence
    
    所属主职机构中的排序号 - 冗余
  - String syncId
    
    同步ID
    如果是从其他系统同步过来的，可以在这里记录一个同步ID
  - String syncSequence
    
    同步序号
    其他系统的序号规则可能不满足0~999的规则，可以在这里记录，并重新计算一个新的值保存在 sequance 中
  - String telephone
    
    电话号码
  - String title
    
    头衔/岗位
    可以在数据字典中定义，这里保存的是数据字典中的 val，而不是 key，因为多个头衔可能对应一个 key。
  - static Object transients
  - Byte type
    
    员工性质
  - String updatedBy
  - User user
    
    关联用户
  - String wechatId
    
    微信客户端用户的 openid
  - Date workingDate
    
    参加工作日期
  - BigDecimal workingYears
    
    工龄基数：入职前的工龄，可以精确到2位数
- Method Detail
  - static Float annualLeaveDays(Employee emp, Date untilDate)
    
    根据员工的开始工作日期、工龄基数、入职日期，计算法定年假数，结果四舍五入到整数。
    算法：
    1. 对于本年度参加工作的，无年假；
    2. 去年参加工作，截止本年7月前，无年假；进入8月后开始有年假（算法同3）；
    3. 其他的根据实际工龄按本年度的实际工作月数计算全年年假。
  - static Float annualLeaveDays(Employee emp, Integer untilYear)
  - static Float annualLeaveDays(Date workingDate, BigDecimal workingYears, Date entryDate, Integer untilYear)
  - static Float annualLeaveDays(Date workingDate, BigDecimal workingYears, Date entryDate, Date untilDate)
  - @CompileStatic static List availableList(Map options = null)
    
    可用的员工列表
    
    Returns:
    Map 列表或者员工对象列表
    Parameters:
    options.types - 表示员工性质的字符串或数字，若字符串则多值之间用逗号分隔，默认为空，即返回受限员工以下（同"1,2,3"）；如果为0，则返回所有。
    options.result - 返回值类型，"map" 或" bean"，默认为"map"，即返回常用字段的Map列表，性能相对较好（10倍）。
    options.orderBy - 排序参数，包括 sort 和 order，默认为 “[sort:'name',order:'asc']”
  - Object beforeValidate()
  - @CompileStatic int compareTo(Object obj)
  - @CompileStatic static List<Employee> findAllByGroup(Object group, Object organization = null)
    
    根据群组获得员工列表
    
    Parameters:
    group - 群组代码/群组对象/群组ID（Long 类型）；可以是列表，或以逗号或分号分隔的多个岗位代码。
    organization - 机构代码/机构对象；可以是列表，或以逗号或分号分隔的多个机构代码。用于限定仅返回在对应机构中的群组成员。
  - @CompileStatic static List<Employee> findAllByGroupName(Object groupName, Object organization = null)
    
    根据群组名称获得员工列表
    
    Parameters:
    groupName - 群组名称；可以是列表，或以逗号或分号分隔的多个群组名称。
    organization - 机构代码/机构对象；可以是列表，或以逗号或分号分隔的多个机构代码。用于限定仅返回在对应机构中的群组成员。
  - @CompileStatic static List<Employee> findAllByPosition(Object position, Object organization = null, Map organizationOptions = null)
    
    根据岗位获得员工列表
    
    Parameters:
    position - 岗位代码/岗位对象/岗位ID（Long 类型）；可以是列表，或以逗号或分号分隔的多个岗位代码。
    organization - 机构代码/机构对象；可以是列表，或以逗号或分号分隔的多个机构代码。
    organizationOptions - 机构过滤选项，参见 Position.findMembers
  - @CompileStatic static List<Employee> findAllByPositionName(Object positionName, Object organization = null, Map organizationOptions = null)
    
    根据岗位名称获得员工列表
    
    Parameters:
    positionName - 岗位名称；可以是列表，或以逗号或分号分隔的多个岗位名称。
    organization - 机构代码/机构对象；可以是列表，或以逗号或分号分隔的多个机构代码。
    organizationOptions - 机构过滤选项，参见 Position.findMembers
  - @CompileStatic static List<Employee> findAllByRole(Object role, Object domainOrApplication = null)
    
    根据角色获得员工列表：仅限直接关联的
    
    Returns:
    员工列表
    Parameters:
    role - 角色代码/角色对象；可以是列表，或以逗号或分号分隔的多个角色代码。
    domainOrApplication - 如果 role 参数为角色代码，则可用于限定角色所属域或应用，默认为 null
  - @CompileStatic static List<Employee> findAllByUsernameInList(List<String> usernames)
    
    根据用户登录名列表获得员工列表
    
    Returns:
    员工列表
    Parameters:
    usernames - 用户登录名列表
  - @CompileStatic static Employee findByUserId(Long userId)
    
    根据用户 ID 获得员工
  - @CompileStatic static Employee findByUsername(String username)
    
    根据用户登录名获得员工
    
    Returns:
    员工对象
    Parameters:
    username - 用户登录名
  - @CompileStatic static List<Employee> getAllKeepOrder(List ids)
    
    根据ID获得员工列表，并保持ID的顺序
    
    Parameters:
    ids - 员工ID列表
  - @CompileStatic static List<Employee> getAllKeepOrderByUserIds(List userIds)
    
    根据用户ID获得员工列表，并保持ID的顺序
    
    Parameters:
    userIds - 用户ID列表
  - @CompileStatic String getDisplayIdType()
    
    获取证件类型显示值
  - @CompileStatic static String getDisplayIdType(String idType)
    
    获取证件类型显示值
  - @CompileStatic String getDisplayNation()
    
    获取民族显示值
  - @CompileStatic static String getDisplayNation(String nation)
    
    获取民族显示值
  - @CompileStatic String getDisplayReligion()
    
    获取政治面貌显示值
  - @CompileStatic static String getDisplayReligion(String religion)
    
    获取政治面貌显示值
  - @CompileStatic static List<Map> getIdTypes()
    
    获取证件类型数据字典
  - EmployeeIdentity getMainIdentity()
    
    主职身份
  - @CompileStatic String getNameAndMail()
    
    名称 + 邮件
  - @CompileStatic static List<Map> getNations()
    
    获取民族数据字典
  - @CompileStatic String getOrgAndName()
    
    主职机构全名 + 名称
  - @CompileStatic static List<Map> getReligions()
    
    获取政治面貌数据字典
  - @CompileStatic String getUserAndName()
    
    登录名 + 名称
  - @CompileStatic List<EmployeeIdentity> identities()
    
    未被禁用的员工身份列表
    如果有多个兼职，则主职身份排第一位
  - @GrailsCompileStatic@grails.compiler.GrailsCompileStatic EmployeeIdentity identity(Object organization, boolean defaultMain)
    
    根据所属机构计算员工身份
    
    Parameters:
    organization - 机构对象（Organization 类型），或者机构 ID（Long 类型）、机构编码（String 类型）
    defaultMain - 如果没找到，是否返回主职身份
  - @CompileStatic Boolean isDeleted()
    
    是否被逻辑删除
  - @CompileStatic Number level(Integer levelType = null)
    
    员工主职身份的最高级别
    
    See Also:
    EmployeeIdentity.level
  - @CompileStatic String toString()

| Detail:
Field
Property
Constructor
Method

BROPEN Documentation, 2020-04-21 11:00

[Groovy] Class Employee

Field Summary

Properties Summary

Methods Summary

Inherited Methods Summary

Field Detail

public static final String GENDER_FEMALE

public static final String GENDER_MALE

public static final Byte TYPE_FORMAL

public static final Byte TYPE_LIMITED

public static final Byte TYPE_SECONDED

public static final Byte TYPE_TRIAL

Property Detail

Date birthdate

String code

static Object constraints

String createdBy

Date dateCreated

String degree

String dingtalkId

Boolean disabled

String email

Date entryDate

String ext1

String ext2

String gender

Date graduateDate

String graduateSchool

Set<Group> groups

static Object hasMany

String idNumber

String idType

Set<EmployeeIdentity> identities

Date lastUpdated

BigDecimal level

static Map listFields

String location

Long mainIdentityId

String major

static Object mapping

String mobile

String name

String nation

String nativePlace

String notes

Organization organization

String payrollPlace

String professionalTitle

String qualification

String rank

String religion

Integer sequence

String syncId

String syncSequence

String telephone

String title

static Object transients

Byte type

String updatedBy

User user

String wechatId

Date workingDate

BigDecimal workingYears

Method Detail

static Float annualLeaveDays(Employee emp, Date untilDate)

static Float annualLeaveDays(Employee emp, Integer untilYear)

static Float annualLeaveDays(Date workingDate, BigDecimal workingYears, Date entryDate, Integer untilYear)

static Float annualLeaveDays(Date workingDate, BigDecimal workingYears, Date entryDate, Date untilDate)

@CompileStatic static List availableList(Map options = null)

Object beforeValidate()

@CompileStatic int compareTo(Object obj)

@CompileStatic static List<Employee> findAllByGroup(Object group, Object organization = null)

@CompileStatic static List<Employee> findAllByGroupName(Object groupName, Object organization = null)

@CompileStatic static List<Employee> findAllByPosition(Object position, Object organization = null, Map organizationOptions = null)

@CompileStatic static List<Employee> findAllByPositionName(Object positionName, Object organization = null, Map organizationOptions = null)

@CompileStatic static List<Employee> findAllByRole(Object role, Object domainOrApplication = null)

@CompileStatic static List<Employee> findAllByUsernameInList(List<String> usernames)

@CompileStatic static Employee findByUserId(Long userId)

@CompileStatic static Employee findByUsername(String username)

@CompileStatic static List<Employee> getAllKeepOrder(List ids)