Configurations are created only on a browser (in a Part Studio or an Assembly) . See Using configurations for more details. For information creating configurations in an Assembly, see Assembly Configurations.
藉由建立整個 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」做為組態名稱。按一下 Tab 鍵來建立新的列,然後輸入「Alternate flange」做為第二個組態名稱。 每個列是一個不同的組態。
在選取了「Sheet thickness」列的情況下,按一下 [組態特徵} 按鈕。在「特徵」清單中連按兩下包含該參數的特徵。選擇參數來以黃色虛線框出參數。在這個案例中是「Sheet thickness」參數。系統會在表格中為參數建立一個新的欄。連按兩下表格儲存格,然後提供一個新的值。接下來,選擇「Alternate flange」組態列並執行相同的操作。使用 Flange 特徵,然後為表格中的「距離」與「彎折角度」提供其他值。
若要用模型測試輸入值,按一下「特徵」清單中「組態」區域內的下拉箭頭,然後選擇新的組態來查看結果。系統會使用新的輸入參數更新模型。

在工作區中有模型或草圖的情況下,開啟「組態」面板:
- Click the Configuration panel icon (
) below the View cube.
-
The Configuration panel opens. Click Configure Part Studio to add an input:
根據預設,「組態」左側的插入符號是展開的 (上圖中藍色箭頭的右邊),當您完成面板該部分的操作時,按一下插入符號來摺疊該部分。
- Click in the first row to activate it, and enter the input value names in the first column. The active row is indicated by a blue bar to the left of the row. Press Tab to move to the next row.
In this example, we'll enter the names for our three possible configurations: Short, Medium, and Tall. - To configure a feature for the selected input value, click Configure features.
- In the Features list, click the feature to configure and select the parameter. The parameter is outlined with a broken yellow line and a new column is created for that parameter.
In this example, we'll click the Extrude feature in the Features list, and select the Depth parameter in the Extrude dialog. The parameter is highlighted in yellow in the dialog, and a new column appears in the table.
The column name defaults to the feature name (as a top-level heading) plus the parameter name (as the subordinate-level heading), in this case Extrude 1 is the Feature name and Depth is the field name.
將游標移動到特徵對話方塊中的欄位上暫留,查看可以組態設定那些參數。當您移動暫留游標時,可供組態使用的參數會以黃色強調顯示。
- 編輯已組態參數:
- To edit a value, double-click it, and enter the new value.
In this example, we'll set the depths for our three input values: - To edit a selection in a dialog, double-click the configured parameter in the table to open the feature dialog.
The parameter in the feature dialog is highlighted in blue. Remove any unwanted selections, and make your new selections on the model or sketch. Click the green check mark in the feature dialog to close it.
- To edit a value, double-click it, and enter the new value.
- When finished defining the configurations, click the Done button in the yellow banner
- To add another parameter (column) to the input, repeat Steps 4-7.
- To test the inputs with the model, under Configurations in the left panel, use the down arrow to select from the menu:
模型應會相對應地更新。如果沒有,請檢查模型確定有正確傳達設計意圖,並已為組態定義做出正確的選擇。
交互參考已組態特徵
將游標移動至組態表格中的特徵上暫留以在模型空間中查看特徵 (如下圖所示):

