Variable Studio Configurations
In Onshape, you can configure Variable Studios similar to the way you can configure Part Studios and Assemblies.
You can configure any variable value or description. All values and descriptions you configure in one Variable Studio are referred to as a configuration. One configuration can include multiple configuration inputs.
The configuration inputs you define in a Variable Studio become options in the Insert dialog when you insert the Variable Studio into another tab or document.

- Click the
icon on the right side of the Variable Studio window to open the Configuration panel.
- The Variable Studio cannot be configured while being automatically referenced. Deselect the Insert into all Part Studios and Assemblies checkbox. (When you insert a configured variable table into a Part Studio or assembly, you must choose which configurations to insert.)
- Click Configure Variable Studio. A configuration input table appears in the Configuration panel.
- Click in the first row to activate it, and enter the input value names in the first column. Press Tab to move to the next row. The blue bar to the left of the row indicates the currently selected configuration in the Variable Studio.
- Right-click a variable value or description and click Configure on the context menu to add it to the configuration table.
- Continue right-clicking and selecting Configure to add additional values or descriptions to the table. The selections are added to the table with their default values, and are highlighted in orange in the Variable Studio.
- Double-click and edit the values in the configuration table as necessary.

- At the bottom of the Configuration panel, click the Add configuration input arrow and select the type of configuration to add. Clicking the button instead of the arrow automatically inserts a List configuration type.
- Select an option from the menu:
- List - Creates a list of selectable values to present at insertion.
Checkbox - Creates a checkbox to check/uncheck during insertion.
Configuration variable - Creates a variable that can be used in any feature or in FeatureScript.
-
Edit the values in the configuration input table as needed.

See Basic steps.

- Click the Add configuration input arrow and select Checkbox.
- Add a Name for the input in the dialog that appears.
- Use the Default option to specify if the configuration should be checked or unchecked by default. This can be changed later.
- Click the green check mark to add the input to the Configuration panel.
- Right-click the value or description to configure in the Variable Studio, and click Configure with to add the value to the input.
- Edit the values in the input as needed.

- Click the Add configuration input arrow and select Configuration variable.
- Add a Name for the variable in the dialog that appears.
- Select a type for the variable. Choose from Length, Angle, Integer, Real, or Text.
- Enter the values for the variable.
- Click the green check mark to add the input to the Configuration panel.
- Enter the values for the variable.
- Right-click a value or description in the Variable Studio and select Set to...
The value is added to the Configuration panel

Configured Variable Studios cannot be released.

-
In the Insert Variable Studio dialog, select the configured Variable Studio.
-
Make selections in the dialog to specify which configurations you want, then click Generate.
Click the Set to last viewed configuration dropdown (
) to select the last active configuration in the Variable Studio, or select Reset to default to set all inputs to their default values.
-
Click the Variable Studio to insert it into your Variable table, or select individual variables from the generated list.

- Insert the configured Variable Studio into the Variable table as described in the last section.
- In the Variable table, click the three-dot menu button and select Edit reference.
- In the Update Variable Studio dialog, right-click the configuration and select Configure (or Configure with if multiple configuration inputs exist in the Part Studio or assembly).
- A notification appears that the Variable Studio has been added to the Part Studio/Assembly configuration. Click the checkmark to close the dialog.
- Open the Configuration panel in the Part Studio or assembly. The Variable Studio configuration becomes a feature (column) in the Configuration panel.

The examples in this section show a configured Part Studio. Functionality is the same for configured Variable Studios.
구성 가시성 조건 대화상자를 사용하면 구성에 로직을 추가할 수 있으므로 특정 입력 및 옵션을 사용할 수 있는 시기를 제어할 수 있습니다.

