コメントブロック

ブロック:コメントCommunity Edition+

はじめに

コメントブロックは、業務レコードにコメント機能を追加するためのブロックです。タスク、記事、チケット、顧客などの詳細ページやポップアップに追加すると、現在のレコードに対するコメントの閲覧、返信、作成ができます。

ヒント

コメントブロック自体はコレクションを作成しません。使用前に、コメントを保存するためのコレクションを用意し、コメント本文、コメント投稿者、コメント所有者、コメント日時などのフィールドを設定してください。

ブロックを追加する

コメントブロックは通常、業務レコードの詳細ページまたはポップアップに追加します。

  1. 対象レコードの詳細ページまたはポップアップを開く
  2. 「ブロックを追加」をクリックする
  3. 「コメント」を選択する
  4. コメントを保存するコレクションを選択する
  5. 画面の案内に従ってフィールドマッピングを完了する

コメントブロックを関連から作成した場合、NocoBase は現在の関連に基づいてコメント所有者フィールドと現在のレコード値を自動的に識別します。この場合、「コメント所有者フィールド」と「コメント所有者フィールド値」は自動入力されるため、通常は手動設定は不要です。

コメントコレクションから直接ブロックを作成した場合は、コメント所有者フィールドと値を手動で設定する必要があります。

フィールドマッピング

コメントブロックは「フィールドマッピング」によって、各コメントをどのように表示・保存するかを判断します。

設定項目説明
コメント本文フィールドコメント本文を保存するフィールドを選択します。
コメント投稿者フィールドユーザーコレクションに関連する多対一フィールドを選択します。
コメント所有者フィールド現在の業務レコードの識別子を保存するフィールドを選択します。
コメント所有者フィールド値現在の業務レコードの値を指定します。例:{{ ctx.popup.record.id }}
コメント日時フィールド表示とデフォルトソートに使用するコメント日時フィールドを選択します。

コメント所有者フィールド

「コメント所有者フィールド」は、現在のレコードに対応するコメントを絞り込むために使われ、新しいコメントを作成するときにも書き込まれます。

手動で選択する場合、ドロップダウンには通常のスカラーフィールドのみが表示され、関連フィールドは表示されません。一般的な設定は次のとおりです。

業務コレクションコメントコレクションの所有者フィールドコメント所有者フィールド値
タスクtaskId{{ ctx.popup.record.id }}
記事postId{{ ctx.popup.record.id }}
チケットticketId{{ ctx.popup.record.id }}

現在のレコードが id 以外の一意識別子を使用している場合は、「コメント所有者フィールド値」を対応するフィールドに変更します。例:{{ ctx.popup.record.uuid }}

関連から作成した場合の自動マッピング

業務レコードの関連からブロックを作成した場合、コメントブロックはその関連の外部キーフィールドを優先的にコメント所有者フィールドとして使用し、現在のレコード値をコメント所有者フィールド値として使用します。

たとえば、タスクコレクションとタスクコメントコレクションの間に一対多の関連があり、タスクコメントコレクションの外部キーフィールドが taskId の場合、タスク詳細ページの関連からコメントブロックを追加すると、ブロックは自動的に次の設定を使用します。

  • コメント所有者フィールド:taskId
  • コメント所有者フィールド値:現在のタスクレコードの識別子

この方法は多くのシナリオに適しており、手動設定のミスを減らせます。

ブロック設定

ページサイズ

1 ページに表示するコメント数を設定します。選択できる値は 5102050100200 です。

データ範囲

コメント一覧のデータフィルター範囲を設定します。特定のステータスや権限条件に一致するコメントだけを表示するなど、追加条件を設定できます。

詳細については、データ範囲の設定をご覧ください。

デフォルトソートルール

コメント一覧のデフォルトソートを設定します。通常はコメント日時フィールドの昇順または降順で並べ替えます。

デフォルトソートを別途設定していない場合、コメントブロックは「コメント日時フィールド」をデフォルトのソートフィールドとして優先的に使用します。

詳細については、ソートルールの設定をご覧ください。

最後のページへ自動ジャンプ

デフォルトでは無効です。無効の場合、コメントブロックを開くと最初のページに留まります。

有効にすると、コメントブロックは初回読み込み時に最後のページへジャンプします。最新のコメントを優先して表示したい場合に適しています。