Field Detail

• public static Object aliasOverridingOrder

Property Detail

• OsmEmployeeService osmEmployeeService

• OsmPositionService osmPositionService

Method Detail

• @bropen.toolkit.annotation.Internal String checkShortName(Organization org)

  检查兄弟机构下的代字是否有重复，有则返回一条消息

  Parameters:

  org - 机构

• boolean containsEmployee(Object org, Object employee)

  判断是否是某个机构下的员工

  Parameters:

  employee - 可以是员工对象、员工身份对象、员工工号、员工ID、或者 null 表示当前员工

  org - 可以是机构对象、机构编码（注意唯一性）、机构ID

• boolean delete(Organization org, boolean force = false)

  删除机构

  Returns:

  如果失败，可以通过 org.errors 获得错误消息

  Parameters:

  org - 机构

  force - 是否为强制删除（自动删除所有下级机构、禁用所有员工），默认为否

• @grails.transaction.Transactional boolean disable(Organization org)

  禁用机构

  建议包含在 withTransaction 闭包中执行，如果返回 false 则执行回滚。

  注意不要和方法 update 混用，可能导致 Hibernate Session 异常。

  Returns:

  如果失败，可以通过 org.errors 获得错误消息

• @grails.transaction.Transactional boolean enable(Organization org)

  启用机构

  建议包含在 withTransaction 闭包中执行，如果返回 false 则执行回滚。

  注意不要和方法 update 混用，可能导致 Hibernate Session 异常。

  Returns:

  如果失败，可以通过 org.errors 获得错误消息

• List<Position> getAllPositions(Organization org, Map options = null)

  取机构下所有岗位，包括下级机构的

  Parameters:

  org - 机构

  options.builtin - 是否查询内置岗位（如部门经理、主管领导等），默认为 null，即查询所有

• List getDeptManagers(Organization org, boolean isEI = false)

  取所有部门经理

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getDeptManagers(String orgCode, boolean isEI = false)

  取所有部门经理

  Parameters:

  orgCode - 机构代码

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getDeptManagers(Collection orgs, boolean isEI = false)

  取所有部门经理

  Parameters:

  orgs - 机构列表，或机构的code列表

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getDeptManagers1(Organization org, boolean isEI = false)

  取部门经理（正）

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getDeptManagers1(Collection orgs, boolean isEI = false)

  取部门经理（正）

  Parameters:

  orgs - 机构列表，或机构的code列表

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getDeptManagers1(String orgCode, boolean isEI = false)

  取部门经理（正）

  Parameters:

  orgCode - 机构代码

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getDeptManagers2(Organization org, boolean isEI = false)

  取部门经理（副）

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getDeptManagers2(Collection orgs, boolean isEI = false)

  取部门经理（副）

  Parameters:

  orgs - 机构列表，或机构的code列表

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getDeptManagers2(String orgCode, boolean isEI = false)

  取部门经理（副）

  Parameters:

  orgCode - 机构代码

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• @Deprecated List<EmployeeIdentity> getEmployeeIdentities(Organization org, boolean heritable = false, boolean includeCompany = true)

  取机构下所有员工，并按级别、机构、序号排序

  Returns:

  员工身份列表

  Parameters:

  org - 机构

  heritable - 是否包含下级机构中的员工

  includeCompany - 是否包含下级单位中的员工

• List<EmployeeIdentity> getEmployeeIdentities(Organization org, Map options)

  取机构下所有员工，并按级别、机构、序号排序

  Returns:

  员工身份列表

  Parameters:

  org - 机构

  options.heritable - 是否包含下级机构中的员工,默认为false

  options.company - 是否包含下级单位中的员工,默认为true

  options.max - 最多取max个，默认为所有

• @Deprecated List<EmployeeIdentity> getEmployeeIdentities(String code, boolean heritable = false, boolean includeCompany = true)

  取机构下所有员工，并按级别、机构、序号排序

  Returns:

  员工身份列表

  Parameters:

  code - 机构代码

  heritable - 是否包含下级机构中的员工

  includeCompany - 是否包含下级单位中的员工

• List<EmployeeIdentity> getEmployeeIdentities(String code, Map options)

  取机构下所有员工，并按级别、机构、序号排序

  Returns:

  员工身份列表

  Parameters:

  code - 机构代码

  options.heritable - 是否包含下级机构中的员工,默认为false

  options.company - 是否包含下级单位中的员工,默认为true

• @Deprecated List<EmployeeIdentity> getEmployeeIdentitiesByLevel(Object org, String levelType, boolean heritable = false)

  取机构下特定的人员，并按级别、机构、序号排序

  Returns:

  员工身份列表

  Parameters:

  org - 机构对象、或机构对象列表

  levelType - S 主管领导（参数heritable无效）；A 全部（不含主管领导）；L 领导；M 正领导；D 副领导；N 员工

  heritable - 是否包含下级机构中的人员

