打开第三方模块【markdown】

[//]:use-markdown

## 1.说明
在某些项目的系统集成中，用户可能希望集成 Smartbi 的功能模块，比如用户管理，这时候可以使用openmodule.jsp（完整地址类似http://ip:port/smartbi/vision/openmodule.jsp）通过在 URL 后带各种参数，集成不同的模块。
目前支持集成的模块有：发布的目录或资源、系统运维、用户管理、会话管理、个人设置、消息中心、审核流程等。

## 2.基本参数
下面的四个参数是集成任何模块时，都必须传入的基本参数。但如果已经单点登录过，就不需要在 URL 中再传递用户名和密码了，除非希望以一个新的用户去集成指定模块。

| 参数 | 描述 |
|-----|-----|
| user | 登录 Smartbi 的用户名 |
| password | 模块id，参数值请见后文 |
| id | Smartbi 资源唯一 ID 值。可以从任意资源的“资源属性”对话框上“节点ID”中获取该值 |
| showbanner | 是否显示Smartbi的标题栏。不设置此参数或设置为false时，不显示标题栏；设置为true时，则显示。 |

传递上述四个参数，集成分析展现模块的访问地址，如下所示。

```

http://localhost:18080/smartbi/vision/openmodule.jsp?id=Analysis&showbanner=false&user=admin&password=manager
```

效果如下所示。


## 3.集成模块与参数对应关系
具体每个模块的集成示例请见集成示例。

| 模块名称 | 模块id | 参数（默认可选） |
|---|---|---|
| 数据门户 | DataPortal | showleftpanel 显示左侧栏； |
| 数据连接 | Database | showleftpanel 显示左侧栏； |
| 数据准备 | DataProvider | 无 |
| 分析展现 | Analysis | showleftpanel 显示左侧栏； |
| 数据挖掘 | DataMining | 无 |
| 运维设置 | OperationMaintenanceSetting | 无 |
| 用户管理 | usermanager | 无 |
| 用户管理 -> 角色管理 -> 资源授权 | rolerespermission | rolename （必须）：角色名称。查看该角色的资源授权。 |
| 用户管理 -> 角色管理 -> 操作授权 | rolefuncpermission | rolename （必须）：角色名称。查看该角色的操作授权。 |
| 会话管理 | sessionmanagement | 无 |
| 个性设置 | myoption | 无 |
| 个人中心-> 我的设置 -> 基本资料 | myinfo | 无 |
| 个人中心-> 我的设置-> 拥有的权限 | mypurview | 无 |
| 拥有发布目录 | mycatalog | 无 |
| 我的工作区 | privatefolder、favorite | 无 |
| 消息中心 | messageCenter | 无 |
| 消息详情 | messageDetail | b64msg：使用base64加密过后的JSON字符串，JSON字符串的格式为：{"id" : 消息id, "category": 消息类型(包括："sys", "notice", "warn", "private"(系统、通知公告、预警、私信) )}。（消息id可通过RMI接口：MessageModule.getMessageByCategory(String category, int pageNum, int pageSize, String title, Boolean showUnread) 来获取，title为title的过滤条件，未null时表示不过滤title） |
| 我的待办 | mytask | 无 |
| 流程监控 | workflowmonitor | 无 |
| 流程管理 | workflow | 无 |
| 应用 | Application | 无 |
| 应用商店 | appstore | order：应用的排序顺序；不传值：默认使用发布时间排序；可取值：time：发布时间；views：访问量；installs：安装数；comments：评论数。<br>注：在该页面中无Tab栏，打开的应用详情为新窗口打开。 |
| 商店运维管理 | appoperation | 无 |
| 应用详情 | appdetail | appId（必须）：应用id；isShowHead：默认为true。 |
| 数据答疑 | DataFaq | 无 |


## 4.集成示例
### 4.1 我的工作区
支持id: privatefolder、favorite
```

http://localhost:8080/smartbi/vision/openmodule.jsp?id=privatefolder&showbanner=false
```

### 4.2 消息详情
集成消息详情模块访问地址（只能访问未读的消息），如下所示。
```

http://localhost:8080/smartbi/vision/openmodule.jsp?id=messageDetail&showbanner=true&b64msg=eyJpZCIgOiAiSThhOGE5ZjVlMDE3OWVhYmZlYWJmMGVlOTAxNzllYWVlYzk4NzAwOGYiLCAiY2F0ZWdvcnkiIDogInByaXZhdGUifQ==
```
其中b64msg为{"id" : "I8a8a9f5e0179eabfeabf0ee90179eaeec987008f", "category" : "private"}的base64加密字符串。

### 4.3 应用商店
集成应用模块中应用商店的访问地址，打开应用商店并按访问量排序，如下所示：
```

http://localhost:18080/smartbi/vision/openmodule.jsp?id=appstore&order=views
```

### 4.4 应用详情
集成应用模块中应用详情的访问地址，如下所示：
```

http://localhost:18080/smartbi/vision/openmodule.jsp?id=appdetail&appId=I8a8aef9a017c989a989acdc7017c9b4f75870ba5