一個 Part Studio 組態可包含一或多個組態輸入項。上方的步驟說明如何建立清單類型的組態輸入項,這樣會在將零件插入至組合件或工程圖時,產生一個組態選擇項的清單。您可以建立多個這種組態輸入項 (以避免一個輸入項變為過於複雜或重複了輸入項),同時建立輸入項的不同類型。其他您可以設定的輸入項類型是「組態變數」與「核取方塊」。您也可以貼上來自目前文件或外部文件中另一 Part Studio 或組合件的輸入項。
在您定義組態輸入項之後 (使用上述的步驟),可以使用「組態」面板底部的 按鈕來建立其他的組態輸入項:
在建立組態輸入項時,您可以指定要加入的輸入項類型:
- 清單 - 建立 Part Studio 中特徵輸入項的清單,當將一或多個零件插入至組合件或工程圖中時,會以選取項目清單的形式出現 (上方說明的即是此種類型)。
- 核取方塊 - 建立核取方塊來開啟或關閉特徵 (例如圓角與倒角),也可以用來抑制或取消抑制特徵。此種類型代表插入時核取/取消核取一個核取方塊。一旦建立核取方塊之後,請使用「+組態特徵」按鈕來選擇相關的特徵。
- 組態變數 - 建立可用於 FeatureScript 中任何特徵的變數。變數的類型可包括:長度、角度、整數、實數或文字。請在插入時輸入變數的值。
- 貼上輸入項 - 貼上來自這個文件或另一文件中其他 Part Studio 或組合件內的輸入項。請參考複製與貼上輸入項。

當以此種方式建立時,「清單輸入」對話方塊會出現。您所給的組態輸入項名稱會變成為系統中的變數。這與使用上述基本步驟所建立的名稱不同;名稱並不會成為系統中的變數。
- Click the
arrow and select List . A new input is added to the Configuration panel.
- Configure parameters following the steps provided in the Basic Steps section above.

- Click the
arrow and select Checkbox. The Checkbox input dialog opens.
- 輸入輸入項的名稱。
組態輸入項欄位中會有一個空白的核取方塊列與一個已勾選的核取方塊列:
- 若要組態一個參數,按一下
。
- 開啟包含參數的特徵 (在「特徵」清單中按一下特徵), 然後選擇參數。此時參數會出現在黃色虛線邊框中,同時會在表格中為該參數建立新的欄位 (在另一個輸入項中設定的參數會出現在黃色虛線邊框中,無法用於組態之中)。
在這個範例中,選擇了 Unsuppressed 做為組態輸入項的參數。
- 按一下
來關閉特徵對話方塊。
- 在組態輸入項中,參數欄會有兩個列,同時會有已勾選的核取方塊。取消勾選第一欄中未勾選方塊旁的核取方塊,使得表格看起來像這樣子:
在特徵清單上方的「組態」清單中,這個組態輸入項會有核取方塊可開啟 (取消抑制) 或關閉 (抑制) 擠出。

