添加自定义特征

从您具有“查看、复制和导出”最小权限集的任何文档中，将自定义特征添加到“特征”工具栏。当您在具有其写入访问权限的 Part Studio 中时，或者当您在查看包含定义特征的 Feature Studio 的版本时，可以添加自定义特征。

1. 在 Part Studio 中，单击特征工具栏中的 。
2. 在对话框中，找到从中定义所需自定义特征的文档：
   1. FeatureScript 样例 - 此筛选器列出了 Onshape 提供的所有包含供您试用的 FeatureScript 样例的文档。
   2. Onshape 标准筛选器 - 这些筛选器的使用方式与“文档”页面上的筛选器一样，用于查找特定的文档。
   3. 搜索框 - 输入文档的名称或粘贴包含 FeatureScript 的文档的 URL（通常通过共享操作获得）。

   自定义特征从其他文档的特定版本链接而来，默认情况下选择的是最新版本。如果没有版本，您可以请求文档所有者（或者具有写入访问权限的某个人）创建一个。

3. 单击任意文档名称可显示从中定义的自定义特征。
4. 选择顶层图标以插入该文档中的所有自定义特征（在工具栏中由各自的图标来表示），或者选择一个特征。

   特征工具栏中会出现自定义特征图标。

   要在关闭对话框之前移除自定义特征，请再次在对话框中选择自定义特征。（这样可以在将自定义特征添加到工具栏和从工具栏中移除自定义特征之间切换。）

5. 如果文档有多个版本，默认情况下会显示最新的版本。单击 以访问版本图并选择不同的版本。
6. 单击对话框右上角的 X 以将其关闭。

自定义特征现在即可用在您的特征工具栏中。

使用自定义特征

使用自定义特征可以在 Part Studio 特征列表中创建特征，就像其他任何 Onshape 特征一样。从其他文档链接而来的自定义特征在特征列表中由 图标来指示。

自定义特征的行为方式与其他 Onshape 特征一样，可以对其进行编辑、抑制、隐藏和删除。

更新自定义特征

当插入的自定义特征来自的文档创建了较新的版本时，特征列表中的链接图标会以蓝色亮显，Part Studio 选项卡上也会显示一个完全相同的图标：

这只是一个通知，无需任何操作。

要更新正在使用的自定义特征的版本：

1. 单击更新图标（或右键单击特征并选择“更新链接的文档”）以访问参考管理器，您可以从中选择更新选项。
2. 要更新到最新版本，请单击“全部更新”。
3. 要更新到特定版本：
   1. 单击“选择性更新”：
   2. 选择文档（如果存在多个），然后单击该文档所对应的 ：
   3. 选择要更新到的版本。
   4. 如有必要，针对列表中的其他任何文档重复以上步骤。
   5. 单击“更新选定内容”。

如果用户的特征列表中的特征与管理员添加的工具相对应，则该特征不会显示为过时（即使该工具已过时），但是如果该特征与该工具来自不同版本，则会显示为不同步 。

参考管理器的“全部更新”命令会将不同步的特征更新为工具栏中的版本，即使该版本低于最新版本或低于当前提供该特征的版本。用户可以单击图标并使用“更新”命令来更新工具：

移除自定义特征

要从工具栏中移除自定义特征，请右键单击工具栏中的图标，然后选择“移除”。

编辑 Part Studio 时，该自定义特征将不再出现在工具栏中，除非已使用该特征且它存在于特征列表中。如果特征列表包含某个自定义特征，而您的工具栏中没有相应的自定义特征图标（要么因为已将其移除，要么因为这是与您共享的文档，您的工具栏从未包含该图标），工具栏中会显示“此 Part Studio 中的链接自定义特征”图标，可以从下拉列表中访问该自定义特征：

这样允许对该 Part Studio 具有访问权限的用户继续使用该自定义特征。

打开链接的自定义特征的文档

要重新熟悉文档中的自定义特征及其工作原理，请右键单击工具栏中的自定义特征图标，然后选择“打开链接的文档”。包含自定义特征的 Feature Studio 的文档将在另一个选项卡中打开。

如果您已在此工作区中编写自己的自定义特征，则从中定义的自定义特征自动可从特征工具栏中的“自定义特征”下拉列表 中使用：

1. 单击图标以列出在工作区中定义的所有自定义特征：

   

