工作日历配置

工作日历配置主要用于标记组织人员日期工作情况。通过配置日期标识、排班规则、工作日历管理及工作日历分配完成组织人员日期情况配置。

日期标识

日期标识主要是对重要日期进行标识定义，例如国家法定节假日、地市上自定义节假日或是单位重要日期等，其中背景颜色及字体颜色是定义在日历上显示的色彩效果。

排班规则

支持星期和周期的排班规则，其中周期排班规则支持自定义周期内工作日及非工作日。排班规则主要用于新建工作日历时规则选择。

工作日历管理

包含基本信息及工作日历设置，其中基本信息支持按年或按日期范围设置排班规则，工作日历主要设置日期工作类型及日期标志。

工作日历分配

工作日历分配主要是将新增的工作日历与组织人员进行绑定。

相关API

工作日历提供下面4个接口，用户可根据自己的实际需求使用对应接口构建业务。下面接口通过“企业门户地址+下面接口”组成，例如：“https://entrylzsdev6-lzsdev-ide.d.xcaas.com/misc/calendar/getworkerbydate?unitID=pdKpvTO33w0RB8MFJlK&date=2025-2-7”

查询指定组织下某天工作的人员列表

接口：
    /misc/calendar/getworkerbydate
请求方法：
    GET
参数：
    unitID  组织id（必填）
    date    日期（必填）
返回值：
    List<String>  
示例：
    https://entrylzsdev6-lzsdev-ide.d.xcaas.com/misc/calendar/getworkerbydate?unitID=pdKpvTO33w0RB8MFJlK&date=2025-2-7

查询指定组织下某天工作的人数

接口：
    /misc/calendar/getworkernumbydate
请求方法：
    GET
参数：
    unitID  组织id（必填）
    date    日期（必填）
返回值：
    int   
示例：
    https://entrylzsdev6-lzsdev-ide.d.xcaas.com/misc/calendar/getworkernumbydate?unitID=pdKpvTO33w0RB8MFJlK&date=2025-2-7

查询指定人员日期范围内工作天数

接口：
    /misc/calendar/getworkdaysbyrange
请求方法：
    GET
参数：
    personFid   人员全路径id（必填）
    start       开始日期（非必填）
    end         结束日期（非必填）
返回值：
    int  
示例：
    https://entrylzsdev6-lzsdev-ide.d.xcaas.com/misc/calendar/getworkdaysbyrange?personFid=/pdKpaJ6338gHqq1PiMg.ogn/pdKprJy33xZqx4wGOc0.ogn/pdKpvTO33w0RB8MFJlK.dpt/pf3IBYU33jSp0IIHpII.psm&start=2025-2-1&end=2025-2-28

根据开始日期和工作天数获取指定人员工作结束日期

接口：
    /misc/calendar/getenddate
请求方法：
    GET
参数：
    personFid   人员全路径id（必填）
    start       开始日期（必填）
    days        工作天数（必填）
返回值：
    String  
示例：
    https://entrylzsdev6-lzsdev-ide.d.xcaas.com/misc/calendar/getenddate?personFid=/pdKpaJ6338gHqq1PiMg.ogn/pdKprJy33xZqx4wGOc0.ogn/pdKpvTO33w0RB8MFJlK.dpt/pf3IBYU33jSp0IIHpII.psm&start=2025-2-1&days=3