バージョン履歴

過去のバージョンを確認し、変更箇所を調べ、共有ドキュメントを復元します。

バージョン履歴は、共同編集で確定した変更を閲覧可能なバージョンにまとめます。作成者、時刻、操作と過去の内容を確認し、権限があれば復元できます。ページを再読み込みしても履歴を参照できます。

バージョン履歴の仕組み

編集内容を送信したときに実行されます。 ユーザーや Agent の変更は Mutation として Changeset にまとめられ、共同編集サービスへ送信されて確定・保存されます。

100%

Revision は、確定済み送信のドキュメント履歴上の位置を表します。History は確定した Changeset のインデックスを作成し、時間と操作でグループ化してタイムラインに表示します。

過去のバージョンを選択したときに実行されます。 Snapshot は特定の revision の完全な内容状態です。基準の Snapshot と目標 revision までの後続 Changeset を読み込み、Mutation を順番に再生して読み取り専用の履歴ビューを作成します。

100%

例：revision 10 の Snapshot + revision 11〜15 の Changeset = revision 15 の内容。

「このバージョンを復元」を選択したときに実行されます。

対象バージョンを選択 → 復元 Mutation を送信 → 共同編集で確定 → 現在の内容を更新し、新しい revision を作成

復元操作も新しい履歴として記録され、以前のバージョンは引き続き保持されます。

一定時間内の編集はグループ化されることがあります。履歴項目は、必ずしも一回のキー入力や Snapshot の生成に対応しません。

色は変更の種類を示します。テキストの置換では追加と削除が同時に表示される場合があります。強調表示の範囲は製品ごとに異なります。

サーバー：Core Collaboration に History Service、Endpoint、永続化用 Database Adapter を追加します。Unit 作成と changeset 確定イベントから履歴インデックスを構築し、バージョンと変更を照会します。
ブラウザー：共通の履歴機能と製品の History / History UI プラグインを登録し、履歴 API に接続します。ビューアーは選択した revision と差分を読み込みます。独自コンテンツには対応するビューアープラグインが必要です。
権限：アプリケーションが認証と認可を提供し、サーバーが履歴の読み取りと復元の権限を確認します。履歴には現在削除済みのデータも含まれます。

共同編集の拡張と History の例を参照し、製品ガイドに従って UI を接続してください。

履歴インデックスは再構築可能な派生データです。確定した changeset が正本です。永続化と保持方針はアプリケーションが管理し、履歴パネルはバックアップの代わりにはなりません。