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

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

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

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

• Cloud Workspace: version control is managed via snapshots in the Change history panel.
• Local Workspace: version control is managed via Git in the Version control panel.

Cloud Workspace でのバージョン管理

Version control for solutions is handled within the Change history panel through snapshots. You can think of snapshots as "checkpoints" of the solution at various stages in its development. Snapshots preserve the entire solution state, including its automation projects, resources, and deployment configuration.

スナップショットの種類

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

• Current version: The current (latest) version of a solution. It appears at the top of the list of snapshots in the Change history panel.
• 手動スナップショット: ユーザーが手動で作成したスナップショットです。エージェントには名前と任意の説明があります。手動スナップショットを選択またはポイントすると、作成者の名前と作成日時が表示されます。読み取り専用モードでのみ開くことができます。
• 自動スナップショット: ソリューションを閉じたとき、およびソリューションが開かれている間は 40 分ごとにスナップショットが自動的に作成されます。自動スナップショットにはタイムスタンプに基づいた名前が付きます (例: 自動スナップショット - 2026-03-14 10:40 UTC)。
• スナップショットのパブリッシュ: ソリューションがパブリッシュされるたびに自動的に作成されるスナップショットです。その名前が、パブリッシュされたソリューション バージョンです。パブリッシュ スナップショットをポイントすると、その作成者の名前と作成日時が表示されます。読み取り専用モードでのみ開くことができます。
  注:

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

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

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

[変更履歴] パネル

The Change history panel lists all snapshots chronologically, showing their:

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

You can use the Filter button to control which types of snapshots appear in the Change history panel.

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

スナップショットの作成

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

1. [ 変更履歴 ] パネルを開きます。[ 現在のバージョンの スナップショット] が選択されていることを確認します。
2. パネルの右上隅にある [スナップショットを作成 ] ボタンを選択します。
3. スナップショットの名前を入力します。
4. 必要に応じて、 Tab キーを押すか、[ 説明を追加 ] フィールドを選択して説明を入力します。
5. Select anywhere in the designer or press the Enter key. The new snapshot is created and is added in the Change history panel.

スナップショットからの復元

One of the main features of snapshots is the ability to restore the solution to a particular point in time. By default, restoring a solution from a snapshot creates a copy of the latest snapshot (that is, Current version) for reference. This ensures that you do not lose any work that you did on the latest version of the solution. You can't restore a snapshot while other people are editing the solution.

スナップショットからソリューションを復元するには、以下の手順を実行します。

1. [ 変更履歴 ] パネルを開きます。
2. Point to a manual, auto, or publish snapshot.
3. [ 復元 ] ボタンを選択します。[ スナップショットを復元 ] ウィンドウが表示されます。
4. [ タイトル] フィールドに、最新のスナップショットのコピーの必須の名前を入力します。
5. 必要に応じて、ソリューションに対して行われた更新の説明を入力します。
6. [ 復元 ] ボタンを選択します。ソリューションが特定の時点に正常に復元されたことを通知するバナー メッセージが表示されます。

To restore without saving the latest snapshot (the Current version snapshot), turn off the Create a snapshot of the current version toggle in the Restore snapshot window, and then select Restore. In the Discard current snapshot window, select Discard and restore to confirm. The latest version of your solution is deleted.

よくある質問

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

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

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

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

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

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

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

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

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

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

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

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

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

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

As a prerequisite, make sure you are working on a locally saved solution:

1. Studio Web を開きます。
2. [ローカル ワークスペース] ページに移動します。
3. [ ソリューションを開く ] ボタンを使用して既存のローカル ソリューションを開くか、[ 新規作成 ] ボタンから新しいソリューションを作成します。以前に開いたソリューションのリストから既存のソリューションを選択することもできます。
4. Select the folder where an existing solution is saved locally or indicate a folder where the new solution is created. Your new local solution opens.
   重要:

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

5. Open the Version control panel.

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

• .gitignore ファイルを作成します。
• ソリューション内の現在のファイルで初期コミットを行います。
• Creates a local branch named main.

注:

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

Git version control can be enabled or disabled from a dedicated toggle in the Version control panel header. You can have version control enabled for some solutions and disabled for others. If you initialize a new repository, version control is enabled automatically.

.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バイトコードキャッシュディレクトリ。

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

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

• [ 新しいブランチを作成 ] ボタンから新しいブランチを作成します。ブランチ名を入力し、[ 作成] を選択します。ブランチが利用可能なブランチのリストに追加されます。名前が既存のブランチと一致する場合、フィールドにインライン エラーが表示され、ブランチは作成されません。
• ブランチを切り替えるには、[ ローカル ブランチ ] または [ リモート ブランチ] のリストからブランチ名を選択します。

ブランチは、ローカル ブランチとリモート ブランチの下にグループ化されます。

ローカル ブランチを切り替える 切り替えの影響を受けないコミットされていない変更は Studio Web で保持されます。

ファイルにコミットされていない変更があり、ターゲット ブランチと競合する場合は、それらの変更を破棄して続行するかどうかを確認する確認ダイアログが表示されます。ダイアログを拒否すると切り替えがキャンセルされ、変更内容は変更されません。

ローカルで削除したファイルは切り替え後も削除されたままになり、破棄可能な削除機能として [ 変更点 ] の下に表示されます。ソリューションが再読み込みされ、新しい分岐が反映されます。

リモート ブランチに切り替え る追跡対象のリモート ブランチに切り替えると、Studio Web はローカル ブランチがリモートから分岐しているかどうかを確認します。

• ローカルのブランチが最新の場合、またはきれいに早送りできる場合は、切り替えがすぐに行われます。
• プッシュされていないローカル コミットまたはコミットされていない変更がスイッチによって破棄される場合は、切り替えが発生する前に確認ダイアログが表示されます。

ブランチの切り替えまたは元に戻すの進行中は、[ バージョン管理 ] パネルが一時的に無効化され、切り替え先のブランチの名前が表示されます。これにより、切り替えが完了するまで、コミットやプッシュなどの他のアクションが実行されなくなります。

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

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

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

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

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

• 緑色と + アイコンは、プロジェクト ファイルに何かが追加されたことを示します。
• オレンジ色と / アイコンは、ファイルが変更されたことを示します。
• Red and the - icon indicate that something has been removed from a project file.

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

1. [バージョン] コントロール パネルの [確定] ボタンを選択します。
2. コミット メッセージを入力します。コミットに含まれる変更が [ 変更 ] セクションに表示されます。
3. 以下のいずれかのオプションを選択します。
   • Commit to commit your changes without pushing them. Your new commit appears in the Commit history section.
   • Commit & Push to commit your changes and push them to the current branch in the configured remote repository. This option is available only after you connect to a remote repository.

To push commits that you made earlier, select the Push button next to the Commit button in the Version control panel.

If the remote branch has commits that you don't have locally, the push is rejected and the Push rejected window appears. Select Force push to push your local commits anyway.

重要:

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

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

コミット履歴を表示する

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

Select a commit from the list to see the Changes section for that particular commit.

コミットのコンテキスト メニューを開き、以下を選択します。

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