仅适用于

访问 Onshape 对象的元数据定义（驱动对象“特性”对话框和物料清单 (BOM) 中显示的数据），查看这些元数据定义，创建用于公司/教室/企业拥有的文档新特性，并为现有 Onshape 特性提供显示名称。管理员可以添加、修改和停用所有用户的特性。用户只能查看这些元数据定义。

若要在 Onshape 中导航到您的“特性/自定义特性”设置，请单击您位于 Onshape 窗口的右上角的帐户用户图标 (帐户用户图标)。这将打开一个下拉菜单。单击“公司/教室/企业设置”。

在页面左侧列表中单击“特性”（Professional 版或 Educator 订阅）或“自定义特性”（Enterprise 版订阅）：

公司设置：特性

公司设置 > 特性

企业设置：自定义特性

企业设置 > 自定义特性

有权创建和编辑特性的用户请参见页面顶部的创建自定义特性按钮。

特性可与以下 Onshape 对象关联：

  • Onshape 零件
  • Onshape 装配体
  • Onshape 工程图
  • Onshape Part Studio
  • Onshape Document
  • Onshape 文件
  • Onshape 应用程序
  • Onshape 条目
  • Onshape Folder
  • Onshape Project

在“属性/自定义特性”页面上：

  1. 单击创建自定义特性。
  2. 指定特性的名称。名称在 Onshape 和现有特性之间应该唯一。测试唯一性时，Onshape 将使用公司/教室/企业名称和特性的名称。
  3. 选择特性类型：
    • 文本
    • 布尔运算
    • 整数
    • 双精度
    • 日期
    • List

      当定义列表和值时，您可以复制/粘贴或单独输入它们。您也可以指定显示名称（但它们可能不会使用重复“值”）。您可以通过拖/放对值进行重新排序，并随时选择每个值使其处于活动/非活动状态。

    • 用户
    • 包含单位的值
  4. 初始发布状态为“待决中”（对用户尚不可用）。如果希望此特性对用户可用，请选择“活动”（对用户可用且输入的值记录在数据库中）。要弃用此特性，请选择“非活动”。非活动值只能通过 Onshape API 来使用。
  5. 提供特性的其余属性，红色星号指示必填输入框。根据您在上方选择的特性类型，可能有不同的属性可用。
    1. 默认值 -（适用于所有类型）如果需要，在此处输入默认值。如果用户未指定值，此值将充当默认值。

      为用户特性类型输入值时，必须是有效的 Onshape 用户电子邮件，即该电子邮件已属于创建特性的公司。

    2. 说明 -（适用于所有类型）为特性输入可选的说明。
    3. 单位类型 - 仅适用于具有单位类型的值。从自定义特性的单位类型列表中进行选择，包括：
      任何 加速度 角度
      角速度 面积 能源
      力 长度 Mass
      力矩 压力 时间
      体积  
    4. 指示可以在何处编辑特性以及它是否必要：
      • 必填 - 指示必须填写特性值。
      • 在版本中编辑值 - 指示可以在文档版本中编辑此特性值；允许用户在任何文档版本中提供此特性的值。还指示是否应仅通过 API 来编辑值，而不是通过 Onshape 用户界面来编辑值。
      • 在工作区中编辑值 - 指示可以在工作区中编辑此特性；允许用户在任何文档工作区中提供此特性的值。还指示是否值应仅通过 API 编辑，而不是通过 Onshape 用户界面编辑。
  6. 输入特性的可选验证条件，包括可具有模式的条件：
    1. 如果该值可以包含多行文本（例如，说明可能需要多行文本），请选中“多行”。
    2. 如有需要，请输入最小长度和/或最大长度。
    3. 在“模式”输入框中指明模式，如任意正则表达式，包括：

      • [A-Z]+ - 需要一个或多个大写字母字符
      • [0-9]+ - 需要一个或多个数字字符
      • [a-z]+ - 需要一个或多个小写字母字符
      • ONS-[0-9]+ - 需要前缀“ONS-”后跟一个或多个数字字符。您可以将必需的前缀放在默认值属性中，以使其自动显示。如果值无效，用户将收到指定所需模式的错误通知。

  7. 选择该特性将可用的一个或多个类别。公司或企业的管理员必须已通过“类别”选项卡定义该类别。您可以选择多个类别，也可以通过单击类别行最右边的 X 删除类别。有关类别的更多信息，请参见下面的内容。
  8. 您可以将分配给零件和/或装配体类别的自定义特性设置为计算的函数，以便使该特性成为计算的特性。有关更多信息，请参见下面的“创建计算的特性”。
  9. 要使该特性可供公司中的所有用户使用，请确保“发布”状态设置为“活动”。
  10. 单击创建。
  11. 一条消息将会显示，提醒您如果将该特性设置为活动，则公司/教室/企业中的所有用户将都能够查看它。单击“确认发布”以继续激活该特性。您也可以稍后再发布。
  12. 您也可以通过选择重新排序来组织自定义特性。这允许您选择任何自定义特性（打开元数据特性图标 图标旁边的点）并通过拖放来重新排列其顺序。单击确认可保存更改，或取消以撤消更改。

