发布到工作区

在 Online Mode 中使用 Release 视图时，发布流程是一个分阶段的流程；该视图左侧的条目会让你一目了然地看到当前处于哪个阶段：

1. Configure Server Release – 发布流程的此阶段用于指定你希望生成的数据类型：源数据（始终生成）、制造数据、装配数据（针对基础设计以及每个检测到的变体）。

2. Validate Project – 发布流程的下一阶段会在已分配的 OutJob 文件中检测到一个或多个“验证（Validation）”类型报告时自动运行。将运行分配给待发布数据项的 Output Job 文件中定义的所有验证输出生成器。

3. Generate Data – 发布流程的下一阶段会自动运行。在此阶段，将运行分配给所包含数据项的 OutJob 文件中定义的所有其他输出，以生成要发布到 Workspace 中相关目标项的数据。

4. Review Data – 当所有验证检查通过且输出数据已生成后，发布流程的此阶段允许你审查生成的数据。

   如果你选择使用 Prepare & Release 或 Prepare & Release & Publish to PLM 命令（来自与 按钮关联的菜单），则 Project Releaser 不会在 Review Data 阶段暂停。

5. Upload Data – 在上一阶段确认发布后，会自动进入下一阶段。该阶段仅显示数据上传到目标 Workspace 中相关数据项修订版的进度。

6. Execution Report – 这是流程的最后阶段，提供发布摘要。提供导航链接，可快速浏览 Explorer panel 中生成的 Item Revision。若你是作为“发布并发布到 PLM”流程的一部分访问 Project Releaser，则会显示 按钮。单击该按钮以继续该流程的底层工作流，将内容发布到 PLM。

   如果你选择使用 Prepare & Release & Publish to PLM 命令（来自与 按钮关联的菜单），则 Project Releaser 不会在 Execution Report 阶段暂停，并且不会显示 按钮。

7. Publish to PLM – 仅当在相关已激活流程下运行发布（用于先发布再发布到 PLM）时，才会出现此阶段。当在上一阶段单击 按钮时会自动进入该阶段（或者如果使用了 Prepare & Release & Publish to PLM 命令（来自与 按钮关联的菜单）则会直接进入）。将出现 Login Credentials 对话框。输入你的 PLM 实例的 Username 和 Password，并选择要使用的 PLM 模板（以 <PLMInstance>:<PublishingTemplate> 的形式显示）。

   请注意，你的 PLM 实例登录凭据仅在首次向该实例发布时需要。之后这些凭据将与 Workspace 一起存储。此后，将该项目发布到同一 PLM 实例时，会按照已定义的工作流和所选发布模板直接进行。
   如果你是首次发布，并且（在 PLM 端）尚未将零件号与 Workspace 项目关联，则这些零件号会在 PLM 中创建，并在首次发布过程中与项目关联。你还可以在发布操作中为 Workspace 组件在 PLM 实例中定义组件条目——以便在 PLM 中获得组件 BOM（可选，取决于发布到 PLM 实例时所定义并使用的发布模板）。

在线阶段 1 – 配置服务器发布

发布流程的此阶段用于指定你希望生成的数据类型。可发布的数据项包括：

• Source Data – 源设计的快照。
• Fabrication Data – 制造厂（Fabrication House）用于制作裸板所需的数据。
• Assembly Data for the Base Design (no variations) – 装配厂（Assembly House）依据物料清单（BOM）对裸板进行完整贴装所需的数据，适用于未变体的基础设计。
• Assembly Data for Design Variant n – 装配厂依据物料清单（BOM）对裸板进行贴装所需的数据，适用于基础设计的 Variant n。

装配数据集的数量将对应于基础（无变体）设计，以及为该设计定义的所有检测到的变体。

此外，你还可以添加并配置 Custom Data 分区——从而创建一组自定义的发布数据。这更多用于向后兼容或自定义数据流。除源数据外，不会创建任何引用。可在发布过程中添加并配置任意数量的自定义数据集（单击当前已定义数据项列表下方的 Add Section 控件）。