높이 및 폭이라는 두 개의 입력이 있는 파트를 예로 들어 보겠습니다.
기본적으로 모든 높이의 일부는 원하는 너비를 가질 수 있습니다. 하지만 엑스트라 와이드 너비는 톨 높이에서만 사용할 수 있다고 가정해 보겠습니다. 이 경우, 너비 입력이 표시되는 조건을 설정할 수 있습니다.
- 구성 패널에서 입력의 점 세 개 버튼을 클릭하고 메뉴에서 가시성 조건을 선택합니다.
구성 가시성 조건 대화상자가 열립니다. 오른쪽 창에는 현재 선택한 구성의 미리 보기가 표시됩니다. 이 패널에서 선택한 옵션을 변경하여 설정을 미리 볼 수 있습니다. - 조건 추가를 클릭합니다.
- 첫 번째 드롭다운을 클릭하고 이 입력의 가시성을 제어할 입력을 선택합니다. 이 예제에서는 높이 입력을 선택합니다.
- 두 번째 드롭다운에서 특정 옵션을 선택하려면 is를 선택하고, 옵션 범위를 선택하려면 is between을 선택합니다.
- Is: 나타나는 세 번째 드롭다운을 클릭하고 입력에 허용된 옵션을 선택합니다.
- Is between: Click the third dropdown and select the first allowed option in the range. Click the fourth dropdown and select the final allowed option in the range.
이 예시에서 너비 입력은 톨 높이에만 사용할 수 있습니다. 오른쪽 미리보기는 선택 사항을 반영하여 업데이트됩니다. 아래 이미지에서 기본 높이에는 너비 입력을 더 이상 사용할 수 없음을 확인할 수 있습니다.
- 저장을 클릭합니다. 이제 너비 입력은 톨 높이를 선택한 경우에만 표시되며 너비 입력 테이블에 가시성 조건 아이콘
이 표시됩니다.

구성 가시성 조건 대화상자의 옵션 규칙 설정을 사용하여 특정 옵션이 표시되어야 하는 조건을 지정할 수 있습니다.
옵션 규칙 로직은 목록 입력에 대해서만 설정할 수 있습니다.
- 구성 가시성 조건 대화상자에서 입력을 확장하고 옵션 규칙 추가를 클릭합니다. 대화상자에 새 섹션이 나타납니다.
- 표시 라인에서 제어 중인 옵션을 선택합니다.
- 옵션: 나타나는 드롭다운을 클릭하고 조건을 설정할 옵션을 선택합니다.
- 범위: 첫 번째 드롭다운을 클릭하고 범위의 첫 번째 옵션을 선택합니다. 두 번째 드롭다운을 클릭하고 범위에서 마지막 옵션을 선택합니다. 범위에는 특정 옵션이 포함되며 겹치는 범위도 허용됩니다.
- When 라인에서:
- 첫 번째 드롭다운에서 입력을 선택합니다.
- 특정 옵션을 선택하려면 is를 선택하고, 다양한 옵션을 선택하려면 is between을 선택합니다.
- Is: 나타나는 드롭다운을 클릭하고 옵션에 허용되는 값을 선택합니다.
- Is between: 첫 번째 드롭다운을 클릭하고 범위에서 첫 번째로 허용된 옵션을 선택합니다. 두 번째 드롭다운을 클릭하고 범위에서 마지막으로 허용된 옵션을 선택합니다.
-
조건 추가를 클릭하고 이 단계를 반복하여 구성 내에 로직을 계속 추가합니다.
옵션 규칙 내의 조건은 AND 문으로 함께 결합됩니다. 제어된 옵션을 표시하려면 모든 조건을 충족해야 합니다.
- 옵션 규칙 추가를 다시 클릭하여 다른 옵션에 대한 조건을 추가합니다.
- 저장을 클릭합니다.
아래 예에서 “Deep” 옵션은 Area가 Default 이상인 경우에만 허용됩니다. “표준” 옵션은 면적이 대형, 기본값 또는 소형인 경우에만 사용할 수 있습니다. “얕은” 옵션은 면적이 작거나 작은 경우에만 사용할 수 있습니다.
다음 예에서는 겹치는 범위를 사용하여 가시성 조건을 지정합니다.
아래 예에서는 옵션과 범위 컨트롤을 조합하여 필요한 로직을 설정합니다.

