データセットの管理

Liferay DXP 2024.Q1+/Portal GA112+

重要

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

データセットを作成したら、ユーザーがそれをどのように表示するかをカスタマイズできます。 表示するフィールドを選択し、フィルターを定義して事前適用し、デフォルトの並べ替えルールを設定し、ユーザーを別のURLにリダイレクトしてそこで操作を実行させ、データセットのページネーションオプションを構成できます。

データセットのアクセス許可の管理

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

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

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

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

• 詳細タブ：データセットの名前（1）と説明（2）を表示および編集します。 変更が完了したら、 保存 をクリックしてください。

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

  

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

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

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

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

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

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

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

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

  アイテムアクションを使用すると、データの特定のニーズとコンテキストに応じて、データセット内のアイテムに関連する多くのアクションを実行できます。 例えば、データセット項目がユーザーを表している場合、可能な操作としては、その項目を有効化／無効化したり、そのユーザーになりすましたりすることなどが挙げられます。 同様に、ウェブコンテンツアイテムの場合、アクションにはコンテンツの有効期限切れや、その履歴と使用状況の表示などが含まれる。

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

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

• ページネーションタブ：データセットのページネーションオプションを設定します。 ページネーションは、大量のデータをより小さく、管理しやすい部分に分割する機能です。

  1ページあたりの表示項目数をデフォルト設定し、ユーザーが各ページに表示する項目数を希望に応じて選択できるオプションリストを提供する。

  選択肢のリストを定義するには、カンマで区切られた正の数を使用してください。

  

• 設定 タブ: データセットを設定します。

データセット設定の構成

「設定」タブでは、データセットがページに表示されているときの、ユーザー向けのデフォルト表示とオプションを設定できます。

• デフォルトのビジュアル化モード

• 空の状態の管理バーを非表示

• ユーザービューを有効にする

ユーザービューが有効になっている場合、ログインしているユーザーはデータセットを表示する際に、設定の追加、保存、削除を行うための新しいコントロールを利用できるようになります。

例えば、ユーザーは選択したフィルターや1ページあたりのアイテム数などを設定済みのビューとして保存できます。

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

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

下の「URLプレビュー」欄には、パラメータを追加した後のURLが表示されます。

注

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

他のタブ で、これらのパラメータと競合する可能性のあるフィールド、フィルタ、またはソート条件を設定している場合、それらの設定は次のルールに従ってリクエスト URL に反映されます。

• nestedFields パラメータ: パラメータが [Visualization Modes] タブでマッピングされたフィールドに既に含まれているフィールドを追加する場合、重複するフィールドを避けるために 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?(familyName%20eq%20'Lastname')%20and%20(givenName%20eq%20'Firstname')

関連トピック

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