1. 企业版、政务版

1.1. 企业版、政务版没有store入口

在后续的企业版和政务版中我们取消了store功能,store主要面向开源版本和开发版本,企业版及政务版的数据结构和开源版有差异,会使得其数据结构被store中某些插件下载时执行的DDL语句破坏。
因此建议使用开源版本进入store下载模板然后再导入到企业版和政务版中。

1.2. 代码更新

首先第一次下载源代码之后,请务必通过git仓库管理好下载的源代码,平台不定期会更新订单中的代码,如遇到技术专员提示升级代码,可以通过当初平台绑定的订单信息下载最新的源代码,直接覆盖本地的代码,再通过仓库比对的方式进行查看更新的部分。

1.3. 插件依赖

平台选配的插件通过沟通群技术单独提供,包括插件的sql文件、菜单json、源代码。
组织机构为例:

将插件文件夹直接复制到工程目录里面

1.3.1. 修改/pom.xml与/ms-mcms/pom.xml 增加插件依赖

[!tip] 如果还存在页面404问题,请重新编译项目重启,推荐使用默认maven配置以及mvn命令行重新编译,避免ide环境问题导致编译失败

1.3.2. 初始化数据

  1. doc/ddl.sql 表机构
  2. doc/init.sql 初始化数据,插件依赖的初始化数据
  3. doc/data.sql 演示数据,如果不需要可以不执行
  4. doc/organization.json 菜单json,复制json直接在菜单导入

[!tip]doc下面文件具体每个插件数量不一样,具体以提供的为准

1.3.3. 版本比对

推荐用户下载代码后直接发布到自己的git仓库,后续下载代码覆盖本地与git仓库进行代码比对。数据库的更新比对方式,可以通过创建新的数据并导入最新SQL脚本,通过Navicat进行结构比对。

1.3.4. 更新父pom.xml

  1. modules 增加 <module>ms-morganization</module>
  2. dependencies 增加依赖
<dependency>
    <groupId>net.mingsoft</groupId>
    <artifactId>ms-morganization</artifactId>
    <version>${ms.version}</version>
</dependency>

1.3.5. 更新ms-mcms\pom.xml

dependencies 增加依赖

<dependency>
    <groupId>net.mingsoft</groupId>
    <artifactId>ms-morganization</artifactId>
    <version>${ms.version}</version>
</dependency>

1.4. 后台页面404、模板管理读取不到模板文件、模板上传到错误路径等

排除方法:设置working directory

[!tip]单项目多模块下启动时候必须设置 Working directory 目录(MSApplication.java所在的目录,这里是ms-mcms),然后重启项目。


检查ms-mcms/pom.xml配置,注释掉排除配置

1.5. 生成文章内容为空

一般是缓存数据被清空导致,先点击清空缓存,再点击刷新缓存

[!tip]系统非正常重启都会导致缓存丢失,例如:linux下通过kill 结束进程,通常推荐重启系统之后都需要重新缓存一下

1.6. 快速去掉铭软相关标识与引导信息

点击 系统设置下的 后台UI配置,可以快速设置登陆界面、后台logo、后台的信息提示

[!tip]如需要隐藏表单上的引导信息,可以通过关闭 隐藏信息提示达到效果

1.7. 政务版 发布到 功能

在多皮肤的基础上增加了发布到,可以实现例如 内网数据只在内网显示、外网只在外网显示。

[!tip]如果修改了字典模版类型的数据,需要应用设置更新保持,栏目模版,文章的发布到进行更新同步

1.8. 需要将静态文件同步到另外一台服务器使用(后台访问的地址与前台用户访问页面地址不一致)

由于{ms:global.url/}{ms:global.host/}都是会获取后台系统的实际地址,导致部署的时候页面中存在http://xxx这种绝对地址,如果静态化后的页面需要分发到其他服务器或访问地址不一致,统一去掉模版中的{ms:global.url/}{ms:global.host/}标签,改用html/{ms:global.template/}方式。同时需要将模版文件夹templatestatic目录也同步到服务器

1.9. 政务版 企业版 停用默认账号

先登陆后台通过默认msopen账号创建一个账号,再在安全设置->账号安全禁用默认账号角色

1.10. 数据量大静态化慢

如果因为数据量大导致静态化慢,可以把栏目列表模版修改为异步请求大方式获取,这样就可以减少栏目列表页面的生成。

<!--列表-->
<ul>
    <li v-for="content in contents">
        {{content.title}}
    </li>
</ul>
<!--分页-->
<el-pagination background @current-change="handleCurrentChange" :page-size="pageSize" :current-page.sync="pageCur" layout="prev, pager, next, jumper" :total="pageTotal"></el-pagination>

<script>
var app = new Vue({
    el: '#app',
    data: {
        //当前页数
        pageCur: 1,
        //每页文章条数
        pageSize: 20,
        //页数总数
        pageTotal: 0,
        contents: [],
    },
    methods: {

        handleCurrentChange: function(val) {
            this.list(val)
        },
        list: function(pageNo) {
            var that = this
            ms.http.post('/lh/cms/inSiteContent/list.do ', {
                typeid: '${field.typeid}',
                pageSize: that.pageSize,
                pageNo: that.pageCur,
                orderby: 'date',
                order: 'desc',
                net: 'insite',
            }).then(function(data) {
                if (data.result) {
                    that.contents = data.data.rows
                    that.pageTotal = data.data.total
                }

            })
        }
    },
    mounted: function() {
        this.list()
    },
})
</script>

