概要

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)投稿のインライン画像。年ごとのフォルダーに保存

サイト コンテンツの 5 つのリスト

サイト コンテンツの 5 つのリスト

📝 注
以前のバージョンでセットアップされたサイトには、ディスカッション購読 リスト、ディスカッションアセット ライブラリ、モデレーション用の列がない場合があります。リストの管理を持つユーザーが、この 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ディスカッション掲示板 への参照 (タイトル)はい-トピックが属するボード
カテゴリVtxCategory1 行テキストはい空カテゴリ名。カテゴリのないトピックでは空
種類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 回
レガシー IDVtxLegacyId1 行テキストはい空トピックのインポート元となったクラシック ディスカッション ボード アイテムの {source list ID}:{item ID}。インポーターがインポート済みのトピックをスキップできるようにします

ディスカッション投稿

返信ごとに 1 アイテム。タイトル は Re: の後にトピックのタイトルが続く形で設定され、登録日時 と 登録者 は投稿日時と作成者、添付ファイル は返信に添付されたファイルを保持します。

列内部名種類インデックス既定値 / 値用途
本文VtxBody複数行テキスト (拡張リッチ テキスト)いいえ空サニタイズ済み HTML としての返信の本文
トピックVtxTopicディスカッショントピック への参照 (タイトル)はい-返信が属するトピック
親投稿VtxParentPostディスカッション投稿 への参照 (タイトル)はい-この返信が応答している返信。最上位の返信では空
パスVtxPath1 行テキストはい空Web パーツが書き込む先祖の返信の ID (例: /12/15/)。最上位の返信では /
レベルVtxDepth数値いいえ0入れ子のレベル: 最上位の返信は 0、それへの返信は 1、以下同様
承認された回答VtxIsAcceptedはい/いいえいいえいいえベスト アンサーに指定された返信では はい。トピックごとに最大 1 つ
いいねVtxLikeCount数値いいえ0返信のいいね数
いいねした人VtxLikedByユーザー (複数)いいえ-返信にいいねしたユーザー
承認ステータスVtxApprovalStatus選択肢はいApproved、Pending、Rejected。既定は Approved返信のモデレーションの状態
メンションVtxMentionsユーザー (複数)いいえ-返信で @ メンションされたユーザー
報告VtxReportCount数値はい0返信に対する報告の件数
報告者VtxReportedByユーザー (複数)いいえ-返信を報告したユーザー
レガシー IDVtxLegacyId1 行テキストはい空この返信のインポート元となったクラシックの返信の {source list ID}:{item ID}

トピックおよび親の返信への参照は、連鎖削除や削除制限の動作なしで作成されます。リストでトピックを削除しても返信は削除されず、返信を削除してもその下の返信は削除されません。Web パーツの 削除 コマンドの動作は異なります。トピックをすべての返信および ディスカッションアセット ライブラリのインライン画像と共に削除し、自身に返信が付いている返信の削除は拒否します。Web パーツは、親が見つからない返信をスレッドの最上位に配置して、何も見えなくならないようにします。「KB10432. カウンター、最終アクティビティ、ベスト アンサーが正しく表示されない」を参照してください。

トピックを削除すると、アセット ライブラリ内のインライン画像の削除も試行されます。このクリーンアップが失敗した場合、ファイルが残ることがあります。

SharePoint の ディスカッショントピック リスト

SharePoint の ディスカッショントピック リスト

ディスカッション購読

ユーザーと対象ごとに 1 アイテム。タイトル は Board:ID または Topic:ID です。

列内部名種類インデックス既定値 / 値用途
ユーザーVtxUserユーザーはい-サブスクライバー
ターゲットの種類VtxTargetType選択肢はいBoard、Topic。既定は Boardサブスクリプションの対象がボードかトピックか
ターゲット IDVtxTargetId数値はい0ボード アイテムまたはトピック アイテムの ID
頻度VtxFrequency選択肢いいえImmediate、Daily、Weekly。既定は Immediateサブスクライバーが通知を受け取りたい頻度
掲示板VtxBoardディスカッション掲示板 への参照 (タイトル)はい-サブスクリプションのボード (トピックのサブスクリプションでも)。フローでボード別にグループ化できるようにします

ユーザーは対象ごとに 1 アイテムを持ちます。別の頻度で再度フォローすると既存のアイテムが更新され、フォローを解除すると削除されます。トピックの作成者は Immediate で自動的にそのトピックをフォローします。Web パーツはこのリストを維持するだけで、メールの送信は Power Automate フローの役割です。そのデータ連携の仕様は「KB10414. Discussions の通知のしくみ: サブスクリプション、メンション、Power Automate」で説明しています。

ディスカッションアセット

エディターでトピックや返信に挿入した画像 (貼り付け、ドロップ、または 画像を挿入 で選択) のためのドキュメント ライブラリです。各画像は一意の名前で、現在の年にちなんだ名前のフォルダー (2026、2027、…) にアップロードされ、年ごとに整理されます。ただし、フォルダー内のアイテム数がリスト ビューのしきい値を超えないことを保証するものではありません。このライブラリには 1 つのカスタム列があります。

列内部名種類インデックス既定値 / 値用途
ディスカッションアセットVtxDiscussionsAsset1 行テキストいいえ空マーカー列のみ。タイトルに関係なくライブラリを認識できるようにします

ファイルを添付 でトピックや返信に添付したファイルはここには保存されません。それらはトピックまたは返信アイテムのリスト アイテム添付ファイルであり、ディスカッショントピック または ディスカッション投稿 リストのアイテムと共に保持されます。

選択肢の値

選択肢の列には、インターフェイスの言語に関係なく以下の英語の値が保存されます。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 フローなどです。

質問と回答

この記事について質問すると、サポートチームから公式回答を受け取れます。

まだ質問はありません。最初の質問を投稿しましょう。

注目の記事

Vitextra のライセンス用に Microsoft 365 テナント ID を確認する方法

任意の Vitextra Web パーツのプロパティ ペインの About セクションから、Microsoft 365 テナントの一意の識別子 (テナント ID) を確認する方法を説明します。テナント ID は Vitextra 製品のライセンスを割り当てるために必要です。

101 1 分
QR コードに会社のロゴを追加する方法

Vitextra QR Code Generator Web パーツに JPG、PNG、SVG のロゴをアップロードし、ロゴのサイズと余白を調整して、コードが読み取れる状態を保つために誤り訂正レベルを上げ、ロゴを削除または置き換えるまでの手順を説明します。

101 1 分
My Tasks: ソリューションの概要

SharePoint Online と Microsoft Teams で使える Vitextra My Tasks の概要です。Planner、To Do、Outlook、SharePoint、Project Online、Azure DevOps のタスクを 1 つの一覧にまとめる方法、主な機能、2 つの Web パーツ、セキュリティ、無料試用版について説明します。

102 2 分

共有