请输入
菜单

38、校外人员进出校

1、业务综述

功能简介
校外人员进出校也称访客管理,该应用提供对外来人员进校实行申请、审批和备案管理流程,校外人员需进出校时,由校内归口单位教职工或本人发起审批流程,经部门负责人审核,保卫处备案后系统会给访客推送一个入校二维码,访客可凭电子二维码进出校园。

对校外人员进校、出校实行"一人一码",凭二维码出入校门,进出校由门卫对二维码的有效性进行验证,并保留进出校记录,系统中可查询访客进出校台帐。
模块简介

菜单名称

用户角色

支持终端

功能说明

基础信息

应用管理员

PC

应用管理员配置系统运行基本参数和数据字典。

入校申请

教职工

PC、移动

教职工填写校外人员信息、入校信息提交单位和保卫处审核。

入校审核

单位管理员、保卫处

PC、移动

审核校外人员入校申请;审核通过后向校外人员发送入校电子凭证。

校外人员进出校

校外人员

移动

校外人员出示进出校二维码。

进出校核验

保卫人员

移动

扫描校外人员进出校二维码,核验进出校信息。

校外人员管理

应用管理员

PC

管理员管理和查询校外人员,可取消校外人员进校凭证

进出校查询

应用管理员

PC

管理员查询校外人员进出校记录。

校外人员统计

应用管理员

移动

可统计校外人员申请人数、申请车辆、进校人数、出校人数和异常人数等

访客登录

访客

移动

访客可自行提交入校申请,同时也可以查看审批记录,最终审批通过后会以短信的形式将二维码发送给访客。

2、业务表数据说明

T_OFFCAMPUS_PERSON_SYSTEM (系统配置表)

字段名

中文名

类型

主键

可空

备注

WID

主键

VARCHAR(32)

 

 

FXEWMYXQ

分享二维码有效期

VARCHAR(32)

 

 

SQSM

申请说明

VARCHAR(3000)

 

 

SQSMYDSJ

申请说明阅读时间

VARCHAR(32)

 

 

AQCNS

安全承诺书

VARCHAR(3000)

 

 

T_OFFCAMPUS_FLOW_PROMPT (提示信息表)

字段名

中文名

类型

主键

可空

备注

WID

主键

VARCHAR(50)

 

 

PROMPT_TITLE

提示标题

VARCHAR(100)

 

 

PROMPT_FLOW_NODE

提示节点

VARCHAR(50)

 

 

PROMPT_INFO

提示内容

BLOB

 

 

IS_USE

是否使用

VARCHAR(10)

 

 

T_OFFCAMPUS_PERSON_CHECKIN_DIC (字典表)

字段名

中文名

类型

主键

可空

备注

WID

主键

VARCHAR(64)

 

 

CODE

代码

VARCHAR(32)

 

 

NAME

名称

VARCHAR(256)

 

 

TYPE

类别

VARCHAR(100)

 

 

IS_USE

是否使用

VARCHAR(32)

 

 

SEQ

排序

DOUBLE(19)

 

 

 

T_OFFCAMPUS_PERSON_CHECKIN (申请信息表)

字段名

中文名

类型

主键

可空

备注

WID

主键

VARCHAR(32)

 

 

USER_ID

学工号

VARCHAR(64)

 

 

USER_NAME

申请人

VARCHAR(64)

 

 

DEPT_CODE

单位代码

VARCHAR(64)

 

 

DEPT_NAME

单位

VARCHAR(128)

 

 

PHONE_NUMBER

联系方式

VARCHAR(64)

 

 

PERSON_TYPE

外来人员类别

VARCHAR(15)

 

 

CAMPUS

进出校区

VARCHAR(32)

 

 

IN_SCHOOL_TIME

预计进校时间

DATETIME(7)

 

 

OFF_SCHOOL_TIME

预计离校时间

DATETIME(7)

 

 

REASON

