通过自定义菜单重构资产页面 - 智能数据建设与治理 Dataphin

本文面向Dataphin超级管理员，介绍如何组合使用资产菜单显隐控制、资产页签访问控制与资产页签隐藏参数（assetTabHidden），配合自定义菜单能力，将原生资产目录灵活拆解并重新嵌入到自定义的资产运营页面中，为不同角色提供精简、聚焦的资产消费入口。

背景信息

Dataphin的资产目录是一个聚合了多种资产类型（表、指标、API、仪表板等）的统一搜索与浏览入口。在实际运营中，企业往往希望针对不同业务团队，提供差异化的资产消费页面，例如：

面向业务分析师，仅提供指标检索入口，隐藏其余资产类型。
将资产检索能力嵌入到企业自定义的运营门户菜单下，去除顶部导航等冗余框架，使其更像一个独立的轻量应用。
通过URL直达资产页面，此时仅保留检索主体区域，隐藏左侧及顶部的原生菜单。

为支撑上述场景，Dataphin提供了三层可组合的控制能力：菜单显隐控制、页签访问控制以及通过URL参数隐藏页面元素。以下将依次说明各项能力并给出完整的组合配置示例。

能力一、资产权限拆分与菜单显隐控制

全局角色的资产-目录下，展示菜单、表、指标、API、仪表板成为五项独立的权限点，您可前往管理中心 > 成员管理 > 全局角色管理中为不同角色配置不同权限点，权限点详情请参见资产权限点。

这一拆分使得菜单是否展示与具体页签能否访问相互解耦，为后续构造自定义资产运营页面提供基础。

能力二、通过URL参数隐藏页面元素

资产目录检索页支持通过URL参数控制页面的展示元素，以便嵌入到自定义菜单或外部页面时呈现更精简的界面。常用参数如下：

参数	说明	取值
`activeTab`	指定进入页面时默认激活的资产页签。	如`INDEX`（指标）等。
`assetTabHidden`	隐藏资产页签切换区域（表/指标/API/仪表板等页签栏）。	`true`/`false`
`topHidden`	隐藏顶部导航栏，使页面以无框架形式嵌入。	`true`/`false`
`tenantId`	指定租户ID。	租户ID。
`search`	预填检索关键词。	关键词字符串。

例如，一个隐藏资产页签和顶部导航栏，默认进入指标检索页面的URL为https://<您的域名>/market/catalog/search?activeTab=INDEX&search=&tenantId=<租户ID>&assetTabHidden=true&topHidden=true。

完整操作步骤

下文以为业务分析师提供一个仅含指标检索的资产运营入口为例，组合使用三项能力完成配置。

一、准备资产页面的目标URL

根据需要呈现的内容，拼接资产目录检索页URL，并附加用于精简界面的参数。例如https://<您的域名>/market/catalog/search?activeTab=INDEX&search=&tenantId=<租户ID>&assetTabHidden=true&topHidden=true。

activeTab=INDEX：默认进入指标检索。
assetTabHidden=true：隐藏资产页签栏，使页面专注于指标内容。
topHidden=true：隐藏顶部导航，使其作为嵌入式页面呈现。
按需使用tenantId等参数。

二、通过自定义菜单嵌入该页面

在管理中心 > 系统设置 > 租户设置 > 样式配置中，选择菜单设置页签。
在资产治理管理 > 资产菜单下，单击添加一级/二级菜单（例如，指标目录），在新建菜单对话框中，填入配置信息后，单击确定。
其中菜单链接URL中填入第二步中准备好的URL，并关闭展示顶部导航。
说明
保存后的自定义菜单仅超级管理员和系统管理员拥有查看权限，其余角色默认无权限查看，需前往全局角色管理中进行配置。

三、在自定义角色中关闭原生资产菜单，并按需开放页签。

在管理中心 > 成员管理 > 全局角色管理中，编辑已有自定义角色或新建自定义全局角色（例如，业务分析师）。
在菜单功能权限配置区域，单击资产，资产-目录下的权限点包含展示菜单、表、指标、API和仪表板。
按需选中权限点（本例中仅选中指标权限点）后，单击确定保存配置。
取消选中展示菜单权限点，以隐藏顶部原生的资产目录菜单入口，避免与后续自定义菜单重复。
按需设置自定义菜单的访问权限，在当前编辑自定义角色页面中，选中步骤二中的自定义菜单（即该自定义菜单对当前角色可见）。
单击确定，保存配置。

四、验证重构效果

使用目标角色账号登录Dataphin。
确认顶部导航中不再展示原生资产目录菜单，而是展示新配置的自定义菜单（指标目录）。
单击自定义菜单，进入嵌入页面，确认页面已隐藏顶部导航与资产页签栏，仅呈现指标检索主体区域。
确认仅能检索指标类资产，其余资产类型已被隐藏。
至此，便完成了一个精简、聚焦、面向特定角色的自定义资产运营页面。

常见问题

Q：取消选中展示菜单权限点后，用户还能访问资产目录吗？
A：能。展示菜单权限点仅控制顶部菜单入口的显隐，不影响通过URL直接访问资产目录页面。通过URL访问时，顶部菜单中的资产目录依然会展示。若需进一步控制实际可访问的资产类型，请使用表/指标/API/仪表板权限点。
Q：assetTabHidden参数与展示菜单权限点有什么区别？
A：二者作用层级不同。展示菜单权限点控制顶部导航中的菜单入口是否展示，是角色级别的权限配置；assetTabHidden控制进入资产目录页面后各类资产页签切换栏是否展示，是页面级别的URL参数。在自定义菜单嵌入场景中，二者通常配合使用，即使用展示菜单权限点隐藏原生入口，用assetTabHidden参数精简嵌入页面。
Q：为什么要同时使用topHidden参数？
A：topHidden=true用于隐藏顶部导航栏。当资产页面被嵌入到自定义菜单或外部门户中时，隐藏原生顶部导航可避免页面框架重复，使嵌入页面看起来更像一个独立的轻量应用。