データセットの表示
Liferay DXP 2024.Q1+/Portal GA112+
この機能は、 リリース機能フラグ (LPS-164563) の背後にあります。
データセットを作成したら、それをページに追加してユーザーに提示します。ユーザーは、 で設定したオプション に従ってそれを使用できます。
ページにデータセットを追加する
データセットフラグメントを使用して、ページ上にデータセットを表示します。
-
どのページでも、 編集
をクリックします。 -
[フラグメント] タブで、[ コンテンツ表示 セクションを展開します。
-
データセット フラグメントをページにドラッグします。
-
ページ上のデータセットのフラグメントをクリックしてください。
-
右側のメニューの「データセット」で、 をクリックし、「データセット」 （
を選択]をクリックします。
-
目的のデータセットを選択し、 をクリックしてを選択します。
データセットは、ページ上にデフォルトの表示モード（カード表示、リスト表示、または表表示）で表示されます。利用可能なビュー、アクション、フィルター、ソートオプションは、データセットの設定によって異なります。
URLトークンのマッピング
Liferay DXP 2026.Q3+ リリース機能 (LPD-38564)
データセットの エンドポイントURLには、中括弧で囲まれたプレースホルダーであるトークンを含めることができます。一般的なケースは、 1 対多のオブジェクト関係 エンドポイント、例えば /o/c/universities/{universityId}/universityStudentsで、データセットには {universityId} の値が存在しない場合です。データセットフラグメントで値を指定します。
トークンは、データセットの REST エンドポイントと、その 高度なオプション パラメータ セクションのパラメータ フィールドに表示されます。パラメータ内のトークン（例： filter=contains(friendlyUrlPath,'{path}')）は、エンドポイント パス内のトークンと同じようにマッピングされます。
始める前に、 データセットフラグメントをページ に追加し、データセットを選択します。 URLトークンマッピングパネルは、選択したデータセットのURLに少なくとも1つのトークンが含まれている場合にのみ表示されます。パネルの最初の行には、「完了」または「未完了」のステータスが表示されます。ステータスが「完了」と表示されるのは、URL内のすべてのトークンがマッピングされた場合のみです。
-
ページを編集用に開いた状態で、ページ上の データセット フラグメントをクリックします。
-
右側のメニューで、 URLトークンマッピング パネルに移動します。
-
マッピングしたいトークンを選択してください。
URL にトークンが 1 つしかない場合、 トークン ドロップダウンでそれが事前に選択されます。複数のトークンがある場合は、いずれか1つを選択する必要があります。各オプションには「マッピング済み」または「マッピングなし」というラベルが付いています。
-
マッピング ドロップダウンを開き、モードを選択します。
各トークンには2つのモードが用意されており、フラグメントの位置と選択したトークンによっては、さらに最大2つのモードが表示されます。詳細については、 マッピング モード を参照してください。
-
マッピングのドロップダウンメニューの下にあるフィールドに、トークンの値を入力してください。
モードによってフィールドが変わります。
トークン値を入力してください: トークン値フィールドに値を入力してください。
選択したエンティティにマッピング: をクリックし、 エンティティを選択 (
)、項目を選択し、フィールドのドロップダウンで識別子を選択します。ページコンテキストエンティティへのマッピング: フィールドドロップダウンで識別子を選択します。
自動的に解決: Liferay が値を提供するため、フィールドは表示されません。
-
URLに残っているトークンごとに、これらの手順を繰り返してください。
すべてのトークンがマッピングされると、ステータスは「完了」と表示されます。トークンが値に解決されると、データセットがプレースホルダーを置き換えます。
マッピングモード
トークンの値の決定方法に合ったモードを選択してください。この文脈において、エンティティとは、オブジェクトエントリやウェブコンテンツ記事のような単一のレコードを指します。
| モード | 使用する場合 | 設定方法 |
|---|---|---|
| 入力トークン値 | あなたは価値を知っているし、それは決して変わらない。 | トークン値欄に入力してください。 |
| 選択したエンティティにマッピングする | このデータセットには、常に1つの項目に属するレコードが表示されます。例えば、1つの大学の学生などです。 | エンティティを選択し、次に値を提供する識別子を選択します。両方とも必須です。 |
| ページコンテキストエンティティへのマッピング | このページには毎回異なる項目が表示され、それにデータセットが追随します。このモードは、 表示ページテンプレート でのみ表示されます。 | 値を提供する識別子を選択してください。それは、表示ページに表示されているレコードから取得されます。 |
| 自動的に解決する | Liferayは、現在のサイトやログインしているユーザーなど、その値を既に把握しています。 | 設定するものは何もありません。これらのトークンは、最初は次のようにマッピングされています。 {siteId}、 {scopeKey}、 {userId}、 {userExternalReferenceCode}、およびデータセットの REST アプリケーションが解決する任意のトークン。 |
選択したエンティティへのマップとページコンテキストエンティティへのマップの場合、フィールドのドロップダウンには、 ID と 外部参照コード が表示されます。 ERC（エンティティ参照コード）は、外部システム内のエンティティを扱う際に特に役立ちます。
トークンのマッピングモードを切り替えると、そのトークンに設定した値がクリアされることがあります。
| 切り替える | 現在の価値はどうなるのか |
|---|---|
| 入力トークン値 | クリア |
| 選択したエンティティにマッピングする | 選択されたエンティティを含め、クリアされました |
| ページコンテキストエンティティへのマッピング | 「選択したエンティティにマッピング」または「ページコンテキストエンティティにマッピング」で選択した識別子フィールドが引き継がれます。その他全ては解決済みです。 |
| 自動的に解決する | 解決済みの値に置き換えられました |
ページエディター内の未解決トークン
トークンが解決されていない間は、フラグメントにはテーブルの代わりにプレースホルダーが表示されます。プレースホルダーには、エンドポイントのURLとその未解決トークンが太字で表示され、空の表のアウトラインと、不足している項目を示す閉じることのできるメッセージが表示されます。
プレースホルダーが表示されている間も、ステータスは「完了」と表示されることがあります。これは、トークンがページコンテキストエンティティにマッピングされているものの、ページエディタにはまだエンティティが表示されていないことを意味します。 ドロップダウンメニューから1つを選択してください。
公開されたページでは、未解決のトークンがあっても訪問者には何もメッセージが表示されません。データセットが全く表示されません。公開する前に、ステータスが「完了」になっていること、およびデータセットがエディタに表示されていることを確認してください。
データセットの表示方法を保存および共有する
Liferay DXP 2024.Q1+/Portal GA112+
データセットに加えた変更はすべて、ブラウザのURLに括弧で囲んで含まれます。これには、 フィルター、 ソート、表示列、ページ、検索バーの状態、および 表示モード が含まれます。
ブラウザの戻るボタンや進むボタンでページを移動しても、設定は保持されます。しかし、リンクやメニュー項目から別のページに移動して戻ってくるとURLが再生成されるため、設定が失われます。
このURLの例は、1ページあたり40項目のデータセットの2ページ目を表示します。
http://localhost:8080/home?com_liferay_frontend_data_set_sample_web_internal_portlet_FDSSamplePortlet-advanced_fdsConfig=(delta:40,page:2)
Liferay DXP 2026.Q1より前のバージョンでは、URLにパラメータがより長い形式で表示され、設定が短く読みやすいリストにまとめられていませんでした。 2026年第1四半期以降のデータセットURLは、それ以前のバージョンと共有できません。
現在表示されているユーザー画面を他のユーザーと共有するには、ページのURLをコピーしてください。コピーしたリンクを開いた人は誰でも同じ構成とレイアウトを見ることができますが、表示されるデータはタイミングや権限によって異なる場合があります。
スクロール位置と列幅は保持されません。フィルター、並べ替え、表示列、ページ、検索バーの状態、および表示モードのみが復元されます。
ユーザービューの保存
Liferay DXP 2026.Q1+
これらのコントロールが表示されるようにするには、データセットマネージャーの「設定」タブで「ユーザービュー」を有効にしてください。
ログインすると、データセットフラグメントの右上にあるコントロールを使用して、フィルター、並べ替え、その他の表示設定を含むユーザービューを保存および管理できます。
ドロップダウンメニューを使用してビューを切り替え、 アクション （
）をクリックして、現在のビューを保存、名前変更、または保存済みビューから削除します。
ユーザービューの共有
Liferay DXP 2026.Q3+
ビューの共有には、データセットマネージャ（LPS-164563） リリース機能フラグ が必要です。
ページのURLをコピーすると、現在表示しているページのスナップショットが一度だけ共有されます。保存したビューを共有するのは少し異なります。共有すると、同僚はユーザービューのドロップダウンメニューに自分専用のエントリを持つことができ、そのエントリはあなたの変更内容と同期されます。自分が所有する見解のみを共有できます。
-
ユーザービューのドロップダウンメニューから、保存済みのビューを選択してください。
-
アクション （
）をクリックし、 共有ビューを選択します。 -
ユーザーの追加 フィールドを使用して、ユーザーまたはユーザー グループを選択します。
選択された受信者は、「このビューを利用できるユーザー」の下に表示されます。ユーザーグループと共有すると、そのグループのすべてのメンバーとビューが共有されます。
-
をクリックして共有します。受信者には、Liferayプラットフォームからの通知とメールが送信されます。
共有すると閲覧のみが許可され、有効期限はありません。受信者は表示内容を変更したり、他のユーザーと共有したりすることはできません。
ビューを共有すると、データが共有されるのではなく、設定が共有されます。受信者は、閲覧権限のあるレコードのみを閲覧できるため、ユーザーによって表示される行が異なる場合があります。
あなたと共有されたビューを使用する
共有ビューは、自分が保存したビューと同じドロップダウンメニューに表示されます。それらは、あなたの閲覧履歴の下の と「共有された」の下に表示されます。
共有ビューは、所有者のオリジナルビューに接続されたままになります。所有者がフィルターや並べ替えの設定を変更すると、次回そのページを開いたときにその変更が反映されます。所有する独立したコピーを作成するには、 保存ビュー… をクリックします。
共有ビューへのアクセス権の取り消し
-
ユーザービューのドロップダウンメニューから共有ビューを選択してください。
-
アクション （
）をクリックし、 共有ビューを選択します。このモーダルには、そのビューにアクセスできるすべてのユーザーが表示されます。
-
受信者の行で アクセスを削除 をクリックします。
-
変更を保存するには、 をクリックして共有 をクリックしてください。
そのビューは受信者のドロップダウンメニューに表示されなくなり、アクセス権が削除されたことは受信者に通知されません。