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.

- 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.
El cuadro de diálogo Condiciones de visibilidad de configuración sirve para agregar lógica a las opciones de configuración, de modo que pueda controlar cuándo están disponibles determinados valores de ajuste y opciones.

Considere una pieza con dos valores de ajuste: altura y ancho.
De forma predeterminada, una pieza de cualquier altura puede tener cualquier ancho. Pero supongamos que el ancho extra ancho solo está disponible para la altura alta. En ese caso, podemos establecer las condiciones en las que la entrada Ancho es visible.
- En el panel Configuración, haga clic en el botón de tres puntos del ajuste y seleccione Condiciones de visibilidad en el menú.
Se abre el cuadro de diálogo Condiciones de configuración de la visibilidad. En el panel derecho se muestra una vista previa de los ajustes de configuración que están seleccionadas. Puede cambiar las opciones seleccionadas en este panel para obtener una vista previa de la configuración. - Haga clic en Agregar condición.
- Haga clic en el primer menú desplegable y seleccione la entrada que debe controlar la visibilidad de esta entrada. En este ejemplo, seleccionaremos la entrada Altura.
- En el segundo menú desplegable, elija es para seleccionar opciones específicas o está entre para seleccionar un intervalo de opciones:
- Es: haga clic en el tercer menú desplegable que aparece y seleccione las opciones permitidas para el ajuste.
- Está entre: 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.
En este ejemplo, el ajuste Ancho solo está disponible para la altura Alta. La vista previa de la derecha se actualiza para reflejar sus selecciones. Puede ver que el ajuste Ancho ya no está disponible para la altura Predeterminada en la imagen de abajo.
- Haga clic en Guardar. Ahora, la entrada Ancho solo está visible cuando se selecciona la Altura alta y la tabla de entrada Ancho muestra el ícono de condiciones de visibilidad
.

Puede utilizar los ajustes de configuración de la regla de opciones del cuadro de diálogo Condiciones de visibilidad de configuración para especificar las condiciones en las que deben aparecer determinadas opciones.
La lógica de las reglas de opción solo se puede configurar para valores de ajuste de listas.
- En el cuadro de diálogo Condiciones de visibilidad de configuración, expanda un ajuste y haga clic en Agregar regla de opción. Aparecerá una nueva sección en el cuadro de diálogo:
- En la línea Mostrar, elija las opciones que se están controlando.
- Opciones: haga clic en el menú desplegable que aparece y seleccione las opciones para las que quiere establecer las condiciones.
- Intervalo: haga clic en el primer menú desplegable y seleccione la primera opción del intervalo. Haga clic en el segundo menú desplegable y seleccione la última opción del intervalo. Los intervalos incluyen las opciones específicas y se permite que haya intervalos superpuestos.
- En la línea Cuándo:
- Seleccione el ajuste del primer menú desplegable.
- Elija Es para seleccionar opciones específicas o Está entre para seleccionar un intervalo de opciones.
- Es: haga clic en el menú desplegable que aparece y seleccione los valores permitidos para la opción.
- Está entre: haga clic en el primer menú desplegable y seleccione la primera opción permitida del intervalo. Haga clic en el segundo menú desplegable y seleccione la última opción permitida del intervalo.
-
Siga agregando lógica a la configuración haciendo clic en Agregar condición y repitiendo esta serie de pasos.
Las condiciones de una regla de opción se combinan como sentencias AND; se deben cumplir todas las condiciones para que las opciones controladas estén visibles.
- Agregue condiciones para otras opciones haciendo clic de nuevo en Agregar regla de opción.
- Haga clic en Guardar.
En el ejemplo siguiente, la opción «Profundo» solo está permitida cuando Área está establecida en Predeterminada o Más grande. La opción «Estándar» solo está permitida cuando Área está establecida en Grande, Predeterminada o Pequeña. La opción «Poco profundo» solo está permitida cuando Área está establecida en Pequeña o Más pequeña:
En el siguiente ejemplo, se usan intervalos superpuestos para especificar las condiciones de visibilidad:
En el siguiente ejemplo, se utiliza una combinación de controles de opciones e intervalos para establecer la lógica requerida.

Las condiciones de los valores de ajuste son aditivas; si agregamos una tercera configuración al ejemplo anterior y establecemos las condiciones que se muestran en la imagen siguiente, la opción Redondeo grande solo estará disponible para las piezas que tengan los valores de ajuste Altura alta y Extraancho.
Cuando se establece el ajuste de Ancho predeterminado para Altura alta, la configuración del redondeo se oculta.
Los ajustes de configuración solo pueden controlar la visibilidad de las ajustes que aparecen debajo de ellos en el panel Configuraciones. En el ejemplo, el ajuste Ancho se puede controlar mediante el ajuste Altura, pero no mediante el ajuste Redondeo.

Las condiciones de visibilidad se reparan (quitan) automáticamente si no se encuentran los valores de ajuste o las opciones necesarios.
Por ejemplo, si la visibilidad del ajuste Ancho depende del valor Altura y se elimina el valor Altura, las condiciones de visibilidad de Ancho se quitarán automáticamente. Lo mismo se aplica a las opciones individuales que se eliminan o mueven. En este ejemplo, el ajuste Altura también se ha quitado de las opciones de Redondeo.
Verá una advertencia en el área de trabajo, y las condiciones se quitarán del cuadro de diálogo:

