工作区项目

Parent page: Altium On-Prem Enterprise Server

Altium Designer 结合 Enterprise Server Workspace，可支持 Workspace Projects。Workspace 项目面向项目生命周期中的开发阶段，简化了受版本控制项目的创建与持续工作流。由 Workspace 控制的集中式存储也使该功能能够作为其他协作服务的基础。

使用 Workspace 项目的一些关键优势包括：

• 存储更简化。无需再为存储位置做决定。备份及其他基础服务都已处理妥当。
• 协作功能的基础。
• 强制版本控制。
• 专用评论系统的优势。
• 通知与状态。包括本地修改在内的文档状态对整个设计团队可见。
• 并行 PCB 设计无需任何复杂设置即可进行。
• 可通过 Web Viewer 与其他用户共享项目的只读、基于浏览器的交互式视图。
• 一系列高级版本控制功能，例如交互式 Project History view。

从技术角度看，Workspace 项目是存储在 Enterprise Server Workspace 上的元信息与 Workspace 自身 Version Control service 的紧密集成的组合。典型工作流如下：

1. 用户可通过 Altium Designer 的 Create Project 对话框 创建新的 Workspace 项目，也可通过 Make Available On Server 对话框将 现有本地项目转换为 Workspace 项目，或在 Workspace 浏览器界面中创建（详见下文）。在创建过程中，用户需要定义项目名称、描述以及设计仓库。
2. 项目访问权限可在 Workspace 的浏览器界面中定义与管理，也可直接在 Altium Designer 中管理。
3. 所有协作者选择打开该项目（可在 Altium Designer 内或在 Workspace 浏览器界面中操作），随后项目会自动以设计文件形式被检出。

本文将介绍如何通过 Enterprise Server Workspace 的浏览器界面来处理项目。关于在设计软件中处理项目的信息，请参阅 Working with Projects。

创建新的 Workspace 项目

创建 Workspace 项目主要有三种方式：

• 在 Workspace 的浏览器界面中创建新项目，或 在 Altium Designer 内创建。
• 在 Altium Designer 内将现有项目（本地项目，或当前处于外部版本控制下的本地项目）提供给 Workspace——即将本地项目转换为 Workspace 项目。更多信息请参阅 Making an Existing Project Available in the Workspace 页面。
• 通过 Workspace 浏览器界面 克隆现有 Workspace 项目，或在 Altium Designer 的 Projects panel 中通过 cloning a project 来克隆。

要通过 Workspace 的浏览器界面直接创建 Workspace 项目：

1. 登录界面并选择 Projects 菜单项以进入 Designs 页面。此前创建的任何项目都会在此列出。

2. 点击页面顶部的 按钮，然后选择 Create Project 菜单项以打开 Create Project  窗口。

   如果存在任何可用的活动 process definitions（适用于 Project Creations 流程主题——在 Workspace 浏览器界面的 Processes 页面的 Project Creations 选项卡中定义），则 按钮菜单将以这些流程替代 Create Project 选项作为可选项。选择所需条目以调用该流程工作流。

3. 该窗口初始会以简化视图呈现。输入所需的项目名称、描述（如需要），并从 Templates 下拉菜单中选择合适的 Project Template。

   项目名称应以并且可包含 A-Z、a-z 或 0-9。允许使用下划线、短横线和空格，但空格只能出现在名称中间（开头和结尾的空格会被忽略）。不能使用以下词语：AUX、COM1-COM9、LPT1-LPT9、CON、NUL 和 PRN。此外，名称不能包含以下字符：\ . / ? % * : | " < >。
4. 要访问更多控件，请点击 按钮。将显示以下字段：
   1. Parent Folder——用于指定在 Workspace 文件夹结构中创建项目文件夹的位置。默认将为 Projects\<ProjectName>。新项目的默认路径在 Workspace 的 Admin – Settings – Projects 页面中指定（位于其 browser interface）。

   2. Repository——该字段会列出通过 Workspace 本地版本控制服务管理、并已共享给你使用的所有设计仓库。选择用于存储新项目及其文件的仓库。默认会选择 Versioned Storage（基于 Git）的仓库。

      如果你从旧的服务器技术升级到 Enterprise Server，并且仍可使用内部（SVN）和/或外部（SVN/Git）设计仓库，则会显示 Repository 字段。该字段会列出通过 Workspace 本地版本控制服务管理、并已共享给你使用的所有设计仓库。选择用于存储新项目及其文件的仓库。如果选择基于 SVN 的仓库，则会显示 Repository Folder 字段。使用该字段指定仓库内用于容纳该项目及其相关文件的文件夹名称。默认将采用项目名称。

