程序包 com.lark.oapi.service.attendance.v1.model

类 Group.Builder

java.lang.Object
com.lark.oapi.service.attendance.v1.model.Group.Builder
封闭类:
Group
public static class Group.Builder extends Object

  • 构造器详细资料

    • Builder

      public Builder()

  • 方法详细资料

    • groupId

      public Group.Builder groupId(String groupId)
      考勤组 ID（仅修改时提供）， 需要从“获取打卡结果”的接口中获取 groupId

      示例值：6919358128597097404

      参数:
      groupId -
      返回:

    • groupName

      public Group.Builder groupName(String groupName)
      考勤组名称

      示例值：开心考勤

      参数:
      groupName -
      返回:

    • timeZone

      public Group.Builder timeZone(String timeZone)
      时区

      示例值：Asia/Shanghai

      参数:
      timeZone -
      返回:

    • bindDeptIds

      public Group.Builder bindDeptIds(String[] bindDeptIds)
      绑定的部门 ID

      示例值：od-fcb45c28a45311afd440b7869541fce8

      参数:
      bindDeptIds -
      返回:

    • exceptDeptIds

      public Group.Builder exceptDeptIds(String[] exceptDeptIds)
      排除的部门 ID

      示例值：od-fcb45c28a45311afd440b7869541fce8

      参数:
      exceptDeptIds -
      返回:

    • bindUserIds

      public Group.Builder bindUserIds(String[] bindUserIds)
      绑定的用户 ID

      示例值：52aa1fa1

      参数:
      bindUserIds -
      返回:

    • exceptUserIds

      public Group.Builder exceptUserIds(String[] exceptUserIds)
      排除的用户 ID

      示例值：52aa1fa1

      参数:
      exceptUserIds -
      返回:

    • groupLeaderIds

      public Group.Builder groupLeaderIds(String[] groupLeaderIds)
      考勤主负责人 ID 列表，必选字段（需至少拥有考勤组管理员权限）

      示例值：2bg4a9be

      参数:
      groupLeaderIds -
      返回:

    • subGroupLeaderIds

      public Group.Builder subGroupLeaderIds(String[] subGroupLeaderIds)
      考勤子负责人 ID 列表

      示例值：52aa1fa1

      参数:
      subGroupLeaderIds -
      返回:

    • allowOutPunch

      public Group.Builder allowOutPunch(Boolean allowOutPunch)
      是否允许外勤打卡

      示例值：true

      参数:
      allowOutPunch -
      返回:

    • outPunchNeedApproval

      public Group.Builder outPunchNeedApproval(Boolean outPunchNeedApproval)
      外勤打卡需审批（需要允许外勤打卡才能设置生效）

      示例值：true

      参数:
      outPunchNeedApproval -
      返回:

    • outPunchNeedPostApproval

      public Group.Builder outPunchNeedPostApproval(Boolean outPunchNeedPostApproval)
      外勤打卡需审批，先打卡后审批（需要允许外勤打卡才能设置生效）

      示例值：true

      参数:
      outPunchNeedPostApproval -
      返回:

    • outPunchNeedRemark

      public Group.Builder outPunchNeedRemark(Boolean outPunchNeedRemark)
      外勤打卡需填写备注（需要允许外勤打卡才能设置生效）

      示例值：true

      参数:
      outPunchNeedRemark -
      返回:

    • outPunchNeedPhoto

      public Group.Builder outPunchNeedPhoto(Boolean outPunchNeedPhoto)
      外勤打卡需拍照（需要允许外勤打卡才能设置生效）

      示例值：true

      参数:
      outPunchNeedPhoto -
      返回:

    • outPunchAllowedHideAddr

      public Group.Builder outPunchAllowedHideAddr(Boolean outPunchAllowedHideAddr)
      外勤打卡允许员工隐藏详细地址（需要允许外勤打卡才能设置生效）

      示例值：true

      参数:
      outPunchAllowedHideAddr -
      返回:

    • outPunchAllowedAdjustAddr

      public Group.Builder outPunchAllowedAdjustAddr(Boolean outPunchAllowedAdjustAddr)
      外勤打卡允许微调地址（需要允许外勤打卡才能设置生效）

      示例值：true

      参数:
      outPunchAllowedAdjustAddr -
      返回:

    • adjustRange

      public Group.Builder adjustRange(Integer adjustRange)
      微调范围，默认为 50 米

      示例值：50

      参数:
      adjustRange -
      返回:

    • allowPcPunch

      public Group.Builder allowPcPunch(Boolean allowPcPunch)
      是否允许 PC 端打卡

      示例值：true

      参数:
      allowPcPunch -
      返回:

    • allowRemedy

      public Group.Builder allowRemedy(Boolean allowRemedy)
      是否限制补卡

      示例值：true

      参数:
      allowRemedy -
      返回:

    • remedyLimit

      public Group.Builder remedyLimit(Boolean remedyLimit)
      是否限制补卡次数

      示例值：true

      参数:
      remedyLimit -
      返回:

    • remedyLimitCount

      public Group.Builder remedyLimitCount(Integer remedyLimitCount)
      补卡次数

      示例值：3

      参数:
      remedyLimitCount -
      返回:

    • remedyDateLimit

      public Group.Builder remedyDateLimit(Boolean remedyDateLimit)
      是否限制补卡时间

      示例值：true

      参数:
      remedyDateLimit -
      返回:

    • remedyDateNum

      public Group.Builder remedyDateNum(Integer remedyDateNum)
      补卡时间，几天内补卡

      示例值：3

      参数:
      remedyDateNum -
      返回:

    • allowRemedyTypeLack

      public Group.Builder allowRemedyTypeLack(Boolean allowRemedyTypeLack)
      允许缺卡补卡（需要允许补卡才能设置生效）

      示例值：true

      参数:
      allowRemedyTypeLack -
      返回:

    • allowRemedyTypeLate

      public Group.Builder allowRemedyTypeLate(Boolean allowRemedyTypeLate)
      允许迟到补卡（需要允许补卡才能设置生效）

      示例值：true

      参数:
      allowRemedyTypeLate -
      返回:

    • allowRemedyTypeEarly

      public Group.Builder allowRemedyTypeEarly(Boolean allowRemedyTypeEarly)
      允许早退补卡（需要允许补卡才能设置生效）

      示例值：true

      参数:
      allowRemedyTypeEarly -
      返回:

    • allowRemedyTypeNormal

      public Group.Builder allowRemedyTypeNormal(Boolean allowRemedyTypeNormal)
      允许正常补卡（需要允许补卡才能设置生效）

      示例值：true

      参数:
      allowRemedyTypeNormal -
      返回:

    • showCumulativeTime

      public Group.Builder showCumulativeTime(Boolean showCumulativeTime)
      是否展示累计时长

      示例值：true

      参数:
      showCumulativeTime -
      返回:

    • showOverTime

      public Group.Builder showOverTime(Boolean showOverTime)
      是否展示加班时长

      示例值：true

      参数:
      showOverTime -
      返回:

    • hideStaffPunchTime

      public Group.Builder hideStaffPunchTime(Boolean hideStaffPunchTime)
      是否隐藏员工打卡详情

      示例值：true

      参数:
      hideStaffPunchTime -
      返回:

    • facePunch

      public Group.Builder facePunch(Boolean facePunch)
      是否开启人脸识别打卡

      示例值：true

      参数:
      facePunch -
      返回:

    • facePunchCfg

      public Group.Builder facePunchCfg(Integer facePunchCfg)
      人脸识别打卡规则，1：每次打卡均需人脸识别，2：疑似作弊打卡时需要人脸识别

      示例值：1

      参数:
      facePunchCfg -
      返回:

    • faceLiveNeedAction

      public Group.Builder faceLiveNeedAction(Boolean faceLiveNeedAction)
      人脸打卡规则， false：开启活体验证 true：0动作验证，仅在 face_punch_cfg = 1 时有效

      示例值：false

      参数:
      faceLiveNeedAction -
      返回:

    • faceDowngrade

      public Group.Builder faceDowngrade(Boolean faceDowngrade)
      人脸识别失败时是否允许普通拍照打卡

      示例值：true

      参数:
      faceDowngrade -
      返回:

    • replaceBasicPic

      public Group.Builder replaceBasicPic(Boolean replaceBasicPic)
      人脸识别失败时是否允许替换基准图片

      示例值：true

      参数:
      replaceBasicPic -
      返回:

    • machines

      public Group.Builder machines(Machine[] machines)
      考勤机列表

      示例值：

      参数:
      machines -
      返回:

    • gpsRange

      public Group.Builder gpsRange(Integer gpsRange)
      GPS 打卡的有效范围（不建议使用）

      示例值：300

      参数:
      gpsRange -
      返回:

    • locations

      public Group.Builder locations(Location[] locations)
      地址列表

      示例值：

      参数:
      locations -
      返回:

    • groupType

      public Group.Builder groupType(Integer groupType)
      考勤类型，0：固定班制，2：排班制， 3：自由班制

      示例值：0

      参数:
      groupType -
      返回:

    • punchDayShiftIds

      public Group.Builder punchDayShiftIds(String[] punchDayShiftIds)
      固定班制必须填

      示例值：6921319402260496386

      参数:
      punchDayShiftIds -
      返回:

    • freePunchCfg

      public Group.Builder freePunchCfg(FreePunchCfg freePunchCfg)
      配置自由班制

      示例值：

      参数:
      freePunchCfg -
      返回:

    • calendarId

      public Group.Builder calendarId(Integer calendarId)
      国家日历 ID，0：不根据国家日历排休，1：中国大陆，2：美国，3：日本，4：印度，5：新加坡，默认 1

      示例值：1

      参数:
      calendarId -
      返回:

    • needPunchSpecialDays

      public Group.Builder needPunchSpecialDays(PunchSpecialDateShift[] needPunchSpecialDays)
      必须打卡的特殊日期

      示例值：

      参数:
      needPunchSpecialDays -
      返回:

    • noNeedPunchSpecialDays

      public Group.Builder noNeedPunchSpecialDays(PunchSpecialDateShift[] noNeedPunchSpecialDays)
      无需打卡的特殊日期

      示例值：

      参数:
      noNeedPunchSpecialDays -
      返回:

    • workDayNoPunchAsLack

      public Group.Builder workDayNoPunchAsLack(Boolean workDayNoPunchAsLack)
      自由班制下工作日不打卡是否记为缺卡

      示例值：true

      参数:
      workDayNoPunchAsLack -
      返回:

    • effectNow

      public Group.Builder effectNow(Boolean effectNow)
      是否立即生效，默认 false

      示例值：true

      参数:
      effectNow -
      返回:

    • remedyPeriodType

      public Group.Builder remedyPeriodType(Integer remedyPeriodType)
      补卡周期类型

      示例值：0

      参数:
      remedyPeriodType -
      返回:

    • remedyPeriodCustomDate

      public Group.Builder remedyPeriodCustomDate(Integer remedyPeriodCustomDate)
      补卡自定义周期起始日期

      示例值：1

      参数:
      remedyPeriodCustomDate -
      返回:

    • punchType

      public Group.Builder punchType(Integer punchType)
      打卡类型，位运算。1：GPS 打卡，2：Wi-Fi 打卡，4：考勤机打卡，8：IP 打卡

      示例值：1

      参数:
      punchType -
      返回:

    • effectTime

      public Group.Builder effectTime(String effectTime)
      生效时间，精确到秒的时间戳

      示例值：1611476284

      参数:
      effectTime -
      返回:

    • fixshiftEffectTime

      public Group.Builder fixshiftEffectTime(String fixshiftEffectTime)
      固定班次生效时间，精确到秒的时间戳

      示例值：1611476284

      参数:
      fixshiftEffectTime -
      返回:

    • memberEffectTime

      public Group.Builder memberEffectTime(String memberEffectTime)
      参加考勤的人员、部门变动生效时间，精确到秒的时间戳

      示例值：1611476284

      参数:
      memberEffectTime -
      返回:

    • restClockInNeedApproval

      public Group.Builder restClockInNeedApproval(Boolean restClockInNeedApproval)
      休息日打卡需审批

      示例值：true

      参数:
      restClockInNeedApproval -
      返回:

    • clockInNeedPhoto

      public Group.Builder clockInNeedPhoto(Boolean clockInNeedPhoto)
      每次打卡均需拍照

      示例值：true

      参数:
      clockInNeedPhoto -
      返回:

    • memberStatusChange

      public Group.Builder memberStatusChange(MemberStatusChange memberStatusChange)
      人员异动打卡设置

      示例值：

      参数:
      memberStatusChange -
      返回:

    • leaveNeedPunch

      public Group.Builder leaveNeedPunch(Boolean leaveNeedPunch)
      请假离岗或返岗是否需打卡

      示例值：false

      参数:
      leaveNeedPunch -
      返回:

    • leaveNeedPunchCfg

      public Group.Builder leaveNeedPunchCfg(LeaveNeedPunchCfg leaveNeedPunchCfg)
      请假离岗或返岗打卡规则

      示例值：

      参数:
      leaveNeedPunchCfg -
      返回:

    • goOutNeedPunch

      public Group.Builder goOutNeedPunch(Integer goOutNeedPunch)
      外出期间是否需打卡

      示例值：0

      参数:
      goOutNeedPunch -
      返回:

    • goOutNeedPunchCfg

      public Group.Builder goOutNeedPunchCfg(LeaveNeedPunchCfg goOutNeedPunchCfg)
      外出期间打卡规则

      示例值：

      参数:
      goOutNeedPunchCfg -
      返回:

    • travelNeedPunch

      public Group.Builder travelNeedPunch(Integer travelNeedPunch)
      出差期间是否需打卡

      示例值：0

      参数:
      travelNeedPunch -
      返回:

    • travelNeedPunchCfg

      public Group.Builder travelNeedPunchCfg(LeaveNeedPunchCfg travelNeedPunchCfg)
      出差期间打卡规则

      示例值：

      参数:
      travelNeedPunchCfg -
      返回:

    • needPunchMembers

      public Group.Builder needPunchMembers(PunchMember[] needPunchMembers)
      需要打卡的人员配置（新）

      示例值：

      参数:
      needPunchMembers -
      返回:

    • noNeedPunchMembers

      public Group.Builder noNeedPunchMembers(PunchMember[] noNeedPunchMembers)
      无需打卡的人员配置（新）

      示例值：

      参数:
      noNeedPunchMembers -
      返回:

    • saveAutoChanges

      public Group.Builder saveAutoChanges(Boolean saveAutoChanges)
      是否直接保存可以自动变更的冲突规则

      示例值：false

      参数:
      saveAutoChanges -
      返回:

    • orgChangeAutoAdjust

      public Group.Builder orgChangeAutoAdjust(Boolean orgChangeAutoAdjust)
      人员异动开关（人员组织架构变更后是否允许自动调整到该考勤组）

      示例值：false

      参数:
      orgChangeAutoAdjust -
      返回:

    • bindDefaultDeptIds

      public Group.Builder bindDefaultDeptIds(String[] bindDefaultDeptIds)
      默认出勤的部门id列表

      示例值：

      参数:
      bindDefaultDeptIds -
      返回:

    • bindDefaultUserIds

      public Group.Builder bindDefaultUserIds(String[] bindDefaultUserIds)
      默认出勤的用户ID列表

      示例值：

      参数:
      bindDefaultUserIds -
      返回:

    • overtimeClockCfg

      public Group.Builder overtimeClockCfg(OvertimeClockCfg overtimeClockCfg)
      加班打卡规则

      示例值：

      参数:
      overtimeClockCfg -
      返回:

    • newCalendarId

      public Group.Builder newCalendarId(String newCalendarId)
      节假日id，（如果考勤组使用了自定义节假日，请用此参数传入节假日id）

      示例值：通过查询考勤组接口获取的new_calendar_id，例如7302191700771358252

      参数:
      newCalendarId -
      返回:

    • allowApplyPunch

      public Group.Builder allowApplyPunch(Boolean allowApplyPunch)
      定位不准时是否允许申请打卡

      示例值：true

      参数:
      allowApplyPunch -
      返回:

    • build

      public Group build()