只能在(Part Studio 或装配体中的)浏览器上创建配置。有关更多详细信息,请参见使用配置。有关在装配体中创建配置的信息,请参见装配体配置。
通过创建整个 Part Studio 或特定零件的变体来创建零件族。您可以配置任何特征或输入值,甚至是零件特性、自定义零件特性、面和零件外观,以及草图文本。例如,您可以配置拉伸特征的深度、圆角特征的应用、为圆角选择的面、自定义特征的 FeatureScript 以及零件编号、颜色和材料。
您在一个 Part Studio 中配置的所有特征和输入参数都称为配置。每个 Part Studio 都可以有一个配置。但是,您可以在一个配置中创建多个配置输入。当您要配置的特征或输入不一定相互关联时,这特别有用。例如,当零件的长度和直径与是否应用圆角无关时,可以使用两个配置输入。这提供了更多的灵活性,并且可以帮助防止每个配置输入变得过于复杂。
将零件插入到装配体或工程图中时,在 Part Studio 中定义的配置输入将成为“插入”对话框中的选项。例如,您创建一个配置输入,以在钣金零件的顶部或左侧放置法兰。将钣金零件插入装配体时,不仅要选择零件,还要选择法兰的配置:
当多个人在同一文档中工作时,每个人都会看到自己选择的配置,但在跟随模式下工作时除外,那时,跟随者会看到引领者选择的配置。
以下是术语图,解释了在 Onshape 中使用单一配置输入创建配置的基本步骤,然后解释了在同一 Part Studio 中创建其他配置输入。还有关于在任何配置输入中配置零件特性的说明,以及处理配置的其他方法。



配置只能在浏览器(在 Part Studio 或装配体中)中创建。通过创建整个 Part Studio 或特定零件的变体来创建零件族。您可以配置任何特征或参数值,甚至是零件属性、自定义零件属性、面和零件外观,以及草图文本。例如,您可以配置拉伸特征的深度、圆角特征的应用、为圆角选择的面、自定义特征的 FeatureScript 以及零件编号、颜色和材料。
您在一个 Part Studio 中配置的所有特征和参数都属于一个配置。每个 Part Studio 可以有一个配置;但是,您可以在一个配置中创建多个配置输入。
当您将零件插入装配体或工程图时,您在 Part Studio 中定义的配置输入将变成“插入”对话框中的选项。
在此示例中,创建了两种配置:新的钣金厚度配置和替代法兰配置。将模型置于工作区后,单击“配置”图标以打开“配置”面板。单击“配置 Part Studio”按钮。输入 “Sheet thickness”(钣金厚度)作为配置名称。单击选项卡以创建新行,然后输入 “Alternate flange”(替代法兰)作为第二个配置名称。每行都是不同的配置。
选择“钣金厚度”这一行后,单击“配置特征”按钮。在“特征”列表中双击包含该参数的特征。选择参数以用黄色虚线勾勒出轮廓,在本例中为“钣金厚度”参数。在表中会为该参数创建一个新列。双击表格单元格,然后提供一个新值。接下来,选择“替代法兰”配置行,使用“法兰”特征执行相同操作,并在表中提供“距离”和“折弯角度”的替代值。
若要使用模型测试输入,请单击“特征”列表的“配置”区域中的下拉箭头,然后选择新配置以查看结果。模型使用新的输入参数进行更新。

