工作区项目

您正在阅读的是 7.2. 版本。关于最新版本,请前往 工作区项目 阅读 8.0 版本

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

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

  • 存储简化。无需再决定存储位置。备份及其他基础服务都已处理妥当。

  • 协作功能的基础。

  • 强制版本控制。

  • 专用评论系统的优势。

  • 通知与状态。包括本地修改在内的文档状态对整个设计团队可见。

  • 并行 PCB 设计无需任何复杂设置即可工作。

  • 可通过 Web Viewer 与其他用户共享项目的只读、基于浏览器的交互式视图。

  • 一系列高级版本控制功能,例如交互式 Project History view

从技术角度看,Workspace 项目由存储在 Enterprise Server Workspace 上的元信息与与 Workspace 自有版本控制服务的紧密集成共同构成。典型工作流程如下:

  1. 用户可通过 Altium Designer 的 Create Project 对话框 创建新的 Workspace 项目,也可通过 Make Available On Server 对话框将 现有本地项目转换为 Workspace 项目,或在 Workspace 浏览器界面中创建(详见下文)。创建过程中,用户需要定义项目名称和描述。

  2. 项目访问权限可在 Workspace 的浏览器界面中定义和管理,也可直接在 Altium Designer 中管理。

  3. 所有协作者选择打开该项目(可在 Altium Designer 内或在 Workspace 浏览器界面中操作),随后项目会自动以设计文件形式被检出。

Workspace 项目的一个主要优势是默认启用版本控制,并且可在无需担心共享驱动器、服务器、约定等问题的情况下进行协同工作。

本文档将介绍如何通过 Enterprise Server Workspace 的浏览器界面使用项目。有关在设计软件中使用项目的信息,请参阅 Getting Familiar with the Altium Design Environment

创建新的 Workspace 项目

