バージョンと履歴

[ドキュメント] パネルでバージョンを作成できます。 をクリックすると、ワークスペースを離れることなく新しいバージョンを作成できます。

[バージョンと履歴] を使用してバージョンを作成することができ、次のように [ドキュメント] パネルに配置することもできます。

1. ドキュメントを開いた状態で、 をクリックして [バージョンと履歴] を開きます。
2. バージョンを作成するワークスペースをクリックします。これにより、そのワークスペースがアクティブになります。
3. [バージョンを作成] アイコン をクリックします。
4. 表示されるダイアログで、新しいバージョンの名前と説明を入力します。
5. 明るい黄色の [更新] アイコン で示されているように、ドキュメント内の図面で更新が保留されている場合は、ダイアログにメッセージが表示されます。

   

   メッセージ のアイコンをクリックして、一覧表示されているすべての図面を更新し、バージョンに最新バージョンの図面が含まれるようにします。[更新] アイコンをクリックしてダイアログをキャンセルしたとしても、図面は更新されます。

6. 次のいずれかをクリックします。
   1. 作成 - 新しいバージョンを作成し、現在アクティブなワークスペースに留まります
   2. バージョンを作成してプロパティを編集する - 新しいバージョンを作成し、新しいバージョンのプロパティダイアログを開きます。このプロパティダイアログには、新しいバージョンの各タブとパーツの名前と説明が表示されます。

新しいバージョンがバージョンと履歴グラフに表示されます。

OnShape は、ドキュメント参照を更新するときに、バージョンを自動的に作成することもできます。その場合は、次に示すように、グラフに自動バージョンアイコンが表示されます。

ユーザーが Onshape の従業員の場合、グラフの [変更済み] 列の下のユーザー名の左側に Onshape のロゴアイコンが表示されます。

自動バージョニングの詳細は、リファレンスの更新を参照してください。

あるバージョンからブランチすると、追加のバージョンを含むことができる新しいブランチと、ブランチの先端 (最後) に新しいワークスペースが作成されます。

1. ドキュメントを開いた状態で、 をクリックして [バージョンと履歴] を開きます。
2. ワークスペースを作成するバージョンエントリを右クリックし、コンテキストメニューから [ブランチしてワークスペースを作成] を選択します。

   

3. 表示される [プロパティ] ダイアログで、ワークスペースの名前と説明を入力します。

   

4. 次のいずれかをクリックします。
   1. 作成 - ワークスペースを作成し、オプションで開きます (チェックボックス)
   2. バージョンを作成してプロパティを編集する - ワークスペースを作成し (オプションで開く)、そのプロパティダイアログを開きます。このプロパティダイアログには、新しいドキュメントワークスペースの各タブとパーツの名前と説明が表示されます。

2 つのワークスペース、2 つのバージョン、または 1 つのバージョンと 1 つのワークスペースを比較できます。また、1 つ以上のブランチをマージすることもできます。

ユーザーがドキュメントを所有している場合、そのユーザーはワークスペースを削除できます。

ドキュメントがユーザーと共有されていて、そのドキュメントの共有権限設定で「削除」が有効になっている場合、そのユーザーはドキュメントのワークスペースを削除できます。

ドキュメントのワークスペースを削除すると、ブランチの先端 (最後) からワークスペースが削除されます。

• ブランチにバージョンが存在しない場合、ワークスペースとブランチは削除されます。

• ブランチに 1 つまたは複数のバージョンが含まれている場合、ワークスペースは削除され、ブランチは最新バージョンに戻ります。

ワークスペースを削除するには、次の手順を実行します。

1. ドキュメントを開いた状態で、 をクリックして [バージョンと履歴] を開きます。
2. 削除するブランチを右クリックします。
3. [削除] を選択します。

   

4. [削除] をクリックして確定します。

   

削除したワークスペースを復元するには、次の手順を実行します。

1. 削除されたワークスペースを含むドキュメントを開きます。
2. ドキュメントメニュー を展開します。

   

3. [削除したワークスペースの復元] を選択します。
4. ダイアログで、復元したいブランチを選択します。
   
