名词解释
队列
同一个队列,单独维护一个单独的序号,每个用户针对同一个队列进行取号,系统有序分配号子。
举例我们日常银行办理业务时候,在取号机上面显示的就是不同的队列:
- 对私业务
- 对公业务
用户可以根据自己的实际情况,选择对应的队列进行取号。
服务窗口
同一个队列,可以有多个服务窗口,比如上面银行的例子,对私业务目前有 100 个人领取了号子,用户分别拿到了 1-100 这100个号。
银行为了提高业务办理的效率,就会设置多个窗口来同时办理对私业务(同一个队列),假如说银行开了 6号、7号、8号 3个窗口来办理对私。
那么,多个服务窗口,是共享同一个队列的,假如当前6号窗口在办理 71 号顾客,那么 7号窗口进行呼叫下一个服务客户的时候,就是 72号顾客,8号窗口进行呼叫下一个服务客户的时候,就是 73号顾客。
在后台相关api接口中,字段 serviceWindow 参数值得就是服务窗口
号子
号子就是用户在某一个队列,通过取号接口,获取到的系统分配的一个针对当前队列唯一的一个受理序号。
添加队列
名称
队列名称,前端接口可获取到当前系统所有队列,根据业务需要在网页、app、小程序端显示,供用户选择进行取号。
排序
这个只是影响到前端队列列表接口返回到队列数据到先后次序,并不是队列本身到排序。
数字越小越靠前
预计完成时间
每个号子的预计完成时间,填写这个信息,方便您在前端用户取号的时候,帮助用户预算排队需要的时候,甚至在号子小票打印的时候,把预计排队时间也打印出来。
队列说明
该信息也会在前端队列列表接口体现出来,方便您展示给用户查看
取号限额
有的业务场景,一个队列需要限制服务人数,超过这个数量,用户就无法再取号了
时效
如果设定了开始时间和截止时间,那么只有在规定的时间范围内才可以进行取号
队列操作
重置队列
通过该操作,可以初始化某一个队列:
- 当前办理号子设置为0
- 当前共取号总数重置为0
- 所有已领取但是未服务的号子,标记为已过号
重置以后,用户可以根据队列的设置重新取号
获取某服务窗口当前服务号子
通过传入队列ID,以及服务窗口名称,可以获取到当前服务窗口正在服务的号子,接口返回示例:
{ "code": 0, "data": { "log": { "id": 322, "mobile": "", "number": 1, "serviceWindow": "1", "status": 1, "statusStr": "受理中", "typeId": 180, "uid": 1679490 }, "type": { "curNumber": 1, "dateBegin": "2020-09-27 18:48:10", "id": 180, "minitus": 10, "name": "对私业务", "numberGet": 1, "status": 0, "statusStr": "正常" } }, "msg": "success" }
如果当前服务窗口没有在服务的号子,或者说这个接口传入的 serviceWindow 参数是一个全新的窗口名称,那么接口将不会返回 log 数据对象,这个时候,这个窗口需要先执行一次 “过号” 操作,系统就会给其分配一个号子让其服务。
过号
服务窗口首次加入队列需要先执行过号操作;
当前轮到的号子,多次呼叫以后无人响应,可根据贵司实际业务规定,执行过号操作;
过号操作后,被执行的号子状态会变为已过号,且无法继续享受服务,请在 UI交互上引导用户重新取号;
呼叫下一个
执行该操作后,当前服务的号子被标记为已服务,同时给当前服务窗口分配所属队列的下一个号子。
强制修改号子状态
在后台取号列表中,可强制修改某个号子为已完成或者已过号状态。