データセットの可視化モード
Liferay DXP 2024.Q2+/Portal GA120+
現在、この機能は リリース機能フラグ （LPS-164563）によって保護されています。
データセット内のデータ表示をカスタマイズするには、データセットマネージャを使用してフィールドを選択し、表示モードを管理します。 視覚化モードは、 テーブル、 リスト、およびカード の 3 つあります。
テーブル表示モードでは、任意の数のフィールドを追加およびカスタマイズし、それらの表示方法を選択できます。 リストやカードでは、フィールドにマッピングできる要素の数が限られています。
視覚化モードを設定したら、 データセットフラグメント を含むページにアクセスし、 表示オプションを使用して希望のモードを選択します。
データを表形式で表示する
テーブル視覚化モードを使用して、フィールドを追加、削除、並べ替え、編集し、フィールドを列にマッピングし、データをテーブルとして データセットフラグメントに表示します。
テーブル表示モードを設定するには、
-
グローバルメニュー (
を開き、 コントロールパネル タブを選択し、オブジェクトの下の データセット をクリックします。 -
アクセスしたいデータセットの 名前 を選択してください。
または、データセットエントリの横にある アクション （
）をクリックし、 編集を選択します。 -
表示モード タブを選択します。
-
テーブル タブを選択します。
-
をクリックして (
)を追加し、 テーブルにフィールドを追加します。 -
表示する項目を選択してください。
1つ以上の項目を選択してください。 検索バーを使って特定のフィールドを検索することもできますし、検索バーを空欄にして利用可能なすべてのフィールドを表示することもできます。
-
［Save（保存）］をクリックします。
フィールドを配置したら、左側のドラッグアイコンを使用してフィールドを目的の位置にドラッグ＆ドロップすることで、フィールドの順序を変更できます。
視覚化モードにフィールドを追加する
視覚化モードにフィールドを追加する際は、フィールド名を手動で指定するか、ツリー構造から利用可能なフィールドを選択できます。 追加されたフィールドがデータセットに表示されます。
追加 () をクリックして、フィールドを手動で追加するか、エンドポイントのデータソースを使用するかを選択します。
ツリービューでデータソースから選択する
表示されているツリー構造は、複雑な構造やネストされた構造内のすべてのフィールドを自動的に検出するわけではないため、一部のフィールドが表示されない場合があります。 このような場合でも、手動でフィールドを追加することができます。
「データソースから割り当てる」を選択すると、追加可能なフィールドを含むツリー構造が表示されます。
（１）構造のレベルを移動し、フィールドの横にあるチェックボックスをクリックして、それを視覚化モードに追加します。 グレー表示されているチェックボックスは、選択した表示モードではそのフィールドが利用できないことを示しています。
（２）または、上部の検索バーを使用することもできます。 一致するフィールドのみが表示され、検索クエリに関連するフィールドが強調表示されます。 構造全体を再度表示するには、検索フィールドをクリアするか、検索バーの末尾にある x をクリックしてください。
（３） すべて選択解除 をクリックすると、すべての選択が一度に解除されます。
保存 をクリックして新しいフィールドを保存し、ウィンドウを閉じます。 追加した内容を破棄して閉じるには、右上隅の キャンセル または x をクリックします。
フィールドを手動で追加する
「フィールドを手動で追加」を選択すると、テキスト入力欄が表示されます。 ツリー構造から選択する際に表示されないフィールドであっても、名前を指定して追加することができます。 これにより、オブジェクトフィールドに含まれるフィールド、またはエンドポイントスキーマで宣言されていないフィールドに関する通常の制限が回避されます。
選択したエンドポイントのAPIと正しいフィールド名については、既に熟知している必要があります。 フィールド名は入力時に検証されないため、正しく入力してください。
手動で追加したフィールドは、データソースから選択したフィールドと同様に、視覚化モードのフィールドに表示されます。 また、適切な配列表記を使用して配列フィールドや配列要素を追加したり、.NET記法を使用してネストされたフィールドを追加することもできます。 親フィールド名と子フィールド名を区切るため (例: student.studentId)。
配列フィールドの追加
配列フィールドは、他のフィールドと同様に、視覚化モードに追加できます。
-
スカラー配列情報を含むフィールド（例：ブログ記事に適用されたタグのリスト）は、テーブル表示モードでは値がカンマで区切られて表示されます。 リスト/カード表示モードでは、値は区切り文字なしで連結されます。
-
テーブル表示モードでは、ツリービューのどのレベルでも、複雑な配列情報（例えば、オブジェクトエントリ）を含むフィールドを選択できます。 リスト／カード表示モードでは、子フィールドのみを選択できます。
複雑な配列フィールドは、名前の後に []* 表記を使用します (例: organizationBriefs[]*)。 複雑な配列に属するフィールドは、親フィールドと子フィールドの間に [] という表記で識別されます (例: organizationBriefs[]name)。
デフォルトのセルレンダラーは、表示時に複雑な配列フィールド全体をJSONオブジェクトに変換します。 また、 セルレンダラークライアント拡張機能 を使用して、フォーマットされていないJSONオブジェクトをよりユーザーフレンドリーな表示に変換することもできます。
テーブル内のフィールドを編集する
視覚化モードにフィールドを追加した後、フィールドを編集してラベルを変更したり、ローカライズしたり、レンダラーを選択したり、並べ替え可能かどうかを定義したりできます。
フィールドを編集するには、フィールドの横にある アクション () をクリックし、 編集 を選択します。
ラベルの編集とローカライズ
フィールドの編集を開始すると、ラベルを変更したり、ローカライズしたりできます（1）。
-
Labelフィールドの横にある旗のアイコンをクリックし、言語を選択します。
-
翻訳したテキストをラベル欄（2）に入力してください。
翻訳されたテキストは自動的に保存されます。
フラグの横にあるローカライズステータスラベルが
翻訳済みに変わり、ローカライズが成功したことを示します。
ユーザーがポータルに該当言語を適用している場合、ローカライズされたテキストが表示されます。
フィールドのレンダラーの選択
レンダラー（3）は、コンポーネントの外観をカスタマイズするための構造化された方法です。 生の値を入力すると、レンダラーはそれに対して最も一般的な形式とUIを想定する。
データが正しく表示されるようにするには、フィールドタイプが選択したレンダラーと互換性がある必要があります。
左下のステータス、日付、日時フィールドには、デフォルトのレンダラーが適用されています。 右側には、ステータス、日付、日時のレンダラーがそれぞれのフィールドに適用されます。
フィールドをソート可能として定義する
フィールドがソート可能としてマークされている場合、ユーザーはコンテンツページでデータセットフラグメントを使用する際に、その要素をソートできます。
初期設定では、ユーザーは整数フィールドに基づいてエントリを並べ替えることができます。 ただし、並べ替えチェックボックスがオフになっている場合、整数フィールドをフィルターとして使用してエントリを並べ替えることはできなくなります（下記参照）。
データをリスト形式またはカード形式で表示する
Liferay DXP 2024.Q2+/Portal GA120+
リスト表示モードとカード表示モードは、これらのモードの要素に少なくとも1つのフィールドをマッピングするまで非表示になっています。
リストとカードの視覚化モードを使用して、フィールドを視覚化モードの要素（タイトル、説明、画像、シンボルなど）にマッピングし、データをリストまたはカードとして データセットフラグメントに表示します。
カードビューとリストビューでは、各セルが簡略化された形で表示され、一貫した外観と操作性を維持します。 その結果、カスタマイズの選択肢が限られており、 セルレンダラークライアント拡張機能 を使用してカスタマイズすることはできません。
-
グローバルメニュー (
を開き、 コントロールパネル タブを選択し、オブジェクトの下の データセット をクリックします。 -
アクセスしたいデータセット の名前 をクリックしてください。
または、データセットエントリの横にある アクション (
) をクリックし、 編集 を選択することもできます。 -
表示モード タブを選択します。
-
リスト または カード タブを開きます。
どちらの表示モードも設定は同様です。唯一の違いは、データの表示方法です。
-
要素にフィールドを割り当てるには、 追加 (
) をクリックし、追加方法を選択します。データソースから割り当て をクリックして、利用可能なフィールドのツリービューから選択します。 をクリックしてフィールドを手動で割り当てます から にフィールド名を入力します。
利用可能な要素は、タイトル、説明、画像、シンボルです。 画像要素はシンボル要素を上書きするため、どちらか一方のみを指定すればよいことに注意してください。
ヒントSymbol要素を使用するには、Clay Icon Referenceのアイコン名に一致する値を持つテキスト型オブジェクト・フィールドを作成する必要があります。
例えば、ショッピングカートのシンボルを使用したい場合は、オブジェクト定義を作成し、テキストフィールドを追加して、好きな名前を付け、オブジェクトエントリを作成するときにフィールドに
shopping-cartと入力します。 フィールドをシンボル要素に割り当てると、ショッピングカートのシンボルが表示されます。
以下に、同じデータを画像を用いたカード形式と、粘土のアイコンをシンボルとして用いたリスト形式で表示した例を示します。
デフォルトの表示モードを定義する
データセットの断片がページ内で使用された際に最初に表示されるデフォルトの視覚化モードを定義できます。
-
グローバルメニュー (
を開き、 コントロールパネル タブを選択し、オブジェクトの下の データセット をクリックします。 -
アクセスしたいデータセット の名前 をクリックしてください。
または、データセットエントリの横にある アクション (
) をクリックし、 編集 を選択することもできます。 -
設定 タブを選択します。
-
デフォルトの表示モード を選択します。
表示可能な場合にのみ、視覚化モードをデフォルトとして設定できます。 デフォルトモードが設定されていて、それが非表示になった場合、アルファベット順で最初のモードが自動的にデフォルトとして選択されます。