本ドキュメントでは、Dataphin のスーパー管理者が アセットメニュー表示制御、アセットタブアクセス制御、および アセットタブ非表示パラメーター (assetTabHidden) を カスタムメニュー 機能と組み合わせて使用する方法について説明します。これらのツールを利用することで、ネイティブのアセットカタログを分解し、そのコンポーネントをカスタム操作ページに埋め込むことができ、異なるユーザーロールに対して最適化された、用途を絞ったエントリポイントを作成できます。
背景情報
Dataphin のアセットカタログは、テーブル、メトリック、API、ダッシュボードなど、さまざまなアセットタイプを検索・参照するための統合ポータルです。組織では、異なる業務チームに対して異なるアセット利用体験を提供する必要がよくあります。例えば、次のようなケースがあります。
ビジネスアナリスト向けに、メトリックのみを検索できるエントリポイントを提供する。
アセット検索機能を企業のカスタムポータルに埋め込み、トップナビゲーションバーなどの冗長な UI 要素を削除して、軽量な体験を提供する。
メイン検索エリアのみを表示する、簡素化されたアセットページへの直接 URL アクセスを提供する。
これらのユースケースをサポートするため、Dataphin は 3 つの組み合わせ可能な制御レイヤーを提供しています。メニュー表示制御、タブアクセス制御、およびページ要素を非表示にする URL パラメーターです。本ガイドでは、各機能について説明し、完全な設定例を提供します。
機能 1：アセット権限の分離とメニュー表示の制御
[アセットカタログ] 配下のグローバルロールの権限には、5 つの独立したアセット権限 ([メニューの表示]、[テーブル]、[メトリック]、[API]、[ダッシュボード]) が含まれます。これらの権限は、[管理センター] > [メンバー管理] > [グローバルロール管理] で、異なるロールに対して設定できます。権限の詳細については、アセット権限をご参照ください。
この分離により、メニューの表示とタブへのアクセスが分離され、カスタムアセット操作ページを構築するための基盤が提供されます。
機能 2：URL パラメーターによるページ要素の非表示
アセットカタログの検索ページは、表示する UI 要素を制御する URL パラメーターをサポートしています。これらのパラメーターを使用することで、カスタムメニューや外部ページに、より簡素化されたインターフェースを埋め込むことができます。以下の表に、一般的なパラメーターを示します。
パラメーター | 説明 | 値 |
| ページ読み込み時にデフォルトでアクティブになるアセットタブを指定します。 | たとえば、 |
| アセットタブバー (テーブル、メトリック、API、ダッシュボードなどのタブを切り替えるエリア) を非表示にします。 |
|
| トップナビゲーションバーを非表示にし、ページを外枠なしで埋め込めるようにします。 |
|
| テナント ID を指定します。 | お客様のテナント ID |
| 検索ボックスにキーワードを事前入力します。 | キーワード文字列 |
たとえば、次の URL を使用すると、アセットタブバーと上部ナビゲーションバーが非表示になり、デフォルトでメトリック検出ページが開きます: https://<your_domain>/market/catalog/search?activeTab=INDEX&search=&tenantId=<your_tenant_id>&assetTabHidden=true&topHidden=true。
操作手順
本トピックでは、ビジネスアナリストにメトリックの取得のみをサポートする資産運用ポータルを提供するを例に、3 つの機能を組み合わせて設定を完了する方法を説明します。
ステップ 1：アセットページの URL を準備
アセットカタログ検索ページの URL を構築し、パラメーターを追加してインターフェースを簡素化します。例: https://<your_domain>/market/catalog/search?activeTab=INDEX&search=&tenantId=<your_tenant_id>&assetTabHidden=true&topHidden=true。
activeTab=INDEX: デフォルトでメトリック検出ページを開きます。assetTabHidden=true: アセットタブバーを非表示にし、ページにメトリックコンテンツのみが表示されるようにします。topHidden=true: トップナビゲーションバーを非表示にし、すっきりとした埋め込み表示にします。必要に応じて、
tenantIdなどのパラメーターを使用します。
ステップ 2：カスタムメニューにページを埋め込む
[管理センター] > [システム設定] > [テナント設定] > [スタイル設定] で、[メニュー設定] タブを選択します。
[資産ガバナンス管理] > [資産] メニューで、クリックしてメトリックカタログなどの第 1 レベルまたは第 2 レベルのメニューを追加します。 新しいメニューダイアログボックスで、設定情報を入力し、[OK] をクリックします。
[メニューリンク URL] に、ステップ 2 で準備した URL を入力し、[トップナビゲーションを表示] をオフにします。
説明カスタムメニューを保存すると、デフォルトではスーパー管理者とシステム管理者ロールのみが表示できます。他のロールについては、グローバルロール管理で権限を設定する必要があります。
ステップ 3：カスタムロールを設定
[管理センター] > [メンバー管理] > [グローバルロール管理] で、既存のカスタムロールを編集するか、新しいカスタムグローバルロール (たとえば、ビジネスアナリスト) を作成します。
[メニュー・機能権限設定] エリアで、[アセット] をクリックします。[アセット]-[カタログ] 配下の権限には、[メニュー表示]、[テーブル]、[メトリック]、[API]、および [ダッシュボード] が含まれます。
必要に応じて権限 (この例では [メトリック] 権限のみ) を選択し、[OK] をクリックして設定を保存します。
上部にあるネイティブの Asset Catalog メニュー項目を非表示にし、後続のカスタムメニューとの重複を避けるには、[メニューの表示] 権限の選択を解除します。
ロール編集ページで、ステップ 2 で作成した [カスタムメニュー] を選択して、このロールに表示されるようにします。
[OK] をクリックして設定を保存します。
ステップ 4：結果を確認
対象ロールに割り当てられたアカウントで Dataphin にログインします。
トップナビゲーションバーに 標準のアセットカタログメニューが表示されなくなった ことを確認します。代わりに、新しいカスタムメニュー ([Metric Catalog]) が表示されます。
カスタムメニューをクリックして埋め込みページを開きます。トップナビゲーションバーとアセットタブバーが非表示 になっており、メインのメトリック検索エリアのみが表示されていることを確認します。
メトリック アセットのみを検索でき、他のすべてのアセットタイプが非表示になっていることを確認します。
これで、簡素化され、用途を絞った、ロール固有のアセット操作ページが作成されました。
よくある質問
Q：メニューの表示権限を解除した場合でも、ユーザーはアセットカタログにアクセスできますか?
A：はい。メニューの表示権限は、トップナビゲーションバーのメニュー項目の表示のみを制御します。直接 URL を介したアセットカタログページへのアクセスを妨げるものではありません。ユーザーが直接 URL を使用してアセットカタログページを開いた場合、そのページにはメニュー項目が表示されます。実際にアクセス可能なアセットタイプを制御するには、
テーブル、メトリック、API、ダッシュボードの個別の権限を使用してください。Q：
assetTabHiddenパラメーターとメニューの表示権限の違いは何ですか?A: 両者は異なるレベルで動作します。「メニューの表示」権限は、上部のナビゲーションバーにあるメニューエントリが表示されるかどうかを制御するロールレベルの設定です。
assetTabHiddenパラメーターは、「アセットカタログ」ページでアセットタブバーが表示されるかどうかを制御するページレベルの URL パラメーターです。カスタムメニューの埋め込みシナリオでは、通常、これらを一緒に使用します。「メニューの表示」権限を使用してネイティブのエントリポイントを非表示にし、assetTabHiddenパラメーターを使用して埋め込みページを簡素化します。Q：
topHiddenパラメーターも使用する必要があるのはなぜですか?A:
topHidden=trueは、トップナビゲーションバーを非表示にするために使用されます。アセットページをカスタムメニューや外部ポータルに埋め込む際に、ネイティブのトップナビゲーションバーを非表示にすると、ページフレームの重複を避け、埋め込みページをスタンドアロンの軽量アプリケーションのように見せることができます。