You can create a custom property that uses FeatureScript to compute a value. Once you have a property like this, you can use it through a custom property in your Company/Classroom/Enterprise settings to compute a property. These computed properties can be used with Part categories. Once you have a computed part property defined, you can create another custom property that uses the computed part property to aggregate it for Assemblies and include the information in the Assembly and Drawings bill of materials tables.

只要单位的类型不是'任何'，以下可以为装配体聚合的特性类型是： 布尔、整数、双精度和包含单位的值。

  1. 在 Onshape 设置的“特性/自定义特性”页面上（如上所述），创建与计算特性配合使用的自定义特性。

  2. 在定义的“类别”部分中，添加“零件”类别以指示将该特性应用于零件，并添加“装配体”类别以将该特性应用于装配体。

  3. 若要创建计算的零件特性，请在“计算的零件特性”部分中选中“计算零件特性”复选框。

  4. Click Select computed part property function to open the Select computed part property function dialog.

    选择计算的零件特性函数按钮

  5. Navigate to the document that contains the FeatureScript function,
    选择计算的零件特性函数所在的位置

  6. Select the function from the list displayed.
    Selecting the function from the source document.

  7. 单击创建以创建特性（或单击“取消”以在不创建特性的情况下关闭页面）。出现提示时确认“创建”操作。

请确保您已定义要用于为装配体创建聚合数据的计算零件特性（如上所述）。

  1. 通过“类别”输入框将装配体类别添加到计算零件特性中：

    将“装配体”类型添加到“类别”中

  2. 请注意，页面底部会出现一个名为“聚合装配体特性”的新区域。（这仅适用于以下类型：:  布尔、整数、双精度、列表和包含单位的值，前提是这些单位的类型不是“任何”。）

    “聚合装配体”复选框

  3. 选中该方框，将出现以下用于定义聚合数据的输入框：

    “聚合装配体特性”输入框

  4. 定义所需的装配体聚合方法以计算和显示：

    1. 包含单位的值、整数和双精度类型

      • 总和、最小值、最大值、平均值、加权总值或加权平均值

    2. 布尔类型

      • 任何 - 如果至少有一项为真，则返回 true

      • 全部 - 如果所有项都为真，则返回 true

      • 并非任何 - 如果至少有一项为真，则返回 false

      • 并非全部 - 如果所有项都为真，则返回 false

    3. 清单类型

      • 第一个 - 返回所有零件和子装配体的第一个聚合特性值。您可以在“自定义特性”页面的“列表值”部分中通过拖放来调整值的顺序。
      • 最后一个 - 返回所有零件和子装配体的最后一个聚合特性值。您可以在“自定义特性”页面的“列表值”部分中通过拖放来调整值的顺序。

  5. 选择聚合特性以计算和显示：

    1. 包含单位的值、整数、双精度和清单类型

      • 相同的特性

    2. 布尔类型

      • 相同的特性（布尔运算）

      • 非修订托管

      • 从所有物料清单中排除

  6. 在缺失值处理输入框中（不适用于清单类型），指定当某个值缺失时如何处理聚合：

    1. 跳过聚合（忽略且不聚合）

    2. 视为零（将缺失值视为零）

  7. 在错误处理输入框中，指定在错误发生时如何处理错误：

    1. 跳过聚合

    2. 将错误视为零（不适用于列表）

    3. 视作真/假（适用于布尔运算）

    4. 将错误传播到计算中

  8. 选中筛选聚合方框来筛选聚合（使用布尔特性作为筛选器时忽略它），然后选择筛选方法：

    1. 布尔运算筛选器特性 - 从“非修订托管”和“从物料清单中排除”中进行选择，或是选择自定义布尔运算特性

    2. 筛选器行为 - 从“为真时包括”和“为真时排除”中选择

  9. 单击创建以创建特性（或单击“取消”以在不创建特性的情况下关闭页面）。

