ver.2サポートサイト

レコードリストブロック

機能概要

レコードリストブロックは、サイト上のページに、セミナーやニュース一覧といったDBのレコード情報を表形式で公開できるブロックです。

※ レコードリストブロックを作成するには、予めDBを作成する必要があります。

※ レコードリストブロックをサイト上で表示する為には、予めサイトやページを作成する必要があります。詳しくは、サイト機能の全体像の操作画面の項目をご参照ください。

※ 作成したレコードリストブロックはページに設置することで、機能します。

※ ページ作成時/編集時にレコードリストブロック、もしくはレコードリストブロックと同時にレコード検索ブロックを作成することも可能です。

機能仕様

レコードリストブロックの作成

1.ブロック一覧

サイト管理画面からレコードリストブロックを作成します。

サイト管理の左メニューからテスト環境＞ブロックをクリックします。

ブロック一覧のプルダウンから「レコードリスト」を選択します。

「レコードリスト」選択後、レコードリストブロックを作成する際、「＋」ボタンをクリックします。

2.レコードリストブロック作成モーダル

レコードリストブロックの追加モーダルが表示されますので、必要事項を記入します。

レコードアイテム同時作成で「作成する」を選択した場合、レコードアイテムブロックを配置するページやレコードアイテムブロックを自動生成します。

※レコードアイテム同時作成で作成できるページは非認証ページとして自動生成しますが、認証ページ内に配置したレコードアイテムブロックとして作成する場合は、

認証ページ上で新規レコードリストブロック作成＞レコードアイテムブロック同時作成を行うことで、該当する認証エリア内の認証ページとして自動生成します。

※レコードアイテムブロックの作成/編集方法は、レコードアイテムブロックをご確認ください。

1.基本設定

レコードリストブロックにおいて、どのアプリのどのDBのリストを作成するか指定します。

レコードリストブロックの作成には、事前に対象となるDBのレコード公開範囲を設定する必要があります。

レコードリスト作成時に、レコード詳細情報を表示する「レコードアイテム」ブロックを同時に作成するかどうか指定します。

２.初期フィールド選択

レコードリストブロックで表示するフィールドを選択します。

※パスワードフィールドは、レコードリストブロックで使用することができません。

※ファイルフィールドは、1レコードリストあたりに対して、1フィールドのみ使用することができます。

※テキストエリアフィールドは、1レコードリストあたりに対して、5フィールドのみ使用することができます。

ページ作成/編集時に、レコードリストブロックとレコード検索ブロックを同時に作成する場合、

レコードリストブロック作成後、続けてレコード検索ブロック作成モーダルが表示、レコード検索ブロックを作成します。

設定方法の詳細は、レコード検索ブロックをご参照ください。

レコードリスト設定

レコードリストブロックの編集/設定方法についてはビジュアル設定とソース設定で異なります。

それぞれ以下のコンテンツをご確認ください。

・レコードリストブロックのビジュアル設定

・レコードリストブロックのソース設定

参照先DBのフィールド追加

レコードリスト上に参照フィールドの参照先DB内に含まれるフィールドを追加することができます。

※1 レコード公開範囲で設定済みのDBを参照している参照フィールドのみ選択可能です。

      参照先レコード値は参照先DBのレコード公開範囲の設定内容が適用されます。

※2 参照先DBのレコード公開範囲が未指定の場合、下記メニューに参照先フィールドが表示されません。

　　ビジュアル設定：リストパーツのフィールド追加プルダウンメニュー
　　ソース設定：コード挿入のフィールド選択プルダウンメニュー

※3 参照フィールドの参照先レコードが非公開の場合は、参照先レコードのフィールド値はnull表示になります。

※4 参照先レコードのフィールド値がnullの場合は、「値なし」と表示されます。

※5 複数参照の参照先フィールドは、1レコードリストあたりに対して、5フィールドのみ使用することができます。

※6 レコードリストブロック作成時に「レコードアイテム同時作成」を「作成する」に選択した場合、レコードリスト上で使用するフィールドに参照先フィールドが含まれると、レコードアイテムも同じ参照先フィールドを使用フィールドとして追加されます。

