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

# 名词解释 ## 队列 同一个队列，单独维护一个单独的序号，每个用户针对同一个队列进行取号，系统有序分配号子。 举例我们日常银行办理业务时候，在取号机上面显示的就是不同的队列： + 对私业务 + 对公业务 用户可以根据自己的实际情况，选择对应的队列进行取号。 ## 服务窗口 同一个队列，可以有多个服务窗口，比如上面银行的例子，对私业务目前有 100 个人领取了号子，用户分别拿到了 1-100 这100个号。 银行为了提高业务办理的效率，就会设置多个窗口来同时办理对私业务（同一个队列），假如说银行开了 6号、7号、8号 3个窗口来办理对私。 那么，多个服务窗口，是共享同一个队列的，假如当前6号窗口在办理 71 号顾客，那么 7号窗口进行呼叫下一个服务客户的时候，就是 72号顾客，8号窗口进行呼叫下一个服务客户的时候，就是 73号顾客。 在后台相关api接口中，字段 serviceWindow 参数值得就是服务窗口 ## 号子 号子就是用户在某一个队列，通过取号接口，获取到的系统分配的一个针对当前队列唯一的一个受理序号。 # 添加队列  ## 名称 队列名称，前端接口可获取到当前系统所有队列，根据业务需要在网页、app、小程序端显示，供用户选择进行取号。 ## 排序 这个只是影响到前端队列列表接口返回到队列数据到先后次序，并不是队列本身到排序。 数字越小越靠前 ## 预计完成时间 每个号子的预计完成时间，填写这个信息，方便您在前端用户取号的时候，帮助用户预算排队需要的时候，甚至在号子小票打印的时候，把预计排队时间也打印出来。 ## 队列说明 该信息也会在前端队列列表接口体现出来，方便您展示给用户查看 ## 取号限额 有的业务场景，一个队列需要限制服务人数，超过这个数量，用户就无法再取号了 ## 时效 如果设定了开始时间和截止时间，那么只有在规定的时间范围内才可以进行取号 # 队列操作 ## 重置队列 通过该操作，可以初始化某一个队列： + 当前办理号子设置为0 + 当前共取号总数重置为0 + 所有已领取但是未服务的号子，标记为已过号 重置以后，用户可以根据队列的设置重新取号 ## 获取某服务窗口当前服务号子  通过传入队列ID，以及服务窗口名称，可以获取到当前服务窗口正在服务的号子，接口返回示例： ```json { "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交互上引导用户重新取号； ## 呼叫下一个 执行该操作后，当前服务的号子被标记为已服务，同时给当前服务窗口分配所属队列的下一个号子。 ## 强制修改号子状态 在后台取号列表中，可强制修改某个号子为已完成或者已过号状态。 ## 前端查看队列进度