来校事由

VARCHAR(512)

 

 

PERSON_NUMBER

人数

VARCHAR(32)

 

 

ATTACHMENTS

附件

VARCHAR(50)

 

 

CREATED_AT

登记时间

DATETIME(7)

 

 

CZR

操作人

VARCHAR(32)

 

 

CZZXM

操作者姓名

VARCHAR(64)

 

 

CZRQ

操作日期

DATETIME(7)

 

 

T_OFFCAMPUS_PERSON_INFO (校外人员信息表)

字段名

中文名

类型

主键

可空

备注

WID

主键

VARCHAR(32)

 

 

USER_ID

学工号

VARCHAR(64)

 

 

USER_NAME

申请人

VARCHAR(64)

 

 

GENDER_CODE

性别

VARCHAR(32)

 

 

PHONE_NUMBER

手机号

VARCHAR(32)

 

 

ID_TYPE

联系方式

VARCHAR(64)

 

 

ID_NO

身份证件号

VARCHAR(64)

 

 

HAS_CAR

是否有车

VARCHAR(15)

 

 

CAR_COLOR

车辆颜色

VARCHAR(30)

 

 

PLATE_NO

车牌号

VARCHAR(32)

 

 

CHECKIN_WID

申请表WID

VARCHAR(64)

 

 

IS_PASS

审核状态

VARCHAR(32)

 

 

ABNORMAL_STATE

异常状态

VARCHAR(10)

 

 

REMARK

备注

VARCHAR(3000)

 

 

INTERVENE_TYPE

干预方式

VARCHAR(20)

 

 

CZR

操作人

VARCHAR(64)

 

 

CZSJ

操作时间

VARCHAR(40)

 

 

T_OFFCAMPUS_PERSON_MESSAGE (短信记录表)

字段名

中文名

类型

主键

可空

备注

WID

主键

VARCHAR(32)

 

 

PERSON_WID

校外人员标识

VARCHAR(64)

 

 

LONG_URL

长链接

VARCHAR(150)

 

 

SHORT_URL

短链接

VARCHAR(150)

 

 

TYPE

类别

VARCHAR(50)

 

 

RECEIVER_USER_ID

短信接收人工号

VARCHAR(65)

 

 

RECEIVER_PHONE

短信接收人电话号码

VARCHAR(50)

 

 

RECEIVER_NAME

短信接收人姓名

VARCHAR(50)

 

 

MESSAGE_CONTENT

短信内容

VARCHAR(200)

 

 

SEND_AT

发送时间

VARCHAR(32)

 

 

SHORT_URL_SUFFIX

短链接后缀

VARCHAR(20)

 

 

 

T_OFFCAMPUS_PERSON_QRREC (二维码表)

字段名

中文名

类型

主键

可空

备注

WID

主键

VARCHAR(64)

 

 

USER_ID

学工号

VARCHAR(64)

 

 

USER_NAME

申请人

VARCHAR(64)

 

 

DEPT_CODE

单位代码

VARCHAR(64)

 

 

DEPT_NAME

单位

VARCHAR(128)

 

 

PHONE_NUMBER

手机号

VARCHAR(64)

 

 

CZZ

操作人

VARCHAR(64)

 

 

CZZXM

操作者姓名

VARCHAR(128)

 

 

CZRQ

操作日期

DATETIME(7)

 

 

T_OFFCAMPUS_PERSON_RECORD (通行记录表)

字段名

中文名

类型

主键

可空

备注

WID

主键

VARCHAR(64)

 

 

PERSON_WID

人员标识

VARCHAR(64)

 

 

IN_SCHOOL_TIME

入校时间

DATETIME(7)

 

 

OFF_SCHOOL_TIME

离校时间

DATETIME(7)

 

 

TYPE

类别

VARCHAR(32)

 

 

CZZ

操作人

VARCHAR(64)

 

 

CZZXM

操作者姓名