입력 조건은 가산적입니다. 위 예제에 세 번째 구성을 추가하고 아래 이미지에 표시된 조건을 설정하면 대형 필렛 옵션은 톨 높이 및 엑스트라 와이드 너비 입력이 모두 있는 파트에만 사용할 수 있습니다.
톨 높이로 기본 너비를 설정하면 필렛 구성이 숨겨집니다.
구성 입력은 구성 패널에서 입력 아래에 나타나는 입력의 가시성만 제어할 수 있습니다. 이 예에서 너비 입력은 높이 입력으로 제어할 수 있지만 필렛 입력으로는 제어할 수 없습니다.

필요한 입력 또는 옵션을 찾을 수 없는 경우 가시성 상태가 자동으로 복구(제거)됩니다.
예를 들어, 폭 입력의 가시성이 높이 입력에 따라 달라지고 높이 입력이 삭제되면 폭에 대한 가시성 조건이 자동으로 제거됩니다. 삭제되거나 이동된 개별 옵션에도 동일하게 적용됩니다.이 예에서는 높이 입력도 필렛 옵션에서 제거되었습니다.
작업공간에 경고가 표시되고 대화상자에서 조건이 제거됩니다.

-
설정한 가시도 조건과 옵션 규칙은 모든 삽입 대화상자(예: 구성된 파트를 어셈블리에 삽입할 때) 에서 사용할 수 있습니다. 가시성 조건에 대한 변경 사항은 구성된 요소를 참조하는 모든 기존 문서에 자동으로 반영됩니다.
-
숨겨진 입력은 항상 기본값을 갖습니다. 이 페이지의 첫 번째 예에서는 너비 옵션이 설정되지 않았더라도 짧은 높이 및 중간 높이 부품에는 기본 너비가 있습니다.
-
구성 입력에 표시되는 옵션이 없는 경우 해당 입력은 숨겨지고 기본값으로 간주됩니다.
-
-
입력 또는 옵션을 축소하면 가시성 조건 요약이 대화상자에 표시됩니다.
-
(파트 및 Part Studio만 해당): 속성에서 제외된 구성 입력은 속성에서 제외된 입력 아래에 있는 다른 입력의 가시성만 제어할 수 있습니다. 아래 예에서 너비가 속성에서 제외된 경우(
아이콘으로 표시) 필렛도 속성에서 제외된 경우에만 필렛 가시성을 제어할 수 있습니다.
-
(파트 및 Part Studio만 해당): 속성에서 제외된 구성 입력은 릴리스 패키지 및 리비전 참조 값에서 기본값을 갖는 것으로 처리됩니다. 가시성 조건으로 인해 기본값을 사용할 수 없는 경우, 첫 번째로 표시되는 값이 사용됩니다.
- 구성 가시성 조건 대화상자의입력 드롭다운을 사용하여 다른 입력을 볼 수 있습니다. 모든 입력을 선택하여 사용 가능한 모든 입력을 볼 수 있습니다.
- 대화상자에 여러 입력이 표시되면 점 3개 버튼을 클릭하여 모든 입력을 확장하거나 축소합니다.
- 구성 가시성 조건 대화상자의 미리 보기 섹션을 플레이그라운드로 사용하여 구성을 테스트할 수 있습니다.
- 대화 상자에서 회색으로 표시된 입력을 제거하려면 숨겨진 입력 표시 확인란을 선택 취소합니다.
- 대화 상자에서 회색으로 표시된 입력을 제거하려면 숨겨진 입력 표시 확인란을 선택 취소합니다.
-
구성된 파트를 어셈블리에 추가할 때 숨겨진 입력은 구성 패널에서 회색으로 표시됩니다.
-
모든 입력에 대한 구성 가시성 조건 대화상자를 열려면 구성 선택기에서
을 클릭합니다. 해당 입력에 대한 대화상자를 열려면 구성 패널에서
을 클릭합니다.

The examples in this section show a configured Part Studio. Functionality is the same for configured Variable Studios.