2. 选择要使用的自定义特征。

编辑并提交用于定义特征的 FeatureScript 时，当前工作区中的自定义特征会自动更新。这对于在开发自定义特征时进行快速测试很有用。

共享自定义特征

要使您的自定义特征可由其他人使用：

1. 创建包含自定义特征 FeatureScript 的文档版本。
2. 执行以下两项操作之一：
   1. 与特定的个人或团队共享文档，至少指定“可以查看、复制和导出”权限。
   2. 将文档设为公开。

企业管理员和用户可以将自定义特征（和公开自定义特征）添加到 Enterprise 帐户中的工具栏。企业管理员可以将公开自定义特征添加到整个企业的工具栏。由企业管理员授予“允许访问公开文档”全局权限后，企业中的用户可以轻松添加公开自定义特征。

企业管理员可以使用此过程将公开自定义特征添加到整个企业的工具栏中。

1. 导航到 https://cad.onshape.com。
2. 使用您的 Enterprise 帐户信息登录。
3. 找到您要添加的自定义特征。如果自定义特征在公开文档中，您必须获得由企业管理员授予的“允许访问公开文档”权限，或按照上述说明操作，将公开文档引入您的企业域。
4. 通过单击工具栏上的 + 按钮，将特征添加到您的工具栏中。
5. 在“用户”菜单中，选择“切换到 <企业域名>”。

当您访问 Enterprise 域时，该特征会出现在您的工具栏上，并会按预期进行更新。

通过将图标作为 SVG blob 选项卡上传至文档中，然后引用它来指定自定义功能图标。有关详细信息，请参见 FeatureScript 文档中自定义图标部分的说明。

说明图像是特征输出的图片，描述图像是特征输出的图片，通过将图像作为 SVG blob 选项卡上传到文档中，然后引用它来指定。有关详细信息，请参见 FeatureScript 文档中自定义图标部分的说明。

如果您的文档包含要发布并向公众开放的自定义特征，则可以在创建文档的新版本时进行发布，也可以直接通过“版本和历史记录”面板中的版本环境菜单进行发布。这也使搜索包含公共自定义特征的文档变得更加容易。

• Onshape 会按字母顺序自动列出自定义特征。
• 如果您选择更新到不是最新版本的某个版本，则“过时”图标会保留。
• 更新自定义特征的参考版本不会更改由工具栏指向的自定义特征的版本。要更新由工具栏指向的版本，请移除现有图标并添加指向较新版本的新自定义特征。
• 更新自定义特征后，您可能必须编辑该特征，它才能正确无误地重生成（例如，添加了要求输入的输入框）。
• 一旦在您的文档中使用了链接的自定义特征，您便对其具有访问权限，即使源文档已删除或取消共享也是如此。
• 向工具栏中添加自定义特征是帐户设置而不是文档设置。图标（以及关联的自定义特征）会出现在您的所有文档中。
• 向工具栏中添加自定义特征（或打开包含自定义特征的文档）会自动开启 FeatureScript 通知，在导航栏中由 来指示。这些通知提供了一些反馈，对于自定义特征的开发者可能很有用。

FeatureScript 在设计时充分考虑到了安全性。为了保护您的安全，FeatureScript 在严密的沙盒中运行，将特征的影响限于它所用于的 Part Studio。这样可确保使用即便是由不受信任的用户编写的自定义特征也相对安全。

自定义特征不能：

• 修改除其用于的 Part Studio 以外的任何内容。
• 以任何方式“感染”您的 Onshape 帐户。
• 向其程序设计者或其他任何人返回任何内容。
• 从特征列表中移除后影响 Part Studio 重生成。
• 修改特征列表中的其他特征。

恶意的（或编写很差的）自定义特征可能：

• 重生成需要很长时间或消耗过多的资源，在移除自定义特征之前，妨碍您使用 Part Studio 的能力。
• 修改 Part Studio 中的变量值或几何图元，企图造成危害。

发布恶意的 FeatureScript 违反 Onshape 使用条款，绝不容忍。

请使用“帮助”菜单中的“反馈”按钮报告恶意的自定义特征。

将自定义特征从您至少具有“链接文档”权限集的任何文档添加到您的特征工具栏。 当您在具有编辑访问权限的 Part Studio 中或正在查看包含用于定义特征的 Feature Studio 的版本时，您可以添加自定义特征。

