CAD

两个 Onshape 集成Copy Anchor Link

Carbon 同时提供两个 Onshape 集成。它们互不共享：各自是独立的 Onshape OAuth 应用，拥有自己的连接、凭据以及哪些 Carbon 物料已关联的记录。公司可以连接任一、两者或都不连接，断开一个绝不会影响另一个。

Onshape Government 是面向 ITAR 和 FedRAMP 版本的第三种、仅拉取的 Onshape 变体，通过你的企业拥有的私有 OAuth 应用连接；参见 Onshape Government。

面板请使用 Onshape V2。如果 Onshape 中出现 Carbon 图标但面板报告未连接，说明公司连接的是 Onshape 而不是 Onshape V2——请同时连接 V2。

设置 Onshape 应用Copy Anchor Link

以下内容每个 Carbon 部署由运维人员执行一次，云端和自托管 Carbon 相同。每个集成在 Onshape 开发者门户中有自己的 OAuth 应用，且只读取自己的变量：

使用面板请设置 Onshape V2。只有需要已发布资产同步时才设置 Onshape。

https://<erp-host>/onshape/panel?documentId={$documentId}&wv={$workspaceOrVersion}&wvId={$workspaceOrVersionId}&elementId={$elementId}&partNumber={$partNumber}&revision={$revision}&nodeId={$nodeId}&occurrencePath={$occurrencePath}&configuration={$configuration}

连接公司Copy Anchor Link

在 Carbon 中打开设置 → 集成。两张 Onshape 卡片都在 CAD 类别下。

如果弹窗以错误结束：

Onshape GovernmentCopy Anchor Link

Onshape Government 是 Onshape 的 ITAR 和 FedRAMP 版本。由于它没有公开 App Store，你的企业必须为 Carbon 创建私有 OAuth 应用。连接后，它支持文档浏览、物料清单导入和已发布资产同步。

一家公司只能连接一个 Onshape 环境。连接另一个之前请断开当前集成。

Onshape 中的 Carbon 面板Copy Anchor Link

打开 Part Studio、装配或图纸，点击右侧面板中的 Carbon 图标。点击 Sign in to Carbon（登录 Carbon）：Carbon 自己源上的弹窗会为你登录（或先进入正常登录），然后自行关闭。会话最长 12 小时，且仅保存在该浏览器标签页中。

面板作用于弹窗所用 Carbon 标签页中当前登录的公司；面板顶部会显示是哪家。要推送到其他公司，请在 Carbon 中切换公司，然后在面板中点击 Sign out（退出） 和 Sign in to Carbon。

面板有三页：

• Parts、Assembly 或 Push，随你打开的元素而定。图纸在这里没有可推送内容；其 PDF 随发布带入。
• Releases（发布），针对整个文档。
• Fields（字段），在 Part Studio 或装配上，面向 Carbon 中具有 settings: update 权限的用户。

推送在工作区或版本中有效。在微版本中面板只显示状态。

状态Copy Anchor Link

每个部件或 BOM 行在推送前显示其状态：

装配的物料清单显示为树状，折叠到顶层，与 Onshape 的结构化 BOM 一致。

写入前先复核Copy Anchor Link

每次推送分两步。点击 Push 会显示 Carbon 将要执行的操作复核；此时尚未写入：

• 将创建的物料及其将获得的值。补货方式、默认制造方法类型和跟踪类型可在此更改；物料 ID 和版本来自 Onshape。每个映射值显示其来自的 Onshape 属性（参见字段）；未映射的值从推送默认值开始。
• 将按部件号关联到现有 Carbon 物料的项，或因为 Onshape 变更而更新的项。复核列出推送将替换的值（设为每次推送都更新的字段）以及 Carbon 保留的 Onshape 值（设为创建时设置的字段）。
• 对于装配，每个制造方法及其新增的行、之前推送写入且将变化的行、手工添加但被接管的行，以及保留的行。
• 对于发布，它创建的每个版本以及使用的变更通知。

Push n to Carbon 按所示应用复核；Cancel 不写入任何内容。复核保留 15 分钟；之后请 Review again（重新复核）。复核中的选择只写入 Carbon；Onshape 保留其值。

推送部件Copy Anchor Link

为 Onshape 部件创建或更新 Carbon 物料：部件号成为物料 ID，外加名称、说明、版本、3D 模型和缩略图。变更后再次推送会更新物料。推送未变更的部件只写入不同的映射值，不导出任何内容。部件必须先在 Onshape 中有部件号。Push all（全部推送） 推送 Part Studio 中所有有编号的部件，最多 50 个。

推送后，该物料就像其他 Carbon 物料一样，所有字段仍可编辑。之后的推送只替换 Fields 页面中设为每次推送都更新的字段。物料页面显示 Onshape 卡片，包含链接、推送会替换的字段、Open in Onshape（在 Onshape 中打开） 以及 Detach（解除关联）（移除链接以停止更新）。该卡片只显示面板建立的链接。

推送装配Copy Anchor Link

推送装配及其物料清单：BOM 中每个物料不存在时创建，BOM 落到装配的制造方法上，包括子装配。推送只改变 Onshape 改变的内容：之前推送写入的行会被更新或移除。你为 Onshape BOM 也列出的部件手工添加的行会被接管；其数量随 Onshape，工序和报废保持不变。Onshape 未列出的手工添加行不受影响。

超过 1,500 个不同部件的装配会被整体拒绝；Push this level only（仅推送此层级） 推送其顶层 BOM，每个子装配作为一行。

BOM 中尚未关联 Onshape 部件的物料会与各自的部件关联。每个关联到其 BOM 行的物料采用设为每次推送都更新的值。只有 Onshape 拥有的值才会写入，因此空的名称或说明单元格绝不会清空 Carbon 的文本。已关联到另一个 Onshape 部件的物料保留其链接，推送不会向它写入任何内容。