• List<EmployeeIdentity> getEmployeeIdentitiesByLevel(Object org, String levelType, Map options)

  取机构下特定的人员，并按级别、机构、序号排序

  Returns:

  员工身份列表

  Parameters:

  org - 机构对象、或机构对象列表

  levelType - S 主管领导（参数heritable无效）；A 全部（不含属于上级机构、并在本机构担任主管领导岗位的员工）；L 领导；M 正领导；D 副领导；N 员工

  options.heritable - 是否包含下级机构中的人员，默认为 false

• List<Map> getEmployeeProps(Organization org, List<String> props, Map options)

  取机构下所有员工，并按级别、机构、序号排序

  Returns:

  员工属性的 Map 列表，如 [id: 1, name: XXX, user_id: XXX]

  Parameters:

  props - 员工属性列表，如 [id, name, user.id]

• @Deprecated List<Employee> getEmployees(Object orgOrCode, boolean heritable = false, boolean includeCompany = true)

• List<Employee> getEmployees(Organization org, Map options)

  取机构下所有员工，并按级别、机构、序号排序

  Returns:

  员工列表

  Parameters:

  org - 机构

  options.heritable - 是否包含下级机构中的员工,默认为false

  options.company - 是否包含下级单位中的员工,默认为true

• List<Employee> getEmployees(String code, Map options)

  取机构下所有员工，并按级别、机构、序号排序

  Returns:

  员工列表

  Parameters:

  code - 机构代码

  options.heritable - 是否包含下级机构中的员工,默认为false

  options.company - 是否包含下级单位中的员工,默认为true

• List getLeaders(Organization org, boolean isEI = false)

  取单位领导（正&副）

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getLeaders1(Organization org, boolean isEI = false)

  取单位领导（正）

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getLeaders2(Organization org, boolean isEI = false)

  取单位领导（副）

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List<Object> getLowerOrgProps(List list, List<String> props, Map options)

  获得所有下级机构的部分属性

  相对方法 getLowerOrgs，在特定的需求下提供更高的性能。

  Returns:

  如果 props 是单值，则为属性值列表，如果是多值，则为 Map 列表

  Parameters:

  list - 机构列表，或包含 id、fullIds 的 Map 列表

  props - 属性名称列表

  options.company - 是否包含下级单位，默认为 true

  options.self - 返回结果中是否包括参数 list 中机构的部分属性，默认为 true

• @Deprecated List<Organization> getLowerOrgs(List<Organization> list, Boolean includeCompany)

  获得所有下级机构

  Returns:

  包含list、及其下级机构的对象列表

  Parameters:

  list - 机构列表

  includeCompany - 是否包含下级单位

• List<Organization> getLowerOrgs(List list, Map options)

  获得所有下级机构

  Returns:

  机构对象列表

  Parameters:

  list - 机构列表，或包含 id、fullIds 的 Map 列表

  options.company - 是否包含下级单位，默认为 true

  options.self - 返回结果中是否包括参数 list 中的机构列表，默认为 true

• @Deprecated List<Employee> getManagedEmployees(Employee emp, boolean heritable = false)

  取某员工管理的下级员工

  Returns:

  下级员工列表（包括自己）

  Parameters:

  emp - 员工

  heritable - 是否包含下级机构里的员工

• List<Employee> getManagedEmployees(Employee emp, Map options)

  取某员工管理的下级员工

  Returns:

  下级员工列表（包括自己）

  Parameters:

  emp - 员工

  options.heritable - 是否包含下级机构里的员工，默认为 false

  options.company - 是否包含下级单位里的而员工，默认为 true

• @Deprecated List<Organization> getManagedOrgs(Employee emp, boolean heritable = false, boolean includeCompany = true)

  取用户管理的机构（作为单位领导、部门经理、部门的主管领导）

  Returns:

  机构列表

  Parameters:

  emp - 员工

  heritable - 是否包含下级机构，默认为false

  includeCompany - 是否包含下级单位，默认为true

• List<Organization> getManagedOrgs(Employee emp, Map options)

  取用户管理的机构

  Returns:

  机构列表

  Parameters:

  emp - 员工

  options - 查询选项

  options.heritable - 是否包含下级机构，默认为false

  options.company - 是否包含下级单位，默认为true

  options.principal - 是否包含正职，默认为true

  options.deputy - 是否包含副职，默认为true

  options.supervisor - 是否包含部门主管领导，默认为true

  options.leader - 是否包含公司领导，默认为true

  options.president - 是否包含公司董事长，默认为true

• Organization getOrg(Organization org)

  获得本机构所在的单位（非部门机构，如公司）

  Parameters:

  org - 机构

