版本和历史记录

您可以从文档面板创建版本；单击 可创建新版本且不离开该工作区。

您还可以通过“版本和历史记录”（也位于“文档”面板中）创建版本：

1. 在文档打开的情况下，单击 以打开“版本和历史记录”。
2. 单击要从其创建版本的工作区，这样将激活该工作区。
3. 单击“创建版本”图标 。
4. 在出现的对话框中，输入新版本的名称和说明。
5. 如果文档中的任何工程图具有待决的更新（由亮黄色的“更新”图标 指示），则对话框中将包含一条消息：

   

   单击消息中的图标 以更新列出的所有工程图，以使版本包含最新版本的工程图。请注意，如果您单击“更新”图标而后取消对话框，仍会更新工程图。

6. 单击任意一项：
   1. 创建 - 创建新版本且仍在当前活动的工作区中
   2. 创建版本并编辑属性 - 创建新版本并打开新版本的“属性”对话框。此“属性”对话框包括新版本中每个选项卡和零件的名称和说明。

新版本会显示在版本和历史记录图表中：

当更新文档参考时，Onshape 还可能会自动创建版本。在此情况下，您将在图形中看到自动版本图标，如下所示：

如果用户是 OnShape 员工，则图表中“已修改”列下方用户名左侧会显示 Onshape 徽标图标：

有关自动版本控制的更多信息，请参阅 更新参考文献。

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（底架）版本创建其自己的工作区，或许标记为车座、车闸和减震器。

4. 右键单击 Base Frame（底架）版本，然后单击“创建分支以创建工作区”：

   

5. 将新工作区命名为“席位”，然后单击创建：

   

   Base Frame（底架）版本仍存在，原始工作区（Main 工作区）也存在。此外，还有一个工作区，即车座。所以，设计者对车座进行更改不会影响 Base Frame（底架）工作区。

6. 减震器和车闸的设计者从同一 Base Frame（底架）版本创建各自的工作区：

   
   此时，每位设计师的工作区都与 Base Frame（底架）版本相同。

7. 随着他们继续在自己的分支机构中进行设计，他们的设计会不断发展，独立于 Base Frame（底架）版本，也彼此独立。当他们工作时，他们可以自由创建工作区的版本。

   独立工作完成后，每个分支将合并回 Main 工作区，将所有独立工作汇集在一起。

   

图例

通常，版本和历史图包含指示某个节点的工作区类型、分支、版本或修订的图标。要更完全了解如何解读该图，请考虑查看此表：

图标	指示
	版本
	变更节点
	包含已核准发布的版本。
	包含发布的版本，该发布中包含已淘汰的条目。
	工作区。
	具有待决的修订的版本。
	“版本和历史记录”中由 Onshape 自动创建的版本；例如，在使用“更新至最新版本”选项时，如本主题中后面所述

术语

• 版本 - 文档的已命名且已保存状态。版本不可变且与工作区分离。创建版本可捕捉特定时间点的工作区。您可以打开版本以及为版本建立分支。

  在版本图中以正常文本和实心点来指示。

• 工作区 -　建模/设计空间。

  活动的工作区在版本图列表中以其左侧的蓝框来指示，关联分支末尾有一个实心点。

• 分支 - 拆分文档并创建新工作区的地方。一个分支可以有零个或多个版本，最多一个工作区。您可以打开和删除分支。

  用粗体和斜体文本以及版本图表上的一个点表示。如果该点处于打开状态，则该分支具有一个关联的工作区。如果该点已关闭，则与该分支关联的工作区已被删除

  。

合并线

所有合并都明确显示在“版本和历史记录”图表中，随着文档的更改，该图表会自动更新。

显示和隐藏合并线

为了使“版本和历史记录”图表更易于可视化，请根据需要切换“显示/隐藏合并”和“显示/隐藏自动版本”按钮：

在 Onshape 浏览器应用程序中显示了合并行和自动版本的版本和历史记录图表（上图）。

在 Onshape 浏览器应用程序中隐藏了合并的版本和历史记录图表（上图）。

