版本與歷程

您可以從文件面中建立版本；按一下 來建立一個新版本而不離開工作區。

您也可以藉由在文件面板中的「版本與歷程」來建立版本：

1. 在文件是開啟的情況下，按一下 來開啟「版本與歷程」。
2. 按一下要從其中建立版本的工作區；這樣會使得工作區變為啟用的。
3. 按一下「建立版本」圖示 。
4. 在出現的對話方塊中輸入新版本的名稱與說明。
5. 如果文件中的任何工程圖有待處理的更新，會以鮮黃色的「更新」圖示 標示，同時會在對話方塊中包括一個訊息：

   

   按一下訊息中的 圖示來更新所有列出的工程圖，使得版本會包含工程圖最新的版本。請注意，如果您按一下「更新」圖示然後取消對話方塊，系統仍會更新工程圖。

6. 按一下兩者之一：
   1. 建立 - 建立新的版本並留在目前啟用的工作區中
   2. 建立版本並編輯屬性 - 建立新版本並同時為新版本開啟「屬性」對話方塊。這個「屬性」對話方塊包括新版本中每個分頁與零件的名稱與說明。

新版本出現在「版本與歷程」圖表中：

當更新文件參考時，Onshape 同時會自動建立版本。在此種狀況下，您會在圖表中看到一個自動版本的圖示，如下所示：

If the user is an Onshape employee, an Onshape logo icon is displayed to the left of the User's name under the Modified column in the graph:

關於自動建立版本的詳細資訊，請參考更新參考。

When you branch from a version, you are creating a new branch that can contain additional versions, as well as a new workspace at the tip (end) of the branch.

1. 在文件是開啟的情況下，按一下 來開啟「版本與歷程」。
2. Right-click on the version entry from which to create a workspace and select Branch to create workspace from the context menu:

   

3. In the Properties dialog that appears, enter the name and description for the workspace:

   

4. 按一下兩者之一：
   1. Create - Creates the workspace and optionally open it (check box)
   2. Create version and edit properties - Creates the workspace (optionally open it) and also open its Properties dialog. This Properties dialog includes names and descriptions for each tab and part of the new document workspace.

您可以比較兩個工作區、兩個版本、或一個版本和一個工作區。您也可以合併一或多個分支。

If a user owns the document, they can delete the workspace.

If a document is shared with a user, and "Delete" is enabled under the document's share permission settings, that user can delete the document's workspace.

For Enterprise users, they must be granted the ability to "Permanently delete" under Global permissions and the ability to "Delete" under the document's share permission settings to delete the document's workspace.

Deleting a document's workspace deletes the workspace from the tip (end) of a branch:

• If no version on the branch exists, then the workspace and the branch are deleted.

• If the branch contains one or more versions, the workspace is deleted, and the branch reverts to the latest version.

To delete the workspace:

1. 在文件是開啟的情況下，按一下 來開啟「版本與歷程」。
2. 在要刪除的分支上按右鍵。
3. 選擇 [刪除]。

   

4. 按一下[刪除] 來確認。

   

還原已刪除的工作區：

1. 開啟包含已刪除工作區的文件。
2. 展開文件功能表 ：

   

3. 選擇「還原已刪除的工作區」。
4. 在對話方塊中，選擇您要還原的分支。
   
5. 按一下 [還原選取的]。

假設有一個團隊正在設計自行車，而車體的設計已相當成熟穩定。現在此團隊想要嘗試不同的零組件設計，可以將基本的車體設計標示為一個版本來嘗試不同的設計。

1. 按一下「版本與歷程」圖示 來在文件面板中開啟「版本與歷程」：

   

2. 按一下「建立版本」圖示 。
3. 將第一個版本命名為 Base Frame，然後按一下 建立：

   

   

   每個設計人員可以從 Base Frame 版本中建立自己的工作區，或許可以將這些工作區命名為 Seat、Brakes、Shocks。

4. 在 Base Frame 版本上按右鍵，然後按一下 [產生分支來建立工作區]：

   