• @Deprecated List<Employee> getPositionEmployees(String posCode, String posName, Object org)

  根据岗位编码或名称，以及机构或编码获取岗位下的员工

  deprecated:

  用 Employee.findAllByPosition && Employee.findAllByPositionName 代替

  Returns:

  员工列表。如果没找到岗位，则返回null

  Parameters:

  posCode - 岗位代码（可选），如果用名称计算则设为null

  posName - 岗位名称（可选），如果用代码进行计算则设为null

  org - 机构对象，或机构代码（字符串类型）、机构ID（Long类型），如果取所有岗位则设为null

• List getPresidents(Organization org, boolean isEI = false)

  取单位董事长（正&副）

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getPresidents1(Organization org, boolean isEI = false)

  取单位董事长（正）

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• List getPresidents2(Organization org, boolean isEI = false)

  取单位董事长（副）

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• Organization getRoot(Organization org)

  获得根机构（级别为0的顶级机构，如集团公司）

  Parameters:

  org - 机构

• List getSupervisors(Organization org, boolean isEI = false)

  取机构主管领导

  Parameters:

  org - 机构

  isEI - 是否返回员工身份，默认为否，即返回员工对象列表

• @Deprecated Integer hasEmployees(Object source, boolean heritable, boolean includeCompany)

  判断机构下是否有在职的员工

  一般情况下，可以直接调用机构的属性 hasEmployees 来进行判断。

  Returns:

  员工身份的数量，0=空

  Parameters:

  source - 机构Bean、机构Code、机构ID、机构列表、机构Bean列表、机构Code列表、机构ID列表

  heritable - 是否包含下级机构中的员工

  includeCompany - 当 heritable 为 true 时，是否包含下级单位中的员工

• Integer hasEmployees(Object source, Map options)

  判断机构下是否有在职的员工

  一般情况下，可以直接调用机构的属性 hasEmployees 来进行判断。

  Returns:

  员工身份的数量，0=空

  Parameters:

  source - 机构、机构Code、机构ID，或机构列表、机构Code列表、机构ID列表

  options.heritable - 是否包含下级机构中的员工，默认为 false

  options.company - 当 heritable 为 true 时，是否包含下级单位中的员工，默认为 true

• @grails.transaction.Transactional @bropen.toolkit.annotation.Internal boolean move(Organization org, Organization parent, Boolean department = null)

  将机构作为子机构，迁移到其他机构下面，或者迁移为根机构

  迁移后，会自动修改相应岗位对应的POS角色级别、机构全名和全排序号、级别等，以及员工/身份级别，流程里的信息不动

  Returns:

  如果失败，可以通过 org.errors 获得错误消息

  Parameters:

  org - 要迁移的机构

  parent - 新的上级机构，如果为null，则表示迁移为根机构

• @grails.transaction.Transactional Integer resetAllFullIds()

  工具方法：重新计算所有机构的 fullIds 属性

  Returns:

  修正的机构数

• @grails.transaction.Transactional Integer resetAllOrganizationHasEmployees()

  工具方法：重新计算所有机构的 hasEmployees 属性。

  Returns:

  修正的机构数：可能是错误的，可以多运行一次，如果返回值都是一样的，则表示实际上修正机构数为 0

• @grails.transaction.Transactional boolean save(Organization org, Map params)

  保存新机构

  需包含在 withTransaction 闭包中执行，如果返回 false 则执行回滚。

  Returns:

  如果保存失败，可以通过 org.errors 获得错误消息

  Parameters:

  org - 一个空的bean对象

  params - 创建bean所需的数据

• @grails.transaction.Transactional boolean update(Organization org, Map params)

  修改机构信息

  需包含在 withTransaction 闭包中执行，如果返回 false 则执行回滚。

  Returns:

  如果保存失败，可以通过 org.errors 获得错误消息

  Parameters:

  org - 更新前的bean

  params - 需要更新的数据

• @grails.transaction.Transactional @bropen.toolkit.annotation.Internal void updateOrganizationHasEmployees(Employee emp)

  根据员工，更新所属机构及所有上级机构的 hasEmployees 属性

  Parameters:

  emp - 员工

• @grails.transaction.Transactional @bropen.toolkit.annotation.Internal void updateOrganizationHasEmployees(EmployeeIdentity ei, Organization org = ei.organization, Boolean disabled = ei.disabled)

  根据员工身份，更新所属机构及所有上级机构的 hasEmployees 属性

  Parameters:

  ei - 员工身份

  org - 身份要移入或移出的机构，默认等于身份所属机构。有时候需要提前从机构中将身份remove掉，避免 deleted object would be re-saved by cascade 等异常

  disabled - 是否从机构中移走，默认等于身份的禁用状态