通过工作区中的模型或草图,打开“配置”面板:
- 单击“视图立方体”下方的“配置”面板图标 (
)。
-
“配置”面板打开。单击“配置 Part Studio”以添加输入:
默认情况下,“配置”左侧的插入符号会展开(显示在蓝色箭头的右侧),当您完成面板的某个部分后,单击插入符号可收拢该部分。
- 单击第一行将其激活,然后在第一列中输入输入值名称。活动行由该行左侧的蓝色条形指示。按下 Tab 移至下一行。
在此示例中,我们将输入三种可能配置的名称:短、中和高。 - 要为所选输入值配置特征,单击“配置特征”。
- 在特征列表中,单击要配置的特征并选择参数。该参数以一条黄色虚线勾勒出轮廓,并为该参数创建了一个新列。
在本示例中,我们将单击“特征”列表中的“拉伸”特征,然后在“拉伸”对话框中选择“深度”参数。该参数在对话框中以黄色亮显,表格中会出现一个新列。
列名称默认为特征名称(作为顶级标题)加上参数名称(作为下级标题),在这种情况下,挤出 1 是特征名称,深度 是字段名称。
将光标悬停在特征对话框中的输入框上,查看可以配置的参数。将光标悬停在可供配置的参数上面时,这些参数以黄色亮显。
- 要编辑已配置的参数,请执行以下操作:
- 要编辑某个值,请双击该值并输入新值。
在此示例中,我们将为三个输入值设置深度: - 要编辑对话框中的选择,请双击表中配置的参数以打开特征对话框。
特征对话框中的参数以蓝色亮显。移除任何不需要的选择,然后在模型或草图上做出新的选择。单击特征对话框中的绿色复选标记将其关闭。
- 要编辑某个值,请双击该值并输入新值。
- 完成配置定义后,请单击黄色横幅中的“完成”按钮
- 要向输入中添加另一个参数(列),请重复步骤 4-7。
- 要使用模型测试输入,请在左侧面板的“配置”下,使用向下箭头从菜单中进行选择:
模型应该相应地更新。如果未更新,请检查设计意图的模型和配置定义以进行精确选择。
交叉参考配置的特征
将光标悬停在配置的表格中的特征上可在模型空间中查看该特征(如下所示):

Part Studio 配置可以包含一个或多个配置输入。上面的步骤解释了如何创建列表类型配置输入,当将零件插入到装配体或工程图时,配置输入会产生配置选项列表。您可以创建多个配置输入(以防止一个输入变得太复杂或复制输入),并且还可以创建不同类型的输入。您可以配置的其他类型输入是配置变量和复选框。您还可以将来自另一个 Part Studio 或装配体的输入粘贴到当前文档或外部文档中。
定义配置输入(使用上述步骤)后,您可以使用配置面板底部的 按钮创建其他配置输入:
创建配置输入时,您可以指定要添加的输入类型:
- 列表 - 在 Part Studio 中创建一个特征输入列表,并在将一个或多个零件插入到装配体或工程图中时,作为选项列表显示。(这种类型在上面也有说明。)
- 复选框 - 创建一个复选框以打开或关闭特征,例如圆角和倒角,以及抑制或取消抑制特征。这种类型会显示一个复选框,供您在插入期间选中/取消选中。创建后,使用“+配置特征”按钮选择关联特征。
- 配置变量 - 创建可用于任何特征和 FeatureScript 中的变量。变量的类型包括:长度、角度、整数、实数和文本。在插入时输入变量的值。
- 粘贴输入 - 将来自其他 Part Studio 或装配体的输入粘贴到此文档或其他文档中。请参见复制和粘贴输入。

以这种方式创建时,会显示一个“列表输入”对话框。您为配置输入提供的名称将成为系统中的变量。这与使用上面使用基本步骤创建的名称不同;该名称不是系统中的变量。
- 单击
箭头并选择“列表”。新输入将添加到“配置”面板。
- 按照上述“基本步骤”部分中提供的步骤配置参数。

- 单击
箭头并选择复选框。复选框输入对话框打开。
- 为输入输入一个名称。
配置输入有一个列,其中包含一个未选中复选框行和一个已选中复选框行:
- 要配置参数,请单击
。
- In the Feature list, click the feature that contains the parameter and select the parameter. The parameter is then outlined with a broken yellow line and a new column is created for that parameter in the table. (Parameters that are configured in another input are outlined with a broken yellow line and are unavailable for configuration.)
In this example, Unsuppressed is selected as a configuration input parameter.
- 单击
关闭特征对话框。
- 在“配置输入”中,参数列有两行,均带有已选中的复选框。取消选中第一列中未选中框旁边的复选框,使表格如下所示:
在特征列表上的配置列表中,此配置输入显示一个复选框,以打开(取消抑制)或关闭(抑制)拉伸。

