データセットの管理

Liferay DXP 2024.Q1+/ポータル GA112+

重要

現在、この機能は リリース機能フラグ (LPS-164563) によって保護されています。

データ セットを作成したら、ユーザーへの表示方法をカスタマイズできます。 表示されるフィールドを選択し、フィルターを定義して事前に適用し、デフォルトの並べ替えルールを設定し、ユーザーをアクションを実行できる別の URL にリダイレクトし、データ セットのページ区切りオプションを構成します。

システムデータセットの使用

システム データ セットを使用すると、基礎となる実装を維持しながら、(変更できない) Java ベースのデータ セットを調整およびカスタマイズできます。 システム データ セットを追加すると、Java ベースのデータ セットのコピーが作成されます。このコピーは、視覚化モード、フィルター、アクションなどを追加または削除することで、 カスタム データ セット のように扱うことができます。

システムデータセットを作成するには、

1. データ セット マネージャー (グローバル メニュー () → コントロール パネル → データ セット) に移動します。

2. ページ上部の システム データ セット タブをクリックします。

   利用可能なすべての Java ベースのデータ セットのリストを含むモーダルが表示されます。

   

   ヒント

   一部の Java ベースのデータ セットはシステム データ セットをまだサポートしていないため、表示されません。

3. カスタマイズ可能なシステム データ セットの基礎として使用する目的のデータ セットを選択します。

4. 作成をクリックします。

ページに表示されるシステム データ セットは、元のデータ セットのコピーです。 編集内容は元のデータ セットとは独立しており、新しいデータ セットは元の Java ベースのデータ セットへの変更の影響を受けません。

システム データ セットを作成すると、ページ内の元のデータ セットの使用法も 新しいカスタマイズに置き換えられます 。 システム データ セットは、作成後いつでも、データ セット マネージャーの [ステータス] 列の切り替えボタンをクリックして無効または有効にすることができます。

システム データ セットを無効にすると、ページは元の Java ベースのデータ セットを使用するようになります。 これにより、カスタマイズしたデータ セットは、アクティブに使用していない場合でも、将来の編集に利用できるようになります。

データセットの権限の管理

ロールの権限を定義する際、データ セット権限は オブジェクト → データ セット にグループ化されます (ただし、 コントロール パネル → オブジェクト → データ セット には、コントロール パネルのデータ セット ページを使用する権限があります)。

データ セットに対する権限の割り当てには、 データ セットに含まれるすべてのエンティティを管理する権限も含まれます。これには、 フィルター、 データ セット アクションなども含まれます。 既存のデータ セットのこれらの機能を管理するには、ユーザーは 更新 権限を持っている必要があります。

データセットのレイアウトと設定の管理

データ セット アプリケーションはタブに分かれています。

• 詳細タブ: データ セットの名前 (1) と説明 (2) を表示および編集します。 変更が完了したら、 「保存」 をクリックします。

  また、そのデータセットで使用されているRESTアプリケーション、スキーマ、エンドポイント（3）に関する情報も表示できます。

  

• Liferay DXP 2024.Q2+/Portal GA120+ 視覚化モード タブ: フィールドを選択し、テーブル、リスト、カードの 3 つの異なる視覚化モードを使用して、データセット内での表示方法を管理します。

  フィールドを編集し、わかりやすいラベルを追加してローカライズし、フィールドのレンダラーを選択し、並べ替え可能か並べ替え不可能かを定義します。

  リストとカードの視覚化モードを、その要素をデータ セットのフィールドにマッピングすることでカスタマイズすることもできます。

• フィルター タブ: ユーザーがデータ セット フラグメントに適用できるフィルターを定義します。

  クライアント拡張機能を使用してカスタマイズされたフィルターを適用したり、日付型フィールドを使用して特定の期間内のエントリを表示したり、 ピックリスト をフィルターのオプションのソースとして構成したりすることができます。

• Liferay DXP 2024.Q3+/Portal GA125+ 並べ替え タブ: ユーザーがデータセットフラグメントを含むページにアクセスしたときにエントリに適用される並べ替えオプションを設定します。 デフォルトの並べ替えオプションを設定することもできます。

  特定のフィールドを基準として、エントリを昇順または降順で並べ替えます。

