Merge branch 'develop' into 'master'

Develop

See merge request doc/ldp-docs!7

报表系统集成/报表系统打印模板使用.md

+# 报表系统打印模板使用
+
+## 一、制作打印模板
+
+操作说明请查看[报表系统集成使用文档 ](./报表系统集成使用文档.md)中的报表管理。
+
+
+
+## 二、功能菜单配置打印模板
+
+首先进入到应用菜单维护页面
+
+![image-20210518162358125](./image/85进入到应用菜单维护页面.png)
+
+
+
+设置功能菜单基本信息
+
+![image-20210518163317226](./image/86设置功能菜单信息.png)
+
+点击选择报表模板
+
+![image-20210518163415024](./image/87选择报表模板.png)
+
+点击保存
+
+![image-20210518163507027](./image/88功能菜单模板保存.png)
+
+
+
+授权功能权限
+
+![image-20210518163818277](./image/89授权打印模板功能菜单权限.png)
+
+
+
+## 三、前端使用打印模板
+
+当前参数页面代码(仅使用打印模板功能)。
+
+前端脚手架需要使用最新报表，非最新版本请替换脚手架中`src/router/loadRouter.js`代码，另外需引入`src/utils/report.js`
+
+**`report.js`** 中提供两个打印报表相关函数。
+
+`getReportUrl` 用于页面功能id关联的报表信息。
+
+`openReportPreview`  用于通过功能id获取到关联报表信息，并直接打开报表预览页面。
+
+使用请查看下面代码示例
+
+```vue
+<template>
+  <div>
+    <el-button @click="getReportInfo">
+        获取报表信息
+    </el-button>
+    <el-button @click="preview">
+        预览报表
+    </el-button>
+  </div>
+</template>
+<script>
+import { openReportPreview, getReportUrl } from '@/utils/report'
+export default {
+  data() {
+    return {}
+  },
+  methods: {
+     getReportInfo() {
+      /**
+       * 通过接口获取当前功能id关联报表的信息。
+       *  第一个参数为当前页面功能id, 动态挂载的页面会经过路由设置，自动会将funcId挂到meta对象上
+       */
+      getReportUrl(this.$route.meta.funcId).then(res => {
+        console.log(res)
+      })
+    },
+    preview() {
+      /**  
+       *  打开预览报表页面
+       *  第一个参数为当前页面功能id, 动态挂载的页面会经过路由设置，自动会将funcId挂到meta对象上
+       *  第二个参数为替换对象， 如果报表模板设置了url参数那么getReportUrl 返回的url的地址需要替换参数，格式为{变量}
+       *  如"/ureport-service/open/urv?reportid=36681d5743d33ab479e23b23c16f5ad1&realmcode={realmcode}&userAccount={userAccount}"
+       *  realmcode为必须参数。 默认会使用当前脚手架中环境配置的`process.env.VUE_APP_REALMCODE`值替换
+       *  如果不替换直接打开地址，可能会url地址解析失败，或者造成参数错误等问题。
+       */
+      openReportPreview(this.$route.meta.funcId, {
+        userAccount: 'admin'
+      })
+    }
+  }
+}
+</script>
+
+```
+

操作文档/LDP中应用统一认证权限配置及开发说明.md

@@ -304,13 +304,16 @@ headers: {
     X-Realm: realmcode
 }
 ```
-#### 5.2 通过开放接口用户名免密登录获取token
-使用此接口前提条件是需要将请求方ip 地址配置在uaa 免密登录白名单中,可在MCS中配置，如下：
+#### 5.2 三方系统（非框架内后端服务）通过开放接口，用户名免密登录获取token
+
+ **注：此接口只能被后端服务调用，前端不能直接调用** 
+
+使用此接口前提条件是需要将请求方（后端服务）ip 地址配置在uaa 免密登录白名单中,可在MCS中配置，如下：
 
 ![白名单配置](../imgs/system-whitelist.png)
 
 
-开放接口地址: **http://{server}/mcs-service/user/auth/token**  
+开放接口地址: **http://{server}/uaa-service/open/user/token**  
 
 request method: **POST**
 
@@ -336,7 +339,79 @@ request Url 参数分别为：
     
 }
 ```