项目发布流程的阶段 1——配置要包含在发布中的内容（要生成哪些数据）。

Source Data 项始终会包含在发布中。其他数据项可选择性包含。

Assignment of Output Jobs

要在发布中包含 Fabrication Data 和 Assembly Data 项，至少需要为它们分配一个 OutputJob 文件。如果你的 Output Job 文件名称以子字符串“fab”和“ass”开头，那么在首次访问 Release 视图时，这些 OutJob 将分别自动分配给 Fabrication Data 和 Assembly Data 分区。否则，你需要在每种情况下手动分配适用的 OutJob。可在 Project Release Options 对话框的 Release Options 选项卡中完成（单击视图左下角的 按钮进入）。

按需将 OutJob 分配给相应的数据集。

对话框底部的 Include Design subfolder into the item content (for legacy compatibility, not recommended) 按钮仅应在遗留兼容性场景下使用。请谨慎使用！

Switching Release Target

Project Release Options 对话框的 Release Options 选项卡也可用于更改发布目标——在受管（Online）与非受管（Offline）操作模式之间切换。提供三个选项：

• Unmanaged - Folder（Offline）：设置此选项可将生成的数据发布到本地文件夹。根文件夹路径在对话框的 Output Path 选项卡中指定。默认设置为 [OutputPath]（使用 Options tab of the Project Options dialog 中 Output Path 字段定义的路径）。
• Unmanaged - Zip（Offline）：设置此选项可将生成的数据发布到本地文件夹。数据将被打包为单个 Zip 文件。Zip 路径/名称在对话框的 Output Path 选项卡中指定。默认设置为 [OutputPath][ProjectName].zip（使用 Project Options 对话框的 Options 选项卡中 Output Path 字段定义的路径 ）。
• Managed - <WorkspaceName>（Online）：设置此选项可发布到你当前已连接的 Workspace（带 WorkspaceName）。

切换发布目标——即生成的数据要发送到哪里——作为该项目发布选项的一部分。

目前不支持将线束设计项目发布到已连接的 Enterprise Server Workspace。因此，当连接到 Enterprise Server Workspace 时，此项目类型在 Project Release Options 对话框中不会提供 Managed - <WorkspaceName> 选项。

Setting Workspace Item Naming Schemes

首次将项目发布到目标 Workspace 时，你可以定义该 Workspace 中目标数据项（其修订版将接收生成的数据）的命名方式。这可在 Project Release Options 对话框的 Item Naming 选项卡中完成；该对话框可通过单击视图左下角的 按钮进入（或单击要发布的数据集的 Target Revision 链接，并从上下文菜单中选择 Edit）。使用此选项卡可：

• 定义项目名称。默认会填入项目的实际名称。
• 为发布过程中可生成的各类数据项定义默认命名方案。在 Item ID 列的某个字段内单击，然后单击字段右侧的 按钮以打开 Choose Item 对话框（Explorer panel 的一种形式），该对话框允许你定位到当前连接的 Workspace 中的现有 Item。

Project 项并不是用于接收发布数据而创建的项，而是一个实体，用作锚点：在 Explorer panel 中查看项目时，用于呈现已发布数据项的整体项目视图，以及它们之间的连接关系。更多信息请参见 Viewing the Released Project 章节。

要更改任何命名方案，请单击 Settings 按钮以打开 Naming Template Settings 对话框。

设置项目名称并定义目标 Workspace 中生成数据项的命名。在此处字段可编辑，因为项目尚未发布。

命名模板支持以下宏格式：

• Parameter-based – 支持使用方括号括起的参数（例如 [ProjectName]、[VariantName]、[ProjectParameter]）。
• Numeric-based – 支持使用花括号括起的数字量词（例如 {0000}、{9000}）。