5. [選択項目を復元] をクリックします。

あるチームは自転車に取り組んでおり、フレームの安定した設計基盤を達成しました。これからは、チームがさまざまなコンポーネント設計を試してみる時期です。基本フレームデザインドキュメントをバージョンとしてマークすることから始めます。

1. [バージョンと履歴] アイコン をクリックし、以下の [ドキュメント] パネルで [バージョンと履歴] を開きます。

   

2. [バージョンを作成] アイコン をクリックします。
3. 1 つ目のバージョンの Base Frame の名前を付けます。[作成] をクリックします。

   

   

   各設計者は、Base Frame バージョンから独自のワークスペース (シート、ブレーキ、ショックなどのラベルをつけて) を作成できます。

4. Base Frame バージョンを右クリックし、[ブランチしてワークスペースを作成] をクリックします。

   

5. 新しいワークスペースに「シート」という名前を付け、[作成] をクリックします。

   

   Base Frame バージョンは、元のワークスペース (メイン) と同様に引き続き存在します。さらに、2 つ目のワークスペースがあるシートがあるため、設計者がシートを変更しても、Base Frame ワークスペースには影響しません。

6. ショックとブレーキの設計者は、それぞれ Base Frame の同じバージョンから独自のワークスペースを作成します。

   
   この時点では、各デザイナーのワークスペースは Base Frame バージョンと同じです。

7. それぞれのブランチで設計を続けるにつれて、Base Frame バージョンとは無関係に、また互いに独立してデザインが進化していきます。作業を進めながら、ワークスペースのバージョンを自由に作成できます。

   独立作業が完了すると、各ブランチはメインワークスペースに統合され、すべての独立作業が 1 か所にまとめられます。

   

凡例

一般的なバージョンおよび履歴グラフには、各ノードのワークスペース、ブランチ、バージョン、またはリビジョンのタイプを示すアイコンが含まれています。グラフの読み方をより完全に理解するため、次のテーブルを見てみましょう。

アイコン	表示
	バージョン
	ノードの変更
	承認されたリリースを含むバージョン。
	廃止されたアイテムを含むリリースを含むバージョン。
	ワークスペース。
	保留中のリビジョンがあるバージョン。
	Onshape によって自動的に作成されたバージョンと履歴のバージョン。たとえば、このトピックで後述する [最新に更新] オプションを使用する場合など。

使用条件

• バージョン - ドキュメントに名前が付けられて保存された状態。バージョンは不変で、ワークスペースとは切り離されています。特定の時点のワークスペースをキャプチャするバージョンを作成します。バージョンを開いて分岐することができます。

  バージョングラフには、通常のテキストと実線で示されます。

• ワークスペース - モデリング/デザインスペース。

  アクティブなワークスペースは、バージョングラフリストの左側に青いボックスで示され、関連するブランチの末尾に開いた点が表示されます。

• ブランチ - ドキュメントが分割され、新しいワークスペースが作成される場所。ブランチには、0 個以上のバージョンと、最大 1 つのワークスペースがあります。ブランチを開いて削除できます。

  バージョングラフには太字と斜体のテキストとドットで示されます。ドットが開いている場合、ブランチには 1 つのワークスペースが関連付けられています。ドットが閉じている場合、そのブランチに関連付けられているワークスペースは削除されています。

マージ線

すべてのマージはバージョンと履歴グラフに明示的に表示され、ドキュメントに変更が加えられると自動的に更新されます。

マージ線の表示と非表示

バージョンと履歴グラフを見やすくするには、必要に応じて [マージの表示/非表示] ボタンや [自動バージョンの表示/非表示] ボタンを切り替えます。

Onshape ブラウザアプリケーション (上図) でマージ線と自動バージョンを表示したバージョンと履歴グラフ。

Onshape ブラウザアプリケーション (上記) で非表示になっているマージを含むバージョンと履歴グラフ。

Onshape ブラウザアプリケーション (上記) で自動バージョンが非表示になっているバージョンと履歴グラフ。

マージ線の例

