You can use the Versions and history panel to create versions (which are View only) and branch a version to create a new workspace. You can also compare history entries in workspaces and versions, and any combination of the two. For more information, see Comparing.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
您可以從文件面中建立版本;按一下 來建立一個新版本而不離開工作區。
您也可以藉由在文件面板中的「版本與歷程」來建立版本:
- 在文件是開啟的情況下,按一下
來開啟「版本與歷程」。
- 按一下要從其中建立版本的工作區;這樣會使得工作區變為啟用的。
- 按一下「建立版本」圖示
。
- 在出現的對話方塊中輸入新版本的名稱與說明。
- 如果文件中的任何工程圖有待處理的更新,會以鮮黃色的「更新」圖示
標示,同時會在對話方塊中包括一個訊息:
按一下訊息中的
圖示來更新所有列出的工程圖,使得版本會包含工程圖最新的版本。請注意,如果您按一下「更新」圖示然後取消對話方塊,系統仍會更新工程圖。
- 按一下兩者之一:
- 建立 - 建立新的版本並留在目前啟用的工作區中
- 建立版本並編輯屬性 - 建立新版本並同時為新版本開啟「屬性」對話方塊。這個「屬性」對話方塊包括新版本中每個分頁與零件的名稱與說明。
新版本出現在「版本與歷程」圖表中:
Onshape may also create a version automatically when updating document references. In that case, you will see an automatic version icon in the graph, as shown below:
關於自動建立版本的詳細資訊,請參考更新參考。
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
To delete a document workspace:
- 在文件是開啟的情況下,按一下
來開啟「版本與歷程」。
- Right-click on the branch to delete.
- 選擇 [刪除]。
- Click Delete to confirm.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
To restore a deleted workspace:
- Open the document with the deleted workspace.
- 展開文件功能表
:
- Select Restore deleted workspaces.
- In the dialog, select the branch(es) you want to restore.
- Click Restore selected.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
假設有一個團隊正在設計自行車,而車體的設計已相當成熟穩定。現在此團隊想要嘗試不同的零組件設計,可以將基本的車體設計標示為一個版本來嘗試不同的設計。
- 按一下「版本與歷程」圖示
來在文件面板中開啟「版本與歷程」:
- 按一下「建立版本」圖示
。
- 將第一個版本命名為 Base Frame,然後按一下 建立:
每個設計人員可以從 Base Frame 版本中建立自己的工作區,或許可以將這些工作區命名為 Seat、Brakes、Shocks。
- Right-click the Base Frame version, then click Branch to create workspace:
- 將新的工作區命名為 Seat,然後按一下 建立:
Base Frame 版本以及原始的工作區 (Main) 仍然存在。此外,會有第二個工作區 Seat,所以設計人員對坐墊 (seat) 所做的變更不會影響 Base Frame 工作區。
- Shocks 與 Brakes 設計人員可從相同的 Base Frame 版本分別建立自己的工作區:
The workspace of each designer is, at this point, identical to the Base Frame version. - As they continue to design in their own branches, their designs evolve, independently of the Base Frame version and independently of each other. As they work, they are free to create versions of the workspaces.
When the independent work is complete, each branch is merged back into the Main workspace, bringing all the independent work together.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
圖例
典型的「版本與歷程」圖表會包含各種圖示以表明工作區、分支版本的類型,或每個節點的修訂版類型。若要全方位了解如何解讀圖表,請參考這個表格:
圖示 | 表示 |
![]() |
版本 |
![]() |
變更節點 |
![]() |
一個版本中包含已經核准的發行。 |
![]() |
一個版本中包含的發行內有已淘汰的項目。 |
![]() |
一個工作區。 |
![]() |
有待決修訂版的一個版本。 |
![]() |
在「版本與歷程」中由 Onshape 自動建立的一個版本;例如,當使用「更新至最新的」選項時 (在這個主題中稍後將說明)。 |
Terms
- 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.
Merge lines
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 linesTo 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 (above).
A Versions and history graph with merges hidden (above).
A Versions and history graph with automatic versions hidden (above).
Merge lines exampleThe 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.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
搜尋歷程記錄可讓您搜尋所有版本與分支間的歷程記錄項目。根據您的搜尋字詞,出現的結果會是經篩選的項目清單。搜尋中不會包含版本名稱與版本說明。
搜尋歷程記錄:
-
在「搜尋歷程記錄」欄位中輸入搜尋字詞。系統會在「版本與歷程」清單中顯示包括搜尋字詞的所有歷程記錄項目:
-
您可以選擇性地進一步縮小搜尋範圍,按一下「搜尋歷程記錄」欄位中的下拉箭頭,這樣可讓您使用下列準則篩選搜尋結果:
-
分頁 - 選擇特定的文件分頁來縮小搜尋的範圍。預設會是「任何」分頁。
-
分頁類型 - 選擇 Part Studio、Assembly 或 Drawing 來縮小搜尋範圍。預設的搜尋會使用所有的分頁類型。按一下 清除 按鈕來重設分頁類型篩選器。搜尋中會同時包含兩個分頁類型。
-
修改者 - 選擇變更歷程的使用者來縮小搜尋的範圍。選項有「只有我」、「不是我」與「任何人」 (預設)。
-
修改日期 - 選擇開始與結束日期來縮小搜尋範圍。預設會搜尋所有的日期。
-
在選取了準則之後,按一下 搜尋 按鈕,即會根據新準則來篩選搜尋字詞。您可以隨時按一下 重設 按鈕來將篩選器準則重設回預設值。
在搜尋時會出現來自所有分支的結果,即使您已在搜尋欄位上方選擇了「啟用中的分支」。
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
「篩選分支」按鈕會改變顯示在您版本圖表中的分支為何。
篩選分支:
- 開啟「版本與歷程」面板。
- 按一下「篩選分支」按鈕。
- 選擇一個篩選器選項:
- 顯示所有分支 - 顯示在版本圖表中的所有分支。這是預設的視圖。
- Show all branches with workspaces - Hide all branches that belong to deleted workspaces. In the image below, you'll see that the bottom green branch (in the image above) has been hidden. This option can be used to clean up large version graphs.
- 顯示目前分支 - 僅顯示目前的分支。
- Show current branch with parent branches - Display only the current branch and its parent branches.
- 顯示所有分支 - 顯示在版本圖表中的所有分支。這是預設的視圖。
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
With the Versions and history panel, you can create versions (which are read-only) and branch a version to create a new workspace.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
You can open the Versions and history panel from the Documents page or from within the document:
- From the Documents page - Select the Information panel icon that corresponds with the document for which you want to open the Versions and history panel, then tap Versions.
- From within the document - Tap the Versions and history icon
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
- The Versions and history panel displays the default version graph for a document,
- A Main workspace and a Start version exist by default.
- Tap to switch between viewing All branches and the Active branch (workspace that is active, or open, in the graphics area).
- Tap Create version
to create a version.
- Tap the X to close the Versions and history panel.
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 every branch ends with a workspace, which are depicted as open dots. Branch names are shown with bold and italic text. 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 highlight. In the image above, branch B1 is the active branch.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
- 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.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
建立文件的一個版本:
- Open the Versions and history panel
.
- Tap the workspace or branch from which to create a version to select it.
- Tap
.
- Add a name and description for the version, then select Create version.
- The newly created version appears in the Versions and history panel.
工作區 (分支) 會以空心圓點來表示。
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
建立文件的一個分支:
- Open the Versions and history panel
.
- Tap the three-dot menu icon next to the version you want to branch from, then tap Branch to create workspace.
- Add a name and description for the branch, and then select Create workspace.
- The newly created branch appears in the Versions and history panel.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
Onshape 會保持所有文件上每個使用者做出變更的完整歷程記錄。這樣可讓您在文件歷程中的一個清單上檢視這些變更,並隨時可將文件還原至歷程中的特定時間點上。
當還原時,系統還原的是您所在的工作區。如果您要還原另一個工作區,請先開啟該工作區。
將版本還原至目前啟用的工作區中:
- Open the Versions and history panel
.
- Tap the version you wish to restore to.
- Tap the three-dot menu icon next to the version you want to restore, then tap Restore to [Target].
關於還原版本的詳細資訊,請參考文件管理。
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
With the Versions and history panel, you can create versions (which are read-only) and branch a version to create a new workspace.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
You can open the Versions and history panel from the Documents page or from within the document:
- 從文件頁面中:
Select the Information panel icon that corresponds with the document for which you want to open the Versions and history panel. From here tap Versions.
- 在文件之中:
輕觸左上角的版本圖示。
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
- The Versions and history panel displays the default version graph for a document, notice there is a Main workspace, and a "Start" version by default.
- There are two icons in the upper right of the Versions and history panel:
- 建立一個版本
- Close Versions and history panel
- 輕觸來在檢視所有分支與啟用中的分支間轉換 (在圖形區域中啟用或開啟的工作區):
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 bold and italic 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.
啟用中的分支,也就是目前開啟的工作區會在標題旁有藍色的長條出現。在上方的圖片中,分支標題 b2 是啟用中的分支,且在左方有藍色的長條表明為啟用的分支。
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
- 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.
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
建立文件的一個版本:
- Access the Versions and history panel.
- 開啟要從其中建立版本的工作區 (或分支)。
- Tap
.
工作區 (分支) 會以空心圓點來表示。
要開啟工作區,請輕觸來選擇所要的工作區,然後輕觸開啟的圖示。
- 加入版本的名稱與說明,然後選擇建立。
- The newly created version appears in the Versions and history panel:
在版本上輕觸來查看詳細資料與選項,例如像是開啟與分支。
![封閉](../Skins/Default/Stylesheets/Images/transparent.gif)
建立文件的一個分支:
- Access the Versions and history panel.
- 輕觸來選擇要從其中建立分支的版本:
- 輕觸分支的圖示:
- 加入分支的名稱與說明,然後選擇建立。
- The newly created branch appears in the Versions and history panel.
請注意:b2 與 Main 都是分支,並在版本圖表中由粗斜體文字與空心圓點表示。
同時注意到 "v1" 與 "Start" 都是已儲存的版本,在版本圖表中以正常文字與實心圓點來指明。
名為 Main 的分支有兩個版本:"v1" 與 "Start",由藍色的線條表示。名為 b2 的分支尚未有任何儲存的版本,因此是黃色線條上的唯一項目。
For additional Learning center resources, follow the self-paced courses here: Branching and Merging (Onshape account required) and Document History and Versions (Onshape account required). You can also follow the learning pathway course here: Onshape Fundamentals: Data Management (Onshape account required) and the technical briefing articles here: Understanding and Working with a Document’s Historical Data (Onshape account required) and Gitflow Version Management (Onshape account required).