在名为“自定义质量”的 Feature Studio 中创建以下 FeatureScript（或类似内容）：

annotation { "Property Function Name" : "Custom mass"}
export const mass =
defineComputedPartProperty(function(context is Context, part is Query, definition is map) returns ValueWithUnits
{
const volume is ValueWithUnits = evVolume(context, { "entities" : part });
const material is Material = getProperty(context, {
"entity" : part,
"propertyType" : PropertyType.MATERIAL
});
return material.density * volume;
});

在公司设置 >  “自定义特性”页面中创建一个名为“自定义质量”的自定义特性：

“质量”的自定义特性

将自定义特性分配给“零件”类别和“装配体”类别：

将“装配体”类型添加到“类别”中

在计算零件特性下选择 FeatureScript:  随后选中该方框，单击选择计算零件特性函数：

为自定义特性选择 FeatureScript

选择聚合装配体特性的复选框，然后指定如何在物料清单中包含这些信息：

在装配体中，您可以将该特性添加到物料清单：

  1. 打开物料清单。

  2. 单击“添加列”，然后选择您在上述过程中创建的自定义特性。

  3. 该特性已添加到物料清单中：

Onshape 元数据和属性/自定义特性只能由管理员编辑。

在“特性/自定义特性”页面上，您可以：

  • 搜索特性。使用搜索框输入特性 ID、名称或部分名称，选中该框以搜索非活动特性。

    该列表首先显示 Onshape 元数据特性，然后按字母顺序显示自定义特性。可以选择重新排序按钮按任意顺序组织自定义特性。

  • 单击“特性名称”将其打开以进行编辑。您可以根据需要对“发布状态” 为“待定”的特性进行任何更改，包括删除该特性。如果该特性已设置为“活动”，则可以将其状态设置为“非活动”并更改其显示名称，但您将无法删除该特性。具有“列表类型”的“活动”特性可以重新排序并添加其他值/显示名称。您可以将现有列表值设为非活动状态，并且可以编辑其显示名称。
  • 在任何“属性”对话框中非活动属性都不可见，但仍与对象相关联。对活动属性所做的任何其他更改都将立即可用并在保存后生效。非活动属性可以再次变为“活动”状态。

    请参见创建和激活新的属性/自定义特性以获取有关修改输入框的信息。

Onshape 元数据定义可能处于非活动状态（已弃用），但不可编辑。

您可以根据属性的不同，在 Onshape 中访问不同区域的属性和自定义特性。

右击图元（例如，零件、Part Studio、装配体、工程图等） 以访问环境菜单，然后单击“特性”以打开“特性”对话框。如果有可访问的自定义特性，它们将在对话框中列出。

您还可以使用“文档”页面上的“高级搜索”特征访问自定义特性。展开“高级搜索”下拉菜单，然后展开“添加标准”下拉菜单：

在“高级搜索”中展开的“添加条件”下拉菜单的屏幕截图

如果有可访问的自定义特性，它们将显示在下拉菜单中（参见上图中亮显的“测试特性”）。

当使用“用户自定义” 特性类型时，无法搜索到当前用户。您必须选择位于列表顶部的当前用户。

如果属性已淘汰或在激活属性后发现定义中存在错误，您可以弃用该属性。弃用某个属性会将其从所有属性对话框中移除，但会使该属性与对象保持关联，并将数据保留在数据库中。要弃用属性：

在“特性”页面上：

  1. 如有必要，搜索以查找特性。
  2. 单击要打开以进行编辑的特性名称。
  3. 选择“发布状态”的下拉列表，然后选择“非活动”。
  4. 单击“保存更改”。

非活动特性可以重新设置为活动状态。

Onshape 元数据定义可能处于非活动状态（已弃用），但不可编辑。