-#### 5.3 外部应用通过WEB URL带token方式登录LDP应用
+
+#### 5.3 框架内服务通过内部接口，用户名免密登录获取token
+
+ **注：此接口只能被框架内后端服务调用，前端不能直接调用**
+
+开放接口地址: **http://{server}/mcs-service/auth/user/token**  
+
+request method: **POST**
+
+request Url 参数分别为：
+
+| 参数      | 说明       |
+| --------- | ---------- |
+| userName  | 用户名(userAccount) |
+| clientId  | 应用ID     |
+| realmCode | 认证域编码  |
+
+返回结果，样例：
+
+```javascript 
+{"code":200,
+  "message":"success",
+  "data":
+  {
+    "userid":"admin","username":"","email":"","orgid":"",
+    "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJjbGllbnR0eXBlIjoicmVzdCIsImF1ZCI6Im1jcyIsInN1YiI6ImFkbWluIiwiY2xpZW50aWQiOiIxNTUyMjk0NjU2NTE1IiwiaXNzIjoidWFhIiwicmVhbG1jb2RlIjoibWNzIiwiZXhwIjoxNTk3OTk2MjkzLCJ1c2VyaWQiOiJhZG1pbiIsImlhdCI6MTU5Nzk4MTg5MywianRpIjoiNWJkMjQwZTItMzEwNy00NzgwLWIwMjItMDkwZTZjZjdmYWU4In0.F3F1Ye0F2EsRiS2p_PQx4TONKnl61JvOpGEhvbzmXpQMRmES7-19NMUwdXUvjRfkq-vE4_HH-5Ni4jRQ6wj45if-LqB2XMmLDeE3msUDb_JLkQTLv_7zk8-ccIZio1Z-1A3ZwUp89S3FjCTgW7zcq4uN8YqRDFHdGxkoIA3IMMo",
+    "realmCode":"mcs","clientId":"1552294656515"
+   }
+    
+}
+```
+
+#### 5.4 框架前端通过接口，用户名免密登录获取token
+
+ **注：前端调用此接口需要拿当前已登录用户TOKEN作为参数**
+
+开放接口地址: **http://{server}/mcs-service/auth/user/token**  
+
+request method: **POST**
+
+request Url 参数分别为：
+
+| 参数      | 说明       |
+| --------- | ---------- |
+| userName  | 用户名(userAccount) |
+| clientId  | 应用ID     |
+| realmCode | 认证域编码  |
+
+request Head 参数分别为：
+
+| 参数         | 说明       |
+| ---------    | ---------- |
+| X-Ldp-Token  | 已登录用户TOKEN |
+| X-Realm      | 应用对应认证域编码    |
+
+返回结果，样例：
+
+```javascript 
+{"code":200,
+  "message":"success",
+  "data":
+  {
+    "userid":"admin","username":"","email":"","orgid":"",
+    "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJjbGllbnR0eXBlIjoicmVzdCIsImF1ZCI6Im1jcyIsInN1YiI6ImFkbWluIiwiY2xpZW50aWQiOiIxNTUyMjk0NjU2NTE1IiwiaXNzIjoidWFhIiwicmVhbG1jb2RlIjoibWNzIiwiZXhwIjoxNTk3OTk2MjkzLCJ1c2VyaWQiOiJhZG1pbiIsImlhdCI6MTU5Nzk4MTg5MywianRpIjoiNWJkMjQwZTItMzEwNy00NzgwLWIwMjItMDkwZTZjZjdmYWU4In0.F3F1Ye0F2EsRiS2p_PQx4TONKnl61JvOpGEhvbzmXpQMRmES7-19NMUwdXUvjRfkq-vE4_HH-5Ni4jRQ6wj45if-LqB2XMmLDeE3msUDb_JLkQTLv_7zk8-ccIZio1Z-1A3ZwUp89S3FjCTgW7zcq4uN8YqRDFHdGxkoIA3IMMo",
+    "realmCode":"mcs","clientId":"1552294656515"
+   }
+    
+}
+```
+
+
+
+#### 5.5 外部应用通过WEB URL带token方式登录LDP应用
 通过5.2中方法，获取到数据，拼接跳转URL如下格式：
 
 **http://{ldp-web-server}?token={token}&appid={clientId}**