VARCHAR(64)

 

 

CZRQ

操作日期

DATETIME(7)

 

 

3、配置说明

3.1、权限配置

功能权限

建议群组

基础信息

应用管理员

入校申请

教职工

入校审核

单位管理员、保卫处

校外人员进出校

校外人员

进出校核验

保卫人员

校外人员管理

应用管理员

进出校查询

应用管理员

校外人员统计

应用管理员

3.2、底座基础配置(重要)

1、emap.properties

1.1 配置文件,增加匿名配置:

# 自定义认证

auth.loginHelpers=header,special

auth.special.authHelper=emapfunauth/speFunAuth

 

# 轻服务域名及文根

lwpub.context.url=http://xwfw.wisedu.com/qljfwapp

 

# 匿名配置

auth.ignores=/sys/emapcomponent/*/*/*,/sys/lwWiseduOffcampusPerCheckin/*default/guest.do,/sys/emapflow/tasks/queryFlowState.do,/sys/lwWiseduOffcampusPerCheckin/modules/guest/*,/sys/lwWiseduOffcampusPerCheckin/modules/guest.do,/sys/lwWiseduOffcampusPerCheckin/api/*,/sys/lwWiseduOffcampusPerCheckin/w/*,/sys/lwWiseduOffcampusPerCheckin/mob/*,/sys/lwpub/mobile/api/public/*

 

#微信公众号的配置,对应appId、appSecret

lwpub.wechat.type=mp

lwpub.wechat.corpid=

lwpub.wechat.corpsecret=

1.2 参数说明

参数名

可选值

参数说明

auth.loginHelpers

header、special、debug、cas

认证方法,这里需要配置为

auth.special.authHelper

emapfunauth/speFunAuth

自定义认证实现类

lwpub.context.url

http://ehall.xx.edu.cn

轻服务域名及文根

auth.ignores

 

毋须认证的地址

lwpub.wechat.type

mp、qy

微信类型,mp=微信服务号,qy=微信企业号

注:通常qy是用于审批端,mp用于访客端

lwpub.wechat.corpid

 

应用id、企业应用ID

lwpub.wechat.corpsecret

 

应用密钥

2、app.properties

2.1 配置文件

文件位置:lwWiseduOffcampusPerCheckin/classes/app.properties

# 短信验证码内容

message_content= \u0024\u007b\u006e\u0061\u006d\u0065\u007d\u0020\u60a8\u597d\u0021\u0020\u60a8\u7684\u5165\u6821\u7533\u8bf7\u5df2\u5ba1\u6838\u901a\u8fc7\uff0c\u8bf7\u70b9\u51fb\u94fe\u63a5\u83b7\u53d6\u51fa\u5165\u6821\u51ed\u8bc1\u3002\u0024\u007b\u0075\u0072\u006c\u007d

lwWiseduOffcampusPerCheckin.dept.leader.groupid=

url.referercheck.ignore=/sys/lwWiseduOffcampusPerCheckin/api/saveSetting.do

antisamy.ignores=/sys/lwWiseduOffcampusPerCheckin/api/saveSetting.do

validatePattern=(?:')|(?:--)|(/\\*(?:.|[\\n\\r])*?\\*/)|(\\b(select|update|union|and|or|delete|insert|trancate|char|into|substr|ascii|declare|exec|count|master|into|drop|execute|script|alert|img|src|link|href|div|span)\\b)

guest.login.cookie.maxAge=3600

api.sign.timestampInterval=300

 

# 验证码发送方式

message.sendTypes=sms

 

# 校园一码通集成所需参数

lwWiseduOffcampusPerCheckin.Sm4=

lwWiseduOffcampusPerCheckin.Sm2=

 

# 微信认证方式

guest.login.wx.oAuth.enable=0

2.2 参数说明

参数名

可选值

参数说明

message_content

 

短信验证码消息模板,unicode格式,可在线编译后设置