从 Project Release Options 对话框的 Item Naming 选项卡中，您可以直接单击某个命名方案条目，并按需更改命名。或者，单击该字段右侧的按钮以打开 Choose Item 对话框（Explorer 面板的一种形式），它允许您在当前已连接的 Workspace 中指定一个现有的 Item 作为目标。

Item 的命名可在 Release 视图的第一阶段期间随时更改，即在配置要发布到当前已连接 Workspace 的数据时。在单击 之后，相关命名将无法再更改，因为发布中包含的每个已启用数据集都会按该命名创建对应的计划 Item——并且这些 Item 会与项目关联。因此，即使您不继续将数据发布到这些 Item 中，它们仍会以就绪状态存在，相应的命名模板条目也会变为灰色。您可以删除这些计划 Item，或使用 Browse 命令（单击某个 Target Revision 条目以访问菜单），并在每种情况下创建一个具有所需命名的新目标 Item。

在按需配置好将作为发布一部分而创建的数据项后，单击视图右下角的 按钮以继续。

按钮有两种状态。单击它将启动标准 Prepare 命令。这会将发布推进到 Review Data 阶段——使您在提交数据发布之前，基本可以再次确认一切无误。如果您不想暂停进行复核，请使用该按钮的下拉菜单并选择 Prepare & Release 命令。

准备过程中会执行若干发布前检查，包括：

• 确保项目及所有文件均已保存。
• 确保项目及所有相关文件（如适用）已提交到 VCS。
• 确保每个已启用的数据项都已命名。
• 确保用户具有创建目标 Item（及修订版）的权限。
• 在 Workspace 中创建所需的目标 Item（及计划修订版）（若当前不存在），并确保对已存在的 Item 使用下一个修订版。

如果发现任何问题，系统会提供解决方案以便您处理（例如保存本地修改的文件并提交到 VCS）。

Source Data Item 会在此时生成——源设计项目文件的快照将发布到目标 Item 修订版。

在线阶段 2 – 验证项目

当阶段 1 无问题完成后，如果在已分配的 OutJob 文件中检测到一个或多个验证类型报告，则会自动运行发布流程的下一阶段。将运行所有已定义的验证输出生成器（这些生成器定义在分配给正在发布的数据项的 Output Job 文件中）。这包括运行以下任意项：

• Differences Report – 使用比较器判断源文档与 PCB 设计文档是否正确同步。
• Electrical Rules Check – 检查所捕获源设计的电气/制图有效性。
• Design Rules Check – 根据指定的板级设计约束检查 PCB 文档的有效性。
• BOM Checks – 检查源 BOM 文档（*.BomDoc）中与 Design Items 或 Part Choices 相关的潜在违规（如可用）。
• Footprint Comparison Report – 将板上封装与其源库进行比较，确保其为最新且匹配。
• Component State Checking – 检查处于受限状态的元件。作为配置的一部分，您需要为目标 Workspace 中每个当前定义的 Lifecycle Definition 的每个当前定义状态确定要采取的动作：不处理、警告或生成错误。后者将阻止设计发布。此外，运行该检查会生成一个便捷的基于 HTML 的报告，使您可以一目了然地看到哪些设计元件不处于有效状态。
• Environment Configuration Compliance Check – 检查是否仅使用了通过环境配置允许、且可供您所分配角色使用的数据项（如适用）。该检查还可确保所有设计项均来源于 Workspace。

如果验证成功，将显示 图标，并显示文本 Passed。如果失败，将显示 图标，并显示文本 Failed。

单击视图右下角的 将停止发布流程。

在线阶段 3 – 生成数据

当阶段 2 无问题完成后，会自动运行发布流程的下一阶段。在此阶段，将运行分配给所包含 Data Items 的 OutJob 文件中定义的所有其他输出，以生成要发布到 Workspace 中相关目标 Item 的数据。

与其他阶段一样（但在此阶段更明显，因为运行时间更长），会使用图标来显示生成进度：