5. 將新的工作區命名為 Seat，然後按一下 建立：

   

   Base Frame 版本以及原始的工作區 (Main) 仍然存在。此外，會有第二個工作區 Seat，所以設計人員對坐墊 (seat) 所做的變更不會影響 Base Frame 工作區。

6. Shocks 與 Brakes 設計人員可從相同的 Base Frame 版本分別建立自己的工作區：

   
   在這個時間點上，每個設計人員的工作區都是與 Base Frame 版本相同的。

7. 當設計人員在自己的分支上繼續設計，其設計工作會完全與 Base Frame 版本分開獨立，且在設計人員的工作之間也是如此。設計人員進行設計工作時，可以任意建立工作區的版本。

   當單獨的工作完成時，可將每個分支合併回 Main 工作區中，讓所有的獨立工作整合在一起。

   

圖例

典型的「版本與歷程」圖表會包含各種圖示以表明工作區、分支版本的類型，或每個節點的修訂版類型。若要全方位了解如何解讀圖表，請參考這個表格：

圖示	表示
	版本
	變更節點
	一個版本中包含已經核准的發行。
	一個版本中包含的發行內有已淘汰的項目。
	一個工作區。
	有待決修訂版的一個版本。
	在「版本與歷程」中由 Onshape 自動建立的一個版本；例如，當使用「更新至最新的」選項時 (在這個主題中稍後將說明)。

條款

• Version - A named and saved state of the document. Versions are immutable and separate from workspaces. Create a version to capture a workspace at a particular point in time. You can open and branch a version.

  Indicated by normal text and a solid dot on the version graph.

• Workspace - A modeling/design space.

  The active workspace is indicated by a blue box to the left of it in the version graph list, and an open dot at the end of the associated branch.

• Branch - Where the document is split and a new workspace is created. A branch can have zero or more versions, and up to one workspace. You can open and delete a branch.

  Indicated by bold and italic text and a dot on the version graph. If the dot is open, the branch has one associated workspace. If the dot is closed, the workspace associated with that branch has been deleted.

合併線

All merges are displayed explicitly in the Versions and history graph, which updates automatically as changes are made to the document.

Showing and hiding merge lines

To make the Versions and history graph easier to visualize, toggle the Show/Hide merges and Show/Hide automatic versions buttons as needed:

A Versions and history graph with merge lines and automatic versions shown on the Onshape browser application (above).

A Versions and history graph with merges hidden on the Onshape browser application (above).

A Versions and history graph with automatic versions hidden on the Onshape browser application (above).

Merge lines example

The example below shows a complex Versions and history graph with several branches. Each branch was created from the Main workspace, and then individual work was done on each branch. As work on each branch was completed, the branches were merged back into Main. The flow of lines to and from the Main branch shows the merging workflow, making it easy to see which changes were merged when.

A Versions and history graph with several branches shown on the Onshape browser application (above).

To automatically scroll to the top or bottom of a branch, right-click on a branch to access the context menu and select either the Scroll to branch top or Scroll to branch bottom option.

如果文件版本中包含已發佈的自訂特徵，系統會在「版本與歷程」圖表的版本節點周圍顯示括弧指標 ({})：

詳細資訊請參考發佈自訂特徵。

搜尋歷程記錄可讓您搜尋所有版本與分支間的歷程記錄項目。根據您的搜尋字詞，出現的結果會是經篩選的項目清單。搜尋中不會包含版本名稱與版本說明。

搜尋歷程記錄：

1. 在「搜尋歷程記錄」欄位中輸入搜尋字詞。系統會在「版本與歷程」清單中顯示包括搜尋字詞的所有歷程記錄項目：

   

在搜尋時會出現來自所有分支的結果，即使您已在搜尋欄位上方選擇了「啟用中的分支」。

2. 您可以選擇性地進一步縮小搜尋範圍，按一下「搜尋歷程記錄」欄位中的下拉箭頭，這樣可讓您使用下列準則篩選搜尋結果：

   