http://www.jsons.cn/unicode

lwWiseduOffcampusPerCheckin.dept.leader.groupid

 

受访人领导审批组ID,一定是在授权中的用户组,基于所在部门寻找上级领导

antisamy.ignores

/sys/lwWiseduOffcampusPerCheckin/api/saveSetting.do

需要XSS漏洞检查的URL

validatePattern

 

XSS漏洞检查表达式,正则表达式

guest.login.cookie.maxAge

3600

访客登录会话时长

单位:秒

api.sign.timestampInterval

300

api接口请求的签名超时时间

用于第三方门禁集成在线鉴权所需参数

单位:毫秒

message.sendTypes

sms

发送验证码方式

sms-短信验证码

lwWiseduOffcampusPerCheckin.Sm4

 

IDS7中身份码所需配置密钥

lwWiseduOffcampusPerCheckin.Sm2

 

IDS7中身份码所需配置密钥

guest.login.wx.oAuth.enable

1、2

访客认证方式,默认值0

0-手机号+短信验证码的形式;

1-微信公众号oauth登录方式

3、校区码报表配置

将lwWiseduOffcampusPerCheckin/web/cpt/lwWiseduOffcampusPerCheckin.cpt文件复制到/opt/wiseduAppGroups/qljfwapp/frReport2/WEB-INF/reportlets目录下,报表存放的路径可以自行指定,以底座frReport2/WEB-INF/resources/JZReportletConfig.xml配置为准。
可以参考下面命令。

cp /opt/wiseduAppGroups/qljfwapp/lwWiseduOffcampusPerCheckin/web/cpt/lwWiseduOffcampusPerCheckin.cpt /opt/wiseduAppGroups/qljfwapp/frReport2/WEB-INF/reportlets

3.3、访客预约功能配置(重要)

1、访客预约入口

http://ehall.xxx.edu.cn/qljfwapp/sys/lwWiseduOffcampusPerCheckin/*default/guest.do

 

2、匿名配置

因为访客预约是不需要过IDS、底座认证,所以需要修改qljfw_location、emap.properties文件,开放匿名功能。

需开放URL清单