You can copy and paste a configuration input into and out of Part Studios, assemblies, and Variable Studios. This makes it quick and easy to share configurations between designs.
-
Open the Configuration panel in the Part Studio, assembly, or Variable Studio that contains the input to copy.
-
Click the input's three-dot menu and select Copy input or Copy all inputs.
-
Open the Configuration panel in the tab to paste the input.
-
Click the arrow next to Configure Part Studio/Assembly/Variable Studio and select Paste inputs.
입력이 구성 패널에 삽입됩니다. -
Select the parameters to configure from the new tab. Continue reading to learn how to now copy input values and parameters into the input tables.
노트:
- You can copy and paste configuration inputs: between Part Studios, assemblies and Variable Studios; within the same document; and between different documents.
- 모든 이름, 가시성 조건, FeatureScript ID 및 변수 정의가 입력과 함께 복사됩니다.
- 복사된 입력은 사용자가 로그아웃할 때까지 사용할 수 있습니다.
- 복사한 입력과 붙여넣은 입력 간의 참조는 유지되지 않습니다. 붙여넣은 후에는 원래 구성 입력에 대한 변경 사항이 붙여넣은 입력에 반영되지 않습니다.
- 대상 구성에 가시성 계산에 필요한 모든 입력이 없는 경우 붙여넣은 가시성 조건이 자동으로 수정(제거)됩니다.
- 내부 FeatureScript ID가 동일한 구성 입력은 붙여넣지 않습니다. 이 문제를 해결하려면 동일한 내부 FeatureScript ID를 가진 구성 입력을 삭제하고 다시 붙여넣을 수 있습니다.

값을 입력하거나 편집하는 데 도움이 되도록 구성에 복사하고 붙여넣을 수 있습니다.
값과 매개변수 복사하기
- Open the
menu in the upper right corner of the Configuration panel.
- Select Copy table:
- 표를 복사했으면 스프레드시트에 붙여넣을 수 있습니다.
표에는 위와 같이 열 이름도 표시됩니다. 이제 표를 편집해서 Onshape로 다시 복사/붙여넣을 수 있습니다.
-
또한 원하는 경우, 표에 비어 있는 추가 행을 삽입할 수 있습니다. 복사 명령을 선택할 때 스프레드시트에 추가 행을 포함시키기만 하면 됩니다.
- Issue a Copy command.
- Onshape 구성 표에서 표의 왼쪽 상단 셀을 클릭합니다.
- Issue a keyboard Paste command:
Onshape는 구성 입력 표의 행과 열에 있는 데이터를 복사한 데이터로 자동으로 대체합니다. 또한 Onshape에는 각 입력 매개변수에 대한 기본 단위가 자동으로 포함됩니다.
Onshape 구성 입력 표에 스프레드시트에서 복사한 것보다 행 수가 많을 경우, 그러한 행은 붙여넣기에 포함되지 않습니다. Onshape는 즉시 필요한 행을 생성합니다.
그러나 Onshape 구성 입력 표에 스프레드시트에서 복사한 것보다 열 수가 많을 경우, 그러한 열은 붙여넣기에 포함되지 않습니다. Onshape는 즉시 필요한 열을 생성하지 않습니다. 단, 붙여넣기 전에 구성 표에서 추가 열(매개변수)을 생성할 수는 있습니다.

- Click an input name to rename it.
- To remove a value or description from a configuration, right-click it in the Variable Studio and click Unconfigure or Unconfigure from.
- To modify options in a configuration input, right-click the row.
Select from one of the following options:
- Switch to - Set the configuration to the option specified in the selected row.
- Set as default - Set the selected row as the default for the input.
- Duplicate row - Copy the selected row and insert the copy into the table.
- Move up/Move down - Reorder the rows in the table.
- Delete row - Delete the row from the table.
- Delete column - Delete the column from the table. The first column cannot be deleted.
- To modify a configuration input table, click its three-dot menu on the right side of the Configuration panel.
Select from one of the following options:
- Copy table/inputs/all inputs - Copy and paste input tables and values. See Copying configurations.
- Move up/move down - Reorder the tables in the Configuration panel.
- Rename - Rename a configuration input. You can also click an input name in the Configuration panel to rename it.
- Edit internal IDs - Open a dialog to change the internal FeatureScript identifiers of the configuration input. When finished, select Break reference and change IDs.
- 가시성 조건 - 가시성 조건 설정을 참조하십시오.
- Expand/collapse all inputs - Expand or collapse all inputs in the Configuration panel.
- Delete - Delete the configuration input table.