通过 Workspace 的浏览器界面直接定义新的 Workspace 项目。

按需定义新项目后，点击 ——新项目将被创建。你将返回到摘要级项目列表，此时会看到新创建项目的条目。

通过浏览器界面创建的另一个 Workspace 项目。

浏览 Workspace 项目

Workspace 浏览器界面中 Projects 页面的项目列表包含所有已与你共享的项目，并提供一系列控件以访问项目管理功能。使用  按钮将页面切换到项目预览（图形磁贴）模式，使用 按钮将页面切换到详细列表模式。

Workspace 浏览器界面的 Designs 页面——处理 Workspace 项目的指挥中心。此处展示的是页面的详细列表模式。将鼠标悬停在图片上可查看项目预览模式。

视图中的项目条目会按 Last modified 日期自动排序，最近修改的项目会最先显示在列表中。点击 按钮可改为按项目名称排序，再次点击可在升序与降序之间切换。

Projects 视图会在右侧边栏窗格中提供与所选项目相关的 Properties 和 Activities 数据。

边栏窗格信息包括： Properties 选项卡： Project——项目状态的高层摘要，包括电路板的 3D 视图（当项目包含 PCB 时）。 Shared With ——可访问该项目的用户和/或角色。将鼠标悬停在条目上可查看用户/角色的全名。 Parameters ——从项目设计本身提取或计算得到的详细元数据。点击 Show More 控件可展开完整列表。 Releases ——按时间顺序排列的项目发布列表。点击某个条目可在 Workspace 的 Manufacturing Portal 中打开该发布。 Activity 选项卡——按时间顺序列出的项目事件，例如提交（Commit）、发布（Release），或与该项目关联的已完成流程工作流。

对于每个项目，视图顶部的按钮也提供以下操作（并在后续链接章节中详细说明）：

• Share – 用于配置项目访问权限的访问控制。
• Activities – 通过菜单访问项目可用的流程活动。
• Functions – 通过菜单访问项目功能。在预览模式下选中某个项目时，也可通过该项目的 按钮访问：
  • Open – 在更详细、以 CAD 为中心的视图中打开项目。等同于在项目名称条目上单击（预览模式）或双击（列表模式）。
  • Move – 将项目重新定位到 Workspace 文件夹结构中的另一个父文件夹下。
  • Edit – 从其 Name、Description 以及 Workspace Parameters 等方面编辑项目。
  • Clone – 创建一个重命名的、与原项目完全相同的副本。
  • Watch/Unwatch – 通过在项目的 Activitiy 选项卡中接收相关通知（更新、发布等），以及在启用 Email Notifications 时通过电子邮件接收通知，来关注/取消关注项目活动。
  • Delete – 通过将其结构和数据移动到 Workspace Trash 来移除项目条目；在该处可将其从 Workspace 中永久删除，或恢复到之前状态。

此外还包含一个项目 Search 功能，可按名称、作者、描述等一系列属性过滤项目列表。在浏览器界面顶部的字段中输入搜索字符串的任意部分，列表将更新为仅包含属性中含有该搜索字符串的项目条目。

要清除搜索过滤，可单击左侧导航窗格中的主 Projects 页面条目，或清空搜索字段并按 Enter。

搜索功能的使用示例：此处根据项目的 Description 查找项目。

使用 Workspace 文件夹

Workspace 还提供在其结构中创建和管理项目文件夹的能力。随后可在生成的文件夹层级结构中的任意文件夹内创建项目，或将项目移动到其中。

