App Builder のバージョニング メカニズム

    概要

    App Builder には堅牢なバージョニング メカニズムがあります。手動編集でも AI 支援の変更でも、データ損失や不整合を発生させずに、過去の状態を安全に保存および復元できます。

    このメカニズムにより、次のことが可能です。

    • 複雑な設計作業中に名前付きチェックポイントを保存する
    • 意図しない変更から迅速に復旧する
    • 影響の大きい操作の前に復元ポイントを確保する
    Note

    Undo/Redo はセッション スコープです。ブラウザー タブを閉じると Undo 履歴は失われます。Version History はセッションをまたいで復元ポイントを保持します。

    前提条件

    開始前に次を確認してください。

    • App Builder でアプリを開いていること
    • 対象ワークスペースでアプリの編集権限があること
    • 現在のセッションに関連するバージョンを表示するため、少なくとも 1 回変更を保存していること

    できること

    バージョニング機能は主に次の 2 つで構成されます。

    • 状態のバージョニング システム: アプリおよびビュー状態の自動/手動スナップショット
    • バージョン参照と管理: 保存済みバージョンの一覧表示、フィルター、名前変更、複製、復元、削除

    スナップショットには、次の App Builder モデル状態が含まれます。

    • アプリ構造
    • ビュー
    • データ ソース
    • テーマ

    スナップショットは Diff/Delta 戦略により効率的に保存されます。

    Version History へのアクセス

    Version History は、アプリ名ドロップダウンのアプリ メニュー (Show Version History) から開けます。

    パネルは左側に表示され、バージョンのタイムラインを確認できます。

    手動でバージョンを保存する

    リスクの高い変更前には、手動保存で意図的な復元ポイントを作成できます。

    1. 分割保存ボタン、またはアプリ/ビューのコンテキスト メニューを開きます。
    2. Save Version を選択します。
    3. (任意) カスタム ラベルを入力します。 : 既定の形式は Manual save - [timestamp] です。
    4. Save を選択します。

    結果:

    • 一意のバージョン ID が自動で割り当てられます。
    • 成功トースト (例: Version saved) が表示されます。

    自動スナップショット

    App Builder は重要な操作の前後で自動スナップショットを作成し、回復ポイントを確保します。

    既定のトリガー:

    • 手動保存したバージョンを復元するとき
    • GitHub へ公開する前
    • デザイン復元を実行する前
    • AI 生成の変更を適用する前
    • 未保存の変更がある状態で 5 分間アイドルになったとき
    • 切断時 (例: ブラウザー タブを閉じたとき)

    自動スナップショットにはトリガーに基づいたラベルが付きます (例: Auto: Before Publish)。

    自動スナップショット既定値

    設定 既定値
    手動保存バージョン復元時の自動スナップショット 有効
    公開前の自動スナップショット 有効
    デザイン復元前の自動スナップショット 有効
    AI 適用前の自動スナップショット 有効
    アイドル タイマー 5 分
    切断時の自動スナップショット 有効
    アプリごとの保持バージョン上限 50
    バージョン保持期間 90 日
    保護されたバージョンはクリーンアップ対象外 はい

    バージョンの参照と管理

    Version History パネルでは、タイムラインの参照とバージョン管理を行えます。

    フィルターとグループ化

    次のフィルターで絞り込みできます。

    • All Versions
    • My Versions
    • Named Versions

    タイムラインは次のようにグループ化されます。

    • Earlier Today
    • Earlier This Week
    • Last Month

    既定では新しい順に表示されます。

    バージョンごとの操作

    各行で実行できる主な操作:

    • Restore
    • Rename
    • Duplicate
    • Delete

    復元ワークフロー

    1. Version History を開きます。
    2. 対象バージョンを選択します。
    3. Restore を選択します。
    4. 復元を確定します。

    結果:

    • 復元成功のトーストが表示されます。
    • 手動保存したバージョンを復元する場合、復元前に自動スナップショットが作成されます。

    アプリ メニューと保存 UX の更新

    アプリ名のドロップダウンから次の操作を実行できます。

    • Rename
    • Duplicate
    • Copy to Workspace
    • Show Version History

    関連する動作更新:

    • Rename はドロップダウンおよびクリック操作の両方からアクセスできます。
    • Duplicate 実行時に現在のアプリから強制遷移しません。
    • Duplicate や Save Version を含む各操作で成功トーストが表示されます。

    保持とクリーンアップ

    バージョン保持は次のルールに従います。

    • バージョンは少なくとも 90 日保持されます。
    • 自動保存バージョンは 90 日以降に削除対象となる場合があります。
    • 手動保存バージョンと自動保存バージョンは、ユーザーが手動で削除することもできます。

    制限事項と注意

    • Version History はソース管理のブランチ戦略を置き換えるものではありません。
    • Undo/Redo と Version History は用途の異なる回復手段です。
    • 正確なトリガー提供範囲はテナント設定やリリース段階により変わる場合があります。

    期待される効果

    この機能により、次が実現できます。

    • リスクの高い編集前に信頼できる復元ポイントを作成する
    • 差し戻しが必要な変更から迅速に回復する
    • 明確なタイムラインとメタデータでアプリ/ビューの変更履歴を追跡する

    関連トピック