采购或制造。 对于新物料，以下第一个给出值的规则胜出：

1. 你在复核中的选择，
2. 映射到补货方式的 Onshape 属性（参见字段），
3. 有组件的 BOM 行为制造，
4. 来自 Onshape 标准内容库的部件为采购，
5. 推送默认值。

Subassembly BOM behavior（子装配 BOM 行为） 为 Show assembly only（仅显示装配） 的子装配不带组件列出，因此推送不会为其写入 BOM，也不说明采购或制造。当物料的采购/制造与 Onshape BOM 不一致时，复核会警告：会获得 BOM 的采购物料，或 Onshape 视为单个整体的制造物料。

已发布的制造方法绝不被编辑。 当装配的方法是已启用且 Onshape BOM 与其不同时，推送会取一个新的草稿版本并写入其中，与 Carbon 中版本变更的方式相同。在有人发布该草稿之前，生效内容不会改变。再次推送会写入同一草稿。推送结果会把每个新草稿列为尚未生效。

推送发布Copy Anchor Link

Releases 页面列出文档最新的 20 个 Onshape 发布，每个标记为 In Carbon（已在 Carbon）、Partial（部分） 或 Not in Carbon（不在 Carbon）。推送一个会：

• 按发布版本号创建每个已发布部件和装配的 Carbon 版本；Carbon 有下一版本时从其复制，
• 把每个已发布装配的 BOM（截至发布版本）写入新版本的制造方法，
• 按发布版本取每个已发布物料的映射值，
• 按发布版本附加模型和缩略图，并把每个已发布图纸作为 <部件号>-<版本>.pdf 附加到其部件上。

新版本进入一张草稿变更通知，以发布命名。它们在你在 Carbon 中发布该通知之前保持未启用，发布后激活它们并取代之前的每个版本。在通知打开且未等待审批时再次推送发布，会加入同一通知，不会重复创建；否则推送会开始新通知。推送必须创建的 BOM 组件不在通知上。

仅有图纸的发布在其 PDF 附加后显示 In Carbon。发布管理需要 Onshape 公司账户；没有时页面会说明。

字段Copy Anchor Link

Fields 页面把 Onshape 属性（Vendor、Project、Material、你公司的自定义属性）映射到 Carbon。属性可以设置部件的物料字段或自定义字段。页面列出你当前打开元素的属性，但映射属于公司并适用于每次推送。它位于面板中，因为 Onshape 只能从文档内部列出属性。

页面以固定行开始：部件号和版本始终来自 Onshape，名称和说明各有模式（见下）。然后是带推送默认值的物料字段，即没有属性设置时新物料获得的值：

• 列表字段有转换：每行把 Onshape 值转换为 Carbon 值。行以 Carbon 自己的值开始，因此选项相同的 Onshape 列表无需设置。把某行设为 No value（无值） 可让字段交给下一条规则。没有对应行的 Onshape 值会在复核中标出且不写入。
• 与单位代码或名称匹配的计量单位值无需映射行。
• 物料字段按物料页面的写入方式写入。更改补货方式也会设置相应的方法。更改补货方式、制造方法或来源方式还会更新草稿 BOM 上的物料行；更改跟踪类型还会更新未结生产订单、收货、发货和调拨。

自定义字段： 先在 Carbon 中创建字段，然后在此选择。文本、列表和对象属性映射到文本字段，布尔映射到是/否，数字映射到数值，日期映射到日期。Onshape 的计算、用户、文件和类别属性无法映射；页面会在列表下方列出它们。没有对应类型 Carbon 字段的属性会说明应添加哪种部件自定义字段类型。

每个 Carbon 字段接受一个属性。已被另一属性设置的字段会灰显保留在列表中，并显示该属性的名称。

Onshape 何时写入字段。 每个映射以及物料的名称和说明都有两种模式之一：

• 创建时设置（默认）：推送创建物料时 Onshape 填充该字段。之后 Carbon 拥有该字段，后续推送不再更改。
• 每次推送都更新：每次推送都用 Onshape 的值替换 Carbon 的值，包括在 Carbon 中做的编辑。空的自定义字段属性会清空 Carbon 字段；空的物料字段或说明从不写入。

设置采购或制造。 Onshape 没有采购/制造属性。在 Onshape 中创建一个列表属性，例如 Make or buy，选项为 Buy、Make 和 Buy and Make。在此映射到补货方式，并在你公司采购的部件上设置值。来自 Onshape 标准内容库的部件（紧固件和其他五金件）在没有属性给值时以采购带入。

• Carbon 按 Onshape 中的显示名称匹配列表值，没有显示名称时按其值匹配。
• Onshape 默认值也是一个值：每个没有自身值的部件都会发送该默认值。使用每次推送都更新时，默认值会替换每个未在 Onshape 中设置的联系物料的 Carbon 值。让 Onshape 默认值留空，以便新物料由推送默认值决定。
• 仅适用于部件的属性在装配行上没有值。Carbon 在那里不写入任何内容。

Refresh（刷新） 重新读取属性和字段列表。Save（保存） 同时保存映射和推送默认值。

面板故障排查Copy Anchor Link

当面板无法从 Onshape 读取，或装配的 BOM 缺少面板需要的列时，错误带有 Show details（显示详情） 和 Copy details（复制详情）：Carbon 向 Onshape 请求了什么、Onshape 回答了什么，包括 Onshape 地址、状态和消息，以及无法读取 BOM 时 Onshape 返回的列标题。请粘贴到支持请求中。它绝不包含令牌或单元格值。

相关内容Copy Anchor Link