@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/.bak//345/272/224/347/224/250/345/274/200/345/217/221/345/271/263/345/217/260-/345/237/272/347/241/200/345/271/263/345/217/260-/344/275/277/347/224/250/346/224/273/347/225/245/357/274/210/345/215/201/344/270/200/357/274/211/357/274/232/346/266/210/346/201/257/344/270/255/345/277/203.md

@@ -0,0 +1,1096 @@
+---
+title: 应用开发平台使用攻略（十一）：消息中心
+date: 2023.03.30
+categories:
+  - 开发攻略
+  - C.6.9.0
+---
+
+
+
+# 																			 应用开发平台使用攻略（十一）：消息中心
+
+## 1.消息中心使用场景
+
+​			消息中心，顾名思义即通知信息的传达处理系统。目的是让用户需要得到的消息及提醒并进行处理。包括应用通知，系统通知，公告，私信，请求等种类。
+
+## 2.消息中心页面功能使用
+
+### 2.1系统管理-基础配置-消息管理
+
+​	打开系统管理-基础配置-消息管理菜单，如下界面：
+
+​	![image-20210701141739262](.\imgs\消息中心\1-1.png)
+
+消息管理页面板块分三大部分：
+
+一、顶部"**新增消息**"按钮
+
+​		![image-20210701142046404](.\imgs\消息中心\1-2.jpg)
+
+点击"**新增消息**"按钮，进入"新增消息"页面，如下图：
+
+![image-20210701142721599](.\imgs\消息中心\1-5.jpg)
+
+二、左边展示"消息列表"
+
+![image-20210701142211103](.\imgs\消息中心\1-3.jpg)
+
+点击"已发送"，列表数据显示已发送列表。已发送列表包含：已发送的普通消息，已发送的定时消息。
+
+![image-20210701143835931](.\imgs\消息中心\1-6.png)
+
+点击"草稿箱"，列表数据显示草稿列表。草稿列表包含：普通草稿，定时草稿。（带有时钟图标的是定时草稿，不带时钟图标是普通草稿）
+
+![image-20210701143958335](.\imgs\消息中心\1-7.png)
+
+点击"**立即发送**"按钮，将定时草稿复制发信人，收信人，消息标题，消息内容和消息附件立即发送给定时草稿的收件人。
+
+点击"消息模板"，列表数据显示消息模板列表。模板列表显示消息模板数据。
+
+![image-20210701144114105](.\imgs\消息中心\1-8.png)
+
+点击上图中的"**使用模板**"按钮，进入"使用模板"页面。如下图：
+
+![image-20210701150104575](.\imgs\消息中心\1-9.jpg)	
+
+点击"定时发送"，列表数据显示定时发送列表。定时发送 列表包括：1、单次定时发送  （单次定时发送只执行一次发送）2、周期定时发送。 （周期定时发送执行多次发送任务。周期定时发送包括：按年发送、按月发送、按日发送、按周发送）
+
+![image-20210701150552597](.\imgs\消息中心\1-10.jpg)
+
+三、右边展示"消息详情"
+
+![image-20210701142534584](.\imgs\消息中心\1-10.jpg)
+
+#### 2.1.1发送普通消息（非定时发送消息，不点击**"定时发送"按钮**）
+
+​    点击"**插入模板**"按钮，将消息模板的标题、内容、附件以及其他相关内容填充到页面。
+
+![image-20210701151027059](.\imgs\消息中心\1-12.png)
+
+​	点击"**收件人**"按钮，选择所需要发送的收件人。
+
+​	![image-20210701150830526](.\imgs\消息中心\1-11.png)
+
+​	点击"**发送**"按钮，将消息立即发送给所选收件人（可在消息管理-消息列表中查看已发送消息）。
+
+​	点击"**存草稿**"按钮，将消息暂存入草稿（可在消息管理-草稿箱列表查看存入草稿的消息）。
+
+​	点击"**保存模板**"按钮，将消息存入模板（可在消息管理-模板列表查看存入的模板）。
+
+#### 2.1.2发送定时消息（点击"**定时发送**"按钮）
+
+​	点击"**定时发送**"按钮,选择发送周期类型（可选择单次发送和周期发送。单次发送只执行一次，周期发送在截止时间前多次发送）
+
+​	单次发送：
+
+​	![image-20210701151229124](.\imgs\消息中心\1-13.jpg)
+
+​	周期发送：
+
+​	周期发送可选执行周期类型：每年、每月、每日、每周
+
+​    周期类型选择：
+
+​	（1）每年
+
+​			  选择所需要执行的月份、日期、以及小时和分钟之后，选择截止时间。				![1-14](.\imgs\消息中心\1-14.jpg)
+
+​	（2）每月
+
+​			 选择所需要执行的日期、以及小时和分钟之后，选择截止时间。			 ![image-20210701151440629](.\imgs\消息中心\1-15.png)
+
+​	（3）每日
+
+​			  选择所需要执行的小时和分钟之后，选择截止时间。				![image-20210701151518790](.\imgs\消息中心\1-16.png)
+
+​	（4）每周
+
+​			 选择所需要执行星期日期、小时和分钟之后，选择截止时间。			![image-20210701151604456](.\imgs\消息中心\1-17.png)
+
+​		同时生成提示信息。点击"**确定**"按钮，关闭时间选择弹窗，回到"**新增消息**"页面。。
+
+​	    悬浮"**插入模板**"按钮，点击模板标题，将消息模板的标题、内容、附件以及其他相关内容填充到页面。
+
+​		点击"**收件人**"按钮，选择所需要发送的收件人，输入消息标题和内容（同时可添加附件）。
+
+​		点击"**发送**"按钮，生成调度任务，在执行发送时间时发送消息（可在消息管理-定时发送列表中查看已发送消息）。
+
+​		点击"**存草稿**"按钮，将消息暂存入草稿（可在消息管理-草稿箱列表查看存入定时草稿的消息）。
+
+​		点击"**保存模板**"按钮，将消息存入模板（可在消息管理-模板列表查看存入的模板）。
+
+​		定时消息列表对不同周期类型分别显示"**按年**","**按月**","**按日**","**按周**"以及"**单次**"发送标识。
+
+#### 2.1.3 草稿箱-定时发送消息-立即发送
+
+![image-20210629172451906](.\imgs\消息中心\1-7.jpg)		
+
+点击"**立即发送**"按钮，生成一条新的普通消息立即发送给用户。
+
+#### 2.1.3 定时发送-立即发送	
+
+![image-20210701151714886](.\imgs\消息中心\1-18.png)
+
+点击"**立即发送**"按钮，生成一条新的普通消息立即发送给用户。
+
+#### 2.1.4消息编辑
+
+##### 2.1.4.1草稿箱-定时发送草稿编辑
+
+​			具体操作与    **2.1.2  发送定时消息 **   相同
+
+##### 2.1.4.2草稿箱-普通草稿编辑
+
+​       悬浮"**插入模板**"按钮，点击模板标题，将消息模板的标题、内容、附件以及其他相关内容填充到页面。
+
+​		点击"**收件人**"按钮，选择所需要发送的收件人，输入消息标题和内容（同时可添加附件）。
+
+​		点击"**发送**"按钮，将消息立即发送给所选收件人（可在消息管理-消息列表中查看已发送消息）。
+
+​		点击"**存草稿**"按钮，将消息暂存入草稿（可在消息管理-草稿箱列表查看存入草稿的消息）。
+
+​		点击"**保存模板**"按钮，将消息存入模板（可在消息管理-模板列表查看存入的模板）。
+
+##### 2.1.4.3消息模板-模板编辑
+
+​		可修改模板的标题、内容以及附件。
+
+##### 2.1.4.4定时发送-定时发送消息编辑
+
+​		具体操作与    **2.1.2 发送定时消息**  相同
+
+#### 2.1.5消息模板-使用模板
+
+![image-20210629172722696](.\imgs\消息中心\1-11.png)
+
+​	点击"使用模板",进入"使用模板"页面。同时将消息模板的标题、内容、附件以及其他相关内容填充到页面。
+
+![image-20210629172759308](.\imgs\消息中心\1-12.png)
+
+​		 点击"**插入模板**"按钮，将消息模板的标题、内容、附件以及其他相关内容填充到页面。
+
+​		点击"**收件人**"按钮，选择所需要发送的收件人，输入消息标题和内容（同时可添加附件）。
+
+​		点击"**发送**"按钮，将消息立即发送给所选收件人（可在消息管理-消息列表中查看已发送消息）。
+
+​		点击"**存草稿**"按钮，将消息暂存入草稿（可在消息管理-草稿箱列表查看存入草稿的消息）。
+
+​		点击"**保存模板**"按钮，将消息存入模板（可在消息管理-模板列表查看存入的模板）。
+
+#### 2.1.6消息管理-删除
+
+​		将已发送消息、草稿、模板、定时消息（同时删除定时调度任务）从列表中删除。
+
+### 2.2消息提醒
+
+鼠标悬浮铃铛，显示未读消息列表的标题。
+
+![image-20210701151845707](.\imgs\消息中心\1-19.jpg)
+
+点击"**全部已读**"按钮，更改未读消息状态。
+
+点击未读消息标题，进入 未读消息列表。
+
+![image-20210701151930471](.\imgs\消息中心\1-20.jpg)
+
+![image-20210701152013966](.\imgs\消息中心\1-21.jpg)
+
+点击顶部"**全部已读**",更改未读消息状态。
+
+![image-20210701152050201](.\imgs\消息中心\1-22.jpg)
+
+鼠标点击附件，可进行下载。
+
+![image-20210701152217786](.\imgs\消息中心\1-23.png)
+
+#### 2.2.1消息提醒集成
+
+##### 2.2.1.1.消息提醒统计
+
+第一步、修改**cloud-system-portal**程序包中的**top-nav.vue**文件
+
+在下方代码块之前
+
+```vue
+	 <el-popover placement="bottom" width="270" trigger="hover">
+        <v-loginInfo></v-loginInfo>
+        <div id="logInfo" class="logInfo" slot="reference">
+          <span
+            :style="rigthMenubg"
+            class="tempo-api-right-menu-login-icon"
+          ></span>
+        </div>
+      </el-popover>
+```
+
+加入以下代码：
+
+```vue
+	<!--jumpMessageList为跳转页面函数-->
+    <div @click="jumpMessageList()" class="header-opt-infor item" style="">
+    <!--notReadCoun为统计数据-->
+        <el-badge
+          :value="this.notReadCount == 0 ? '' : this.notReadCount"
+          :max="99"
+          v-show="this.isAdmin == 0 ? true : false"
+          type="primary"
+          style="right: 16px;"
+        >
+        <!--v-messageList为未读列表组件-->
+          <el-popover placement="bottom" width="280" trigger="hover">
+            <v-messageList
+              :notRead="this.notReadCount"
+              v-show="this.notReadCount == 0 ? false : true"
+            ></v-messageList>
+            <i slot="reference" class="el-icon-message-solid" size="small"></i>
+          </el-popover>
+        </el-badge>
+      </div>
+```
+
+在<script></script>中引入des-utils，如下：
+
+```
+import DesUtils from "../../common/des-utils";
+```
+
+在data中加入
+
+```js
+	  //未读统计
+	  notReadCount: 0,
+      //定时轮询定时器
+      msgTimer: "",
+       //是否显示铃铛控制器
+      isAdmin: 0,
+      //定时轮询熔断机制
+      reqCountBool: true,
+      reqList: true
+```
+
+在method加入
+
+```js
+	//点击消息标题或提示铃铛，页面跳转函数
+	jumpMessageList() {
+      let routeUrl = this.$router.resolve({
+        path: "/system-manage/message/messageList/view"
+      });
+      window.open(routeUrl.href, "_blank");
+    },
+    //铃铛提示显示控制函数，判断权限
+     isTenancy(authoritiesIds) {
+      let _this = this;
+      let count = 0;
+      let roleList = authoritiesIds;
+      for (let i = 0; i < roleList.length; i++) {
+        if (roleList[i] === "TENANCYGLY") count++;
+      }
+      if (count === 0) {
+        _this.isAdmin = 0;
+        return false;
+      } else {
+        _this.isAdmin = 1;
+        return true;
+      }
+    },
+    //获取用户userId
+    //定时轮询查询未读统计个数
+    getSession() {
+      let _this = this;
+      axios["system-manager"].post("/api/ou/user/session").then(res => {
+        if (res.userId == "admin") _this.isAdmin = 1;
+        else if (this.isTenancy(res.authoritiesIds)) {
+        } else _this.isAdmin = 0;
+        _this.userName = res.name;
+        _this.code = DesUtils.strEnc(res.userId, "a1", "a2", "a3");
+        _this.reqCountBool = true;
+        _this.reqList = true;
+        _this.getCount();
+      });
+      _this.msgTimer = setInterval(function() {
+        if (_this.reqList) {
+          _this.getCount();
+        }
+      }, 10000);
+    },
+    //全部未读个数
+    getCount() {
+      let param = {
+        id: "",
+        code: this.code
+      };
+      if (this.reqCountBool) {
+        this.reqCountBool = false;
+        axios["system-manager"]
+          .post("/api/announcement/getMessageCount", param)
+          .then(res => {
+            this.notReadCount = res.notRead;
+            window.localStorage.setItem("notReadCoutData", this.notReadCount);
+            this.reqCountBool = true;
+          });
+      }
+    },
+```
+
+在css中加入基础样式（可根据项目需求定制修改样式）
+
+```css
+.header-opt-infor {
+  color: #adb5be;
+  cursor: pointer;
+  line-height: 60px;
+  padding-left: 16px;
+  padding-right: 16px;
+  font-size: 16px;
+  float: left;
+}
+.header-opt-infor:hover {
+  color: #fff;
+}
+.el-badge__content {
+  border: 0px solid #fff !important;
+}
+.header-opt .logInfo span {
+  display: inline-block;
+}
+```
+
+##### 2.2.1.2.消息提醒列表
+
+参考**cloud-system-portal**程序包中的**messageList.vue**文件
+
+### 2.3消息列表
+
+点击"全部消息"，显示已读和未读消息列表。
+
+![image-20210701152410689](.\imgs\消息中心\1-24.png)
+
+点击"未读",显示未读消息列表。
+
+![image-20210701152454255](.\imgs\消息中心\1-25.png)
+
+点击"已读",显示已读消息列表。	
+
+![image-20210701152542867](.\imgs\消息中心\1-26.png)
+
+## 3.消息中心接口功能使用
+
+### 3.1. 消息管理
+
+说明：发送消息，新增草稿，新增模板，新增定时发送消息
+
+字段值控制数据说明：
+
+| isSend | timeSend | isModel | isTimer | 消息类型         |
+| ------ | -------- | ------- | ------- | ---------------- |
+| 1      | 1        | 0       | 0       | 非定时已发送消息 |
+| 1      | 1        | 0       | 1       | 定时发送已发消息 |
+| 1      | 0        | 0       | 1       | 定时发送列表消息 |
+| 0      | 0        | 0       | 1       | 定时草稿         |
+| 0      | 0        | 0       | 0       | 普通草稿         |
+| 0      |          | 1       |         | 模板             |
+
+cronConfig存储json字符串值含义：
+
+| radio | moreTimeType | 定时类型     |
+| ----- | ------------ | ------------ |
+| 0     | 0            | 单次定时发送 |
+| 1     | 0            | 按年发送     |
+| 1     | 1            | 按月发送     |
+| 1     | 2            | 按日发送     |
+| 1     | 3            | 按周发送     |
+
+#### 3.1.1 新增消息接口
+
+* method : post
+
+* url : http://IP:端口/gateway/服务名/api/announcement/addSendMessage
+
+<b>Postman样例:</b>
+适用于前端直接调用
+http://IP:端口/gateway/cloud-system-manage/api/announcement/addSendMessage
+
+![image-20210701152410689](.\imgs\消息中心\1-27.png)
+
+返回数据如下:
+
+```json
+{
+    "timestamp": 1669275497066,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/announcement/addSendMessage",
+    "data": {
+        "tenantId": "",
+        "secretCode": null,
+        "secretName": null,
+        "createTime": null,
+        "updateTime": 1669275497050,
+        "creatorId": null,
+        "reviserId": null,
+        "id": "4028b88184a7eba80184a892b26a00bd",
+        "isSend": "1",
+        "msgType": "0",
+        "title": null,
+        "senderId": "admin",
+        "senderName": "系统管理员",
+        "sendTime": 1669275497051,
+        "isRead": "0",
+        "detailContent": "测试普通消息",
+        "receiverId": "977df2c3b2f9451c9ba7b95338d227c4",
+        "receiverName": "测试",
+        "receiverSessionId": null,
+        "showType": null,
+        "url": null,
+        "enclosureIds": "",
+        "isModel": "0",
+        "isTimer": "0",
+        "cronConfig": null,
+        "timeSend": "1"
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+
+#### 3.1.2 保存模板接口
+
+- method : post
+
+- url : http://IP:端口/gateway/服务名/api/announcement/save
+
+
+
+<b>Postman样例:</b>
+适用于前端直接调用
+http://IP:端口/gateway/cloud-system-manage/api/announcement/save
+
+![image-20210701152410689](.\imgs\消息中心\1-28.png)
+
+返回数据如下:
+
+```json
+{
+    "timestamp": 1625103926904,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/announcement/save",
+    "data": {
+        //多租户ID  多租户开启后不为空，不开启为空
+        "tenantId": "",
+        "secretCode": null,
+        "secretName": null,
+        "createTime": null,
+        "updateTime": 1669275644803,
+        "creatorId": null,
+        "reviserId": null,
+        //消息ID
+        "id": "4028b88184a7eba80184a894f38400be",
+        //未发送标识 0：未发送（模板不发送） 1：已发送
+        "isSend": "0",
+        //模板类型  
+        "msgType": "warn",
+        //模板标题
+        "title": " 测试",
+        //发信人userId 为PF_USER_INFO的用户userId
+        "senderId": "admin",
+        //发信人名称 为PF_USER_INFO的用户名称
+        "senderName": " 系统管理员",
+        "sendTime": 1625103926886,
+        "isRead": "0",
+        //消息内容
+        "detailContent": " <p>测试</p><p><br></p>",
+        "receiverId": null,
+        "receiverName": null,
+        "url": null,
+        "enclosureIds": " ",
+        //模板标识 如果是模板，isModel设置为1
+        "isModel": " 1",
+        //定时标识 如果是模板，isTimer设置为0
+        "isTimer": " 0",
+        "cronConfig": null,
+        "timeSend": null
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+
+#### 3.1.3 已发送列表
+
+- ​    method : post
+
+- ​    url : http://IP:端口/gateway/cloud-system-manage/api/announcement/page
+
+
+<b>Postman样例:</b>
+  适用于前端直接调用 
+
+ http://IP:端口/gateway/cloud-system-manage/api/announcement/page
+
+![image-20210701152410689](.\imgs\消息中心\1-29.png)
+
+  返回数据如下:
+
+  ```json
+{
+    "timestamp":1622707099079,
+    "status":1,
+    "message":"成功",
+    "stackmessage":null,
+    "path":"/api/announcement/page",
+    "data":{
+        "rows"：[
+        	{
+                "tenantId":"",
+                "secretCode":null,
+                "secretName":null,
+                "createTime":null,
+                "updateTime":1622699145000,
+                "creatorId":null,
+                "reviserId":null,
+                "id":"3f28836079d0a34d0179d0b085ca0014",
+                "isSend":"1",
+                "msgType":"msg",
+                "title":"1",
+                "senderId":"admin",
+                "senderName":"系统管理员",
+                "sendTime":1622703900000,
+                "isRead":"0",
+                "detailContent":"<p>测试</p>",
+                "receiverId":"f8a8c6b1c9544096ace0e87adb26d945",
+                "receiverName":"1",
+                "url":null,
+                "enclosureIds":"",
+                "isModel":"0",//不是模板
+                "isTimer":"1",//定时发送的消息  
+                "cronConfig":"{"cron":"0 5 * * * ? *","stopTime":"2021-06-30 14:45:36","moreTimeType":"0"}",
+                "timeSend":"1"//普通已发送 定时已发送
+            }...
+        ],
+		
+        "total":25,
+        "pageSize":0,
+        "pageNumber":0,
+        "totalPages":0,
+        "records":0
+    },
+    "extraInfo":{},
+    "success":true
+}
+  ```
+
+  #### 3.1.4删除消息接口
+
+- method : post
+
+- url : http://IP:端口/gateway/cloud-system-manage/api/announcement/removeAnnouncement
+
+  <b>Postman样例:</b>
+
+http://IP:端口/gateway/cloud-system-manage/api/announcement/removeAnnouncement
+
+​    适用于前端直接调用 
+
+![image-20210701152410689](.\imgs\消息中心\1-30.png)
+
+注意:传入的ids必须为数据库已有的数据
+
+ 返回数据如下:
+
+```
+true
+```
+
+#### 3.1.5消息模板列表
+
+- method : post/get
+- url : http://IP:端口/gateway/cloud-system-manage/api/announcement/modelList
+
+**Postman**样例:
+
+适用于前端直接调用 
+
+http://IP:端口/gateway/cloud-system-manage/api/announcement/modelList
+
+![image-20210701152410689](.\imgs\消息中心\1-31.jpg)
+
+  返回数据如下:
+
+```json
+ {
+    "timestamp": 1669275774750,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/announcement/modelList",
+    "data": [
+        {
+            "id": "4028b88184a7eba80184a896dc3300bf",
+            "title": "消息模板1"
+        }
+    ],
+    "extraInfo": {},
+    "success": true
+}
+```
+
+#### 3.1.6收件人列表
+
+- method : post/get
+
+- url : http://IP:端口/gateway/cloud-system-manage/api/announcement/getRecieverByPage
+
+  **Postman**样例:
+
+   适用于前端直接调用 
+
+  http://IP:端口/gateway/cloud-system-manage/api/announcement/getRecieverByPage
+
+  请求数据如下：
+
+  ![image-20210701152410689](.\imgs\消息中心\1-32.png)
+
+  返回数据如下：
+
+  ```json
+  {
+      "timestamp": 1660726277007,
+    "status": 1,
+      "message": "成功",
+    "stackmessage": null,
+      "path": "/api/announcement/getRecieverByPage",
+      "data": {
+          "rows": [
+              {
+                  "tenantId": "",
+                  "secretCode": "secret40",
+                  "secretName": null,
+                  "createTime": 1660702207000,
+                  "updateTime": 1660702207000,
+                  "creatorId": null,
+                  "reviserId": null,
+                  "id": "cef4a46b17ac49aea0ccb183e3c86d52",
+                  "username": "havery",
+                  "password": "{bcrypt}$2a$10$PmRkNxf3NNVkUrsJJV6YEeeGIuy4uZUWt5UHsBlzCXVqkHdpmM64.",
+                  "status": "1",
+                  "ipAddress": null,
+                  "passChanged": 1660702267000,
+                  "passLocked": null,
+                  "macAddress": null,
+                  "errTimes": 0,
+                  "userId": "2ea5695cc08143609c72125dae7655e8",
+                  "grade": "4",
+                  "authorities": null,
+                  "authoritiesIds": null,
+                  "name": "havery",
+                  "code": null,
+                  "deptId": null,
+                  "deptCode": null,
+                  "orgId": null,
+                  "orgName": null,
+                  "rootOrgId": null,
+                  "deptName": null,
+                  "gradeName": null,
+                  "secret": null,
+                  "loginIp": null,
+                  "email": null,
+                  "threeMemberManage": false,
+                  "threeMemberManagEmpChange": false,
+                  "adminUser": false,
+                  "userType": "1",
+                  "addTime": null,
+                  "lastTime": null,
+                  "enabled": true,
+                  "credentialsNonExpired": true,
+                  "accountNonExpired": true,
+                  "accountNonLocked": true
+              }
+          ],
+          "deptcodes": null,
+          "total": 1,
+          "pageSize": 0,
+          "pageNumber": 0,
+          "totalPages": 0,
+          "records": 0
+      },
+      "extraInfo": {},
+      "success": true
+  }
+  ```
+
+  
+
+
+
+#### 3.1.7 已发送/草稿/模板/定时发送消息详情
+
+  * method : post/get
+
+  * url : http://IP:端口/gateway/cloud-system-manage/api/announcement/getMessageInfor
+
+    <b>Postman样例:</b>
+适用于前端直接调用 
+    
+      http://IP:端口/gateway/服务名//api/announcement/api/announcement/getPfMessageInfor
+    
+
+ 请求参数：
+    
+![image-20210701152410689](.\imgs\消息中心\1-33.png)
+    
+    返回内容：
+    
+    ```json
+    {
+        "tenantId": "",
+        "secretCode": null,
+        "secretName": null,
+        "createTime": null,
+        "updateTime": 1660718964000,
+        "creatorId": null,
+        "reviserId": null,
+        "id": "3f28835482aa68120182aa905dc6004d",
+        "isSend": "1",
+        "msgType": "0",
+        "title": "1111",
+        "senderId": "admin",
+        "senderName": "系统管理员",
+        "sendTime": 1660718964000,
+    "isRead": "0",
+        "detailContent": "<p>1111</p>",
+        "receiverId": "01baeac963d34fe691cf442446941abc",
+    "receiverName": "wjh",
+        "receiverSessionId": null,
+    "showType": null,
+        "url": null,
+    "enclosureIds": "",
+        "isModel": "0",
+        "isTimer": "0",
+        "cronConfig": "{\"cron\":\"\",\"stopTime\":\"Wed Aug 17 2022 14:49:15 GMT+0800 (中国标准时间)86400000\",\"moreTimeType\":\"0\",\"radio\":\"1\"}",
+    "timeSend": "1"
+    }
+### 3.2.消息列表
+
+#### 3.2.1 消息列表
+
+- method : post
+
+- url : http://IP:端口/gateway/cloud-system-manage/api/announcement/pageMessage
+
+  http://localhost:8080/gateway/cloud-system-manage/api/announcement/pageMessage
+
+  Postman样例:
+
+  适用于前端直接调用 
+
+![image-20210701152410689](.\imgs\消息中心\1-41.png)
+
+2.1.1 消息详情
+
+* method : post/get
+
+* url : http://IP:端口/gateway/服务名//api/announcement/getPfMessageInfor
+
+  <b>Postman样例:</b>
+适用于前端直接调用 
+  
+  http://localhost:8080/gateway/cloud-system-manage/api/announcement/getPfMessageInfor
+  
+
+请求参数：
+
+![image-20210701152410689](.\imgs\消息中心\1-38.png)
+
+  返回内容：
+
+  ```json
+  {
+      "tenantId": null,
+      "secretCode": null,
+      "secretName": null,
+    "createTime": null,
+      "updateTime": 1660719720000,
+      "creatorId": null,
+    "reviserId": null,
+      "id": "3f28835482aa68120182aa9be741005c",
+    "msgType": "0",
+      "title": "信息",
+    "senderId": "admin",
+      "senderName": "系统管理员",
+      "sendTime": 1660719720000,
+      "isRead": "0",
+    "detailContent": "<p>姓名：havery</p><p>性别：男</p>",
+      "receiverId": "01baeac963d34fe691cf442446941abc",
+    "url": null,
+      "enclosureIds": "",
+      "receiverSessionId": null,
+      "showType": null
+  }
+  ```
+
+  
+
+#### 3.2.2更新未读
+
+##### 3.2.2.1 全部已读
+
+说明:查询已读/未读消息列表
+
+* method : post
+
+* url : http://IP:端口/gateway/cloud-system-manage/api/announcement/updateMessageStatus
+
+  <b>Postman样例:</b>
+  适用于前端直接调用 
+
+  http://localhost:8080/gateway/cloud-system-manage/api/announcement/updateMessageStatus
+
+  ![image-20210701152410689](.\imgs\消息中心\1-37.png)
+
+  返回数据如下：
+
+  ```
+  true
+  ```
+
+  
+
+
+##### 3.2.2.2 点击未读
+
+​		method : post
+
+​		url : http://IP:端口/gateway/cloud-system-manage/api/announcement/updateMessage
+
+<b>Postman样例:</b>
+适用于前端直接调用 
+
+![image-20210701152410689](.\imgs\消息中心\1-36.png)
+
+返回数据如下：
+
+```
+true
+```
+
+#### 3.2.3收件人消息详情
+
+  * method : post/get
+
+  * url : http://IP:端口/gateway/cloud-system-manage/api/announcement/getPfMessageInfor
+
+    <b>Postman样例:</b>
+适用于前端直接调用 
+    
+    请求数据如下：
+    
+
+![image-20210701152410689](.\imgs\消息中心\1-39.png)
+    
+返回数据如下：
+    
+    ```json
+    {
+        "tenantId": "",
+        "secretCode": null,
+        "secretName": null,
+        "createTime": null,
+        "updateTime": 1618385830000,
+        "creatorId": "",
+        "reviserId": "",
+        "id": "3f28835482aacb860182ab50a893000b",
+        "msgType": "msg",
+        "title": "222",
+    "senderId": "admin",
+        "senderName": "管理员",
+        "sendTime": 1618385830000,
+    "isRead": "1",
+        "detailContent": "111",
+    "receiverId": "2ea5695cc88143609c72125dae7655e8",
+        "url": "",
+    "enclosureIds": "",
+    "receiverSessionId": null,
+        "showType": null
+    }
+
+
+## 附：附件上传下载删除接口
+
+#### 附件上传
+
+- method : post
+- url : http://IP:端口/gateway/cloud-system-manage/api/enclosure/upload 
+
+![image-20210701152410689](.\imgs\消息中心\1-42.png)
+
+
+
+#### 附件下载
+
+- ​	method : get
+
+- ​	url : http://IP:端口/gateway/cloud-system-manage/api/enclosure/download
+
+
+​	无返回参数，下载文件
+
+#### 附件列表
+
+- ​	method : get
+
+- ​	url :http://IP:端口/gateway/cloud-system-manage/api/enclosure/list
+
+
+![image-20210701152410689](.\imgs\消息中心\1-35.png)
+
+```json
+{
+    "timestamp": 1618390379395,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/enclosure/list",
+    "data": [
+        {
+            "tenantId": "",
+            "createTime": null,
+            "updateTime": 1618291808000,
+            "creatorId": null,
+            "reviserId": null,
+            //文件ID
+            "id": "3f28811578c8ba4a0178c9b55837001a",
+             //文件名称
+            "name": "图形化安装部署手册.html",
+             //文件大小  Byte
+            "size": 103974972,
+              //文件路径 
+            "path": "E:\\merit_cloud/enclosure/图形化安装部署手册.html"
+        },
+        {
+            "tenantId": "",
+            "createTime": null,
+            "updateTime": 1618291817000,
+            "creatorId": null,
+            "reviserId": null,
+            "id": "3f28811578c8ba4a0178c9b57c58001b",
+            "name": "安装.html",
+            "size": 30185,
+            "path": "E:\\merit_cloud/enclosure/安装.html"
+        }
+    ],
+    "extraInfo": {},
+    "success": true
+}
+```
+
+​	
+
+### 备注
+
+#### 自定义消息内容
+
+使用场景：
+
+​		当发送的消息内容只有局部改变时，可使用此方法。例如：需要发送的消息内容为：
+
+```
+"今年的净利润为$profit，总收入为$count,总支出为$expendture"
+```
+
+​			其中净利润值，总收入，总支出是可修改变量，其他内容改变频率极低，这时可使用自定义模板，需要设置msgType为唯一值（假设设置为：money）。具体操作流程如下：
+
+首先新建模板，调用新增模板接口
+
+url : http://IP:端口/gateway/cloud-system-manage/api/announcement/save
+
+![image-20210701152410689](.\imgs\消息中心\1-34.png)
+
+请求成功后拿到返回结果如下：
+
+```json
+{
+    "timestamp": 1660730394254,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/announcement/save",
+    "data": {
+        "tenantId": "",
+        "secretCode": null,
+        "secretName": null,
+        "createTime": null,
+        "updateTime": 1660730394251,
+        "creatorId": null,
+        "reviserId": null,
+        "id": "3f28835482aacb860182ab3ec68d000a",
+        "isSend": "0",
+        "msgType": "money",
+        "title": "收入支出明细",
+        "senderId": "admin",
+        "senderName": "系统管理员",
+        "sendTime": 1660730394252,
+        "isRead": "0",
+        "detailContent": "今年的净利润为$profit，总收入为$count,总支出为$expendture",
+        "receiverId": "",
+        "receiverName": "",
+        "receiverSessionId": null,
+        "showType": null,
+        "url": "",
+        "enclosureIds": "",
+        "isModel": "1",
+        "isTimer": "0",
+        "cronConfig": null,
+        "timeSend": null
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+
+需要发送消息时，查询模板列表中msgType为money的对象，拿到消息模板内容和标题（附件按需添加）
+
+```json
+detailContent ="今年的净利润为$profit，总收入为$count,总支出为$expendture";
+titile="收入支出明细";
+```
+
+然后替换的数据为key value键值对,可以用json,map，Java代码示例如下：
+
+```java
+#JSON键值对
+JSONObject data=new JSONObject();
+data.put("$profit":"100"),
+data.put("$expendture":"100"),
+data.put("$count":"200"),
+#Map键值对
+Map<String,Object> data=new HashMap<>();
+data.push("$profit":"100"),
+data.push("$expendture":"100"),
+data.push("$count":"200"),
+```
+
+遍历键值对后替换***detailContent***内容：
+
+```java
+JSON替换方法
+Iterator<String> keys=data.kets();
+while(keys.hasNext()){
+  String key=keys.next();
+  detailContent.replace(key,data.get("key"));
+}JAVA
+Map替换方法
+Set set=data.entrySet();
+for(Iterator iter=set.iterator();iter.hasNext()){
+ Map.Entry entry=(Map.Entry) iter.next();
+ String key=(String) entry.getKey();
+ detailContent.replace(key,entry.getValue());
+}
+```
+
+替换***detailContent***后，设置发送内容和标题，即可完成模板内容替换。调用  **3.1.1 新增消息接口**    将消息发送给用户
+