以下の例は、複数のブランチを含む複雑なバージョンと履歴グラフを示しています。各ブランチはメインワークスペースから作成され、各ブランチで個別の作業が行われました。各ブランチの作業が完了すると、ブランチはメインに統合されました。メインブランチに出入りする線の流れにはマージのワークフローが示され、どの変更がいつマージされたかが簡単にわかります。

Onshape ブラウザアプリケーション (上記) で表示している複数のブランチを含むバージョンと履歴グラフ。

ブランチの一番上または一番下まで自動的にスクロールするには、ブランチを右クリックしてコンテキストメニューにアクセスし、[ブランチの先頭までスクロール] または [ブランチの下部までスクロール] オプションを選択します。

ドキュメントバージョンに公開されたカスタムフィーチャーが含まれている場合、バージョンと履歴グラフのバージョンノードの周囲に括弧インジケーター ({}) が表示されます。

詳細は、カスタムフィーチャーの公開を参照してください。

[検索履歴] を使用すると、すべてのバージョンとブランチにわたって履歴エントリを検索できます。結果は、検索語に基づいて絞り込んだエントリの一覧です。バージョン名とバージョンの説明は検索対象に含まれません。

履歴を検索するには、次の手順を実行します。

1. [検索履歴] フィールドに検索語を入力します。検索語を含むすべての履歴エントリが [バージョンと履歴] リストに表示されます。

   

検索時には、検索フィールドの上で [アクティブブランチ] を選択していても、すべてのブランチの結果が表示されます。

2. 必要に応じて検索をさらに絞り込むには、[検索履歴] フィールドのドロップダウン矢印をクリックします。これにより、次の条件に従って検索を絞り込むことができます。

   

• タブ - 特定のドキュメントタブを選択して検索範囲を絞り込みます。既定は [すべて] タブです。

• タブの種類 - [Part Studio]、[アセンブリ]、[図面] のいずれかを選択して検索を絞り込みます。既定の検索では、すべてのタブの種類が使用されます。タブの種類のフィルターをリセットするには、[クリア] ボタンをクリックします。いずれのタブの種類も検索対象に含まれます。

• 変更者 - 履歴を変更した人を選択して検索を絞り込みます。オプションには、[自分のみ]、[自分ではない]、[すべて] (既定) があります。

• 更新日 - 開始日と終了日を選択して検索を絞り込みます。既定では、すべての日付が検索されます。

3. 条件を選択したら、[検索] ボタンをクリックします。新しい条件に従って検索語が絞り込まれます。すべてのフィルター条件を既定値に戻すには、[リセット] ボタンをクリックします。

[ブランチをフィルター] ボタンをクリックすると、バージョングラフに表示されるブランチが変更されます。

ブランチを絞り込むには、次の手順を実行します。

1. [バージョンと履歴] パネルを開きます。
2. [ブランチをフィルター] ボタンをクリックします。
3. フィルターオプションを選択します。
   • すべてのブランチを表示 - バージョングラフですべてのブランチを表示します。既定のビュー。

     

   • ワークスペースを含むすべてのブランチを表示 - 削除されたワークスペースに属するすべてのブランチを非表示にします。下の画像では、一番下の緑のブランチ (上の画像) が非表示になっていることがわかります。このオプションは大きいバージョンのグラフをクリーンアップするために使用できます。

     

   • 現在のブランチを表示 - 現在のブランチのみを表示します。

     

   • 現在のブランチを親ブランチと一緒に表示 - 現在のブランチとその親ブランチのみを表示します。

     

[バージョンと履歴] パネルは、ドキュメントページまたはドキュメント内から開くことができます。

• ドキュメントページから - [バージョンと履歴] パネルを開くドキュメントに対応する情報パネルアイコンを選択し、[バージョン] をタップします。
• ドキュメント内で、グラフィック領域の左側にあるバージョンと履歴アイコン をタップします。

• [バージョンと履歴] パネルには、ドキュメントの既定のバージョングラフが表示されます。
• メインワークスペースと開始バージョンは既定で存在します。
• タップして すべてのブランチ と アクティブブランチ (グラフィック領域でアクティブまたは開いているワークスペース) の表示を切り替えます。
• [バージョンを作成] をタップしてバージョンを作成します。
• [X] をタップして [バージョンと履歴] パネルを閉じます。