• 分頁 - 選擇特定的文件分頁來縮小搜尋的範圍。預設會是「任何」分頁。

• 分頁類型 - 選擇 Part Studio、Assembly 或 Drawing 來縮小搜尋範圍。預設的搜尋會使用所有的分頁類型。按一下 清除 按鈕來重設分頁類型篩選器。搜尋中會同時包含兩個分頁類型。

• 修改者 - 選擇變更歷程的使用者來縮小搜尋的範圍。選項有「只有我」、「不是我」與「任何人」 (預設)。

• 修改日期 - 選擇開始與結束日期來縮小搜尋範圍。預設會搜尋所有的日期。

3. 在選取了準則之後，按一下 搜尋 按鈕，即會根據新準則來篩選搜尋字詞。您可以隨時按一下 重設 按鈕來將篩選器準則重設回預設值。

「篩選分支」按鈕會改變顯示在您版本圖表中的分支為何。

篩選分支：

1. 開啟「版本與歷程」面板。
2. 按一下「篩選分支」按鈕。
3. 選擇一個篩選器選項：
   • 顯示所有分支 - 顯示在版本圖表中的所有分支。這是預設的視圖。

     

   • 顯示有工作區的所有分支 - 隱藏屬於已刪除工作區的所有分支。在下方的圖片中，您會看到綠色分支的底部被隱藏 (上方圖片中)。這個選項可用來清理大型的版本圖表。

     

   • 顯示目前分支 - 僅顯示目前的分支。

     

   • 顯示有父分支的目前分支 - 僅顯示目前的分支與其父分支。

     

您可以從文件頁面或文件內開啟「版本與歷程」面板：

• 從文件頁面中 - 選擇與您要開啟「版本與歷程」面板相對應文件的資訊面板圖示，然後輕觸版本。
• From within the document, tap the Versions and history icon on the left side of the graphics area.

• 「版本與歷程」面板中顯示文件的預設版本圖表。
• 根據預設會有一個 Main 工作區與一個 Start 版本存在。
• 輕觸來在檢視所有分支與啟用中的分支間轉換 (在圖形區域中啟用或開啟的工作區)。
• 輕觸「建立版本」 來建立一個版本。
• 輕觸 X 來關閉「版本與歷程」面板。

圖表以樹狀結構顯示所有的版本與工作區。圖表中根據分支有不同的色彩標示。每個分支使用一個顏色，然後以工作區來結束，會以空心圓點來代表。分支名稱是以粗斜體文字顯示。版本則是以實心圓點及正常文字來表示，且是唯檢視的。

使用中分支，也就是目前開啟的工作區會用藍色強調顯示。在上方的圖片中，分支 B1 是使用中的分支。

• Version - A named and saved state of the document. Versions are immutable and separate from workspaces. Create a version to capture a workspace at a particular point in time. You can open and branch a version.

  Indicated by normal text and a solid dot on the version graph.

• Workspace - A modeling/design space.

  The active workspace is indicated by a blue box to the left of it in the version graph list, and an open dot at the end of the associated branch.

• Branch - Where the document is split and a new workspace is created. A branch can have zero or more versions, and up to one workspace. You can open and delete a branch.

  Indicated by bold and italic text and a dot on the version graph. If the dot is open, the branch has one associated workspace. If the dot is closed, the workspace associated with that branch has been deleted.

建立文件的一個版本：

1. 開啟「版本與歷程」面板 。
2. 輕觸以選擇要從其中建立版本的工作區或分支。

工作區 (分支) 會以空心圓點來表示。

3. 輕觸 。
4. 加入版本的名稱與說明，然後選擇建立版本on。

   

5. 新建立的版本會出現在「版本與歷程」面板中。
   

When you branch from a version, you are creating a new branch that can contain additional versions, as well as a new workspace at the tip (end) of the branch.

1. 開啟「版本與歷程」面板 。
2. Tap the three-dot menu icon next to the version (other than Main) you want to branch from (Start, in the image below), then tap Branch to create workspace.

   