-
Las condiciones de visibilidad y las reglas de opción que defina estarán disponibles en todos los cuadros de diálogo Insertar (es decir, al insertar una pieza configurada en un ensamblaje). Los cambios realizados en las condiciones de visibilidad se reflejarán automáticamente en todos los documentos existentes que hagan referencia al elemento configurado.
-
Los ajustes ocultos siempre tienen su valor predeterminado. En el primer ejemplo de esta página, las piezas de altura Corta e Intermedia tienen el ancho Predeterminado, aunque no se haya establecido ninguna opción de ancho.
-
Si un ajuste de configuración no tiene opciones visibles, se oculta y asume su valor predeterminado.
-
-
Cuando se contrae el ajuste o la opción, se muestra un resumen de las condiciones de visibilidad en el cuadro de diálogo.
-
(Solo Parts y Part Studios): las entradas de configuración que se han excluido de las propiedades solo pueden controlar la visibilidad de otras entradas que se encuentran debajo de ellas y que también se han excluido de las propiedades. En el ejemplo siguiente, si el ancho está excluido de las propiedades (indicado por el ícono
), solo puede controlar la visibilidad del redondeo si también está excluido de las propiedades.
-
(Solo piezas y Part Studios): los ajustes de configuración que se han excluido de las propiedades se consideran como si tuvieran sus valores predeterminados en los paquetes de lanzamiento y en los valores de referencia de revisión. Si las condiciones de visibilidad impiden utilizar el valor predeterminado, se utiliza el primer valor visible.
- Utilice el menú desplegable Entradas del cuadro de diálogo de configuración de las condiciones de visibilidad para ver otras entradas. Puede seleccionar Todas las entradas para ver todas las entradas disponibles.
- Cuando aparezcan varios ajustes en el cuadro de diálogo, haga clic en el botón de tres puntos para expandir o contraer todos los ajustes.
- Puede usar la sección de vista previa del cuadro de diálogo Configuración de las condiciones de visibilidad como campo de prueba para los ajustes de configuración.
- Desactive la casilla Mostrar ajustes ocultos para quitar los ajustes atenuados del cuadro de diálogo.
- Desactive la casilla Mostrar ajustes ocultos para quitar los ajustes atenuados del cuadro de diálogo.
-
Cuando agregue piezas configuradas a los ensamblajes, los ajustes ocultos aparecerán atenuados en el panel Opciones de configuración.
-
Haga clic en
en el selector de configuraciones para abrir el cuadro de diálogo de configuración de las condiciones de visibilidad para todas las entradas. Haga clic en
en el panel Configuraciones para abrir el cuadro de diálogo de esa entrada.

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.
Los ajustes se insertan en el panel Configuración. -
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.
Notas:
- You can copy and paste configuration inputs: between Part Studios, assemblies and Variable Studios; within the same document; and between different documents.
- Todos los nombres, condiciones de visibilidad, ID de FeatureScript y definiciones de variables se copian con el ajuste.
- Los ajustes copiados estarán disponibles hasta que el usuario cierre sesión.
- Las referencias entre el ajuste copiado y el ajuste pegado NO se conservan; una vez pegados, los cambios en el ajuste de configuración original NO se reflejan en los ajustes pegados.
- Las condiciones de visibilidad pegadas se reparan (eliminan) automáticamente si la configuración de destino no tiene todos los ajustes necesarios para calcular la visibilidad.
- Los ajustes de configuración que tienen los mismos ID internos de FeatureScript no se pegan. Para solucionarlo, puede eliminar el ajuste de configuración que tiene el mismo ID interno de FeatureScript y volver a pegarlo.

Para facilitar la adición o edición de valores, se puede copiar y pegar dentro y fuera de una configuración.
Para copiar valores y parámetros, haga lo siguiente:
- Open the
menu in the upper right corner of the Configuration panel.
- Select Copy table:
- Una vez copiada la tabla, puede pegarla en una hoja de cálculo:
Tenga en cuenta que los nombres de las columnas también vienen con la tabla, como se muestra arriba. Ahora puede editar la tabla y copiar/pegarla de nuevo en Onshape:
- Seleccione solo las filas y las columnas con datos (no los nombres de columna o encabezados), como se muestra en azul a continuación:
También puede rellenar la tabla con filas vacías adicionales, si lo desea. Solo tiene que incluir las filas adicionales en la hoja de cálculo al seleccionar el comando copiar.
- Issue a Copy command.
- En la tabla Configuración Onshape, haga clic en la celda superior izquierda de la tabla.
- Issue a keyboard Paste command:
Onshape reemplaza automáticamente los datos que estaban en las filas y columnas de la tabla de ajuste de configuración con los datos que se copiaron. Onshape también incluye las unidades predeterminadas para cada entrada, automáticamente.
Tenga en cuenta que si hay más filas copiadas de la hoja de cálculo que de la tabla de ajustes de configuración de Onshape, esas filas se incluirán en el pegado. OnShape crea las filas sobre la marcha.
Sin embargo, si hay más columnas copiadas de la hoja de cálculo que en la tabla de ajustes de configuración de Onshape, esas columnas no se incluyen en el pegado. Onshape aún no crea columnas sobre la marcha. Sin embargo, puede crear columnas adicionales (parámetros) en la tabla de configuración antes de pegarlas.

- 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.
- Condiciones de visibilidad: consulte Configuración de las condiciones de visibilidad.
- Expand/collapse all inputs - Expand or collapse all inputs in the Configuration panel.
- Delete - Delete the configuration input table.