- 单击
按钮右侧的箭头。
- 选择
编辑外观
- 输入变量输入的名称(这将成为系统中的实际变量,通过使用 #<variable-name> 进行参考)。
- 选择变量类型:长度、角度、整数、实数、文本。文本可以是可以在自定义 FeatureScript 中使用的任何类型的文本。
- 为您所选的变量类型,输入值。
- 单击复选标记以保存您的定义。
- 将变量应用至特征:
- 双击特征列表中的特征,以将其打开。
- 对于草图,您可以右击尺寸,选择“配置尺寸”,然后选择配置或设置为#<variable-name>
- 关闭特征对话框。
- 通过在页面左侧特征列表上方的“配置”列表中选择值来测试该值:

Renaming configurations
To rename a configuration input or input parameter (column), hover over the current name to display the I-cursor. Click to select the current text, type the new text, then press Enter.
Configuration input parameters (columns) can be renamed for sketch features only.
Configuration inputs can also be renamed via the context menu.
Context menus
To make adjustments to a configuration input, click three-dot button
- Copy table - Copy the entire configuration input. You can then paste it into a spreadsheet for record-keeping or editing. You can likewise paste from a spreadsheet back into a configuration input. See Copying and pasting input values and parameters
- Copy input - Copy the input and values (rows). You can then paste it into another Part Studio or Assembly's Configuration panel, and add parameters using the Copy table command. See Copying and pasting inputs.
- Copy all inputs - Copy all the inputs and values (rows) in the Configuration panel. You can then paste it into another Part Studio or Assembly's Configuration panel, and add parameters using the Copy table command. See Copying and pasting inputs.
- Move up/down - Reorder the input in the Configuration panel. You can also click and drag the inputs to reorder them.
- Rename - Rename the configuration input. You can also rename the input as described in the Renaming configurations section.
- Edit FeatureScript IDs - This dialog will change the internal FeatureScript identifiers of the configuration input. Click inside the dialog boxes to change IDs. When finished, select Break reference and change IDs in the lower right corner.
This dialog is typically only useful if you need to build a Part Studio inside a custom FeatureScript feature.
- Exclude from properties - See Excluding configurations from affecting properties.
- Collapse/Expand all inputs - Collapse or expand all the configuration inputs in the Configuration panel.
- Visibility conditions - See Setting visibility conditions.
- Delete - Select this action to immediately delete the configuration input; no warning is given.
For all tables, use the context menu (right-click) to operate on rows or columns:
Column context menu
Row context menu
- Switch to - When right-clicking a row that is not the currently selected input, the menu item is prefaced with Switch to a different input.
- Set as default - If a row is not currently the default input value, set it as the new default. The current default is displayed next to the input name.
- Duplicate row - Create a duplicate row; this is especially convenient when preparing to paste a new input into this one. See Copying and pasting tables into and out of Configuration Inputs below, for more information.
- Move up/down - Move the selected row up or down one row. You can also click and drag to reorder the rows.
- Rename - Rename the input.
- Delete column/row - Delete the selected column or row.
You can click and drag individual column edges in the table to resize them; in the case of stacked column labels, click and drag the bottom label, indicated in the illustration above by the blue arrow.

您可以调整配置输入参数可见的条件。
考虑一个带有两个配置输入的零件:高度和宽度。
默认情况下,任意高度的零件可以将宽度设置为任意值。但是,假设超宽度仅适用于“较高”高度。在这种情况下,我们可以设置“宽度”输入参数可见的条件。
- In the Configuration panel, click the configuration's three-dot button, and select Visibility conditions from the menu.
“配置可见性条件”对话框打开。右侧面板显示当前选定配置的预览。您可以在此面板中更改所选选项以预览您的设置。 - 单击“添加条件”。
- 单击第一个下拉菜单,然后选择应控制此输入参数可见性的参数。在此示例中,我们将选择“高度”输入参数。
- 单击第二个下拉菜单,然后选择输入参数可用的条件。在此示例中,“宽度”输入参数仅适用于“较高”高度。右侧的预览会更新以反映您的选择。在下图中,您可以看到“宽度”输入参数不再适用于“较低”高度。
- 单击“保存”。现在,“宽度”输入参数仅在选择“较高”高度时可见,“宽度”输入参数表显示可见性条件图标
。
设置多个条件
配置条件是累加的;如果我们在上面的示例中添加第三种配置并设置下图所示的条件,则“大圆角”选项将仅适用于同时具有“较高”高度和“超宽”宽度输入参数的零件。
当将“较高高度”设置为“默认宽度”时,“圆角”配置将被隐藏。
配置输入参数只能控制“配置”面板中显示在其下方的输入的可见性。在我们的示例中,“宽度”输入参数可以由“高度”输入参数控制,但不能由“圆角”输入参数控制。
修复可见性条件
如果找不到必要的输入,则会自动修复(移除)可见性条件。
例如,如果“宽度”输入参数的可见性取决于“高度”输入参数,并且删除了“高度”输入参数,则“宽度”的可见性条件将自动移除。
“宽度”的可见性条件是根据“高度”输入参数计算得出的。
“高度”输入参数已删除。
系统会自动修复“宽度”输入参数的可见性条件。
提示
-
您设置的可见性条件可在所有“插入”对话框中找到(即,将配置的零件插入到装配体中时)。
-
隐藏的输入参数始终有其默认值。在上面的示例中,即使未设置宽度选项,“较低高度”和“中等高度”的零件也具有“默认宽度”。
-
(仅限零件和 Part Studio):已从特性中排除的配置输入只能控制其下方其他输入的可见性,这些输入参数也已从特性中排除。在下面的示例中,如果将“宽度”排除在特性中(由图标
指示),则只有当“圆角”也从特性中排除时,它才能控制圆角的可见性。
- 使用“配置可见性条件”对话框中的“输入”下拉菜单来查看其他输入参数。您可以选择“所有输入”来查看所有可用输入参数。
- When multiple inputs are displayed in the dialog, click the three-dot button to expand or collapse all inputs.
- 您可以将配置可见性条件对话框的预览部分用作操场来测试您的配置。
- 选中“显示隐藏的输入参数”复选框以在“配置可见性条件”对话框中显示灰色的输入参数。
-
Hidden inputs are grayed out in the Configurations panel.
-
Click
in the Configurations selector to open the Configuration visibility conditions dialog for all inputs. Click
in the Configurations panel to open the dialog for that input.
-
对可见性条件所做的更改会自动反映在引用配置元素的所有现有文档中。


您可以将配置输入复制并粘贴到 Part Studio 或装配体中或将其粘贴到 Part Studio 或装配体中。这使得在设计之间共享配置变得轻松快捷。
-
在 Part Studio 或装配体中打开包含要复制的输入的“配置”面板。
-
单击输入的三点菜单,然后选择“复制输入”或“复制所有输入”。
-
在 Part Studio 或装配体中打开“配置”面板以粘贴输入。
-
单击“配置 Part Studio/装配体”旁边的箭头,然后选择“粘贴输入”。
输入将插入到“配置”面板中。 -
从新的 Part Studio 或装配体中选择要配置的参数。继续阅读以了解现在如何将输入值和参数复制到输入表中。
注释:
- 您可以复制和粘贴配置输入:Part Studio 和装配体之间、同一文档内以及不同文档之间。
- 所有名称、可见性条件、FeatureScript ID 和变量定义都与输入一起复制。
- 在用户登出之前,复制的输入都可用。
- 复制的输入和粘贴的输入之间的参考不会保留;粘贴后,对原始配置输入的更改不会反映在粘贴的输入中。
- 如果目标配置没有计算可见性所需的所有输入,则粘贴的可见性条件将自动修复(移除)。
- 不粘贴具有相同内部 FeatureScript ID 的配置输入。要修复此问题,您可以删除具有相同内部 FeatureScript ID 的配置输入,然后重新粘贴。

您可以将配置复制并粘贴到配置中,以帮助输入或编辑值。
要复制值和参数,请执行以下操作:
- 打开右上角“+配置特征”旁边的
菜单。
- 选择复制表格:
- 复制表格后,您可以将其粘贴到电子表格中:
请注意,列名也与表一起出现,如上所示。现在您可以编辑表格并将其复制/粘贴回 Onshape:
- 只选择具有数据的行和列(不是列名或标题),如下面的蓝色所示:
如果需要,您还可以为表格添加额外的空白行。在为复制命令进行选择时,只需包括电子表格中的额外行。
- 发出复制命令。
- 在 Onshape 配置表中,单击表格左上角的单元格。
- 发出键盘复制命令:
Onshape 会自动将配置输入表的行和列中的数据替换为复制的数据。Onshape 还会自动包含每个输入的默认单位。
请注意,如果从电子表格复制的行数多于 Onshape 配置输入表格中的行数,则这些行不包含在粘贴中。Onshape 会立即创建行。
但是,如果从电子表格复制的列数多于 Onshape 配置输入表格中的列数,则这些列不包含在粘贴中。Onshape 尚未动态创建列。但是,在粘贴前,您可以在配置表格中创建其他列(参数)。

Onshape 还有一种机制,可以直接从“配置”面板为您先前定义的每个配置输入和选项配置属性。您可以配置零件属性或外观属性。如果您有 Professional 或 Enterprise 帐户,则还可以配置自定义特性。
- 在 “配置” 面板中输入现有配置后,单击面板顶部的 配置属性。
- Click the Properties for drop down to select the part or appearance to configure.
包含已配置特性的零件和外观在列表中以复选标记显示: - 单击“添加特性”。
-
选择要配置的特性;特性可用于零件、外观和自定义特性。所有配置输入都将添加到表中。
- 双击“特性”列中的单元格进行编辑。按 Tab 键移至下一行。
- 要编辑一个值,请键入新值并按 Enter 键接受。
- To edit a dialog selection, make the new selections in the dialog, then click
to close the dialog.
- 要编辑一个值,请键入新值并按 Enter 键接受。
-
根据需要重复操作以配置其他特性。以下示例均配置了零件编号和面外观特性。
请注意,如果您启用了自动生成零件编号的功能(通过您的 Professional 版公司编号方案或 Enterprise 版编号方案),则可以在“零件编号”特性列中右键单击,然后选择“生成下一个零件编号”:
如果表中的任何属性设置为只读,则无法删除表、向表中添加属性或删除只读属性列。您仍可以修改可编辑属性的单元格值。再次将只读属性设置为可编辑以修改该表。

某些配置表可以从特性中排除。当您不想重复配置的特性表中的配置选项时,这很有用。排除的配置被视为始终使用其默认值。
例如,以弹簧为例。弹簧的直径和高度均有配置可供选择。
弹簧是否压缩会影响几何图元,但不会影响零件编号;压缩和未压缩时弹簧是同一个零件。若要指定无论弹簧高度如何都应分配所有零件编号,必须将每个配置选项添加到配置特性表中,并为每个配置选项指定零件编号。
为每种配置可能性设置零件编号。
如果改为从特性中排除压缩配置表,您可以根据直径指定零件编号:
压缩配置表不包括在配置的特性表中。无论弹簧高度如何,都将设置零件编号。
从零件的特性中排除配置
-
In the Configuration panel, click the configuration's three-dot button, and select Exclude from properties from the menu. The Excluded from properties icon
appears next to the configuration's name.
将排除的配置添加回零件的属性中
-
在“配置”面板中,单击配置的三点按钮,然后从菜单中选择 “包含在特性中”。
将配置的零件插入到装配体中
将具有排除配置的零件插入到装配体中时,您将在该零件旁边看到“从属性中排除”图标。
发布排除配置的零件
发布排除配置的零件时,您将在创建发布候选对话框中看到“从属性中排除” 图标。
注释
- 排除配置被视为始终使用其默认值。发布套件和修订参考将始终使用这些默认值。
- 物料清单 (BOM) 和发布管理将仅在排除的配置上存在差异的零件视为相同的零件。
- 如果发布了具有排除配置的某些内容,则该配置的所有值均被视为已发布。
- 排除配置仍将包含在:
- 几何图元计算
- 计算的特性
- 质量特性工具
- 如果您发现物料清单中提供的质量与“质量属性”工具中提供的质量之间存在差异,则可能是由于物料清单中忽略了某些配置所致。

您可以使用在 Part Studio 中创建的配置输入来测试结果,并使用该信息来调整设计意图。但是,创建配置输入的主要目的是为生产工作流程(如创建装配体和工程图)中使用的零件提供选项。
若要在 Part Studio 中测试配置,请使用征列表顶部的“配置”区域选择配置输入,查看它们如何影响 Part Studio 中的零件:
浏览器上的 Part Studio 中特征列表的“配置”部分的示例
Android 设备上的 Part Studio 中特征列表的配置部分(下拉菜单处于打开状态)的示例
iOS 设备上 Part Studio 中特征列表的“配置”部分示例
将零件插入装配体或工程图时,在插入过程中,直接在所有平台(浏览器、iOS 和 Android)的“插入”对话框中选择所需的输入:
浏览器上的插入对话框,如上所示
Android 设备上的插入对话框,如上所示
iOS 设备上的插入对话框,如上所示
In an Assembly, configured parts are indicated by the icon in the Instances list:

iOS 和 Android 对配置的支持仅限于以下内容:
-
查看右侧的“配置”面板 (
)。
-
在左侧面板(功能列表上方)中的“配置”之间进行选择:
在 iOS 上选择“配置”
-
(仅限 iOS)如果配置中存在“可见性条件”,则应用这些条件。
您无法在 iOS 或 Android 平台上创建或编辑配置或可见性条件。这只能在桌面(浏览器)平台上完成。
有关其他学习中心资源,请参阅:自定进度课程 > 配置。您还可以在此处阅读学习路径课程:零件配置简介(需要 Onshape 帐户),以及此处的技术简报文章:参数变量与配置变量(需要 Onshape 帐户)。