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. 初始化数据

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

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

1.3.3. 版本比对

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

1.3.4. 更新父pom.xml

modules 增加 <module>ms-morganization</module>
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所在模块的目录，这里是D:\work\gov\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/}方式。同时需要将模版文件夹template与static目录也同步到服务器

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. 从外部导入数据到内容表时，注意需要初始化的字段，否则会导致无法静态化

content_type 不能为NULL ，如果为空应该为空串
content_display 不能为NULL, 应设置为默认0
del 默认0
category_ids 不能为NULL,这里记录着文章所有的父栏目ID
content_style 不能为NULL,这里关系到静态化生成目录，如果为空会导致静态文件404
progress_status 应该默认为终审通过
has_list_html、has_detail_html 应为0（未被静态化标识）
导入数据后需要重启服务并在静态化重新刷一下缓存或在缓存管理删除缓存并重新缓存

[!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. 如何切换缓存类型为Redis

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

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

ShiroConfig：securityManager，defaultWebSessionManager，singleSessionControlFilter

1.20. 模板上传失败问题

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

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

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

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

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

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

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

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

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

1.24. 文章新建、审核、发布的流程说明

1.24.1. 文章新建：

角色需要分配文章管理的文章新增权限，并且在栏目权限管理中分配具体拥有哪些栏目的权限，分配好后该角色即可在这些具体栏目下发布新文章。

1.24.2. 审核：

需要开启审核开关，并且给具体栏目配置完整审批，否则在未配置的栏目下发布的新文章不会进入审批流程。

配置时，每个审批节点至少勾选一名角色，为确保审批流程中这篇文章能正常走到终审节点，漏勾选的数据会被认为是不合法的。

上述配置完成后，该栏目发布的新文章将会是草稿状态，提交审核会进入待审文章等待审核，管理员可以进入待审文章界面对文章进行审核。前提是该栏目的审批配置中某个审批节点勾选了该管理员所属角色，并且角色拥有提交审核、审批等相关权限。

支持设置不同审批级别：审批设置相同的角色，就能实现审批跳级；如一、二审设置同一角色，该角色审批通过后，直接进行三审；

1.24.3. 发布：

文章发布到网站需要进行静态化操作，静态化只会选择“终审通过”以及被允许显示的那些文章。

若开启自动静态化，则文章审核通过后会自动发布到网站。如果是手动静态化，则角色需要有相关权限。

1.24.4. 关于审批的角色配置：

一个角色可以对文章进行审批，需要拥有的权限：内容管理中的待审文章权限

审批配置中对应栏目要细分勾选角色的审批权限；

如果需要对一个角色对其进行授权配置：

.新建一个角色，拥有审批权限，以及栏目权限管理中的栏目权限。且对应建立此角色的管理员。
在栏目权限管理中，对此角色添加栏目对应权限。
在审批配置中，对此栏目进行配置勾选。
打开审批开关。

1.24.5. 定时发布

新增文章时设置发布时间配合定时调度能够实现文章定时发布功能

注意：发布时间按天计算，只能预发布明天及以后的文章定时调度配置每天凌晨执行静态化首页、栏目、文章

1.24.6. XSS过滤配置

在稳定后上线前，建议把XSS过滤配置中的拦截路径调整好，删除有关/ms/**，/**此类路径。

1.24.7. 文件上传路径不符合预期

多次上传同一张图片时，后续的上传将直接引用第一次上传时系统产生的路径；更换图片不会影响其他地方对该图片的引用；

1.24.8. 进入缓存管理异常

1、如果缓存管理使用的是redis，检查redis连接是否正常 2、如果是开启集团站群的情况，首先站群配置中关闭站群，然后缓存管理清空缓存；再开启站群，缓存管理中刷新缓存；建议开发阶段确定是否要使用站群避免此情况！