考勤组列表
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>获取考勤组列表数据</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://ip:port/attendance/group/list</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>http GET</li>
</ul>
<h5>请求类型</h5>
<ul>
<li>Content-Type: form-data</li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">pageNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>当前页</td>
</tr>
<tr>
<td style="text-align: left;">pageSize</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>每页显示条数</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>考勤组名称（支持模糊查询）</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
&quot;pageNo&quot; : &quot;1&quot;,
&quot;pageSize&quot; : &quot;10&quot;,
&quot;name&quot; : &quot;xxxx&quot;
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td>状态码(是否成功)</td>
</tr>
<tr>
<td style="text-align: left;">success</td>
<td style="text-align: left;">boolean</td>
<td>成功标志</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td>返回信息</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">object</td>
<td>返回数据</td>
</tr>
<tr>
<td style="text-align: left;">total</td>
<td style="text-align: left;">int</td>
<td>总数</td>
</tr>
<tr>
<td style="text-align: left;">size</td>
<td style="text-align: left;">int</td>
<td>显示条数</td>
</tr>
<tr>
<td style="text-align: left;">current</td>
<td style="text-align: left;">int</td>
<td>当前页</td>
</tr>
<tr>
<td style="text-align: left;">orders</td>
<td style="text-align: left;">array</td>
<td>排序字段</td>
</tr>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">string</td>
<td>考勤组ID</td>
</tr>
<tr>
<td style="text-align: left;">opUserId</td>
<td style="text-align: left;">string</td>
<td>操作人的userId</td>
</tr>
<tr>
<td style="text-align: left;">addressId</td>
<td style="text-align: left;">string</td>
<td>考勤地点ID</td>
</tr>
<tr>
<td style="text-align: left;">corpId</td>
<td style="text-align: left;">string</td>
<td>机构ID</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">string</td>
<td>考勤组名称</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">string</td>
<td>考勤组类型 <br/> FIXED：固定班制考勤组，TURN：排班制考勤组，NONE：自由工时考勤组</td>
</tr>
<tr>
<td style="text-align: left;">ownerPersonId</td>
<td style="text-align: left;">sring</td>
<td>考勤组主负责人ID</td>
</tr>
<tr>
<td style="text-align: left;">submanagerPersonIds</td>
<td style="text-align: left;">string</td>
<td>考勤组子管理员personid集合</td>
</tr>
<tr>
<td style="text-align: left;">workdayClassIds</td>
<td style="text-align: left;">string</td>
<td>周班次列表<br/>固定班制必填，0表示休息。<br/>从左到右依次代表周一到周日，每日的排班情况</td>
</tr>
<tr>
<td style="text-align: left;">freecheckWorkDays</td>
<td style="text-align: left;">string</td>
<td>自由工时考勤组工作日<br/>自由工时必填，0表示休息<br/>从左到右依次代表周一到周日，每日的排班情况</td>
</tr>
<tr>
<td style="text-align: left;">freecheckDayStartMinOffset</td>
<td style="text-align: left;">int</td>
<td>自由工时偏移量<br/>自由工时考勤组考勤开始时间与当天0点偏移分钟数<br/>例如：540表示9:00</td>
</tr>
<tr>
<td style="text-align: left;">enableEmpSelectClass</td>
<td style="text-align: left;">string</td>
<td>未排班时是否允许员工选择班次打卡(0：允许，1：不允许)</td>
</tr>
<tr>
<td style="text-align: left;">skipHolidays</td>
<td style="text-align: left;">string</td>
<td>是否跳过节假日：（0（默认）：跳过，1：不跳过）</td>
</tr>
<tr>
<td style="text-align: left;">specialDays</td>
<td style="text-align: left;">string</td>
<td>特殊日期配置<br/>onDuty为上班配置，offDuty为休息<br/>{"onDuty": [{"date":"2023-03-08","classId":"111", "className": "班次名称", "timeSection": "09:00-18:00"}],"offDuty":[{"date":"2023-03-08","classId":"222"}]}</td>
</tr>
<tr>
<td style="text-align: left;">enableOutsideCameraCheck</td>
<td style="text-align: left;">string</td>
<td>是否开启外勤打卡必须拍照：（0：开启，1（默认）：关闭）</td>
</tr>
<tr>
<td style="text-align: left;">enableOutsideCheck</td>
<td style="text-align: left;">string</td>
<td>是否可以外勤打卡（0（默认）：允许，1：不允许）</td>
</tr>
<tr>
<td style="text-align: left;">enableNextDay</td>
<td style="text-align: left;">string</td>
<td>是否第二天生效（0：是，1：否）</td>
</tr>
<tr>
<td style="text-align: left;">effective</td>
<td style="text-align: left;">string</td>
<td>是否已生效（0：已生效，1：失效）</td>
</tr>
<tr>
<td style="text-align: left;">effectiveTime</td>
<td style="text-align: left;">date</td>
<td>生效时间</td>
</tr>
<tr>
<td style="text-align: left;">offset</td>
<td style="text-align: left;">int</td>
<td>考勤范围（单位：米）</td>
</tr>
<tr>
<td style="text-align: left;">disableCheckWithoutSchedule</td>
<td style="text-align: left;">string</td>
<td>未排班时是否禁止员工打卡（0：禁止，1：（默认不禁止）不禁止）</td>
</tr>
<tr>
<td style="text-align: left;">disableCheckWhenRest</td>
<td style="text-align: left;">string</td>
<td>休息日打卡是否需审批（0：需要，1：不需要）</td>
</tr>
<tr>
<td style="text-align: left;">classesInfo</td>
<td style="text-align: left;">object</td>
<td>班次信息</td>
</tr>
<tr>
<td style="text-align: left;">autoJoin</td>
<td style="text-align: left;">string</td>
<td>是否自动加入排班（0：是，1：否）</td>
</tr>
<tr>
<td style="text-align: left;">overtimeRule</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>加班规则（0：加班必须审批，加班时长以审批时间为准，1：加班必须审批，以打卡时间为准）</td>
</tr>
<tr>
<td style="text-align: left;">classesList</td>
<td style="text-align: left;">array</td>
<td>考勤时间</td>
</tr>
<tr>
<td style="text-align: left;">memberCount</td>
<td style="text-align: left;">int</td>
<td>考勤组人员数量</td>
</tr>
<tr>
<td style="text-align: left;">classesIds</td>
<td style="text-align: left;">array</td>
<td>班次id数组集合</td>
</tr>
<tr>
<td style="text-align: left;">overtimeRuleId</td>
<td style="text-align: left;">string</td>
<td>加班规则ID</td>
</tr>
<tr>
<td style="text-align: left;">createTime</td>
<td style="text-align: left;">date</td>
<td>创建时间</td>
</tr>
<tr>
<td style="text-align: left;">updateTime</td>
<td style="text-align: left;">date</td>
<td>修改时间</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;success&quot;: true,
&quot;message&quot;: &quot;&quot;,
&quot;code&quot;: 200,
&quot;result&quot;: {
&quot;records&quot;: [
{
&quot;ownerPersonId&quot;: null,
&quot;workdayClassIds&quot;: &quot;1,2,1,1,1,0,0&quot;,
&quot;specialDays&quot;: null,
&quot;type&quot;: &quot;FIXED&quot;,
&quot;addressId&quot;: &quot;1&quot;,
&quot;effective&quot;: null,
&quot;effectiveTime&quot;: &quot;2023-03-24 00:00:00&quot;,
&quot;submanagerPersonIds&quot;: null,
&quot;id&quot;: &quot;1&quot;,
&quot;freecheckDayStartMinOffset&quot;: null,
&quot;enableEmpSelectClass&quot;: &quot;0&quot;,
&quot;corpId&quot;: &quot;1&quot;,
&quot;skipHolidays&quot;: &quot;0&quot;,
&quot;offset&quot;: null,
&quot;classesList&quot;: [
&quot;周6、周7 休息&quot;,
&quot;周1、周3、周4、周5 测试 09:00-18:00 19:00-20:00&quot;,
&quot;周2 哈哈哈哈测试 09:00-18:00&quot;
],
&quot;classesInfo&quot;: [{
&quot;date&quot;: &quot;2023-03-08&quot;,
&quot;classId&quot;: &quot;111&quot;,
&quot;className&quot;: &quot;班次名称&quot;,
&quot;timeSection&quot;: &quot;09:00-18:00&quot;
}],
&quot;autoJoin&quot; : &quot;0&quot;,
&quot;overtimeRule&quot; : &quot;0&quot;,
&quot;memberCount&quot;: 1,
&quot;freecheckWorkDays&quot;: null,
&quot;enableOutsideCameraCheck&quot;: &quot;1&quot;,
&quot;opUserId&quot;: &quot;e9ca23d68d884d4ebb19d07889727dae&quot;,
&quot;disableCheckWithoutSchedule&quot;: &quot;1&quot;,
&quot;classesIds&quot;: [
&quot;1&quot;,
&quot;2&quot;
],
&quot;enableOutsideCheck&quot;: &quot;0&quot;,
&quot;createTime&quot;: &quot;2023-03-08 17:50:08&quot;,
&quot;updateTime&quot;: &quot;2023-03-08 17:50:08&quot;,
&quot;enableNextDay&quot;: &quot;0&quot;,
&quot;name&quot;: &quot;测试&quot;,
&quot;overtimeRuleId&quot; : &quot;123&quot;,
&quot;disableCheckWhenRest&quot;: null
}
],
&quot;total&quot;: 1,
&quot;size&quot;: 10,
&quot;current&quot;: 1,
&quot;orders&quot;: [],
&quot;optimizeCountSql&quot;: true,
&quot;searchCount&quot;: true,
&quot;countId&quot;: null,
&quot;maxLimit&quot;: null,
&quot;pages&quot;: 1
},
&quot;data&quot;: null,
&quot;timestamp&quot;: 1679466644323
}</code></pre>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>