グラフには、ドキュメントのすべてのバージョンとワークスペースがツリー形式で表示されます。グラフはブランチごとに色分けされています。各ブランチは 1 色で、すべてのブランチは開いたドットとして描かれるワークスペースで終わります。ブランチ名は太字と斜体で表示されます。バージョンは、実線の点、および通常のテキストとして描かれ、表示専用です。

現在開いているワークスペースであるアクティブブランチは青く強調表示されます。上の図では、ブランチ B1 がアクティブブランチです。

• バージョン - ドキュメントに名前が付けられて保存された状態。バージョンは不変で、ワークスペースとは切り離されています。特定の時点のワークスペースをキャプチャするバージョンを作成します。バージョンを開いて分岐することができます。

  バージョングラフには、通常のテキストと実線で示されます。

• ワークスペース - モデリング/デザインスペース。

  アクティブなワークスペースは、バージョングラフリストの左側に青いボックスで示され、関連するブランチの末尾に開いた点が表示されます。

• ブランチ - ドキュメントが分割され、新しいワークスペースが作成される場所。ブランチには、0 個以上のバージョンと、最大 1 つのワークスペースがあります。ブランチを開いて削除できます。

  バージョングラフには太字と斜体のテキストとドットで示されます。ドットが開いている場合、ブランチには 1 つのワークスペースが関連付けられています。ドットが閉じている場合、そのブランチに関連付けられているワークスペースは削除されています。

ドキュメントのバージョンを作成するには、次の手順を実行します。

1. [バージョンと履歴] パネル を開きます。
2. バージョンを作成するワークスペースまたはブランチをタップして選択します。

ワークスペース (ブランチ) は、開いたドットで示されます。

3. をタップします。
4. バージョンの名前と説明を追加し、[バージョンを作成] を選択します。

   

5. 新しく作成されたバージョンが [バージョンと履歴] パネルに表示されます。
   

あるバージョンからブランチすると、追加のバージョンを含むことができる新しいブランチと、ブランチの先端 (最後) に新しいワークスペースが作成されます。

1. [バージョンと履歴] パネル を開きます。
2. ブランチしたいバージョン (メイン以外) の横にある 3 点メニューアイコンをタップし (下の画像の [開始])、[ブランチしてワークスペースを作成] をタップします。

   

3. ブランチの名前と説明を追加し、[ワークスペースの作成] を選択します。
4. 新しく作成されたブランチが [バージョンと履歴] パネルに表示されます。
   

Onshape は、すべてのユーザーがすべてのドキュメントに加えたすべての変更の履歴を保持します。これにより、ドキュメント履歴の 1 つのリストでこれらの変更を表示することも、ドキュメントを履歴の特定の時点にいつでも復元することもできます。

復元時には、現在開いているワークスペースに復元されます。別のワークスペースに復元したい場合は、まずそのワークスペースを開きます。

現在アクティブなワークスペースにバージョンを復元するには、以下の手順に従います。

1. [バージョンと履歴] パネル を開きます。
2. 復元したいバージョンをタップします。
3. 復元したいバージョンの横にある 3 点メニューアイコンをタップし、[<ターゲット> に復元] をタップします。

   

バージョンの復元の詳細は、ドキュメント管理を参照してください。

[バージョンと履歴] パネルは、ドキュメントページまたはドキュメント内から開くことができます。

• [ドキュメント] ページから:

  [バージョンと履歴] パネルを開くドキュメントに対応する情報パネルアイコンを選択します。ここから [バージョン] をタップします。

• ドキュメント内で、

  グラフィック領域の左側にあるバージョンと履歴アイコン をタップします。

  

• [バージョンと履歴] パネルには、ドキュメントの既定のバージョングラフが表示されます。メインワークスペースと開始バージョンが既定であります。
• [バージョンと履歴] パネルの右上には、次の 2 つのアイコンがあります。