要在（默认）顶层 Project 文件夹下创建新文件夹，请从 Create Folder 按钮菜单中选择 选项。在随后的 Create Folder 窗口中，指定新文件夹名称、其父文件夹以及可选描述。新文件夹始终创建在当前选中的文件夹下，该文件夹将成为其父文件夹。

通过选择已创建文件夹的标题打开该文件夹，并使用上方的面包屑导航返回上级层级。

使用 菜单选项可修改文件夹详细信息（Edit）、将文件夹移动到不同的父文件夹下（Move），或从 Workspace 的文件夹结构中移除该文件夹（Delete）。移动文件夹时，在 Move folder <folder> to 窗口中从层级树选择新的父文件夹。

上传项目

在 Altium Designer 中，Make Available on Server 命令会将本地项目上传到 Workspace，使其成为受版本控制的 Workspace 项目。在 Workspace 浏览器界面中，也可通过 Upload Project 按钮菜单中的 选项执行等效流程。浏览并选择本地项目的宿主文件夹，即可默认将该项目上传到当前选中的 Workspace 文件夹；或者使用 Change 选项，在 Upload Project 窗口的 Parent Folder 列表中选择文件夹层级结构中的其他位置。

本地项目中任何现有的版本控制链接都会被忽略；上传后的项目将成为完全受版本控制的 Workspace 项目 – 本地源项目不会以任何方式被更改。

移动项目

要将项目重新定位到不同的 Workspace 文件夹，请从 Move 菜单下拉选项中选择 ，并在 Move project <project> to 窗口中从文件夹层级结构选择新位置。使用 按钮确认后，所选项目将托管在新指定的父文件夹下。

共享 Workspace 项目

当项目位于 Workspace 中后，你需要确定哪些用户实际上可以访问该项目。这通过共享项目来完成，更准确地说，是通过配置其访问权限来完成。默认情况下，Workspace 项目会与以下对象共享：

• 项目的 Owner，通常是创建该项目（或将其发布到 Workspace）的设计人员：完全（读/写）访问权限。
• Administrators 角色组：完全（读/写）访问权限。
• Workspace 的所有成员：仅查看权限。

可在 Workspace 浏览器界面的 Admin – Settings – Projects 页面中定义/更改新项目的默认权限。请注意，项目 Owner 天生就被赋予访问权限，因此不会出现在列表中。

可通过 Workspace 的浏览器界面配置访问权限，也可直接在 Altium Designer 内进行配置。

要在 Workspace 浏览器界面中配置项目访问权限，请在 Designs  页面（主菜单中的 Projects）选择项目条目，然后单击 按钮打开 Share:<project> 窗口；或使用与项目条目关联的 Share 菜单中的 选项。这里提供了将项目共享给其他用户或用户组（角色）所需的全部控制项。

当项目在 Workspace 中集中管理后，与他人共享就只是管理各项目权限的问题。

在 Share <project> 窗口中：

• 当启用 Can Edit 选项时，用户/角色拥有读/写权限；若禁用该选项，则仅有读取权限。
• 可在 Shared With 区域中，通过 Workspace Members 条目的下拉菜单，将项目共享给 Workspace 的所有成员，并设置为只读（Can View）或读/写（Can Edit）访问。
• 要移除某个现有用户/角色对项目的共享访问权限，请在其关联的下拉菜单中单击 Remove 选项。

需要注意的事项：

• 默认情况下，所有 Workspace 用户都能看到该项目。如果你希望将访问权限锁定为特定的一组用户和/或用户组，必须先在 Workspace Members 条目的下拉菜单中选择 No access 。
• 项目 Owner 永久拥有读/写权限。
• 你也可以共享指向该项目的直接链接。该链接可通过在 Sharing 窗口底部单击 Copy Link 控件获取。链接会被复制到剪贴板。使用该链接时，会在权限允许的情况下，为相应用户提供对项目详细管理页面的访问；该页面概览将在下一节中介绍。

Sharing a Project with a Workspace User

要将项目共享给另一个 Workspace 用户：

1. 在 Share 窗口中，在 Share Project With 字段中开始输入某个 Workspace 用户（成员）的全名、用户名或电子邮件地址，以激活匹配用户列表。从列表中选择所需用户。可选择多个用户。要移除已选用户，请单击其姓名右侧的删除叉号。

   

