ソリューションのバージョン管理

Studio Web でソリューションのバージョン管理を有効化して使用すると、チーム メンバーの作業を上書きすることなく、ソリューション バージョンを追跡、復元、コラボレーションできます。

バージョン管理によりチームのコラボレーションが強化され、複数のユーザーがソリューションの異なるバージョンをいつでも表示、追跡、復元できます。これにより、開発者はお互いの作業を上書きすることなく、オートメーションを構築およびテストできます。

Studio Web でのバージョン管理は、ワークスペースの種類によって動作が異なります。

1. クラウド ワークスペース: バージョン管理は、[ 変更履歴 ] パネルのスナップショットを使用して管理します。
2. ローカル ワークスペース: バージョン管理は、[ バージョン管理 ] パネルの Git で管理します。

Cloud Workspace でのバージョン管理

ソリューションのバージョン管理は、[ 変更履歴 ] パネル内で スナップショットを使用して行います。スナップショットは、開発のさまざまな段階としてのソリューションの「チェックポイント」と考えることができます。スナップショットでは、オートメーション プロジェクト、リソース、デプロイの設定など、ソリューションのステート全体が保持されます。

Snapshot types

スナップショットには複数の種類があります。

1. 現在のバージョン: ソリューションの現在の (最新の) バージョンです。これは、変更履歴パネルのスナップショットのリストの一番上に表示されます。
2. 手動スナップショット: ユーザーが手動で作成したスナップショットです。名前とオプションの説明があります。手動スナップショットを選択またはホバーすると、作成者の名前と作成日時が表示されます。読み取り専用モードでのみ開くことができます。
3. 自動スナップショット: ソリューションを閉じたとき、およびソリューションが開かれている間は 40 分ごとにスナップショットが自動的に作成されます。自動スナップショットにはタイムスタンプに基づいた名前が付きます (例: 自動スナップショット - 2026-03-14 10:40 UTC)。
4. スナップショットのパブリッシュ: ソリューションがパブリッシュされるたびに自動的に作成されるスナップショットです。名前はパブリッシュされたソリューションのバージョンです。パブリッシュスナップショットにホバーすると、作成者の名前と作成日が表示されます。読み取り専用モードでのみ開くことができます。
   注:

   手動スナップショットを含むすべてのスナップショットは、ソリューションにアクセスできるすべてのユーザーが利用できます。

[変更履歴] パネル

[変更履歴] パネルには、すべてのスナップショットが時系列順に一覧表示され、次の情報が表示されます。

