概要
Discussions は、ボードが作成されたサイトの 5 つのリスト (4 つのカスタム リストと 1 つのドキュメント ライブラリ) にすべてを保存します。これらは**サイト コンテンツ**にある通常の SharePoint リストで、他のリストと同様にサイトのアクセス許可、バージョン管理、保持、検索の対象になります。この記事は、リストに対してビュー、レポート、フローを作成する管理者や、アイテムを手動で修正する必要があるすべての人のための列のリファレンスです。データの保存場所とテナント外に送られるものについては「KB10411. Discussions がデータを保存する場所: リスト、列、プライバシー」で扱っています。この記事はスキーマについてです。説明しているバージョンは 26.10.3 です。
リストの作成と認識の仕組み
リストは、サイト所有者がサイトで最初にボードを作成したとき (未設定 画面の 新しい掲示板) に Web パーツが作成します。これにはリストの管理アクセス許可が必要です。各リストは次の設定で作成されます。
- バージョン管理オン、コンテンツ タイプオフ、グリッド編集オフ、非表示でない、検索クロールの対象。
- 4 つのリストでは添付ファイルが有効。フォルダーの作成はライブラリでのみ有効。
- すべてのカスタム列が既定のビューに追加される。
リストのタイトルは、リストを作成するユーザーのインターフェイス言語から取得されます。英語のサイトでは Discussions Boards、Discussions Topics、Discussions Posts、Discussions Subscriptions、Discussions Assets、ロシア語のサイトでは Доски обсуждений、Темы обсуждений、Сообщения обсуждений、Подписки обсуждений、Файлы обсуждений です。列の表示名も同じルールに従います。内部名は常に以下の表のとおりで、常に Vtx で始まります。
Web パーツはタイトルに依存しません。各リストは固定 ID を持つマーカー列によって認識されるため、リストの名前を自由に変更しても見つけられます。まず既定のタイトルで検索し、次に同じテンプレートの表示されているリストの中からマーカー列で検索します。
| リスト | 既定のタイトル | テンプレート | マーカー列 | 内容 |
|---|---|---|---|---|
| 掲示板 | ディスカッション掲示板 | カスタム リスト | モード (VtxMode) | ボードごとに 1 アイテム: モード、カテゴリ、承認ルール |
| トピック | ディスカッショントピック | カスタム リスト | 掲示板 (VtxBoard) | トピックごとに 1 アイテム。カウンターと状態を含む |
| 投稿 | ディスカッション投稿 | カスタム リスト | トピック (VtxTopic) | 返信ごとに 1 アイテム。親の返信とスレッドのパスを含む |
| サブスクリプション | ディスカッション購読 | カスタム リスト | ターゲットの種類 (VtxTargetType) | 誰がどのボードまたはトピックをどの頻度でフォローしているか |
| アセット | ディスカッションアセット | ドキュメント ライブラリ | ディスカッションアセット (VtxDiscussionsAsset) | 投稿のインライン画像。年ごとのフォルダーに保存 |

