排队 / 叫号 / 取号 模块使用教程

名词解释

 

队列

 

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

 

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

• 对私业务
• 对公业务

 

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

 

服务窗口

 

同一个队列，可以有多个服务窗口，比如上面银行的例子，对私业务目前有 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交互上引导用户重新取号；

 

呼叫下一个

 

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

 

强制修改号子状态

 

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

 

前端查看队列进度