バージョンと履歴

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

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

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

   

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

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

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

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

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

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

ドキュメントのブランチを作成するには、次の手順に従います。

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

   

4. 表示される [プロパティ] ダイアログで、ブランチの名前と説明を入力します。

   

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

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

ドキュメントワークスペースを削除するには:

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

   

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

   

削除したワークスペースを復元するには:

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

   

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

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

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

   

2. [バージョンを作成] アイコン をクリックします。
3. 最初のバージョンにベースフレームの名前を付けます。[作成] をクリックします。

   

   

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

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

   

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

   

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

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

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

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

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

   

凡例

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

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

使用条件

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

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

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

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

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

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

マージ線

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

マージ線の表示と非表示

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

マージ線と自動バージョンを表示したバージョンと履歴グラフ (上図)。

マージを非表示にしたバージョンと履歴グラフ (上)。

自動バージョンを非表示にしたバージョンと履歴グラフ (上図)

マージ線の例

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

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

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

詳細については、「カスタムフィーチャを公開する」を参照してください。

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

履歴を検索するには:

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. バージョンを作成するワークスペース (またはブランチ) を開きます。

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

これを行うには、目的のワークスペースをタップして選択し、開くアイコンをタップします。

3. をタップします。

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

   バージョンをタップすると、[開く] や [ブランチ] などの詳細とオプションが表示されます。

   

ドキュメントのブランチを作成するには、次の手順に従います。

1. [バージョンと履歴] パネルにアクセスします。
2. ブランチを作成するバージョンをタップして選択します。

   

3. ブランチアイコンをタップします。

   

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

   b2 およびメインはブランチであり、バージョングラフでは太字と斜体のテキスト、および開いたドットで示されることに注意してください。

   また、「v1」と「スタート」は保存されたバージョンであり、バージョングラフでは通常のテキストと実線で示されます。

   メイン というタイトルのブランチには、ラインの青色で示されているように、「v1」と「開始」の 2 つのバージョンがあります。b2 というタイトルのブランチには、まだ保存されたバージョンはありません。黄色の行にある唯一のアイテムです。

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

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

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

1. [バージョン] パネルを開きます。
2. 復元したいバージョンをタップします。
3. パネルの上部にある復元アイコンをタップします。

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