※7 追加可能なフィールドタイプは、参照フィールドの参照レコード数の設定によって異なります。詳細は下記の表をご参照ください。

リスト設定

レコードリストブロックの初期表示のフィルタ設定、初期ソート、初期表示件数などの指定を設定することができます。

フィルタ

レコードリストブロックが初期表示される際のレコード表示について、任意の条件で抽出表示する設定ができます。

同一設定内にアクセス日との関係抽出とフィールド条件抽出を作成した場合、AND条件で結ばれます。

アクセス日との関係抽出 例：過去1週間に更新された対応履歴を抽出

アクセス日との関係抽出かつフィールド条件抽出 例：開催日が今日から1か月以内かつ「受付ステータス」というセレクトフィールドの値が「受付中」のセミナーだけを抽出

フィルタのフィールド条件抽出に参照先DBのフィールドを指定する場合

参照先DBのフィールド値に応じて、レコードリスト上に表示するレコードを抽出することができます。
参照フィールドが1レコード参照の場合のみ、参照先DB内のインデックスが設定されているフィールドタイプ、テキストエリアフィールド、システムフィールド（レコードID、作成日時、最終更新日時）が指定できます。

インデックスが設定されている使用可能フィールドタイプ：テキスト、メールアドレス、セレクト、マルチセレクト、整数、数値、電話番号、日時、日付、月日、時刻

フィールド条件抽出 例１：参照先DBの商品マスタの「販売ステータス」というセレクトフィールドの値が「販売前、販売中」のフィールドを抽出

フィールド条件抽出 例２：参照先DBの商品マスタの「販売ステータス」というセレクトフィールドの値が「販売中」、かつ、「製造年月日」という日付フィールドで「2022年3月16日以前」のフィールドを指定

※高度な条件設定にて、 条件式による抽出条件指定が可能です。

※高度な条件の設定においても参照フィールドを使用できます。

　指定フォーマット：@参照フィールド識別名.参照先DBフィールド識別名

　例）販売中のカタログ資料の資料一覧

　参照先DBの販売ステータスのフィールド識別名SalesStatusのラベルID2(販売中)の場合、@ReferenceField.SalesStatus = '2'とフォーマットを指定する。

　また、参照先DBのフィールド値（参照先レコード）による指定も可能です。

　指定フォーマット：@reference._id = 2

　参照先DB内に該当レコードIDが存在する場合、抽出表示の条件として使用できます。

※条件に指定する参照先DBのフィールドが削除された場合、レコードリストブロックへアクセスした場合の表示は500エラーが表示されます。

※参照先DBの参照フィールドにおいて、参照先DBのレコード公開範囲の設定内容に影響しません。

初期ソート

レコードリストブロックを初期表示する際の並び順を指定します。

インデックスが設定されている使用可能フィールドタイプ、もしくは、システムフィールドの中からソートする項目を指定、

表示するデータの昇順、もしくは、降順の指定を行うことができます。

※使用可能フィールドタイプ：テキスト、メールアドレス、セレクト、整数、数値、電話番号、日時、日付、月日、時刻

初期表示件数

レコードリストブロック上で表示するレコード件数を設定することができます。

初期設定は「20件」となっており、「1～100件」までの範囲の中から表示件数を指定することができます。

参考情報

ファイルダウンロードURLの独自ドメイン対応

レコードリスト上にファイルフィールドを使用、ファイルダウンロードURLのリンクが表示される際、

ファイルフィールドに添付されているファイルをダウンロードできるURLが生成されます。

そのURL内の一部にサイトドメイン名が含まれますが、独自ドメインオプションを使用している場合、

ファイルフィールドのファイルダウンロードURL内の本番環境のサイトドメイン(spiral-site.com)が独自ドメイン名に自動で差し変わります。

日時フィールドのタイムゾーン指定

ブロック作成時および基本設定モーダル上からレコードリスト上で使用する日時フィールド、作成日時、最終更新日時のタイムゾーンを指定することができます。

制限事項

レコードリストブロックの作成可能ブロック数や使用できるフィールド数、表示可能総レコード数などは上限が設定されています。

詳細については各種上限値をご参照ください。