📝 注
以前のバージョンでセットアップされたサイトには、ディスカッション購読 リスト、ディスカッションアセット ライブラリ、モデレーション用の列がない場合があります。リストの管理を持つユーザーが、この 2 つのリストが存在する前に Web パーツが構成されたページを開くとすぐに、Web パーツが不足しているリストと列を追加します。ボードのセットアップ (掲示板を作成 と 掲示板を使用) では常に同じチェックが実行されるため、後のバージョンで導入された列もそこで追加されます。既に存在するリストや列 (ID で認識) が二重に作成されることはありません。リストの管理を持たないユーザーはリストを検索するだけです。
以下の表のインデックスは、大きなリストでもフィルターが高速になるように、列が SharePoint のインデックス付きで作成されたことを意味します。既定値は、その列なしでアイテムが作成されたときに SharePoint が割り当てる値です。Web パーツはほとんどの列を明示的に設定します。
ディスカッション掲示板
ボードごとに 1 アイテム。タイトル は 掲示板 ドロップダウンに表示されるボード名です。モデレーターは、タイトル、説明、モード、カテゴリ、承認の設定を Web パーツの 掲示板の設定 パネルで編集します。リストのフォームはその代替手段です。
| 列 | 内部名 | 種類 | インデックス | 既定値 / 値 | 用途 |
|---|---|---|---|---|---|
| 説明 | VtxDescription | 複数行テキスト (プレーン テキスト) | いいえ | 空 | ボードの説明。掲示板の設定 パネルで編集します。このバージョンでは Web パーツに表示されません |
| モード | VtxMode | 選択肢 | いいえ | Discussion、QnA、Mixed。既定は Discussion | ボードのモード: ディスカッションのみ、質問と回答のみ、またはその両方。別のモードを選ばない限り、新しいボードは Mixed で作成されます |
| カテゴリ | VtxCategories | 複数行テキスト (プレーン テキスト) | いいえ | 空 | ボードのカテゴリ。1 行に 1 つの名前。「KB10423. カテゴリによるトピックの整理」を参照 |
| トピック | VtxTopicCount | 数値 | いいえ | 0 | ボードのトピック数: 作成時に 0 に設定され、トピックが作成されると増加し、Web パーツからトピックが削除されると減少します (ベスト エフォート)。このバージョンでは Web パーツに表示されません |
| 承認が必要 | VtxRequireApproval | はい/いいえ | いいえ | いいえ | はい: リストの管理を持たないユーザーのトピックと返信は Pending として作成され、モデレーション キューで待機します |
ディスカッショントピック
トピックごとに 1 アイテム。タイトル はトピックのタイトル、登録日時 と 登録者 は投稿日時と作成者、添付ファイル はトピックに添付されたファイルを保持します。
| 列 | 内部名 | 種類 | インデックス | 既定値 / 値 | 用途 |
|---|---|---|---|---|---|
| 本文 | VtxBody | 複数行テキスト (拡張リッチ テキスト) | いいえ | 空 | サニタイズ済み HTML としてのトピックの本文 |
| 掲示板 | VtxBoard | ディスカッション掲示板 への参照 (タイトル) | はい | - | トピックが属するボード |
| カテゴリ | VtxCategory | 1 行テキスト | はい | 空 | カテゴリ名。カテゴリのないトピックでは空 |
| 種類 | VtxTopicType | 選択肢 | はい | Discussion、Question。既定は Discussion | トピックがディスカッションか質問か |
| ステータス | VtxStatus | 選択肢 | はい | Open、Answered、Locked。既定は Open | モデレーターがトピックをロックしている間は Locked。それ以外では、ベスト アンサーを指定すると Answered、ベスト アンサーの指定を解除するか指定された返信を削除すると Open。Web パーツが表示する回答済みの状態はこの列ではなく 承認された回答 から導出されるため、質問をロックしてもそのバッジやビューは変わりません |
| 固定 | VtxIsSticky | はい/いいえ | はい | いいえ | ピン留めされたトピックが先頭に表示されます |
| おすすめ | VtxIsFeatured | はい/いいえ | はい | いいえ | おすすめ ビューに表示されます |
| 返信 | VtxReplyCount | 数値 | いいえ | 0 | 承認済みの返信数。Web パーツが維持します |
| 閲覧数 | VtxViewCount | 数値 | いいえ | 0 | ブラウザー セッションでトピックが最初に開かれたときに増加します |
| 最終アクティビティ | VtxLastActivity | 日付と時刻 | はい | - | 承認済みの返信が追加された時刻、または返信が承認された時刻。初期値はトピックの作成時刻です。トピック一覧の並べ替えに使用します。返信を削除または拒否しても、前のアクティビティ時刻には戻りません |
| 最終返信者 | VtxLastReplyBy | ユーザー | いいえ | - | 最後の承認済み返信の作成者 - モデレーション キューから承認された返信の場合は、モデレーターではなくその返信の作成者 |
| 承認された回答 | VtxAcceptedPostId | 数値 | いいえ | 0 | ディスカッション投稿 内のベスト アンサーの ID。ない場合は 0。回答済みの状態の源: 回答済み バッジと 回答済み ビューは値が 0 より大きいトピック、未回答 ビューは値が 0 の質問です |
| いいね | VtxLikeCount | 数値 | いいえ | 0 | トピックのいいね数 |
| いいねした人 | VtxLikedBy | ユーザー (複数) | いいえ | - | トピックにいいねしたユーザー。ユーザーごとに 1 回 |
| 承認ステータス | VtxApprovalStatus | 選択肢 | はい | Approved、Pending、Rejected。既定は Approved | モデレーションの状態。メンバーには Approved のアイテムと自分のアイテムが、モデレーターにはすべてが表示されます |
| メンション | VtxMentions | ユーザー (複数) | いいえ | - | 本文で @ メンションされたユーザー。通知用 |
| 報告 | VtxReportCount | 数値 | はい | 0 | 報告の件数。0 より大きい間、トピックはモデレーション キューに表示されます |
| 報告者 | VtxReportedBy | ユーザー (複数) | いいえ | - | トピックを報告したユーザー。ユーザーごとに 1 回 |
| レガシー ID | VtxLegacyId | 1 行テキスト | はい | 空 | トピックのインポート元となったクラシック ディスカッション ボード アイテムの {source list ID}:{item ID}。インポーターがインポート済みのトピックをスキップできるようにします |
ディスカッション投稿
返信ごとに 1 アイテム。タイトル は Re: の後にトピックのタイトルが続く形で設定され、登録日時 と 登録者 は投稿日時と作成者、添付ファイル は返信に添付されたファイルを保持します。
| 列 | 内部名 | 種類 | インデックス | 既定値 / 値 | 用途 |
|---|---|---|---|---|---|
| 本文 | VtxBody | 複数行テキスト (拡張リッチ テキスト) | いいえ | 空 | サニタイズ済み HTML としての返信の本文 |
| トピック | VtxTopic | ディスカッショントピック への参照 (タイトル) | はい | - | 返信が属するトピック |
| 親投稿 | VtxParentPost | ディスカッション投稿 への参照 (タイトル) | はい | - | この返信が応答している返信。最上位の返信では空 |
| パス | VtxPath | 1 行テキスト | はい | 空 | Web パーツが書き込む先祖の返信の ID (例: /12/15/)。最上位の返信では / |
| レベル | VtxDepth | 数値 | いいえ | 0 | 入れ子のレベル: 最上位の返信は 0、それへの返信は 1、以下同様 |
| 承認された回答 | VtxIsAccepted | はい/いいえ | いいえ | いいえ | ベスト アンサーに指定された返信では はい。トピックごとに最大 1 つ |
| いいね | VtxLikeCount | 数値 | いいえ | 0 | 返信のいいね数 |
| いいねした人 | VtxLikedBy | ユーザー (複数) | いいえ | - | 返信にいいねしたユーザー |
| 承認ステータス | VtxApprovalStatus | 選択肢 | はい | Approved、Pending、Rejected。既定は Approved | 返信のモデレーションの状態 |
| メンション | VtxMentions | ユーザー (複数) | いいえ | - | 返信で @ メンションされたユーザー |
| 報告 | VtxReportCount | 数値 | はい | 0 | 返信に対する報告の件数 |
| 報告者 | VtxReportedBy | ユーザー (複数) | いいえ | - | 返信を報告したユーザー |
| レガシー ID | VtxLegacyId | 1 行テキスト | はい | 空 | この返信のインポート元となったクラシックの返信の {source list ID}:{item ID} |
トピックおよび親の返信への参照は、連鎖削除や削除制限の動作なしで作成されます。リストでトピックを削除しても返信は削除されず、返信を削除してもその下の返信は削除されません。Web パーツの 削除 コマンドの動作は異なります。トピックをすべての返信および ディスカッションアセット ライブラリのインライン画像と共に削除し、自身に返信が付いている返信の削除は拒否します。Web パーツは、親が見つからない返信をスレッドの最上位に配置して、何も見えなくならないようにします。「KB10432. カウンター、最終アクティビティ、ベスト アンサーが正しく表示されない」を参照してください。
トピックを削除すると、アセット ライブラリ内のインライン画像の削除も試行されます。このクリーンアップが失敗した場合、ファイルが残ることがあります。