创建 Workspace 项目有多种方式:

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

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

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

    如果针对“Project Creations”流程主题存在任何可用的活动 process definitions(在 Workspace 浏览器界面的 Processes 页面 Project Creations 选项卡中定义),则 按钮菜单将以这些流程作为选项来替代 Create Project 选项。选择所需条目以调用该流程工作流。
  3. 该窗口初始将以简化视图显示。输入所需的项目名称、描述(如需要),并从 Templates 下拉菜单中选择合适的 Project Template

    项目名称应以 A-Z、a-z 或 0-9 开头,并且可包含 A-Z、a-z 或 0-9。允许使用下划线、短横线和空格,但空格只能出现在名称中间(开头和结尾的空格将被忽略)。不能使用以下词语:AUXCOM1-COM9LPT1-LPT9CONNULPRN。此外,名称不能包含以下字符:\ . / ? % * : | " < >
  4. 点击 单击并拖动以移动 按钮以访问 Parent Folder 字段。使用该字段指定项目在 Workspace 文件夹结构中的创建位置。这将是当前打开的文件夹,或(默认情况下)为 Projects。请注意,新项目的默认文件夹路径在 Workspace 浏览器界面的 Admin – Settings – Projects 页面中指定(Workspace's browser interface)。在 Create Project 窗口中,点击该字段右侧的 Change  链接以访问 Workspace 的文件夹结构,从中选择用于存储项目的其他文件夹。

    如果默认文件夹(例如 Projects)不可访问,Workspace 将创建一个 Personal Folder 层级结构来存储你的项目。它会显示为一个以你的用户名命名的私有顶层文件夹,并包含一个用于存储已创建或已上传项目的 My Projects 子文件夹。新创建的项目将存储在 My Projects 文件夹中;或者如果当前打开了另一个可访问的文件夹,则新项目将存储在该文件夹中。

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

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

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

该项目最初将以读/写权限共享给创建它的设计人员以及 Administrators 组中的所有成员。该项目也会共享给所有 Workspace 用户,但权限为只读。有关配置项目访问权限的更多信息,请参阅 Sharing a Workspace Project

浏览 Workspace 项目

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

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

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

列表模式视图()可通过各列的列标题按 NameAuthorDate 排序。点击一次按升序排序,再点击一次按降序排序。列名右侧的箭头将指示当前启用的排序方向。

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

 

边栏窗格信息包括:

  • Propertiestab:
    • Project – 项目状态的高层级概览,包括其预览(电路板的 3D 视图、多板原理图文档图像或线束布线文档图像)。
    • Child Projects (仅适用于Multi-board projects )– Multi-board 项目中所包含并链接的子项目 PCB 列表 – show image。单击某个子项目链接,即可像平常一样在 Web Viewer 中打开该 PCB 项目。
    • Shared With – 有权访问该项目的用户和/或组。将鼠标悬停在某个条目上可查看该用户/组的全名。
    • Reports – 为当前所选项目生成的电气与设计规则检查(ERC 和 DRC),包括每份报告中的错误/违规数量。选择某个 ERC 或 DRC 条目即可在项目内访问并检查报告详情。有关 DRC 和 ERC 报告的更多信息,请参阅 Web Viewer 页面。
    • Parameters – 从项目设计本身提取或计算得到的详细元数据。单击 Show More 控件以展开完整列表。
    • Where Used – 其他项目的列表(例如 Multi-board projects),这些项目会引用/包含本项目内容。单击某个条目将在新的浏览器标签页中打开并查看该项目。
    • Releases – 按时间顺序排列的项目发布列表。单击某个条目即可在工作区的 Manufacturing Portal 中打开该发布。
  • Activity tab – 按时间顺序列出的项目事件,例如 Commit、Release,或与该项目相关的已完成流程工作流。

对于每个项目,视图顶部的按钮还提供以下操作(并在后续链接章节中详细说明):

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

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

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

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

使用工作区文件夹

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

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

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

使用 菜单选项可修改文件夹详情(Edit)、将文件夹移动到不同的父文件夹下(Move),或从工作区文件夹结构中移除该文件夹(Delete)。移动文件夹时,请在 Move folder <folder> to 窗口的层级树中选择新的父文件夹。

上传项目

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

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

上传 Gerber 或 ODB++ 文件集

工作区也接受以归档格式打包的已生成 Gerber/ODB++ 制造文件集合,可通过 按钮菜单中的 Upload GerberUpload ODB++ 选项上传。上传流程与上述项目上传流程基本相同。

Javascript ID: AES_GerberODBupload_7_0.png

选择 New – Upload Gerber 选项,在 Windows 文件浏览器中定位并选择已归档的 Gerber 文件集。

Upload Gerber 窗口中,如有需要可编辑建议的项目 Name(取自 Gerber 归档名称),并添加 Description。你可以使用 Change 选项指定不同于默认项目存储文件夹的项目存储位置。

上传的文件集将被处理并添加到工作区项目集合中:初始显示为 Gerber 图标,刷新或查看后会生成预览图像。

选择 New – Upload ODB++ 选项,在 Windows 文件浏览器中定位并选择已归档的 ODB++。

Upload ODB++ 窗口中,如有需要可编辑建议的项目 Name(取自 ODB++ 归档名称),并添加 Description。你可以使用 Change 选项指定不同于默认项目存储文件夹的项目存储位置。

上传的文件集将被处理并添加到工作区项目集合中:初始显示为 ODB++ 图标,刷新或查看后会生成预览图像。

单击 Gerber/ODB++ 项目名称,或使用相关菜单中的 Open 选项,在工作区的专用查看器中加载该文件集。该查看器提供所有包含文件/层的合成视图,允许隐藏图层或仅查看某一图层,提供点到点测量功能,并支持放置 comments

移动项目

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

 

共享工作区项目

项目进入工作区后,你需要确定哪些用户实际上可以访问该项目。这通过共享项目来完成,更准确地说,是通过配置其访问权限来实现。

默认情况下,工作区项目 会与以下对象共享:

  • 项目的 Owner(通常是创建该项目的设计者,或将其提供到工作区的人):完整(读/写)访问权限。
  • Administrators 组:完整(读/写)访问权限。
  • 工作区的所有成员:仅查看权限。

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

访问权限的配置既可通过工作区的浏览器界面完成,也可 directly from within Altium Designer

要通过工作区浏览器界面配置项目访问权限,请在 Designs page(主菜单中的 Projects)上选择项目条目,然后单击  按钮打开 Share:<project> 窗口——或使用与项目条目关联的 菜单中的 Share 选项。这里提供了将项目共享给其他用户或组所需的全部控件。

在工作区中集中管理项目后,与他人共享就只是管理各项目权限的问题。在工作区中集中管理项目后,与他人共享就只是管理各项目权限的问题。

Share <project> 窗口中:

  • 当启用 Can Edit 选项时,用户/组将拥有读/写访问权限。如果禁用该选项,则仅拥有读取权限。
  • 可在 Shared With 区域中,通过 Workspace Members 条目的下拉菜单,将项目共享给 Workspace 的所有成员,并设置为只读(Can View)或读/写(Can Edit)访问权限。
  • 要移除现有用户/组对项目的共享访问权限,请在相应的下拉菜单中单击 Remove 选项。

需要注意的事项:

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

Workspace 项目活动

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

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

从用户角度看,Process Workflows 及其内在步骤被视为 Activities。用户可以发起可用活动,并由被分配的用户按任务序列完成其工作流步骤——这些任务可在 Tasks page 中获取。

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

随后会为被分配到该活动的用户(或多个用户)创建工作流任务。适用于已登录用户的任务将显示在 Tasks page 中,用户可在其中执行操作以将工作流推进到下一阶段。

请注意,如果某项活动被分配给一个组——例如 Engineers——则相关任务将对该组的所有成员可用,同时也对任何被分配到该活动的个人用户可用。在这种情况下,这些用户中的任何一位都可以完成评审步骤并提交结果()。

在活动准备期间除了可以为其分配用户和组之外,还可以在流程工作流(Process Workflow)配置本身中添加特定分配,从而使活动在准备之前就天然地分配给特定用户/组。例如,可以在 AdHoc_Review 工作流中将 Engineers 组预设为分配对象。

► 更多信息请参阅 定义流程工作流

Workspace 项目功能

与项目相关的功能操作可从 Designs 页面上的 菜单中使用,包括打开、移动、编辑、克隆、关注和移除 Workspace 项目。该菜单也可从所选项目条目的 按钮打开:

打开项目

从项目条目的 菜单或顶部 菜单中选择 Open 选项,可将项目打开到面向制造、以 CAD 为中心的视图中;或者在预览模式()下,点击项目名称。该视图可通过导航窗格访问多个子视图:

  • Design – 浏览并与项目的设计文档交互、检查对象属性并添加评审评论。该视图适用于当前(最新)项目修订版,并使用 Web Viewer 界面。
  • Simulation – 将仿真结果文件上传到当前项目,随后所有有权访问该项目的用户都可查看或下载这些文件。
  • Tasks – 查看并与流程式界面交互,该界面呈现适用于当前项目的所有 Tasks(活动作业)。
  • Releases – 查看当前项目所有发布(Release)的摘要信息,每个发布都可在 Manufacturing Portal 视图中打开;该视图进一步提供子视图,用于查看所选发布中的发布包文件、设计文档和供应数据。
  • Activities – 查看适用于当前项目的活动或已关闭的 流程工作流活动
  • History – 浏览与项目相关的主要事件的渐进式时间线,包括创建、提交、发布和克隆。每当发生与项目相关的受支持事件,该事件都会作为一个专用磁贴添加到时间线中,并在适用时提供多种操作(例如设计数据对比)。
  • Assembly Assistant – 提供对可视化板级装配工具的访问,该工具基于 BOM 条目与其图形对应项之间的交互。可调用经审计的逐步引导流程,帮助你按步骤完成 PCB 板的实体装配。在单一位置提供可追踪的装配进度视图,从而避免复杂的手工或纸质板级装配核对流程。
在 Altium Designer 中,通过在 Projects 面板 里右键单击某个项目条目并选择 Show in Web Browser 命令,可打开 Workspace 以 CAD 为中心的项目视图。

► 更多信息请参阅 特定项目的管理

编辑项目

要编辑 Workspace 中现有项目的属性,请在 Designs 页面(Projects)上选择该项目条目,然后从其 菜单或顶部 菜单中选择 Edit 选项。在随后出现的 Project Editing 窗口中,你可以更改项目的 NameDescription,并管理 Workspace Parameters 条目。

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

克隆项目

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

点击 按钮可显示目标父文件夹信息。目标文件夹设置会自动与项目名称一致,除非手动指定,或通过 Change 选项分配到其他现有父文件夹。

 如果针对“项目创建(Project Creations)”流程主题存在任何可用的活动 流程定义(在 Workspace 浏览器界面的 Processes 页面之 Project Creations 选项卡中定义),则 菜单将提供与可用流程工作流相对应的 Clone – process name 选项。

选择后,将使用该流程所定义的工作流来执行克隆过程。

也可以在 Altium Designer 中通过 Explorer 面板 菜单中的 Clone 选项来克隆项目,或在 Projects 面板 中右键单击项目名称,并从上下文菜单中选择 Clone 选项。

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

关注项目

要在 Workspace 中“关注(watch)”——即接收与项目相关的通知——请选择 Designs 页面(Projects)上的项目条目,然后从其 菜单或顶部 菜单中选择 Watch 选项。

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

如果已配置并启用 Workspace Email NotificationsAdmin – Settings – Email Notifications),通知也会发送到你的电子邮箱。

► 更多信息请参阅 配置电子邮件通知

删除 Workspace 项目

要删除(移除)现有 Workspace 项目,请在 Designs 页面(Projects)上选择该项目条目,然后从其 菜单或顶部 菜单中选择 Delete 选项。该操作本质上是“软删除”,即将项目仓库移动到 Workspace 的 Trash 区域。也可以在 Altium Designer 中通过 Explorer 面板 菜单 Delete 选项删除项目。

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

  • Delete 选项仅对对所选项目具有写入权限的用户可用。
  • 此操作会使项目在 Workspace 中不再存在。它只会从 Workspace 中移除——不会影响你的本地工作副本。
AI-LocalizedAI 翻译
如您发现任何问题,请选中相关文本/图片,并按 Ctrl + Enter 键向我们提交反馈。
Content