3. 加入分支的名稱與說明，然後選擇建立工作區。
4. 新建立的分支會出現在「版本與歷程」面板中。
   

Onshape 會保持所有文件上每個使用者做出變更的完整歷程記錄。這樣可讓您在文件歷程中的一個清單上檢視這些變更，並隨時可將文件還原至歷程中的特定時間點上。

當還原時，系統還原的是您所在的工作區。如果您要還原另一個工作區，請先開啟該工作區。

將版本還原至目前啟用的工作區中：

1. 開啟「版本與歷程」面板 。
2. 輕觸您要還原的版本。
3. 輕觸您要還原版本旁的三點功能表圖示，然後再輕觸 [還原至 [目標]]。

   

關於還原版本的詳細資訊，請參考文件管理。

您可以從文件頁面或文件內開啟「版本與歷程」面板：

• 從文件頁面中：

  選擇與您要開啟「版本與歷程」面板相對應文件的資訊面板圖示，然後從該處輕觸版本。

• From within the document:

  Tap the Version and history icon on the left side of the graphics area.

  

• The Version and history panel displays the default version graph for a document. There is a Main workspace and a Start version by default.
• 「版本與歷程」右上角有兩個圖示：

- 建立一個版本

- Close Version and history panel

• Tap the labels at the top of the panel to switch between viewing All branches and the Active branch (the workspace that is currently open in the graphics area):

The graph displays all versions and workspaces of a document in tree form. The graph is color-coded by branch. Each branch is one color, and branch names are shown with outlined, color-coded text. The workspace associated with a branch is displayed as an open dot. Versions are depicted as solid dots (and normal text) and are View only.

The active branch, which is the currently open workspace, is indicated by a blue box around the title. For example, in the image above, B2 is the active branch name.

• Version - A named and saved state of the document. Versions are immutable and separate from workspaces. Create a version to capture a workspace at a particular point in time. You can open and branch a version.

  Indicated by normal text and a solid dot on the version graph.

• Workspace - A modeling/design space.

  The active workspace is indicated by a blue box to the left of it in the version graph list, and an open dot at the end of the associated branch.

• Branch - Where the document is split and a new workspace is created. A branch can have zero or more versions, and up to one workspace. You can open and delete a branch.

  Indicated by bold and italic text and a dot on the version graph. If the dot is open, the branch has one associated workspace. If the dot is closed, the workspace associated with that branch has been deleted.

To create a version of the current active document:

1. On the left side of the graphics area, tap the Create version icon .
2. Enter the name (and optionally, description) of the new version and tap Create.

To create a version from another workspace or branch:

1. Tap the Versions and history icon to open the Version and history panel.
2. Tap the workspace (or branch) from which to create a version to open that workspace.

工作區 (分支) 會以空心圓點來表示。

3. Tap the Create version icon at the top of the panel.

4. Add a name and description for the version, then tap Create.
5. The newly created version appears in the Versions and history panel.

Tap the three dot menu next to a version to see options such as Properties, Open, and Branch to workspace.

When you branch from a version, you are creating a new branch that can contain additional versions, as well as a new workspace at the tip (end) of the branch.

1. Tap the Versions and history icon to open the Version and history panel.
2. Tap to select the version from which to create a branch.
3. Tap the three dot menu next to the version, then tap Branch to create workspace.
4. Add a name and description for the branch, and then tap Create.
5. The newly created branch appears in the Versions and history panel.

Onshape 會保持所有文件上每個使用者做出變更的完整歷程記錄。這樣可讓您在文件歷程中的一個清單上檢視這些變更，並隨時可將文件還原至歷程中的特定時間點上。

當還原時，系統還原的是您所在的工作區。如果您要還原另一個工作區，請先開啟該工作區。

將版本還原至目前啟用的工作區中：

1. Open the Versions and history panel.
2. 輕觸您要還原的版本。
3. Tap the three dot menu next to the version and tap Restore to Main.

關於還原版本的詳細資訊，請參考文件管理。