ディスカッション購読
ユーザーと対象ごとに 1 アイテム。タイトル は Board:ID または Topic:ID です。
| 列 | 内部名 | 種類 | インデックス | 既定値 / 値 | 用途 |
|---|---|---|---|---|---|
| ユーザー | VtxUser | ユーザー | はい | - | サブスクライバー |
| ターゲットの種類 | VtxTargetType | 選択肢 | はい | Board、Topic。既定は Board | サブスクリプションの対象がボードかトピックか |
| ターゲット ID | VtxTargetId | 数値 | はい | 0 | ボード アイテムまたはトピック アイテムの ID |
| 頻度 | VtxFrequency | 選択肢 | いいえ | Immediate、Daily、Weekly。既定は Immediate | サブスクライバーが通知を受け取りたい頻度 |
| 掲示板 | VtxBoard | ディスカッション掲示板 への参照 (タイトル) | はい | - | サブスクリプションのボード (トピックのサブスクリプションでも)。フローでボード別にグループ化できるようにします |
ユーザーは対象ごとに 1 アイテムを持ちます。別の頻度で再度フォローすると既存のアイテムが更新され、フォローを解除すると削除されます。トピックの作成者は Immediate で自動的にそのトピックをフォローします。Web パーツはこのリストを維持するだけで、メールの送信は Power Automate フローの役割です。そのデータ連携の仕様は「KB10414. Discussions の通知のしくみ: サブスクリプション、メンション、Power Automate」で説明しています。
ディスカッションアセット
エディターでトピックや返信に挿入した画像 (貼り付け、ドロップ、または 画像を挿入 で選択) のためのドキュメント ライブラリです。各画像は一意の名前で、現在の年にちなんだ名前のフォルダー (2026、2027、…) にアップロードされ、年ごとに整理されます。ただし、フォルダー内のアイテム数がリスト ビューのしきい値を超えないことを保証するものではありません。このライブラリには 1 つのカスタム列があります。
| 列 | 内部名 | 種類 | インデックス | 既定値 / 値 | 用途 |
|---|---|---|---|---|---|
| ディスカッションアセット | VtxDiscussionsAsset | 1 行テキスト | いいえ | 空 | マーカー列のみ。タイトルに関係なくライブラリを認識できるようにします |
ファイルを添付 でトピックや返信に添付したファイルはここには保存されません。それらはトピックまたは返信アイテムのリスト アイテム添付ファイルであり、ディスカッショントピック または ディスカッション投稿 リストのアイテムと共に保持されます。
選択肢の値
選択肢の列には、インターフェイスの言語に関係なく以下の英語の値が保存されます。Web パーツは表示用にそれらを翻訳します。
| 列 | 値 | 表示 |
|---|---|---|
モード (VtxMode) | Discussion、QnA、Mixed | ディスカッションのみ、質問と回答のみ、ディスカッションと質問 |
種類 (VtxTopicType) | Discussion、Question | ディスカッション、質問 |
ステータス (VtxStatus) | Open、Answered、Locked | ロック済み バッジ。回答済み バッジは 承認された回答 から導出されます (上記参照)。Open にはバッジなし |
承認ステータス (VtxApprovalStatus) | Approved、Pending、Rejected | 承認待ち バッジと 拒否済み バッジ。Approved にはバッジなし |
ターゲットの種類 (VtxTargetType) | Board、Topic | - |
頻度 (VtxFrequency) | Immediate、Daily、Weekly | 即時、毎日のダイジェスト、毎週のダイジェスト |
リストで編集できるもの
Web パーツはサインイン ユーザーとして SharePoint REST API 経由でリストに書き込み、読み込みのたびにリストを読み直すため、リストのフォームで行った変更は次回の再読み込み時に反映されます。安全に編集できる列もあれば、Web パーツが維持しているため触らない方がよい列もあります。
| リストで安全に編集できる | Web パーツが維持する |
|---|---|
| ボードの タイトル、説明、モード、カテゴリ、承認が必要 - または、より便利な Web パーツの 掲示板の設定 パネル | トピックの 返信、閲覧数、最終アクティビティ、最終返信者 とボードの トピック |
| トピックの カテゴリ、固定、おすすめ、ステータス (Locked) と、トピックまたは返信の 承認ステータス。トピックのタイトル、カテゴリ、本文は、トピック ビューの 編集 でも変更できます | トピックの 承認された回答 と返信の 承認された回答 - 必ず一緒に変更してください。回答済みの状態は 承認された回答 に従います |
| トピックまたは返信の 本文 (プレーンな HTML。Web パーツは表示時にサニタイズします) | 返信の パス、レベル、親投稿、トピック - 返信を手動で移動するとスレッドが壊れます |
| サブスクリプションの 頻度 | いいね / いいねした人、報告 / 報告者 |
カウンターは読み込んだ値を増減して更新され、操作のたびにリストから再集計されるわけではありません。書き込みの失敗や同時更新で不正確になることがあり、次の操作で手動設定した値が修正されるとは限りません。インポートした過去の「いいね」数は、対応するユーザー列の人数を超える場合があります。この過去の件数は保持してください。承認状態はモデレーション コマンドで変更してください。列を直接編集しても、関連するカウンターは更新されません。
❗ 重要
Vtx 列を削除したり名前を変更したりせず、その種類も変更しないでください。Web パーツはマーカー列の ID でリストを認識し、他のすべての列を内部名で読み取ります。列がないとボードはエラーで失敗します。列やリストの表示名の変更は無害です。
💡 ヒント
リストは通常の SharePoint リストなので、Web パーツが提供しないものを作成できます。モデレーター向けの 承認ステータス = Pending でフィルターしたトピックのリスト ビュー、レポート用のトピックの Excel にエクスポート、ディスカッショントピック と ディスカッション投稿 に対する Power BI レポート、メール配信のための ディスカッション購読 に対する Power Automate フローなどです。