- 按一下
按鈕右側的箭頭。
- 選擇
。
- 輸入變數輸入項的名稱 (會成為系統中實際的變數,會以 #<變數名稱> 出現)。
- 選擇變數的類型:長度、角度、 整數、實數與文字。文字可以是任何可用於 FeatureScript 中的文字類型。
- 為您選取的變數類型輸入值。
- 按一下核取符號來儲存您的定義。
- Apply the variable to a feature:
- 在「特徵」清單中連按兩下特徵來開啟它。
- For a sketch, you can right-click a dimension, select Configure dimensions and then either Configuration or Set to #<variable-name>
- 關閉特徵對話方塊。
- Test the value by selecting it in the Configurations list above the Feature list on the left side of the page:

在建立組態之後,您可以使用 功能表來在 Part Studio 中操作:
- 複製表格 - 複製整個組態輸入項,然後您可以將其貼入試算表中來保存記錄或編輯。您也可以從試算表中將其貼回至組態輸入項。請參考複製與貼上輸入項值及參數
- 複製輸入項 - 複製輸入項和跟值 (列),然後您可以將其貼入至另一 Part Studio 或組合件的「組態」面板中,然後使用「複製表格」的指令來加入參數。請參考複製與貼上輸入項。
- 複製所有輸入項 - 複製在「組態」面板中的所有輸入項與值 (列),然後您可以將其貼入至另一 Part Studio 或組合件的「組態」面板中,然後使用「複製表格」的指令來加入參數。請參考複製與貼上輸入項。
- 上移/下移 - 在「組態」面板中重新調整輸入項的順序。
- 重新命名 - 重新命名組態輸入項。
- 編輯 FeatureScript IDs - 這個對話方塊會變更組態輸入項的內部 FeatureScript 識別碼。在對話方塊內按一下來變更 ID。完成時請選擇右下角的 [斷開參考並變更 IDs]。
這個對話方塊通常是在需要於自訂 FeatureScript 特徵內部建立 Part Studio 時才有用。
- 從屬性中排除 - 請參考從受影響的屬性中排除組態。
- 顯示情形條件 - 請參考設定顯示情形條件。
- 刪除 - 選擇這個動作來立即刪除組態輸入項;系統不會發出任何警告。
對於所有表格,請使用環境選單 (按滑鼠右鍵) 進行對列或欄的操作:
- 切換至 - 當在非目前所選輸入項的列上按右鍵時,功能表項目會顯示開端為切換至不同輸入項。
- 設為預設 - 當在非目前預設輸入項的列上按右鍵時,選擇這個選項會將該列設定為新的預設。
- 複製列 - 建立重複的列;在準備要將新輸入項貼至這個表格時特別有用。詳細資訊請參考下方的組態輸入項表格中的表格複製與貼上。
- 上移 - 將所選的列向上移動一列。
- 下移 - 將所選的列向下移動一列。
- 重新命名 - 重新命名輸入項。
- 刪除列 - 刪除所選的列。
您可以按一下並拖曳表格中個別的欄邊線以調整欄的大小;在欄標籤堆疊的情況下,按一下並拖曳底部的標籤 (上方圖例中藍色箭頭所指)。

You can adjust the conditions under which a configuration input is visible.
Consider a part with two configuration inputs: Height and Width.
By default, a part of any height can have any width. But let's say the Extra Wide width is only available for the Tall height. In that case, we can set the conditions under which the Width input is visible.
- In the Configuration panel, click the configuration's three-dot button, and select Visibility conditions from the menu.
The Configuration visibility conditions dialog opens. The right panel shows a preview of the currently selected configurations. You can change the selected options directly in this panel to preview your settings. - Click Add condition.
- Click the first dropdown, and select the input that should control the visibility of this input. In this example, we'll select the Height input.
- Click the second dropdown, and select the conditions under which the input is available. In this example, the Width input is only available for the Tall height. The preview on the right updates to reflect your selections. You can see that the Width input is no longer available for the Short height in the image below.
- Click Save. Now, the Width input is only visible when the Tall height is selected, and the Width input table displays the Visibility conditions icon
.
Setting multiple conditions
Configuration conditions are additive; if we add a third configuration to the above example and set the conditions shown in the image below, the Large Fillet option will only be available for parts that have both the Tall height and Extra Wide width inputs.
When the Default width is set for the Tall height, the Fillet configuration is hidden.
Configuration inputs can only control the visibility of inputs that appear below them in the Configurations panel. In our example, the Width input can be controlled by the Height input, but not by the Fillet input.
Repairing visibility conditions
Visibility conditions are automatically repaired (removed) if the necessary inputs cannot be found.
For example, if the visibility of the Width input depends on the Height input, and the Height input is deleted, the visibility conditions for Width are automatically removed.
Visibility conditions for Width are calculated from the Height input.
Height input is deleted.
Visibility conditions are automatically repaired for the Width input.
提示
-
The visibility conditions you set are available in all Insert dialogs (i.e., when inserting a configured part into an assembly).
-
Hidden inputs always have their default value. In the example above, Short and Medium height parts have the Default width, even though no width options are set.
-
(Parts and Part Studios only): Configuration inputs that have been excluded from properties can only control the visibility of other inputs below them that have also been excluded from properties. In the example below, if Width is excluded from properties (indicated by the
icon), it can only control the Fillet visibility if Fillet is also excluded from properties.
- Use the Inputs dropdown in the Configuration visibility conditions dialog to view other inputs. You can select All inputs to view all inputs available.
- You can use the preview section of the Configuration visibility conditions dialog as a playground to test your configurations.
- Select the Show hidden inputs checkbox to show grayed-out inputs in the Configuration visibility conditions dialog.
-
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.
-
Changes made to visibility conditions are automatically reflected in all existing documents that reference the configured element.


您可以將組態輸入項複製與貼入 Part Studio 或組合件中,或是反向操作。這樣可快速與輕鬆地在設計間分享組態。
-
在 Part Studio 或組合件中開啟包含了要複製輸入項的「組態」面板。
-
按一下輸入項的三點功能表,然後選擇 [複製輸入項] 或 [複製所有輸入項]。
-
在 Part Studio 或組合件中開啟「組態」面板來貼上輸入項。
-
按一下「組態 Part Studio/組合件」旁的箭頭,然後選擇 [貼上輸入項]。
輸入項即被插入至「組態」面板中。 -
從新的 Part Studio 或組合件中選擇要組態的參數。繼續閱讀以了解如何將輸入項的值與參數複製到輸入項表格中。
注意:
- 您可以複製與貼上組態輸入項:可以在 Part Studios 與組合件之間,相同的文件中,以及不同的文件之間。
- 所有的名稱、顯示情形條件、FeatureScript ID、以及變數定義都會隨輸入項一起複製。
- 經複製的輸入項直到使用者登出之前都可使用。
- 系統不會維持複製輸入項與貼上輸入項之間的參考;一旦貼上之後,對原始組態的變更不會反映在貼上的輸入項中。
- 如果目標組態並沒有計算顯示情形所需要的所有輸入項,系統會自動修復 (移除) 貼上的顯示情形條件。
- 系統不會貼上有相同內部 FeatureScript ID 的組態輸入項。要解決這個問題,您可以刪除有相同內部 FeatureScript ID 的組態然後再次貼上。

您可以複製與貼入組態中或反向操作,以幫助輸入或編輯值。
複製值與參數:
- 開啟右上角的
功能表,就在 [+組態特徵] 功能的旁邊。
- 選擇 [複製表格]:
- 複製表格之後,您可以將其貼入試算表中:
請注意,欄名稱會與表格一起貼入 (如上所示)。您現在可以編輯表格,然後將其複製/貼回 Onshape 中:
- 僅選擇內有資料的列與欄 (不是欄名稱或標題),如下方藍色部分所示:
如果需要,您也可以使用額外的空白列來加長表格。只需要在選取複製指令時,將額外的列包含在試算表中。
- 送出一個「複製」的指令。
- 在 Onshape 組態表格中,按一下表格最左上方的儲存格。
- 送出一個「貼上」的指令:
Onshape 會自動以所複製的資料取代組態輸入項表格列與欄內的任何資料。Onshape 同時會自動包括各個輸入項的預設單位。
注意,如果從試算表中複製的列數多於 Onshape 組態輸入項表格中的列數,則在貼上的操作中會包括多的欄。Onshape 會在操作的過程中建立列。
不過,如果從試算表中複製的欄數多於 Onshape 組態輸入項表格中的欄數,則在貼上的操作中不會包括多的欄。Onshape 不會在操作的過程中建立欄位。不過您可以在貼上之前於組態表格中建立額外的欄 (參數)。

Onshape has a mechanism for also configuring properties for each of the configuration inputs and options you have previously defined, directly from the Configuration panel. You can configure part properties or appearance properties. If you have a professional or enterprise account, you can also configure custom properties.
- With an existing configuration input in the Configuration panel, click Configured properties at the top of the panel.
- Click the Properties for drop down to select the part or appearance to configure.
Parts and appearances that include configured properties are displayed with a check mark in the list: - Click Add property.
-
Select the property you wish to configure; properties are available for parts, appearances, and for custom properties. All the configuration inputs are added to the table.
- Double-click a cell in the Property column to edit it. Press Tab to move to the next row.
- To edit a value, type the new value and hit Enter to accept.
- To edit a dialog selection, make the new selections in the dialog, then click
to close the dialog.
- To edit a value, type the new value and hit Enter to accept.
-
Repeat as necessary to configure additional properties. The example below has both had part number and face appearance properties configured.
Note that if you have automatic part number generation turned on (through your Professional company numbering schemes or Enterprise numbering schemes), you can right-click in the Part number property column and select Generate next part number:

可以將某些組態表格從屬性中排除。當您不要在 已組態屬性表格中重複組態輸入項時相當有用。系統永遠會將經排除組態視為擁有其預設值。
例如,考慮一個彈簧零件。同時可為彈簧的直徑與高度使用組態。
彈簧是否壓縮會影響幾何,但不會影響零件編號;彈簧壓縮或不壓縮時都是同一個零件。若要不論彈簧高度來指定所有零件編號,您會需要將每個輸入項個別地加入至已組態屬性表格中,然後為每個輸入項指定零件編號。
為每個可能的組態設定零件編號。
如果您改採從屬性中排除 Compression 組態,您可以僅根據直徑來指定零件編號:
從「已組態屬性」表格中排除 Compression 組態表格。系統會不考慮彈簧高度而設定零件編號。
從零件屬性中排除一個組態
-
在組態面板中,按一下組態的三點按鈕,然後從功能表中選擇從屬性中排除。從屬性中排除圖示
會出現在組態名稱旁。
將已排除組態加回至零件屬性中
-
在組態面板中,按一下組態的三點按鈕,然後從功能表中選擇包括在屬性中。
將已組態零件插入至組合件中
When inserting a part with excluded configurations into an assembly, you'll see the Excluded from properties icon next to the part.
發行有排除組態的零件
當發行有已排除組態的零件時,您會在建立發行候選對話方塊中看到 從屬性中排除圖示。
注意
- 系統永遠會將經排除組態視為擁有其預設值。發行套件與修訂版參考永遠會使用這些預設值。
- 材料表 (BOM) 與發行管理會將僅在排除組態中不同的零件視為相同的零件。
- 如果發行了有排除組態的項目,會視為發行了該組態的所有值。
- 系統仍會將排除的組態包括在:
- 幾何計算
- 已計算屬性
- 質量屬性工具
- 如果您看到在 BOM 與質量屬性工具中所提供的質量有所差異,有可能是因為在 BOM 中忽略了某些組態。

您可以使用在 Part Studio 建立的組態輸入項來測試結果,並使用結果資訊來調整設計理念。不過, 建立組態輸入項的重點是讓您能夠在像是建立組合件與工程圖的生產流程中有使用不同零件的選項。
若要在 Part Studios 中測試組態,請使用「特徵」清單上方的「組態」區域來選擇組態輸入項,以了解輸入項如何影響 Part Studio 中的零件:
在瀏覽器版本的 Part Studio 中特徵清單「組態」部分的範例
在 Android 裝置的 Part Studio 中特徵清單「組態」部分的範例,下拉清單是開啟的
在 iOS 裝置上 Part Studio 中特徵清單「組態」部分的範例
當將零件插入至組合件或工程圖時,在所有作業平台上 (瀏覽器、iOS 與 Android) 於插入過程中直接在「插入」對話方塊中選擇所需的輸入項:
上方是瀏覽器版本的插入對話方塊
上方是 Android 中的插入對話方塊
上方是 iOS 中的插入對話方塊
在組合件中,經組態的零件會在「實例」清單中以 圖示標出。

iOS and Android support for configurations is limited to the following:
-
Viewing the Configuration panel (
) on the right.
-
Selecting between Configurations in the left side panel (above the Features list):
Selecting Configurations on iOS
-
(iOS only) Visibility conditions are applied, if they are present in the configuration.
You cannot create or edit configurations or visibility conditions from the iOS or Android platforms. This can only be done from the desktop (browser) platform.
關於在「學習中心」的其他資源,請參考:Self-Paced Courses > Configurations。您也可以參照此處的學習途徑課程:Introduction to Part Configurations (需要有 Onshape 帳戶),與此處的技術簡報文章:Parametric Variables vs Configuration Variables (需要有 Onshape 帳戶)。