"api工厂" 使用手册

api接口开箱即用,云后台管理,助力前端,解放后端开发;

不懂编程也能独立开发应用,小步快跑,快速创业!

旨为更懂你!

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

名词解释


队列


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


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

  • 对私业务
  • 对公业务


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


服务窗口


同一个队列,可以有多个服务窗口,比如上面银行的例子,对私业务目前有 100 个人领取了号子,用户分别拿到了 1-100 这100个号。

银行为了提高业务办理的效率,就会设置多个窗口来同时办理对私业务(同一个队列),假如说银行开了 6号、7号、8号 3个窗口来办理对私。


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


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


号子


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


添加队列


image.png


名称


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


排序


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

数字越小越靠前


预计完成时间


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


队列说明


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


取号限额


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


时效


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


队列操作


重置队列


通过该操作,可以初始化某一个队列:

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


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


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


image.png


通过传入队列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交互上引导用户重新取号;


呼叫下一个


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


强制修改号子状态


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


前端查看队列进度


image.png

Copyright © 杭州于芯科技有限公司

浙ICP备15041833号