/sys/lwWiseduOffcampusPerCheckin/mob/*

/sys/lwWiseduOffcampusPerCheckin/api/*

/sys/lwWiseduOffcampusPerCheckin/w/*
# 访客申请的页面和接口地址

/sys/lwWiseduOffcampusPerCheckin/modules/guest.do

/sys/lwWiseduOffcampusPerCheckin/modules/guest/*

/sys/lwWiseduOffcampusPerCheckin/*default/guest.do

/sys/lwWiseduOffcampusPerCheckin/*default/mobile/*
# 轻服务底座相关接口

/sys/lwpub/mobile/api

/sys/lwpub/public/mob

/sys/emapflow/*

/sys/emapcomponent/*

/code/*

新增地址(xmq.20231103)

/qljfwapp/sys/lwWiseduOffcampusPerCheckin/wxLogin/getAppId.do

 

/qljfwapp/sys/lwWiseduOffcampusPerCheckin/wxLogin/getOpenId.do

 

/qljfwapp/sys/lwWiseduOffcampusPerCheckin/wxLogin/callback.do

emap.properties 展开源码

注意检查nginx配置,有些匿名url可能已经开启过了

qljfw_location.conf 展开源码

 

3、审核通后短信相关配置

路径:lwWiseduOffcampusPerCheckin/classes/app.properties

注:下面的 参数message_content是审核通过后向申请人发送预约成功的短信模板。

# 验证码发送方式

message.sendTypes=sms

# 短信验证码内容

message_content= \u0024\u007b\u006e\u0061\u006d\u0065\u007d\u0020\u60a8\u597d\u0021\u0020\u60a8\u7684\u5165\u6821\u7533\u8bf7\u5df2\u5ba1\u6838\u901a\u8fc7\uff0c\u8bf7\u70b9\u51fb\u94fe\u63a5\u83b7\u53d6\u51fa\u5165\u6821\u51ed\u8bc1\u3002\u0024\u007b\u0075\u0072\u006c\u007d

 

4、访客登录页logo修改

文件地址:/qljfwapp/lwWiseduOffcampusPerCheckin/web/public/images/loginGuestLogo.png

5、微信服务号oauth集成

  1. root/emap.properties

lwpub.wechat.type=mp

#微信公众号的配置,对应appId

lwpub.wechat.corpid=

#微信公众号的配置,对应secret

lwpub.wechat.corpsecret=

  1. lwWiseduOffcampusPerCheckin/classes/app.properties

访客微信扫描二维码后是否开启oauth认证,默认0不开启

guest.login.wx.oAuth.enable=1

 

注:配置0默认的手机号+短信验证码的形式;1为微信公众号集成登录方式。

3.4、门禁集成方案

1、宇视道闸

(1)、修改数据库

T_OFFCAMPUS_PERSON_SYSTEM里的QTMJCS的值改为1

(2)、修改配置文件app.properties

具体配置文件在classes/app.properties

#智能速通系统登录URL

 

uniLoginUrl=

 

#系统登录账号

 

uniLoginId=

 

#系统登录密码

 

uniLoginPwd=

 

#新增访客接口地址

 

uniAddVisitorUrl=

 

#添加权限组ID接口地址

 

AddGroupIdsUrl=

 

#添加权限组的ID

 

AddGroupIds=

3.5、一码通集成

校外人员进出校是支持与一码通行集成使用的,但在使用前需要先做系统集成才可使用。

1、配置身份二维码基本信息

针对访客,配置好访客通行口令,不同闸机的口令不同,此口令可用于“策略服务器”时,下发通行指令。

路径:系统配置->认证服务配置->身份二维码配置

2、从minos中获取集成参数

2.1 获取appId、appSecret

路径:应用管理->轻量级服务->详情

2.2 获取网关路径

学校部署网关的域名,格式:协议[http、https] + 域名

http/https://gataway.xxx.edu.cn

3、应用中配置

3.1、对应身份二维码的口令

不同校区的事项权限代码、口令应该不一致,所以需要在访客系统中关联上通行指令。

路径:访客系统->基础信息管理->校区信息设置。

3.2 配置集成参数

启用“校园身份码”,将API地址、appId、appSecret填入表单中。

3.6、使用手册

3.6.1、校外人员基础配置

基础信息配置–基础配置功能

可配置校外人员申请须知、发送短信验证码发送模板等。

3.6.2、访客申请入口

5.1.2版本中新增了访客可以自行发起入校申请的功能,若客户希望将这个地址开放到公众号时,可以提供此地址。

入校申请:http://域名/qljfwapp/sys/lwWiseduOffcampusPerCheckin/*default/guest.do

3.6.3、外来人员类别

适用角色

应用管理员

支持终端

PC

功能描述

提供外来人员类别的管理,管理员可根据学校相关管理规定对外来人员进行分类管理。

3.6.4、校区信息

适用角色

应用管理员

支持终端

PC

功能描述

提供校区信息的管理,管理员需根据学校实际情况维护学校校区信息,同时会为校区生成固定二维码,管理可以下载后打印,也可以批量打印此二维码用于贴在校区的出入口,访客可通过今日校园、微信等扫码后查询自己的通行信息。

图:校区管理列表页

图:出入校二维码下载页

图:新增表单页

 

图:批量打印出入校二维码

3.6.5、干预方式

适用角色

应用管理员

支持终端

PC

功能描述

校外人员入校后,如未按照规定时间出校或未按规定进行离校登记,系统就认为该外来人员为异常人员,管理员或保卫处需要对这类异常进行处理并标记处理方式。干预方式维护功能提供异常人员的处理方式。

3.6.6、外来人员入校申请

适用角色

教职工

支持终端

PC、移动端

功能描述

校外人员需进出校时,由校内归口单位教职工通过该功能进行线上提交申请,同时可以将下载二维码或截图分享给访客,有访客识别后自行申请入校。

  • 申请:填写校外人员基本信息,提交单位和保卫处审核。
  • 编辑:申请若被撤回、草稿、驳回时,用户可重新编辑申请内容并重新提交。
  • 删除:申请若被撤回、草稿、驳回时,用户可直接删除数据。
  • 撤回:当第一个审批人还未进行审批时,申请人可撤销申请,可重新编辑申请内容后再次提交。
  • 查询校外人员:查询本人已经提交进出校的校外人员信息。

3.6.7、外来人员入校审核

适用角色

部门负责人、保卫处

支持终端

PC、移动端

功能描述

系统将获取到当前登录用户所需要办理和已办理的申请记录,办理人可对需要审核的数据进行审核操作;

  • 通过:若审批人认为情况属实,即可同意进入下一步。
  • 退回:将申请记录驳回至申请人;
  • 不通过:将终止流程,申请人将无法再次编辑发起申请。

 

3.6.8、校外人员入校申请

适用角色

校外人员

支持终端

移动

功能描述

管理员可以将访客入校申请的链接挂在公众号、门户等便于查看的地方,也可以通过校内人员将申请链接以二维码的形式分享给访客,方便访客能自行申请入校信息,待相关人员审批通过后,系统会以短信的形式将出入校电子通行证推送给访客;访客也可再次登入系统查看入校申请的审批情况,若审批通过后可直接打开出入校通行证。

图:访客信息登录

图:访客入校登记页

图:出入校电子够通行证

3.6.9、校外人员扫码入校

适用角色

校外人员

支持终端

移动

功能描述

校外人员出入校时可通过今日校园、微信等客户端扫描出入校的固定二维码,系统识别通过后会给出通行的指示,并用于给保卫人员核验,系统上将显示当前用户离校的倒计时及相关重要信息,避免用户伪造,方便保卫人员能快速侦别通行的权限。

图:出入校扫码查询通行权限

图:允许通行 图:不允许通行

3.6.10、校外人员入校通行证

适用角色

校外人员

支持终端

移动

功能描述

校外人员出入校申请审批通过后,系统会通过短信向校外人员发送进校凭证,校外人员凭进校凭证入校。

 

3.6.11、保卫人员核验

适用角色

保卫人员

支持终端

移动

功能描述

校外人员进出校时向保卫人员出示本人进出校二维码由保卫人员核验并记录进出校时间。

3.6.12、外来人员信息查询

适用角色

保卫处

支持终端

PC、移动端

功能描述

校外人员进出校审核通过后,通过该功能可查询所有已经申请的校外人员基本信息和审核情况。

  • 取消预约:保卫处可取消该校外人员的入校申请,取消后校外人员无法打开入校凭证。
  • 发送预约短信:校外人员进出校审批通过系统向校外人员发送入校凭证短信,如遇到特殊情况校外人员没有接收短信或短信丢失时,可通过该功能重复向校外人员发送短信。
  • 干预:校外人员入校后,如未按照规定时间出校或未按规定进行离校登记,系统就认为该外来人员为异常人员,管理员或保卫处通过该功能对这类异常进行处理并标记处理方式。

3.6.13、校外人员进出校查询

适用角色

保卫处

支持终端

PC

功能描述

保卫处可查询到校外人员的进出校记录。

 

3.6.14、校外人员统计

适用角色

保卫处

支持终端

PC

功能描述

保卫处可查询到校外人员的数据统计结果。可统计校外人员申请人数、申请车辆、进校人数、出校人数和异常人数等。

 

上一个
37、信息网络服务-通讯录
下一个
场景化应用实施手册
最近修改: 2024-06-25Powered by