– 尚未运行/生成。

– 正在运行/生成。

– 生成成功。

– 生成失败。

单击视图右下角的 将停止发布流程。

在线阶段 4 – 复核数据

在所有验证检查均已通过并生成输出数据后，发布流程的此阶段允许您查看已生成的数据。

在提交发布并将数据上传到 Workspace 之前，请先检查生成的数据，确认一切符合预期。

页面默认以简单（紧凑）视图显示生成的数据。单击与感兴趣部分关联的 Details 控件可切换到更详细的视图。

单击某个 Details 控件，可将对应部分的生成数据从简单视图切换为详细视图。再次单击 Hide Details 控件可切换回去。

在生成数据的紧凑视图中，单击某个 View 链接可打开关联的数据文件或文件集：可在 Altium Designer 中相应的编辑器内打开（例如 Gerber 文件或压缩/未压缩 ODB++ 文件使用 CAM 编辑器），或在相应的外部应用程序中打开（例如使用 Microsoft Excel 打开物料清单）。在详细视图中，双击某条目可仅查看该文件。

许多设计人员常用的一个“可发布”测试，是将当前发布生成的 Gerber 文件与上一次发布的 Gerber 文件进行比较。单击某个 Gerber 输出旁的 Compare Gerber 链接，并从下拉菜单中选择先前的发布，即可将准备好的 Gerber 数据与所选发布的数据进行对比。系统将使用默认浏览器打开您的 Company Workspace 并显示结果。

在将数据发布到 Workspace 之前，从 Project Releaser 访问 Gerber 对比功能。

► 了解有关 Gerber Comparison 功能的更多信息（Altium 365 Workspace、Enterprise Server Workspace）。

如果在查看数据后发现需要修改，请单击视图右下角的 按钮。将出现确认对话框，提示所有已生成的数据都会丢失——单击 OK 将取消发布，并返回到流程的第 1 阶段。

如果生成的数据看起来都没问题，请单击 按钮继续发布（同样位于视图右下角）。将出现 Confirm Release 对话框，汇总将发布到 Workspace 的项目配置。您也可以在此添加 Name（此处默认条目为 [ProjectName]）、Description，并添加任何相关的发布说明。

确认将发布的内容（就生成的 Item-Revisions 而言），并可更改名称/描述以及添加发布说明。

在线阶段 5 – 上传数据

在上一阶段确认发布后，将自动进入此阶段。该阶段仅显示将数据上传到 Workspace 中相关数据 Item 的修订版的进度。

此阶段仅反映将生成的数据上传到 Workspace 中已链接的 Item-Revisions 的进度。

在线阶段 6 – 执行报告

这是流程的最后阶段，提供发布摘要。

发布的最终报告。

使用导航链接可快速访问包含已发布数据（制造数据、装配数据以及任何自定义数据集）的关联 Item Revision，位置在 Explorer panel 中——这是您进入 Workspace 的入口。

借助 Explorer 面板，可直接在 Workspace 中查看项目的已发布数据。

Viewing the Released Project

对于 Workspace 项目，在发布完成后您还可以使用一项额外功能。单击 Project Page 链接（位于 Execution Report 页面顶部导航链接中的最后一个），将打开 Explorer 面板，在 Project View 中呈现该项目——仅适用于 Workspace 项目。

如果您之前在 Classic View 中查看过该项目，可能需要手动切换到 Project View——可通过 Explorer 面板右上角与 按钮关联的菜单中的命令来完成切换。

借助 Project View，您可以在 Explorer 面板中更详细地浏览 Workspace 项目。

Releases 区域（视图左下角）将显示与该项目相关的项目发布汇总，其中包括每次发布及其组成包的摘要。单击该区域中的 按钮可打开 Batch state change dialog，您可使用它在一次批处理过程中同时更改与同一发布相关的多个条目的生命周期状态。

