项目历史

Parent page: Workspace 项目

Enterprise Server Workspace 通过专用的交互式 History 视图，为“以历史概览的形式查看项目活动”的需求提供了一个优雅的解决方案。该项目 History 视图可通过 Workspace 的浏览器界面 访问，也可在 Altium Designer 内访问，并以递进的时间线形式展示与项目相关的重大事件。事件包括项目创建、提交、发布、克隆以及 MCAD 交换等，并在适用时提供相应的事件操作命令。

访问项目历史

要访问某个项目的 History 视图，需要从该项目面向 CAD 的详细管理页面进入——即 Projects Management 页面。在左侧窗格中单击 History 选项。

Projects Management 页面本身可从主 Projects 页面打开：双击某个项目条目、单击其标题，或从 菜单中选择 Open 选项。更多信息请参阅 特定项目的管理。

从项目的详细管理页面访问该项目的历史记录。

历史时间线——概览

History 视图以时间线形式呈现项目演进过程中发生的基本事件。它基本可分为三个关键要素，如下图及说明所示。

识别 History 视图的三个关键组成部分。

1. Main trunk of the timeline。事件时间顺序方向为自下而上。第一个事件——项目创建——会出现在时间线底部。后续事件依次显示在上方，最新（当前最新的事件）显示在时间线顶部。
2. Events。每当与项目相关的受支持事件（见下文）发生时，都会以一个专用的磁贴添加到时间线中。不同类型的事件会使用不同颜色的磁贴，并且要么直接连接到时间线主干，要么在旁边带有关联图标（如 MCAD Exchange 事件的情况；）。
3. Search。单击视图右上角的 控件可访问搜索字段，用于对项目历史进行基础搜索。随着你输入搜索字符串，时间线会应用过滤，仅显示与该搜索相关的事件。更多信息请参阅 过滤搜索。

受支持的事件

时间线展示项目生命周期中发生的一系列事件。每个事件都会以专用的“事件磁贴”形式出现在时间线上。以下各节将介绍当前支持并可作为项目历史时间线一部分进行展示的事件范围。

项目创建

Related pages:创建新的 Workspace 项目（浏览器界面 / Altium Designer）、将现有项目上线、克隆项目（浏览器界面 / Altium Designer）

当项目被创建时，时间线中会添加 Project Created 事件磁贴。该事件标志着项目历史时间线的起点。因此，它总是位于时间线底部的条目。该事件的磁贴有两种不同的呈现形式：

• 当项目是在 Workspace 内新建时。磁贴会显示项目创建者的姓名（及头像/符号）以及项目创建时间。如果在创建时输入了项目描述，也会在磁贴中显示。

• 当项目是从现有项目克隆而来时。磁贴会显示创建该克隆项目的人员姓名（及头像/符号）以及项目创建时间。如果在克隆时输入了项目描述，也会在磁贴中显示。磁贴还提供指向原始源项目的链接——单击后将访问该项目的详细管理页面，并在浏览器的单独标签页中打开。

Project Created 事件磁贴通过实心蓝色连接线和节点与时间线主干物理连接：

项目提交

每次你将 项目保存到 Worskpace（项目在 Worskpace 内部的 Versioned Storage Git 仓库下进行管理）时，时间线都会添加一个 Project Committed 事件磁贴。磁贴会显示执行提交与推送的人员姓名（及头像），以及日期和时间。如果在提交与推送时通过 Save to Server dialog 添加了注释，也会在磁贴中显示。

初始 Project Committed 事件磁贴示例。

该磁贴还支持并展示设计差异（diff）信息，提供当前提交与上一次提交之间更详细的变更内容。支持的元素包括文件、元件、网络、变体以及 PCB 结构。磁贴中的差异部分会按以下状态对受该提交事件影响的各类元素进行汇总：

– 新增元素。

– 删除元素。

– 修改元素。

单击磁贴中的 控件可展开该差异部分，按名称显示受影响的元素。

使用可用的 Show More 和 Show Less 控件可查看每种元素类型的完整列表。单击磁贴中的 控件可返回汇总显示。

单击磁贴右上角的 控件可打开菜单，其中包含以下命令：

• Clone – 使用该命令可基于该项目的特定修订版创建一个克隆。将出现 Clone Project 窗口，用于确定项目 Name、Description，以及在 Advanced 选项下的目标 Server Folder 和 Repository。请注意，窗口横幅文本会反映该克隆是从项目的哪个修订版创建的。按需定义信息后，单击 按钮。项目将被创建，并在时间线中添加一个 Project Cloned 事件磁贴。

你可以直接从对应修订版的 Project Committed 事件磁贴中，基于活动项目的任意特定修订版创建克隆。

• Download Snapshot – 使用该命令可将该项目特定修订版的项目源文件以 Zip 压缩包形式下载。Zip 文件名以及 PCB 项目文件名将包含该修订版提交并推送到 Workspace 的日期与时间（UTC 时间）。

Project Committed 事件磁贴通过实心蓝色连接线和节点与时间线主干物理连接：。项目的最新修订版（即最后一次提交）会通过其节点为白色填充来加以区分：。