• Liferay DXP 2024.Q2+/Portal GA120+ アクション タブ: データセット内の要素にリンクされたアクションを作成します。

  アイテムアクションを使用すると、データの特定のニーズとコンテキストに応じて、データセット内のアイテムに関連する多くのアクションを実行できます。 たとえば、データ セット アイテムがユーザーを表す場合、実行可能なアクションには、そのユーザーをアクティブ化/非アクティブ化したり、ユーザーになりすますことが含まれます。 同様に、Web コンテンツ アイテムの場合、アクションにはコンテンツの有効期限を設定したり、履歴や使用状況を表示したりすることが含まれます。

  作成アクションを使用すると、ユーザーは新しいデータを作成したり、データを作成できる別の場所にリダイレクトしたりできます。

  詳細については、「 データ セット アクションの使用 」を参照してください。

• ページ区切りタブ: データ セットのページ区切りオプションを構成します。 ページ区切りにより、大量のデータが、より小さく管理しやすい部分に分割されます。

  ページあたりのデフォルトのアイテム数を設定し、各ページに表示するアイテムの希望数を選択できるオプションのリストをユーザーに提供します。

  オプションのリストを定義するには、コンマで区切られた正の数値を使用します。

  

• 設定タブ: データ セットを構成します (例: デフォルトの視覚化モードを設定します)。

  

データセットに高度なパラメータを追加する

高度なオプション パラメータ セクションで、パラメータ フィールドにパラメータの文字列を入力して、データ セットを表示するときにリクエスト URL に追加します。 nestedFields、 filter、 sort パラメータなど、エンドポイントと互換性のある任意のパラメータを入力できます。 これらのパラメータは、データ セットが表示されるときにデフォルトで使用されます。

下の URL プレビュー フィールドには、パラメータを追加した後の結果の URL が表示されます。

注

パラメータは、選択したエンドポイントに適切であり、正しい構文を使用する必要があります。 サポートされていないパラメータや不正なパラメータを追加した場合、データ セットのレンダリングでエラーが返され、データ セットからの結果が返されません。 API クエリ パラメータの詳細については、 API クエリ パラメータ を参照してください。

これらのパラメータと競合する可能性のある 他のタブ でフィールド、フィルタ、または並べ替え基準を構成した場合、それらの構成は、次のルールに従ってリクエスト URL で考慮されます。

• nestedFields パラメータ: パラメータが、視覚化モード タブでマップされたフィールドにすでに含まれているフィールドを追加する場合、フィールドの重複を避けるため、URL に再度追加されることはありません。

• フィルター パラメーター: パラメーター フィールドとフィルター タブの両方にフィルターを追加した場合、フィルターは および 演算子で結合されます。

• ソート パラメータ: 同じフィールドの「ソート」タブでソート基準が設定されている場合、「パラメータ」フィールドの基準が上書きされます。 「並べ替え」タブに追加された並べ替え基準は、パラメータ内の基準の前に最終 URL に追加されます。

たとえば、フィルター タブでフィルターとして familyName フィールドが設定されたユーザーのデータ セットがあり、パラメーター フィールドに filter=givenName eq 'Firstname' を追加すると、次の URL がデフォルトで表示されます。

/headless-admin-user/v1.0/user-accounts?filter=givenName%20eq%20'Firstname'

データ セットを表示しているユーザーが、姓 familyName フィルターを姓 Lastnameに対して有効にした場合、URL は 2 つのフィルターを結合して、結果として得られるフィルター (familyName eq 'Lastname') および (givenName eq 'Firstname'を生成します。

/headless-admin-user/v1.0/user-accounts?filter=%28%28familyName+eq+%27Lastname%27%29%29+and+%28givenName+eq+%27Firstname%27%29%

データセットの表示方法を保存して共有する

ベータ機能

重要

この機能はベータ機能フラグ (LPD-22473) で保護されています。 詳細については、 ベータ機能フラグ を参照してください。

データ セットに加えた変更 ( フィルター、 並べ替え、表示されている列、ページ、検索バーの状態、 視覚化モードなど) は URL に反映されます。

ブラウザの戻るボタンまたは進むボタンを使用して移動すると、構成は URL を通じて保持されます。 リンクまたはメニュー項目を介して別のページに移動して戻ると、URL が再生成されるため、構成は失われます。

現在のビューを保存したり、他のユーザーと共有したりするには、ページの URL をコピーします。 コピーされたリンクを開くと、同じ構成とレイアウトが表示されますが、表示されるデータはタイミングと権限によって異なる場合があります。

注

スクロール位置と列幅は保持されません。 フィルター、並べ替え、表示されている列、ページ、検索バーの状態、視覚化モードのみが復元されます。

関連トピック

• データセットの作成
• データセットの視覚化モード
• データセットフィルター
• データセットアクション
• データセットアクションの使用