- バージョンの作成

- [バージョンと履歴] パネルを閉じる

• パネル上部のラベルをタップすると、[すべてのブランチ] と [アクティブブランチ] (現在グラフィック領域で開いているワークスペース) の表示を切り替えることができます。

グラフには、ドキュメントのすべてのバージョンとワークスペースがツリー形式で表示されます。グラフはブランチごとに色分けされています。各ブランチは 1 色で、ブランチ名はアウトラインで囲まれ色分けされたテキストで表示されます。ブランチに関連付けられたワークスペースは開いた点として表示されます。バージョンは、実線の点 (および通常のテキスト) として描かれ、表示専用です。

現在開いているワークスペースであるアクティブブランチは、タイトルが青いボックスで囲まれて表示されます。たとえば上の図では、ブランチ B2 がアクティブブランチ名です。

• バージョン - ドキュメントに名前が付けられて保存された状態。バージョンは不変で、ワークスペースとは切り離されています。特定の時点のワークスペースをキャプチャするバージョンを作成します。バージョンを開いて分岐することができます。

  バージョングラフには、通常のテキストと実線で示されます。

• ワークスペース - モデリング/デザインスペース。

  アクティブなワークスペースは、バージョングラフリストの左側に青いボックスで示され、関連するブランチの末尾に開いた点が表示されます。

• ブランチ - ドキュメントが分割され、新しいワークスペースが作成される場所。ブランチには、0 個以上のバージョンと、最大 1 つのワークスペースがあります。ブランチを開いて削除できます。

  バージョングラフには太字と斜体のテキストとドットで示されます。ドットが開いている場合、ブランチには 1 つのワークスペースが関連付けられています。ドットが閉じている場合、そのブランチに関連付けられているワークスペースは削除されています。

現在のアクティブなドキュメントのバージョンを作成するには、次の手順を実行します。

1. グラフィック領域の左側で、バージョン作成アイコン をタップします。
2. 新しいバージョンの名前 (およびオプションで説明) を入力し、[作成] をタップします。

別のワークスペースまたはブランチからバージョンを作成するには、次の手順を実行します。

1. [バージョンと履歴] アイコン をタップして [バージョンと履歴] パネルを開きます。
2. バージョンを作成するワークスペース (またはブランチ) をタップして、そのワークスペースを開きます。

ワークスペース (ブランチ) は、開いたドットで示されます。

3. パネル上部にある [バージョンを作成] アイコン をタップします。

4. バージョンの名前と説明を追加し、[作成] をタップします。
5. 新しく作成されたバージョンが [バージョンと履歴] パネルに表示されます。

バージョンの横にある 3 点メニューをタップすると、[プロパティ]、[開く]、[ブランチしてワークスペースを作成] などのオプションが表示されます。

あるバージョンからブランチすると、追加のバージョンを含むことができる新しいブランチと、ブランチの先端 (最後) に新しいワークスペースが作成されます。

1. [バージョンと履歴] アイコン をタップして [バージョンと履歴] パネルを開きます。
2. ブランチを作成するバージョンをタップして選択します。
3. バージョンの横にある 3 点メニューをタップし、[ブランチしてワークスペースを作成] をタップします。
4. ブランチの名前と説明を追加し、[作成] をタップします。
5. 新しく作成されたブランチが [バージョンと履歴] パネルに表示されます。

Onshape は、すべてのユーザーがすべてのドキュメントに加えたすべての変更の履歴を保持します。これにより、ドキュメント履歴の 1 つのリストでこれらの変更を表示することも、ドキュメントを履歴の特定の時点にいつでも復元することもできます。

復元時には、現在開いているワークスペースに復元されます。別のワークスペースに復元したい場合は、まずそのワークスペースを開きます。

現在アクティブなワークスペースにバージョンを復元するには、以下の手順に従います。

1. [バージョンと履歴] パネルを開きます。
2. 復元したいバージョンをタップします。
3. バージョンの横にある 3 点メニューをタップし、[メインに復元] をタップします。

バージョンの復元の詳細は、ドキュメント管理を参照してください。