名词解释

队列

同一个队列，单独维护一个单独的序号，每个用户针对同一个队列进行取号，系统有序分配号子。

举例我们日常银行办理业务时候，在取号机上面显示的就是不同的队列：

  • 对私业务
  • 对公业务

用户可以根据自己的实际情况，选择对应的队列进行取号。

服务窗口

同一个队列，可以有多个服务窗口，比如上面银行的例子，对私业务目前有 100 个人领取了号子，用户分别拿到了 1-100 这100个号。
银行为了提高业务办理的效率，就会设置多个窗口来同时办理对私业务（同一个队列），假如说银行开了 6号、7号、8号 3个窗口来办理对私。

那么，多个服务窗口，是共享同一个队列的，假如当前6号窗口在办理 71 号顾客，那么 7号窗口进行呼叫下一个服务客户的时候，就是 72号顾客，8号窗口进行呼叫下一个服务客户的时候，就是 73号顾客。

在后台相关api接口中，字段 serviceWindow 参数值得就是服务窗口

号子

号子就是用户在某一个队列，通过取号接口，获取到的系统分配的一个针对当前队列唯一的一个受理序号。

添加队列

image.png

名称

队列名称，前端接口可获取到当前系统所有队列，根据业务需要在网页、app、小程序端显示，供用户选择进行取号。

排序

这个只是影响到前端队列列表接口返回到队列数据到先后次序，并不是队列本身到排序。
数字越小越靠前

预计完成时间

每个号子的预计完成时间，填写这个信息，方便您在前端用户取号的时候，帮助用户预算排队需要的时候，甚至在号子小票打印的时候，把预计排队时间也打印出来。

队列说明

该信息也会在前端队列列表接口体现出来，方便您展示给用户查看

取号限额

有的业务场景，一个队列需要限制服务人数，超过这个数量，用户就无法再取号了

时效

如果设定了开始时间和截止时间，那么只有在规定的时间范围内才可以进行取号

队列操作

重置队列

通过该操作，可以初始化某一个队列：

  • 当前办理号子设置为0
  • 当前共取号总数重置为0
  • 所有已领取但是未服务的号子，标记为已过号

重置以后，用户可以根据队列的设置重新取号

获取某服务窗口当前服务号子

image.png

通过传入队列ID，以及服务窗口名称，可以获取到当前服务窗口正在服务的号子，接口返回示例：

  1. {
  2.     "code": 0,
  3.     "data": {
  4.         "log": {
  5.             "id": 322,
  6.             "mobile": "",
  7.             "number": 1,
  8.             "serviceWindow": "1",
  9.             "status": 1,
  10.             "statusStr": "受理中",
  11.             "typeId": 180,
  12.             "uid": 1679490
  13.         },
  14.         "type": {
  15.             "curNumber": 1,
  16.             "dateBegin": "2020-09-27 18:48:10",
  17.             "id": 180,
  18.             "minitus": 10,
  19.             "name": "对私业务",
  20.             "numberGet": 1,
  21.             "status": 0,
  22.             "statusStr": "正常"
  23.         }
  24.     },
  25.     "msg": "success"
  26. }

如果当前服务窗口没有在服务的号子，或者说这个接口传入的 serviceWindow 参数是一个全新的窗口名称，那么接口将不会返回 log 数据对象，这个时候，这个窗口需要先执行一次 “过号” 操作，系统就会给其分配一个号子让其服务。

过号

服务窗口首次加入队列需要先执行过号操作；
当前轮到的号子，多次呼叫以后无人响应，可根据贵司实际业务规定，执行过号操作；

过号操作后，被执行的号子状态会变为已过号，且无法继续享受服务，请在 UI交互上引导用户重新取号；

呼叫下一个

执行该操作后，当前服务的号子被标记为已服务，同时给当前服务窗口分配所属队列的下一个号子。

强制修改号子状态

在后台取号列表中，可强制修改某个号子为已完成或者已过号状态。

前端查看队列进度

image.png