2. 使用关联的下拉菜单为用户设置权限，在 Can View 权限（只读）与 Can Edit 权限（读/写）之间选择。请注意，Workspace Members Can View/Edit 选项是全局的，可能会覆盖已应用到特定用户的共享权限。在大多数情况下，建议将该选项设置为 No access。

   

3. 单击 按钮确认添加用户并返回 Projects 视图。下次打开 Share 窗口时，可通过展开 Shared With 网格列表看到已添加的用户。使用与用户条目关联的 Can Edit/View 菜单可更改权限或移除该用户条目本身。单击 保存任何更改。

   

   请注意，Properties 窗格会显示对当前所选项目应用的共享摘要。

   

Sharing a Project with a Defined Role Group

你也可以将项目共享给 Workspace 中定义的角色组（参见 Admin – Roles）。角色权限将应用于该角色组的所有成员用户。要将项目共享给另一个组：

1. 在 Share 窗口中，在 Share Project With 字段中开始输入某个 Workspace 角色（用户组）的名称，以激活匹配角色列表。从列表中选择所需角色。可选择多个角色。要移除已选角色，请单击其名称右侧的删除叉号。

   

2. 使用关联的下拉菜单为角色设置权限，在 Can View 权限（只读）与 Can Edit 权限（读/写）之间选择。请注意，Workspace Members Can View/Edit 选项是全局的，可能会覆盖已应用到特定用户的共享权限。在大多数情况下，建议将该选项设置为 No access。

   

3. 单击 按钮以确认添加角色并返回 Projects 视图。下次打开 Share 窗口时，可通过展开 Shared With 网格列表查看已添加的角色。使用与某个用户条目关联的 Can Edit/View 菜单来更改权限或移除该角色条目本身。单击 保存任何更改。

   

   请注意，Properties 窗格会显示当前所选项目已应用共享设置的摘要。

   

Advanced Share Settings

单击 Share 窗口右上角的 Advanced Settings 控件，以打开用于设置高级共享选项的窗口。对于具有编辑权限的人员，你可以控制其是否可以与他人共享，从而限制进一步共享。对于仅查看权限的人员，你可以控制其是否也能下载原生数据（项目本身）以及派生数据（例如生成的 Gerber 或 PDF）。他们仍可像之前一样在浏览器界面中查看数据并发表评论。

如果某个仅查看权限的人员不被允许下载，则其只能通过浏览器界面查看项目。由于通过 Altium Designer 查看项目需要先下载项目，因此在这种情况下他们无法通过 Altium Designer 查看项目。

Workspace 项目活动

Workspace 提供了一项独特能力：可对 Workspace 项目应用可配置的 Process Workflows，以执行定制化任务，例如进行设计评审和创建新项目。流程及其底层工作流由 Workspace 管理员创建并配置，启用后，将同时对 Altium Designer 和 Workspace 浏览器界面的用户可用。

► 有关更多信息，请参阅 Creating & Managing Processes。
► 有关这些流程在 Altium Designer 中的使用信息，请参阅 Performing Design Reviews。

从用户角度看，Process Workflows 及其内在步骤被视为 Activities。用户可以调用可用的活动，并由被分配的用户按任务序列完成其工作流步骤——这些任务可通过 Tasks 页面访问。

在 Designs 页面（Projects）上选择 菜单，并从可用流程中选择一个，以为当前所选项目发起一项活动。在随后出现的流程表单窗口中填写所需字段与选项，然后启动流程（）。根据所调用的 Process Workflow，可能需要提交后续步骤（）以准备评审数据。

随后会为分配到该活动的一个或多个用户创建工作流任务。适用于当前登录用户的任务会显示在其 Tasks 页面中，用户可在此对其进行处理，以将工作流推进到下一阶段。

请注意，当某个活动被分配给一个角色组——例如 Engineers——相关任务将对该组的所有成员可用，同时也对被单独分配到该活动的任何用户可用——此处为用户 Bruce （Engineers 角色的成员）。在这种情况下，这些用户中的任何一个都可以完成评审步骤并提交结果（）。

