1、业务综述(通知公告)
功能描述
各学校部门通过统一的平台进行授权发布,向师生发布通知,师生则可以通过这个平台统一获得需要的通知公告内容。
师生可以查看所有的校内通知,支持PC和移动端同步查看,并且公告带有附件,支持在线预览和下载,极大地方便通知到达的方式和查看信息的效率。
功能模块
菜单名称 |
用户角色 |
支持终端 |
功能说明 |
栏目管理 |
应用管理员 |
PC |
统一设置栏目属性和栏目发布管理员,进行栏目的发布授权。 |
公告管理 |
应用管理员 |
PC、移动 |
管理对自己有权限的栏目下的公告,支持创建、隐藏、删除、撤回、排序、置顶和查看详情。 |
系统配置 |
应用管理员 |
PC |
管理员配置消息发送方式、提醒内容和是否开启已读模式 |
公告浏览 |
教职工、学生、游客 |
PC、移动 |
学校师生可以所有栏目的公告,支持按照栏目、公告标题和内容搜索、查看详情。 |
业务流程
2、初始化配置(通知公告)
2.1、业务表数据说明
2.1.1、T_LWPS_TZGG_JCPZ (础配置)
列名 |
数据类型 |
长度 |
小数位 |
主键 |
允许空 |
列说明 |
WID |
VARCHAR2 |
40 |
|
√ |
|
wid |
KFTXFS |
VARCHAR2 |
100 |
|
|
|
开放提醒方式 |
TXNR |
VARCHAR2 |
600 |
|
|
√ |
提醒内容 |
KQYDMS |
VARCHAR2 |
3 |
|
|
√ |
开启已读模式 |
CZZ |
VARCHAR2 |
100 |
|
|
|
操作者 |
CZZXM |
VARCHAR2 |
100 |
|
|
|
操作者姓名 |
CZRQ |
DATETIME |
7 |
|
|
|
操作日期 |
CJRQ |
DATETIME |
7 |
|
|
|
操作日期 |
2.1.2、T_LWPS_TZGG_BM(部门)
列名 |
数据类型 |
长度 |
小数位 |
主键 |
允许空 |
列说明 |
WID |
VARCHAR2 |
40 |
|
|
√ |
wid |
GGDM |
VARCHAR2 |
40 |
|
√ |
|
公告代码 |
BMDM |
VARCHAR2 |
40 |
|
√ |
|
部门代码 |
BMMC |
VARCHAR2 |
300 |
|
|
√ |
部门名称 |
TBRQ |
DATE |
7 |
|
|
√ |
同步日期 |
TBLX |
VARCHAR2 |
10 |
|
|
√ |
同步类型 |
CZRQ |
DATE |
7 |
|
|
√ |
操作日期 |
CZZ |
VARCHAR2 |
30 |
|
|
√ |
操作者 |
CZZXM |
VARCHAR2 |
120 |
|
|
√ |
操作者姓名 |
2.1.3、T_LWPS_TZGG_GG(公告)
列名 |
数据类型 |
长度 |
小数位 |
主键 |
允许空 |
列说明 |
WID |
VARCHAR2 |
40 |
|
|
√ |
wid |
GGDM |
VARCHAR2 |
40 |
|
√ |
|
公告代码 |
GGBT |
VARCHAR2 |
600 |
|
|
√ |
公告标题 |
FBBM |
VARCHAR2 |
300 |
|
|
√ |
发布部门 |
LMDM |
VARCHAR2 |
40 |
|
|
√ |
公告栏目 |
FBSJ |
VARCHAR2 |
20 |
|
|
√ |
发布时间 |
YXSJ |
VARCHAR2 |
20 |
|
|
√ |
有效时间 |
GGNR |
CLOB |
4000 |
|
|
√ |
公告内容 |
FBR |
VARCHAR2 |
100 |
|
|
√ |
发布人工号 |
FJ |
VARCHAR2 |
40 |
|
|
√ |
附件 |
LLQX |
VARCHAR2 |
400 |
|
|
√ |
浏览权限 |
GGZT |
VARCHAR2 |
3 |
|
|
√ |
公告状态 |
BY1 |
VARCHAR2 |
3000 |
|
|
√ |
备用1 |
BY2 |
VARCHAR2 |
3000 |
|
|
√ |
备用2 |
BY3 |
VARCHAR2 |
3000 |
|
|
√ |
备用3 |
BY4 |
VARCHAR2 |
3000 |
|
|
√ |
备用4 |
BY5 |
VARCHAR2 |
3000 |
|
|
√ |
备用5 |
BY6 |
VARCHAR2 |
3000 |
|
|
√ |
备用6 |
BY7 |
VARCHAR2 |
3000 |
|
|
√ |
备用7 |
BY8 |
VARCHAR2 |
3000 |
|
|
√ |
备用8 |
BY9 |
VARCHAR2 |
3000 |
|
|
√ |
备用9 |
BY10 |
VARCHAR2 |
3000 |
|
|
√ |
备用10 |
TBRQ |
DATE |
7 |
|
|
√ |
同步日期 |
TBLX |
VARCHAR2 |
10 |
|
|
√ |
同步类型 |
CZRQ |
DATE |
7 |
|
|
√ |
操作日期 |
CZZ |
VARCHAR2 |
30 |
|
|
√ |
操作者 |
CZZXM |
VARCHAR2 |
120 |
|
|
√ |
操作者姓名 |
FBRXM |
VARCHAR2 |
300 |
|
|
√ |
发布人 |
LLCS |
NUMBER |
10 |
0 |
|
√ |
浏览次数 |
SFZD |
VARCHAR2 |
3 |
|
|
√ |
是否置顶 |
ZDSJZ |
VARCHAR2 |
20 |
|
|
√ |
置顶时间值 |
PX |
NUMBER |
5 |
0 |
|
√ |
排序 |
PCURL |
VARCHAR2 |
3000 |
|
|
√ |
PC链接 |
YDURL |
VARCHAR2 |
3000 |
|
|
√ |
移动链接 |
NRLX |
VARCHAR2 |
3 |
|
|
√ |
内容类型 |
DSFB |
VARCHAR2 |
20 |
|
|
√ |
定时发布 |
TXFS |
VARCHAR2 |
100 |
|
|
√ |
提醒方式 |
SFYTZ |
VARCHAR2 |
3 |
|
|
|
是否已通知 |
2.1.4、T_LWPS_TZGG_LLJL(浏览记录)
列名 |
数据类型 |
长度 |
小数位 |
主键 |
允许空 |
列说明 |
WID |
VARCHAR2 |
40 |
|
√ |
|
wid |
GGDM |
VARCHAR2 |
40 |
|
|
√ |
公告代码 |
TBRQ |
DATE |
7 |
|
|
√ |
同步日期 |
TBLX |
VARCHAR2 |
10 |
|
|
√ |
同步类型 |
CZRQ |
DATE |
7 |
|
|
√ |
操作日期 |
CZZ |
VARCHAR2 |
30 |
|
|
√ |
操作者 |
CZZXM |
VARCHAR2 |
120 |
|
|
√ |
操作者姓名 |
LLCS |
NUMBER |
5 |
0 |
|
√ |
浏览次数 |
RYBH |
VARCHAR2 |
40 |
|
|
√ |
人员编号 |
LLRQ |
VARCHAR2 |
20 |
|
|
√ |
浏览日期 |
2.1.5、T_LWPS_TZGG_LM(栏目)
列名 |
数据类型 |
长度 |
小数位 |
主键 |
允许空 |
列说明 |
WID |
VARCHAR2 |
40 |
|
|
√ |
wid |
LMDM |
VARCHAR2 |
40 |
|
√ |
|
栏目代码 |
LMMC |
VARCHAR2 |
600 |
|
|
√ |
栏目名称 |
ZTMS |
VARCHAR2 |
3000 |
|
|
√ |
主题描述 |
LLQX |
VARCHAR2 |
900 |
|
|
√ |
浏览权限 |
BY1 |
VARCHAR2 |
3000 |
|
|
√ |
备用1 |
BY2 |
VARCHAR2 |
3000 |
|
|
√ |
备用2 |
BY3 |
VARCHAR2 |
3000 |
|
|
√ |
备用3 |
BY4 |
VARCHAR2 |
3000 |
|
|
√ |
备用4 |
BY5 |
VARCHAR2 |
3000 |
|
|
√ |
备用5 |
BY6 |
VARCHAR2 |
3000 |
|
|
√ |
备用6 |
BY7 |
VARCHAR2 |
3000 |
|
|
√ |
备用7 |
BY8 |
VARCHAR2 |
3000 |
|
|
√ |
备用8 |
BY9 |
VARCHAR2 |
3000 |
|
|
√ |
备用9 |
BY10 |
VARCHAR2 |
3000 |
|
|
√ |
备用10 |
TBRQ |
DATE |
7 |
|
|
√ |
同步日期 |
TBLX |
VARCHAR2 |
10 |
|
|
√ |
同步类型 |
CZRQ |
DATE |
7 |
|
|
√ |
操作日期 |
CZZ |
VARCHAR2 |
30 |
|
|
√ |
操作者 |
CZZXM |
VARCHAR2 |
120 |
|
|
√ |
操作者姓名 |
SFSY |
VARCHAR2 |
3 |
|
|
√ |
是否使用 |
PX |
NUMBER |
5 |
0 |
|
√ |
排序 |
LMGGSFKZD |
VARCHAR2 |
3 |
|
|
√ |
栏目公告是否可置顶 |
2.1.6、T_LWPS_TZGG_LMQX(栏目权限)
列名 |
数据类型 |
长度 |
小数位 |
主键 |
允许空 |
列说明 |
WID |
VARCHAR2 |
40 |
|
√ |
|
wid |
LMDM |
VARCHAR2 |
40 |
|
|
√ |
栏目代码 |
ZGH |
VARCHAR2 |
40 |
|
|
√ |
职工号 |
XM |
VARCHAR2 |
300 |
|
|
√ |
职工姓名 |
BMDM |
VARCHAR2 |
40 |
|
|
√ |
所在部门 |
TBRQ |
DATE |
7 |
|
|
√ |
同步日期 |
TBLX |
VARCHAR2 |
10 |
|
|
√ |
同步类型 |
CZRQ |
DATE |
7 |
|
|
√ |
操作日期 |
CZZ |
VARCHAR2 |
30 |
|
|
√ |
操作者 |
CZZXM |
VARCHAR2 |
120 |
|
|
√ |
操作者姓名 |
2.1.7、T_LWPS_TZGG_ZD(字典)
列名 |
数据类型 |
长度 |
小数位 |
主键 |
允许空 |
列说明 |
WID |
VARCHAR2 |
50 |
|
|
|
|
TYPE |
VARCHAR2 |
255 |
|
√ |
|
|
VALUE |
VARCHAR2 |
255 |
|
√ |
|
|
DISPLAYVALUE |
VARCHAR2 |
255 |
|
|
√ |
|
TBRQ |
DATE |
7 |
|
|
√ |
|
TBLX |
VARCHAR2 |
10 |
|
|
√ |
|
CZRQ |
DATE |
7 |
|
|
√ |
|
CZZ |
VARCHAR2 |
30 |
|
|
√ |
|
CZZXM |
VARCHAR2 |
120 |
|
|
√ |
|
PX |
NUMBER |
10 |
0 |
|
√ |
|
SFSY |
VARCHAR2 |
1 |
|
|
√ |
|
2.2、修改上传附件大小
如:需要经附件上传大小由5M修改为20M。修改/opt/wiseduAppGroups/qljfwapp/lwPsTzggApp/classes/parammodel/gggl/Q_xrtzggxqbdModel.epm
2.3、配置匿名访问
增加匿名配置,游客可访问通知公告
找到轻服务的nginx配置文件,如qljfwapp_location.conf,将如下的几个地址添加为匿名访问
##通知公告
location ~* /qljfwapp/sys/lwPsTzggApp/index.do{
default_type text/plain;
access_by_lua_file /opt/ids_nginx_config/lua/mod_cas_anonymous.lua;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://qljfw_server;
}
location ~* /qljfwapp/sys/lwPsTzggApp/configSet/noraml/getRouteConfig.do{
default_type text/plain;
access_by_lua_file /opt/ids_nginx_config/lua/mod_cas_anonymous.lua;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://qljfw_server;
}
location ~* /qljfwapp/sys/lwPsTzggApp/ggll/*{
default_type text/plain;
access_by_lua_file /opt/ids_nginx_config/lua/mod_cas_anonymous.lua;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://qljfw_server;
}
location ~* /qljfwapp/sys/lwPsTzggApp/modules/ggll.do{
default_type text/plain;
access_by_lua_file /opt/ids_nginx_config/lua/mod_cas_anonymous.lua;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://qljfw_server;
}
location ~* /qljfwapp/sys/lwPsTzggApp/modules/ggll/*{
default_type text/plain;
access_by_lua_file /opt/ids_nginx_config/lua/mod_cas_anonymous.lua;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://qljfw_server;
}
location ~* /qljfwapp/sys/lwPsTzggApp/lmgl/*{
default_type text/plain;
access_by_lua_file /opt/ids_nginx_config/lua/mod_cas_anonymous.lua;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://qljfw_server;
}
目录:ROOT/emap.properties,如已有下列配置,不必重复配置
#匿名访问地址
auth.ignores=/sys/lwPsTzggApp/index.do,/sys/lwPsTzggApp/configSet/noraml/getRouteConfig.do,/sys/lwPsTzggApp/ggll/,/sys/lwPsTzggApp/modules/ggll.do,/sys/lwPsTzggApp/modules/ggll/
#swhost配置为域名+文根,例如:
swhost=http://域名/qljfwapp
#lwpub.context.url配置为域名+文根,例如:
lwpub.context.url=http://xwfw.wisedu.com/qljfwapp
2.4、公告列表独立页面
可通过url方式,打开某个栏目的公告列表,主要用于在门户中以卡片的方式展现某个栏目的公告列表。
公告列表独立页面,链接地址样例:
http://域名/qljfwapp/sys/lwPsTzggApp/index.do?LMDM=D41CF39A2FE128ADE0530E0510AC3EBC
其中LMDM为数据库T_LWPS_TZGG_LM.LMDM获取具体的栏目代码。
2.5、公告详情独立页面
可通过url方式,打开某个公告详情。
单独跳转时进入公告详情独立页面,链接地址样例:
http://域名/qljfwapp/sys/lwPsTzgg/index.do#/noticeDetail/D4E970BDD274173EE0530E0510ACF706
其中D4E970BDD274173EE0530E0510ACF706为具体公告的代码,获取方式是数据库T_LWPS_TZGG_GG.GGDM获取具体的公告代码。
3、开发文档
3.1、开放接口
3.1.1、获取栏目接口
接口地址: http://ip:port/emap/sys/lwPsTzggApp/lmgl/getColumnList.do
接口请求参数:无
接口请求头: 需要传通知公告对应的Cookie
返回类型: json
内容编码类型: form-data
请求方式: get/post
3.1.2、获取栏目下公告列表
接口地址: http://ip:port/emap/sys/lwPsTzggApp/ggll/getNoticeListByColumnId.do
接口请求参数:
{
columnId: '栏目代码', --栏目代码
pageNum:1, --页码
pageSize: 10 --每页显示记录数
}
接口请求头: 需要传通知公告对应的Cookie
返回类型: json
内容编码类型: form-data
请求方式: get/post
3.1.3、获取公告详情
3.2、开放页面
3.2.1、公告列表页
页面地址: http://ip:port/emap/sys/lwPsTzggApp/index.do?min=1&LMDM={LMDM}#/ggll
注: (1)ip和port 需要修改为现场的域名+上下文
(2){LMDM}修改为需要查看的公告栏目代码
3.2.2、详情页
页面地址:http://ip:port/emap/sys/lwPsTzggApp/index.do?min=1#/noticeDetail/{GGDM}
注: (1)ip和port 需要修改为现场的域名+上下文
(2){GGDM}修改为需要查看的公告代码
4、使用手册
4.1、系统配置
适用角色
应用管理员
支持终端
PC
功能描述
应用管理员统一设置开放提醒方式、已读模式,开放提醒方式是指根据学校可支持的消息通道进行设置,栏目管理员在发布公告时,可设置基于什么方式通知接收人;开启已读模式是指浏览人在浏览通知公告时,系统将记录浏览的痕迹。
4.2、栏目管理
适用角色
应用管理员
支持终端
PC
功能描述
应用管理员统一设置栏目属性和栏目发布管理员,进行栏目的发布授权,支持栏目的拖动排序,更改栏目的展示顺序,每个栏目需要设置是否可以在栏目内做置顶公告。
4.3、公告管理
适用角色
应用管理员
支持终端
PC、移动
功能描述
公告管理员管理对自己有权限的栏目下的公告,支持的操作有按照公告标题和内容搜索、按照公告状态、发布时间进行查询,支持创建、隐藏、删除、撤回、排序、置顶和查看详情。单篇公告可以设置有效时间,到时间自动隐藏。
新建公告时,可选择维护公告内容,或选择添加外部链接。维护公告内容支持编辑文本内容,上传附件;外部链接维护时可添加访问公告的地址,可区别pc和移动端访问内容。
支持消息推送,管理员可选择消息提醒的方式,系统将通过消息提醒可浏览当前公告的所有人员。
图:公告管理
图:新建公告
图:公告排序
4.4、公告浏览
适用角色
教职工、学生、游客
支持终端
PC、移动端
功能描述
学校师生可以查看所有栏目的公告,支持已读标记,确保不漏掉任何一条通知公告;支持按照栏目、公告标题和内容搜索、查看详情。如果公告带有附件,支持常见的word、pdf、excel文件格式的在线预览和下载。