在 Onshape 浏览器应用程序中隐藏了自动版本的版本和历史记录图表（上图）。

合并线示例

以下示例显示了包含多个分支的复杂“版本和历史记录”图表。每个分支都是从 Main 工作区创建的，然后在每个分支上完成单独的工作。随着每个分支的工作完成，这些分支被合并回了 Main 中。进出 Main 分支的线流显示了合并工作流程，便于查看何时合并了哪些更改。

Onshape 浏览器应用程序上显示了带有多个分支的版本和历史记录图表（上图）。

要自动滚动到分支的顶部或底部，请右键单击分支访问快捷菜单，然后选择“滚动到分支顶部”或“滚动到分支底部”选项。

如果文档版本包含已发布的自定义特征，则版本和历史记录图表中版本节点周围会显示括号指示符 ({})：

请参见发布自定义特征以获取更多信息。

通过搜索历史记录可以在所有版本和分支中搜索历史记录条目。结果是基于搜索词进行筛选的条目列表。版本名称和版本说明不包含在搜索中。

要搜索历史记录，请执行以下操作：

1. 在“搜索历史记录”输入框中输入搜索词。所有历史记录条目（包括搜索词）都显示在“版本和历史记录”列表中：

   

进行搜索时，将从所有分支提供结果，即使您选择了“搜索”输入框上方的“活动分支”也是如此。

2. （可选）要进一步缩小搜索范围，请单击“搜索历史记录”输入框中的下拉箭头。这使您可以使用以下条件筛选搜索：

   

• 选项卡 - 通过选择特定文档选项卡来缩小搜索范围。默认为“任何”选项卡。

• 选项卡类型 - 通过选择 Part Studio、装配体或工程图缩小搜索范围。默认搜索使用所有选项卡类型。单击清除按钮可重置选项卡类型筛选器。两个选项卡类型都包含在搜索中。

• 修改者 - 通过选择进行历史更改的人员来缩小搜索范围。选项包括“只有我”、“不是我”或“任何”（默认）。

• 修改日期 - 通过选择开始日期和结束日期缩小搜索范围。默认情况下会搜索所有日期。

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 是活动分支。

• 版本 - 文档的已命名且已保存状态。版本不可变且与工作区分离。创建版本可捕捉特定时间点的工作区。您可以打开版本以及为版本建立分支。

  在版本图中以正常文本和实心点来指示。

• 工作区 -　建模/设计空间。

  活动的工作区在版本图列表中以其左侧的蓝框来指示，关联分支末尾有一个实心点。

• 分支 - 拆分文档并创建新工作区的地方。一个分支可以有零个或多个版本，最多一个工作区。您可以打开和删除分支。

  用粗体和斜体文本以及版本图表上的一个点表示。如果该点处于打开状态，则该分支具有一个关联的工作区。如果该点已关闭，则与该分支关联的工作区已被删除

  。

要创建文档的版本：

1. 打开“版本和历史记录”面板。
2. 轻按要创建版本的工作区或分支以将其选中。

工作区（分支）以空心点来指示。

3. 轻按 。
4. 为版本添加名称和说明，然后选择 创建版本。

   

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. 轻按要分支的版本（主版本除外）旁边的三点菜单图标（开始，在下图中），然后轻按“分支”创建工作区。

   

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.

• 版本 - 文档的已命名且已保存状态。版本不可变且与工作区分离。创建版本可捕捉特定时间点的工作区。您可以打开版本以及为版本建立分支。

  在版本图中以正常文本和实心点来指示。

• 工作区 -　建模/设计空间。

  活动的工作区在版本图列表中以其左侧的蓝框来指示，关联分支末尾有一个实心点。

• 分支 - 拆分文档并创建新工作区的地方。一个分支可以有零个或多个版本，最多一个工作区。您可以打开和删除分支。

  用粗体和斜体文本以及版本图表上的一个点表示。如果该点处于打开状态，则该分支具有一个关联的工作区。如果该点已关闭，则与该分支关联的工作区已被删除

  。

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.

有关恢复版本的更多信息，请参阅 文件管理。