Workspace 项目功能

与项目相关的功能操作可从 Designs 页面上的 菜单中获取，包括打开、移动、编辑、克隆、关注以及移除 Workspace 项目。该菜单也可从所选项目条目的 按钮访问：

打开项目

从项目条目的 菜单或上方的 菜单中选择 Open 选项，以在面向制造、以 CAD 为中心的视图中打开项目——或者在预览模式（）下，单击项目名称。该视图可通过导航窗格访问多个子视图：

• Design – 浏览并与项目的设计文档交互、检查对象属性并添加评审评论。该视图适用于当前（最新）项目修订版，并使用 Web Viewer 界面。
• Supply – 交互式查看从设计文档中提取的进行中（WIP）BOM 数据，包括来自项目已填充的 ActiveBOM 文档的制造商与供应商器件数据条目。
• Releases – 查看当前项目所有 Release 的摘要信息，每个 Release 都可在 Manufacturing Portal view 中打开。该视图进一步提供所选 Release 中发布包文件、设计文档与供应数据的子视图。
• Activities – 查看适用于当前项目的活动或已关闭的 Process workflow Activities。
• History – 浏览与项目相关的主要事件的时间线，包括创建、提交、发布与克隆。每当与项目相关的受支持事件发生时，该事件都会作为一个专用磁贴添加到时间线中，并在适用时提供多种操作。

► 有关更多信息，请参阅 Management of a Specific Project。

编辑项目

要编辑 Workspace 中现有项目的属性，请在 Designs 页面（Projects）上选择其条目，然后从其 菜单或上方的 菜单中选择 Edit 选项。在随后出现的 Project Editing 窗口中，你可以更改项目的 Name、Description，并管理 Workspace Parameters 条目。

在 Project Editing 窗口中单击 按钮，以显示从项目派生并与项目一同存储的附加属性数据。选择 Parameters 控件以访问并添加（）、编辑或移除（）参数 Name/Value 键值对。这些参数会与项目一起保存在 Workspace 中，并可在 Altium Designer 中作为 Special Strings 使用——在设计空间中选中已放置的文本对象后，可从 Properties 面板访问。相比之下，Project type 参数保存在项目文件（*.PrjPcb）中，并可在 Altium Designer 中编辑。

克隆项目

要克隆（复制）现有 Workspace 项目，请在 Designs 页面（Projects）上选择其条目，然后从其 菜单或上方的 菜单中选择 Clone 选项。使用 Clone Project 窗口为克隆项目设置名称与描述——默认情况下，将使用原项目名称并附加 - Copy 后缀。

单击 按钮以显示附加属性字段，其中包括目标父文件夹与 Repository 信息。目标文件夹设置会自动与项目名称一致，除非手动指定，或通过 Change 选项分配到不同的现有父文件夹。

按需设置字段后，单击 按钮确认。原项目将连同其组成文件与数据一起被克隆（复制），并作为新的项目条目添加到 Projects 页面列表中。

关注项目

要在 Workspace 中“关注”（接收通知）某个项目，请在 Designs 页面（Projects）上选择其条目，然后从其 菜单或上方的 菜单中选择 Watch 选项。

当你关注（watch）一个项目时，你将在界面右侧窗格的 Activities 选项卡下收到与该项目相关的通知（例如提交、发布和属性更改消息）。项目创建者将自动被设置为关注该项目。启用后，该命令将变为 Unwatch——选择它可停止关注该项目，并停止接收与该项目相关事件的通知。

删除 Workspace 项目

要删除（移除）现有 Workspace 项目，请在 Designs 页面（Projects）上选择其条目，然后从其 菜单或上方的 菜单中选择 Delete 选项。该操作本质上是“软删除”，即将项目仓库移动到 Workspace 的 Trash area 中。在 Altium Designer 中，可通过 Explorer panel 里的  菜单 Delete 选项删除项目。

在该视图中（从主菜单选择 Trash），可以将项目条目彻底移除（Permanently Delete），或撤销该操作（Restore）。请注意， 按钮会移除工作区回收站中存储的所有条目（在可能的情况下）。