• バージョン番号と説明 (例: "v1.1.0- フィードバックフォームが含まれています)。
• 作成者とタイムスタンプ (例: 「2 か月前、ジョン・ドウ著」)。
• タイトル (例: 「NetSuite 統合をテストする前の安定したビルド」)

[フィルター] ボタンを使用して、[変更履歴] パネルに表示するスナップショットの種類を制御できます。

パネルからスナップショットを選択すると、その特定の時点に存在していたソリューションが表示されます。過去のスナップショットを参照すると、ソリューションの過去のバージョンが読み取り専用モードで表示されていることが知らせる一時的なバナー メッセージが表示されます。

自動スナップショットには、組織の権利に基づく保持制限があり、ライセンス プランによって異なる場合があります。

1. ソリューションごとの制限: 各ソリューションでは、自動スナップショットの最大数が保持されます。この制限に達すると、新しいスナップショットが追加されると、最も古いスナップショットが自動的に削除されます。
2. 時間ベースの制限: 設定された保持期間より古い自動スナップショットは自動的に削除されます。

Creating a snapshot

新しい手動スナップショットを作成するには:

1. Open the Change history panel. Ensure that the Current version snapshot is selected.
2. パネルの右上隅にある [スナップショットを作成 ] ボタンを選択します。
3. スナップショットの名前を入力します。
4. 必要に応じて、 Tab キーを押すか、[ 説明を追加 ] フィールドを選択して説明を入力します。
5. Select anywhere in the Studio Web Designer or press the Enter key. The new snapshot is created and is added in the Change history panel.

Restoring from a snapshot

スナップショットの主な機能の1つは、ソリューションを特定の時点に復元できることです。既定では、スナップショットからソリューションを復元すると、参照用に最新のスナップショット ( 現在のバージョン) のコピーが作成されます。これにより、ソリューションの最新バージョンで行った作業が失われることがなくなります。

To restore a solution from a snapshot:

1. Open the Change History panel.
2. 手動スナップショットまたはパブリッシュ スナップショットの上にカーソルをホバーさせます。
3. [ 復元 ] ボタンを選択します。[ スナップショットを復元 ] ウィンドウが表示されます。
4. [ タイトル] フィールドに、最新のスナップショットのコピーの必須の名前を入力します。
5. 必要に応じて、ソリューションに対して行われた更新の説明を入力します。
6. [ 復元 ] ボタンを選択します。ソリューションが特定の時点に正常に復元されたことを通知するバナー メッセージが表示されます。
7. Alternatively, turn the Create a snapshot of the current version toggle off to discard the latest version of the solution.

Turning the Create a snapshot of the current version toggle off restores the solution without saving the latest snapshot (the Current version snapshot). This means that the latest version of your solution is deleted.

よくある質問

自動スナップショットはパフォーマンスに影響しますか?

いいえ。自動スナップショットはバックグラウンドで作成され、デザイナーでの作業が妨げられたり、速度が低下したりすることはありません。

自動スナップショットを個別に削除できますか?

いいえ。自動スナップショットは Studio Web によって自動的に管理され、個別に削除することはできません。古い自動スナップショットは、保持ポリシーに基づいて自動的に削除されます。

自動スナップショットはストレージにカウントされますか?

はい。自動スナップショットはクラウド ストレージを使用します。保持期間の制限により、ストレージ使用量は制限されたままになります。

自動スナップショットは、ソリューションにアクセスできるすべてのユーザーに表示されますか?

はい。すべてのスナップショットと同様に、自動スナップショットは、ソリューションにアクセスできるすべてのユーザーが使用できます。

共有ソリューションの自動スナップショットはどうなりますか?

共有ソリューションは、所有ソリューションと同じ自動スナップショット ポリシーに従います。自動スナップショットは、ソリューションを開いて作業しているすべてのユーザーに対して作成され、すべてのスナップショットはアクセス権を持つすべてのユーザーに表示されます。

ローカル ソリューションの自動スナップショットを作成できますか?

いいえ。自動スナップショットは、クラウド ソリューションでのみ利用可能です。

ローカル ワークスペースでのバージョン管理

Studio Web は Git と連携して、マシンにローカルに保存されたソリューションの効率的なバージョン管理を可能にします。

前提条件として、ローカルに保存されたソリューションで作業していることを確認してください。

1. Studio Web を開きます。
2. [ローカル ワークスペース] ページに移動します。
3. [ ソリューションを開く ] ボタンを使用して既存のローカル ソリューションを開くか、[ 新規作成 ] ボタンから新しいソリューションを作成します。以前に開いたソリューションのリストから既存のソリューションを選択することもできます。
4. 既存のソリューションをローカルに保存するフォルダーを選択するか、新しいソリューションを作成するフォルダーを指定します。新しいローカル ソリューションが開きます。
   重要:

   ブラウザーからプロンプトが表示されたら、Studio Web にファイルの編集を許可します。

5. [バージョン管理] パネルを開きます。

パネルを初めて開くと、ローカル Git リポジトリを初期化するように指示されます。この手順は必須です。[ リポジトリを初期化 ] ボタンを選択すると自動的に実行されます。ローカル Git リポジトリを初期化すると、Studio Web では以下の処理が行われます。

• .gitignore ファイルを作成します。
• ソリューション内の現在のファイルで初期コミットを行います。
• 「main」という名前のローカル ブランチを作成します。

注:

main ブランチ名は、Studio Web で初期化されたリポジトリにのみ適用されます。既存のリポジトリ (手動で作成したリポジトリまたはリモートからクローンしたリポジトリ) に接続すると、Studio Web はそのリポジトリの既存の既定のブランチを使用します。ローカル ブランチの名前はいつでも手動で変更できます。

Git バージョン管理は、[ バージョン管理 ] パネルのヘッダーにある専用のトグルから有効化または無効化できます。一部のソリューションではバージョン管理を有効化し、他のソリューションでは無効化することができます。新しいリポジトリを初期化すると、バージョン管理が自動的に有効化されます。

.gitignore

ローカルの Git リポジトリを初期化すると、次のエントリを含む .gitignore ファイルが自動的に作成されます。

ファイル	説明
.agent-builder	一時的にバンドルされたエージェントの成果物。
.DS_Store	macOS Finderメタデータファイル;ソース コードの一部ではありません。
*_UiCache.zip	生成された UI キャッシュ アーカイブ一時的な出力。
**/.local	任意の深さのローカルキャッシュおよび一時データディレクトリ。
*.crswap	クラッシュリカバリ中に作成された一時的なスワップファイル。
**/.entities/EntitiesBundle.*.zip	生成されたエンティティはアーカイブをバンドルします。
remote-repository.config.json	リモート リポジトリ接続用の Studio Web ローカルの設定
.sw-path-marker	ワークスペースのパスを追跡するための Studio Web マーカー ファイル。
venv/	Python 仮想環境ディレクトリ。
.venv/	代替 Python 仮想環境ディレクトリ。
__pycache__/	Pythonバイトコードキャッシュディレクトリ。

ブランチを作成・管理する

[バージョン管理] パネルの左上隅からブランチ名を選択して、次の操作を行います。

1. [新しいブランチを作成] ボタンから新しいブランチを作成します。ブランチ名を入力し、 [ 作成] を選択します。利用可能なブランチのリストにブランチが追加されます。
2. [ ローカル ブランチ] のリストからブランチ名を選択して、ブランチを切り替えます。ブランチを切り替えると、ソリューションがリロードされます。

Branches are grouped under local branches and remote branches. When you switch to a tracked remote branch, Studio Web checks whether your local branch has diverged from the remote:

• If your local branch is up to date, or can fast-forward cleanly, the switch happens immediately with no confirmation required.
• If the switch would discard unpushed local commits or uncommitted changes, a confirmation dialog appears before the switch happens.

リモート リポジトリに接続する

既存のローカル リポジトリをリモート リポジトリに接続するには、以下の手順を実行します。

1. [バージョン] コントロール パネルの右上隅にあるオプション アイコンを選択します。
2. [ GitHub に接続 ] ボタンを選択します。[GitHub の認証] ウィンドウが表示されます。
3. GitHub Integration Service コネクタを使用して GitHub に認証します。
4. 認証に成功したら、[ リポジトリ URL ] フィールドにリモート リポジトリの URL を入力します。
5. [ 設定を保存 ] ボタンを選択します。
6. または、[ 戻る ] を選択して [ バージョン管理 ] パネルに戻ります。

変更をコミットしてプッシュする

ソリューションでの作業中に行った変更は、バージョン コントロール パネルの [変更] に記録されます。リストの各変更を選択すると、変更内容が並べて表示されます。変更点は次のように強調表示されます。

• 緑色と + アイコンは、プロジェクト ファイルに何かが追加されたことを示します。
• オレンジ色と / アイコンは、ファイルが変更されたことを示します。
• 赤と - アイコン は、プロジェクト ファイルから何かが削除されたことを示します。

ソリューションに加えられた変更をコミットし、現在のブランチにプッシュするには、以下の手順を実行します。

1. [バージョン] コントロール パネルの [確定] ボタンを選択します。

2. コミット メッセージを入力します。コミットに含まれる変更が [ 変更 ] セクションに表示されます。

3. [ コミット] を選択して、変更をプッシュせずにコミットします。新しいコミットが [コミット履歴 ] セクションに表示されます。

4. [ Commit & Force Push ] を選択して、変更をコミットし、強制的にプッシュします。このオプションは、リモート リポジトリに接続した後にのみ使用できます。コミットは、設定された リモートリポジトリの現在のブランチにプッシュされます。

   コミットがまだプッシュされていない場合は、バージョン コントロール パネルの [コミット] ボタンの横にある [強制プッシュ] アイコンを選択します。

重要:

強制プッシュは、リモートリポジトリのコミット履歴をローカル履歴で上書きし、Git の通常の安全性チェックをバイパスします。

• リモート履歴を書き換える: リモートブランチのコミットをローカルコミットに置き換えます。
• コミットを破棄する: ローカルブランチにないリモート上のコミットは、リモートから削除されます。
• ブランチポインタを更新します: 代わりに、リモートブランチをローカルコミットにポイントします。

コミット履歴を表示する

[コミット履歴] セクションには、最初のコミットから時系列ですべてのコミットが含まれます。各コミットには、作成者と作成日に関する情報が表示されます。

リストからコミットを選択すると、その特定のコミットの [変更 ] セクションが表示されます。

コミットを右クリックし、以下を選択します。

• このコミットからブランチを作成して 、このコミットから始まる新しいローカル ブランチを作成します。新しいブランチに名前を付けて、[ 作成] を選択します。これで新しいブランチがアクティブになり、利用可能なブランチのリストに表示されます。
• ローカル ブランチをこのコミットにリセット して、現在のブランチをコミットが作成されたときの状態に復元します。このコミットより新しいコミットは、 コミット履歴から自動的に削除されます。