1.11. 自动静态化

启用开关,在涉及到文章变动如新增修改删除分发等情况下,会自动静态化首页、相关栏目页、文章详情页。

[!tip]生产环境推荐开启此功能,可以不用手动静态化页面。

1.12. 多皮肤

不同的皮肤在html文件夹下会生成对以模版名称命名的文件夹,例如:html/a模版 、html/b模版

1.13. 因防火墙、安全狗、WAF之类的过滤导致文章保存失败

如果本地开发环境保存没有问题,上线部署后产生了发布文章的数据不完整(例如大于多少文字后无法保存),建议检查环境配置,如果没有防火墙、安全狗、WAF之类的配置,再检查一下容器是否限制了传送数据的长度,下面以东方通为例截图:

1.14. 从外部导入数据到内容表时,注意需要初始化的字段,否则会导致无法静态化

  1. content_type 不能为NULL ,如果为空应该为空串

  2. content_display 不能为NULL, 应设置为默认0

  3. del 默认0

  4. category_ids 不能为NULL,这里记录着文章所有的父栏目ID

  5. content_style 不能为NULL,这里关系到静态化生成目录,如果为空会导致静态文件404

  6. progress_status 应该默认为 终审通过

  7. has_list_html、has_detail_html 应为0(未被静态化标识)

  8. 导入数据后需要重启服务并在静态化重新刷一下缓存或在缓存管理删除缓存并重新缓存

[!tip] 外来文章迁移进系统时应该同步到缓存及es中,在保存成功后回调缓存文章方法及es同步文章方法。

1.15. 大文件上传

大文件上传推荐第三方专业存储平台,如七牛云存储,如果上传文件到服务器可以考虑直接ftp上传

1.16. 静态化提示后台正在静态化问题

1.开发环境检查模板可以适当减少文章数据量,手动生成时不必多次点击,后台会一直执行程序。

2.线上环境请开启自动静态化,具体操作参考本页面 '自动静态化' 问题。

[!tip] 静态化是多线程操作,多次点击会消耗大量线程,点击生成一次就可以,后台会持续生成静态文件直至结束

1.17. 动态静态化读取模板有误

1.动态静态化作用主要是让开发者快速调整模板,不需要去手动静态化查看修改模板后的效果,在生产环境建议不要开启!

2.动态解析会默认读取自定义字典里模板类型的第一个,排序不对会导致错误选择模板类型。皮肤风格会选择第一个模板类型对应的在应用设置里绑定的皮肤风格,确认都无误后再在静态化配置里开启动态静态化解析,通过ip+/mcms/index.do的方式访问。

1.18. 修改加密算法后登录失败

修改加密算法后会使管理员密码失效,更改后需第一时间按以下步骤进行操作:
1.在管理员管理界面修改一名其他超级管理员的密码,
2.重启系统,
3.用已修改的超级管理员登录,恢复其他管理员密码数据。

[!tip] 尽量在拿到代码时确定使用的密码加密方式,避免修改加密算法,同时修改安全设置的权限避免给到普通管理员。

1.19. 文章缓存问题

1.遇到文章预览、静态化时模板报日期格式转换错误以及页面取不到文章数据等常见情况基本都是缓存问题引起的,

如出现下图报错需要在系统设置---->缓存管理 里进行刷新缓存,然后重新静态化即可。

2.文章缓存是缓存在 如ehcache或Redis(企业版不支持)中,并非缓存至本地,各个管理员账号缓存数据共通。

1.20. 如何切换缓存类型为Redis

1.在yml配置中type改成redis
2.放开redis配置注释
3.配置自己正确的redis链接配置

4.若需要使用redis共享session,要在ShiroConfig中将部分注释的代码放开(有多处代码需改动,需注释上一行代码启用红框代码),示例如下

1.21. 模板上传失败问题

模板上传失败通常是因为zip包中含有文件上传配置中未声明的文件类型如js、txt等,建议检查下压缩包中文件类型是否全部补充完整。遇到其他文件上传失败也可以先检查下是否没有配置文件类型被允许上传或者上传大小超过限制。

zip压缩时,需要选择 ‘存储‘ 方式进行压缩,否则由于压缩算法不同也可能导致上传失败。参考 上传模板

1.22. 更新自定义配置模型的Json数据

需要更新自定义模型,有两种方式。可以直接在原项目的基础上进行修改。保存之后重新进行导入即可。如果没有原项目,可以拖一个和原先模型命名一致的表单。且标题和字段名和原模型一致。

1.23. 通过绑定内外网模板,不能限制内外网访问

设置内外网模板后,并非直接绑定内外网。通过模板配置,可以生成两套不同的样式和皮肤。在不同的目录下,以内外网模板命名静态化生成两套页面。栏目绑定对应模板,通过选择文章发布到,可以区分文章生成的位置。如果需要内外网配置,需要服务器允许且配置。例如允许外网IP访问其中某一个文件夹。

[!tip]如需内外网使用同一个模板,也需要区分模板名称。如果未使用内网模板,可以不进行设置。

1.24. 附属栏目只显示于当前子栏目

发布文章可勾选附属栏目,文章会同时显示于附属栏目之中,并参与分页。但是附属栏目只支持选中的栏目,其父栏目之中不显示此文章。

Copyright © mingsoft.net 2021 all right reserved,powered by Gitbook该文件修订时间: 2023-01-31 17:32:55

results matching ""

    No results matching ""

    results matching ""

      No results matching ""