通過自訂菜單重構資產頁面 - 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用於隱藏頂部導覽列。當資產頁面被嵌入到自訂菜單或外部門戶中時，隱藏原生頂部導航可避免頁面架構重複，使嵌入頁面看起來更像一個獨立的輕量應用。