集成文档门户

1. 概述

1.1 功能概述

在掌握单文档集成方案后，Wyn 进一步提供完整的文档门户集成能力：用户既可通过固定Token（简单易操作）实现快速对接，也可采用更安全的单点登录（安全性更高）方案（调用系统登录API），将整个分析门户无缝嵌入业务系统，实现统一工作台体验。

2. 操作步骤

2.1 固定Token（令牌）集成（方法1）

使用系统管理账号登录后，依次单击「系统管理>安全设置>生成令牌」，进入生成令牌界面。
在生成令牌界面，填写令牌名称、描述以及用于生成令牌的用户和密码，选择组织路径，然后单击 生成令牌 按钮。可见右侧已经生成令牌。
生成令牌后，单击令牌右侧的更多按钮，选择生成集成地址，打开生成窗口。
将隐藏头像菜单设置为是，然后单击生成地址按钮，即可生成集成门户的地址和集成系统管理的地址，选择集成门户的地址后的复制地址按钮即可复制集成门户的地址。

头像菜单： 是指文档门户底部的头像菜单，该菜单用于显示当前登录用户、退出系统或管理员进入后台管理网站。如将此菜单隐藏，也即隐藏这些功能。

接下来，将复制的“ 集成门户的地址 ”作为业务系统中某个菜单链接的目标地址或业务系统页面文件中某个iframe的src属性或者超链接的href属性即可。

2.2 门户网站集成参数

在URL上可以通过一系列参数来控制文档门户的显示样式。

参数	说明
hidenavlogo	不使用该参数或参数值为false，集成的门户网站左上角将始终显示产品图标；参数值为true，隐藏门户网站左上角的产品图标；
lng	不使用该参数，集成门户网站的语言将使用系统设定中指定的语言或使用用户个人配置中指定的语言；使用该参数，并指定正确的语言，集成的门户网站将使用该语言来显示内容，例如站点语言为中文，若使用参数lng=en，站点内容将用英文显示;
theme	不使用该参数，集成门户网站的主题将使用系统设定中指定的主题或使用用户个人配置中指定的主题；使用该参数，并指定正确的主题名称，集成的门户网站将使用该主题来显示，例如theme=red;
hidenav	使用该参数，并设定参数值为True，集成页面隐藏左边栏，仅展示文档列表
hidenavdetail	使用该参数，并设定参数值为True，隐藏左边栏的二级菜单
enablecreatedocumentinlistpage	使用该参数，并设定参数值为True，将在文档门户的顶部菜单栏中显示“创建文档”的图标。
hideColumns	仅对非系统管理员起效使用该参数，并指定正确的文档列表的列名，将隐藏该列；如果要隐藏多列，列名用逗号隔开，例如：hideColumns=updatedBy
title	用于在浏览器标签上添加额外的标题。

2.3 预览区域快捷操作栏更多集成参数

可以在 URL 中通过 hideActions参数来隐藏在单击更多按钮时出现的菜单选项或预览区域快速操作栏中的对应功能。具体可以隐藏的功能以及参数值列表如下，如需隐藏多个功能，各参数值之间使用英文逗号分隔即可。

参数值	说明
logout	隐藏“退出登录” 功能菜单
favorite	隐藏“收藏”功能图标
category	隐藏“管理分类”功能图标和菜单
setHome	隐藏“设为主页”功能图标和菜单
rename	隐藏“重命名”功能图标和菜单
openInNewWindow	隐藏“新窗口”打开图标
refresh	隐藏“刷新”功能图标
delete	隐藏“删除文档”功能图标和菜单
download	隐藏文档“下载”功能图标和菜单
copyUrl	隐藏“复制链接”功能菜单
copyReport	隐藏报表的“复制”功能图标和菜单
copyDashboard	隐藏仪表板的“复制”功能图标和菜单
copyDataset	隐藏数据集的“复制”功能图标和菜单
reporting:exportReport	隐藏报表“导出”功能图标和菜单
reporting:editReport	隐藏报表的“编辑”功能图标和菜单
reporting:createReportWithTemplate	隐藏报表模板的“新建”报表功能菜单
reporting:copyAsTemplate	隐藏报表的“复制为报表模板”功能图标和菜单
reporting:editTemplate	隐藏报表模板的“编辑”功能图标和菜单
reporting:previewRevision	隐藏报表修订历史中“预览”之前版本的功能按钮
reporting:editRevision	隐藏报表修订历史中“编辑”之前版本的功能按钮
dashboards:editDashboard	隐藏仪表板的“编辑”功能图标和菜单
dashboards:createWith	隐藏仪表板的“基于当前文档创建”功能和菜单
reconfigDataSource	隐藏数据源的“重新配置”功能图标和菜单
modifyDataSource	隐藏数据源“编辑”功能图标和菜单
modifyDataset	隐藏数据集的“编辑”功能图标和菜单
refreshDataset	隐藏数据集的“刷新缓存”功能图标和菜单
modifyTheme	隐藏主题文件的“编辑”功能图标和菜单
appendData	隐藏Excel数据源的“追加数据”功能图标和菜单
modifyFloorPlan	隐藏自定义地图资源的“编辑”功能图标和菜单
batchCheckBox	隐藏门户中的“复选框”功能图标

2.4 单点登录集成（方法2）

如果集成后需要进行权限控制，就需要通过单点登录集成的方法集成用户身份，以实现不同用户使用不同的Token登录Wyn 系统。具体方法请参见：用户身份集成