还可在目标 Workspace 的 Web Viewer 中进一步访问项目发布信息，可通过 Explorer panel 的 按钮打开。在 Workspace 的 Web Viewer 中，可在 Releases 视图中访问与该项目相关的所有发布——或在本地服务器提供的 Workspace 中使用 Manufacture 视图。该页面列出所有项目发布，最新条目位于顶部；可通过其打开按钮（）在 Workspace 的 Manufacturing Portal中打开单个发布。Manufacturing Portal 视图提供所选发布的更详细信息，包括其组成的发布包文件、完整的设计文档集，以及元器件制造商与供应商详情。请注意，Send to Manufacturer 功能仅在 Altium 365 Workspace 中可用。► 更多信息请参阅 Altium 365 Workspace Releases View 页面。

就这些——项目发布完成后，您可以直接关闭 Release 视图（使用视图右下角的 按钮）。当您将来需要对同一项目重新发布时，Project Releaser 可让这一过程快速且轻松，并会自动递增目标 Item-Revisions。

发布到 PLM 实例

Related pages: PLM 集成（Altium 365 Workspace、Enterprise Server Workspace），发布到 PLM

作为在 Altium Designer 中运行 Project Releaser 的一部分，您可以将设计发布到某个 PLM 实例。发布操作会使用发布模板（publishing template）——该模板在该 PLM 实例的集成配置中定义——用于控制数据应如何传播到 PLM。此功能可通过适当配置的流程来使用。安装包中提供了一个示例流程定义——Project Releaser with Publish——其底层工作流可在 Project Releaser 中作为额外阶段，实现发布到已集成的 PLM 实例。其工作流图如下所示。

默认 Project Releaser with Publish 示例流程定义的工作流图

激活后，作为 Project Releaser 的一部分，用于发布到 PLM 实例的流程可在 Altium Designer 中访问：可从活动项目的 Project » Project Releaser 子菜单进入，或从 Project Releaser 右键上下文子菜单进入（在 Projects 面板中右键单击设计项目条目即可访问）。

访问作为 Project Releaser

的一部分、用于发布到 PLM 实例的流程Project Releaser

将显示 Project Releaser，并新增一个阶段——7. Publish to PLM。此外，在与 按钮关联的菜单中还提供了一个命令——Prepare & Release & Publish to PLM——如果您希望运行 Project Releaser 时不停下来查看生成的数据和执行报告，可使用该命令。

用于运行 Project Releaser 的附加命令：不停下来查看生成的数据和执行报告

如果您使用标准的 Prepare 命令运行 Project Releaser，在查看并发布数据后， 按钮会在 Execution Report 阶段出现。单击该按钮以继续该流程的底层工作流，从而发布到 PLM。随后将出现 Login Credentials 对话框。请输入您的 PLM 实例的 Username 和 Password，并选择要使用的 PLM 模板（其显示形式为 <PLMInstance>:<PublishingTemplate>）。

如果您选择使用 Prepare & Release & Publish to PLM 命令，最终将直接显示 Login Credentials 对话框。Project Releaser 不会在 Execution Report 阶段暂停，也不会显示 按钮。

首次发布到 PLM 实例时访问的 Login Credentials 对话框。

单击 Diagram 选项卡以查看该流程的底层工作流。

Login Credentials 对话框的 Diagram 选项卡

单击 按钮以按照该工作流继续发布流程。

您可以通过 Workspace 的浏览器界面，在项目详细管理页面的 Activities 视图中查看发布到 PLM 流程的状态。项目的详细管理页面可通过以下方式打开：在 Workspace 浏览器界面的 Projects 页面中选择所需项目，单击项目列表上方的 控件，并在相关菜单中选择 Open 条目。或者，直接在列表中双击所需项目条目。该页面会在新的浏览器标签页中打开。您始终可以在流程工作流的历史记录（History 选项卡）中准确查看已创建的内容，例如在 PLM 实例中创建的料号等。