1. 轻按“添加自定义特征”图标 ()。

   “添加自定义特征”面板打开。

2. 轻按以在当前工作区和浏览文档之间进行选择。
3. 轻按以选择添加自定义特征的来源文档。
4. 轻按以选择文档版本。
5. 轻按以选择您要添加的自定义特征。

   轻按下拉菜单以选择其中的所有自定义特征，或轻按个别自定义特征。

   添加的自定义特征会以蓝色亮显在浮出面板中，并且它会添加到您的特征工具栏中。

6. 轻按复选标记以关闭浮出面板。

Onshape 会按字母顺序自动列出自定义特征。

从其他文档链接而来的自定义特征在特征列表中由链接图标表示。

当插入的自定义特征来自的文档创建了较新的版本时，特征列表中的链接图标会以蓝色亮显，Part Studio 选项卡上也会显示一个完全相同的图标。

请参见链接的文档，了解链接的文档以及如何更新的详细信息。

要从特征工具栏移除自定义特征：

1. 轻按特征工具栏右下角的“管理”。
2. 轻按您要移除的自定义特征旁边的 x。
3. 当您完成自定义特征管理时，轻按“完成”。

FeatureScript 在设计时充分考虑到了安全性。为了保护您的安全，FeatureScript 在严密的沙盒中运行，将特征的影响限于它所用于的 Part Studio。这样可确保使用即便是由不受信任的用户编写的自定义特征也相对安全。

自定义特征不能：

• 修改除其用于的 Part Studio 以外的任何内容。
• 以任何方式“感染”您的 Onshape 帐户。
• 向其程序设计者或其他任何人返回任何内容。
• 从特征列表中移除后影响 Part Studio 重生成。
• 修改特征列表中的其他特征。

恶意的（或编写很差的）自定义特征可能：

• 重生成需要很长时间或消耗过多的资源，在移除自定义特征之前，妨碍您使用 Part Studio 的能力。
• 修改 Part Studio 中的变量值或几何图元，企图造成危害。

发布恶意的 FeatureScript 违反 Onshape 使用条款，绝不容忍。

请使用“帮助”菜单中的“联系技术支持”按钮来报告恶意的自定义特征。

您必须使用浏览器上的 Onshape 将自定义特征添加至特征工具栏，然后才可以在移动设备上访问它。请参见 Onshape 浏览器帮助主题“自定义特征”，了解详细信息。

在移动设备上的 Part Studio 中：

1. 轻按“特征”图标以访问特征工具栏。

   在浏览器上使用 Onshape 添加的自定义特征可以在移动设备上的特征工具栏中使用。

2. 轻按以使用自定义特征。
3. 填写对话框，然后轻按对勾。
4. 已使用的自定义特征列在特征列表中，就像其他任何 Onshape 特征一样。

自定义特征的行为方式与其他 Onshape 特征一样，可以对其进行编辑、抑制、隐藏和删除。

从其他文档链接而来的自定义特征在特征列表中由链接图标表示。

当插入的自定义特征来自的文档创建了较新的版本时，特征列表中的链接图标会以蓝色亮显，Part Studio 选项卡上也会显示一个完全相同的图标。

请参见链接文档，了解链接的文档以及如何更新的详细信息。

FeatureScript 在设计时充分考虑到了安全性。为了保护您的安全，FeatureScript 在严密的沙盒中运行，将特征的影响限于它所用于的 Part Studio。这样可确保使用即便是由不受信任的用户编写的自定义特征也相对安全。

自定义特征不能：

• 修改除其用于的 Part Studio 以外的任何内容。
• 以任何方式“感染”您的 Onshape 帐户。
• 向其程序设计者或其他任何人返回任何内容。
• 从特征列表中移除后影响 Part Studio 重生成。
• 修改特征列表中的其他特征。

恶意的（或编写很差的）自定义特征可能：

• 重生成需要很长时间或消耗过多的资源，在移除自定义特征之前，妨碍您使用 Part Studio 的能力。
• 修改 Part Studio 中的变量值或几何图元，企图造成危害。

发布恶意的 FeatureScript 违反 Onshape 使用条款，绝不容忍。

请使用“帮助”菜单中的“联系技术支持”按钮来报告恶意的自定义特征。