项目发布

Related page: 板级设计发布

每次你使用 Altium Designer 的 Project Releaser 执行项目发布时，时间线都会添加一个 Project Released 事件磁贴。磁贴会显示执行发布的人员姓名（及头像），以及日期和时间。如果在将生成的数据发布到 Workspace 时通过 Confirm Release dialog 添加了发布说明，也会在磁贴中显示。发布中包含的每个数据集也会被列出。

Project Released 事件磁贴示例。

单击磁贴右上角的 控件可打开菜单，其中包含以下命令：

• View – 打开一个专用的制造门户（在单独的浏览器标签页中），以便更细致地检查已发布的数据。在该门户中，你可以查看并浏览已发布的文件数据、检查 BOM，并查看与评论设计本身的快照（即该发布数据的源）。你还可以使用控件按不同粒度下载制造数据（从完整数据集到单个生成的输出文件）。所选发布也可以作为 Manufacturing Package 直接发送给你的制造商。更多信息请参阅 Manufacturing Portal 中的“浏览发布包”。

访问专用的 Manufacturing Portal 标签页，以便更细致地检查项目发布内容。

• BOM To– 允许你将此版本中的物料清单（BoM）数据与另一个版本进行对比。使用相关子菜单可与上一版本的 BOM 数据对比，或从该项目已创建的所有版本中选择进行对比。数据对比功能会检测指定项目版本之间原始 BOM 数据的差异，并且也可从 Workspace 的项目 Releases view 访问。对比结果通过下载 CSV 文件提供，其中详细列出在指定项目版本之间发生变化的 BOM 数据——新增、移除或更新。

• Download – 允许你通过一个 subsequent window 选择要下载发布包中的哪些数据集。完成选择后，点击 按钮。系统将下载一个 Zip 压缩包，其中包含每个所选数据集对应的文件夹。
• Download Snapshot – 允许你以 Zip 压缩包形式下载用于创建该发布包的设计版本快照。

项目克隆

Related page: 克隆项目（browser interface / Altium Designer）

每次克隆项目——无论是通过 Workspace 的浏览器界面，还是在 Altium Designer 内部——时间线上都会添加一个 Project Cloned 事件卡片。卡片会显示执行克隆的人员姓名（及头像），以及日期和时间。克隆时会自动生成一段描述并添加到卡片中，你也可以输入新的描述来覆盖它。卡片中提供了指向被克隆项目的链接——点击后将进入该项目的详细管理页面，并在浏览器的单独标签页中打开。

Project Cloned 事件卡片示例。

MCAD 交换

Related page: Altium MCAD CoDesigner

在电子与机械设计领域协同工作时，Workspace 充当两者之间的桥梁——促进 直接 ECAD-MCAD 协同设计。每当对项目的 PCB 设计进行更改，并通过相应的 CoDesigner 面板将这些更改推送到 Workspace 时，时间线上都会添加一个 MCAD Changes Suggested 事件卡片。卡片会显示执行推送的人员姓名（及头像），以及日期和时间。如果在推送时通过 MCAD CoDesigner 面板（Altium Designer）或 Altium CoDesigner 面板（在 supported MCAD software 中）发布了消息，该消息也会显示在卡片中。

当 MCAD 工程师在其支持的 MCAD 软件中对 PCB 进行更改并将其推送回 Workspace 后，在 Altium Designer 中从 Workspace 拉取这些更改之后，相应的推送事件将会出现在项目历史时间线 only 上。

示例展示了两个与 MCAD 相关的事件。时间线主干中较低的事件表示来自 ECAD 端的推送事件，而较高的事件表示来自 MCAD 端的回推事件。

筛选搜索

点击视图右上角的 控件以打开搜索字段，用于沿时间线快速查找感兴趣的事件。搜索功能支持对项目历史进行基础搜索，并在你输入搜索字符串时动态应用筛选——页面上只保留与该搜索相关的事件。事件卡片中匹配的文本会被高亮显示。

项目历史搜索示例。随着你输入（不区分大小写的）搜索词，时间线会动态筛选，并在每个相关事件卡片中高亮匹配条目。

搜索功能适用于以下信息：

• 事件卡片标题。
• 执行该事件的人员姓名。
• 描述性文本（事件发生时来自评论/备注/描述的文本）。
• 差异对比数据文本——在 Project Committed 事件卡片中。
• 数据集名称——在 Project Released 事件卡片中。
• 项目名称——在 Project Cloned 事件卡片和 Project Created 事件卡片中（通过克隆创建时）。

要清除当前筛选并返回完整时间线，请清空搜索字段——可以选中当前文本并按 Backspace 键，或点击字段最右侧的 控件。或者，点击汇总当前显示事件数量的框（位于视图顶部）中的 Clear Filter 控件。

使用新事件更新

每当与项目相关的受支持事件发生时，该事件会被检测到并自动提供给 History view。事件发生后不久，视图底部会出现通知——点击 控件即可用新事件更新时间线。

也提供手动刷新：点击视图右上角的 控件即可执行。