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.
La boîte de dialogue de Conditions de visibilité de la configuration vous permet d'ajouter de la logique à vos configurations afin de contrôler la disponibilité de certaines entrées et options.

Considérons une pièce avec deux entrées : hauteur et largeur.
Par défaut, une pièce de n'importe quelle hauteur peut avoir n'importe quelle largeur. Mais imaginons que la largeur extra large est disponible uniquement pour la hauteur haute. Dans ce cas, nous pouvons définir les conditions dans lesquelles l'entrée Largeur est visible.
- Dans le panneau Configuration, cliquez sur le bouton à trois points de l'entrée, puis sélectionnez Conditions de visibilité dans le menu.
La boîte de dialogue de Conditions de visibilité des configurations s'ouvre. Le volet droit affiche un aperçu des configurations actuellement sélectionnées. Vous pouvez modifier les options sélectionnées directement dans ce panneau pour prévisualiser vos paramètres. - Cliquez sur Ajouter une condition.
- Cliquez sur la première liste déroulante et sélectionnez l'entrée qui doit contrôler la visibilité de cette entrée. Dans cet exemple, nous allons sélectionner l'entrée Hauteur.
- Dans la deuxième liste déroulante, choisissez soit est pour sélectionner des options spécifiques, soit est entre pour sélectionner une gamme d'options :
- Est : cliquez sur la troisième liste déroulante qui apparaît et sélectionnez les options autorisées pour la saisie.
- 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.
Dans cet exemple, l'entrée Largeur n'est disponible que pour la Grande hauteur. L'aperçu sur la droite est mis à jour pour refléter vos sélections. Vous pouvez voir que l'entrée Largeur n'est plus disponible pour la hauteur par défaut dans l'image ci-dessous.
- Cliquez sur Enregistrer. Désormais, l'entrée Largeur n'est visible que lorsque la Hauteur haute est sélectionnée, et le tableau d’entrée Largeur affiche l'icône des conditions de visibilité
.

Vous pouvez utiliser les paramètres de règle d'option dans la boîte de dialogue des Conditions de visibilité de la configuration pour spécifier les conditions dans lesquelles certaines options doivent apparaître.
La logique des règles d'option ne peut être définie que pour les entrées de liste.
- Dans la boîte de dialogue Conditions de visibilité de la configuration, développez une entrée et cliquez sur Ajouter une règle d'option. Une nouvelle section apparaît dans la boîte de dialogue :
- Dans la ligne Afficher, choisissez les options qui sont contrôlées.
- Options : cliquez sur la liste déroulante qui apparaît et sélectionnez les options pour lesquelles vous souhaitez définir les conditions.
- Plage : cliquez sur la première liste déroulante et sélectionnez la première option de la gamme. Cliquez sur la deuxième liste déroulante et sélectionnez la dernière option de la gamme. Les plages incluent les options spécifiques et les plages qui se chevauchent sont autorisées.
- Dans la ligne Quand :
- sélectionnez l'entrée dans la première liste déroulante.
- Choisissez soit est pour sélectionner des options spécifiques, soit est entre pour sélectionner une gamme d'options.
- Est : cliquez sur la liste déroulante qui apparaît et sélectionnez la ou les valeurs autorisées pour l'option.
- Est entre : cliquez sur la première liste déroulante et sélectionnez la première option autorisée de la plage. Cliquez sur la deuxième liste déroulante et sélectionnez la dernière option autorisée dans la plage.
-
Continuez à ajouter de la logique dans la configuration en cliquant sur Ajouter une condition et en répétant cette série d'étapes.
Les conditions d'une règle d'option sont combinées sous forme d'instructions AND (ET) ; toutes les conditions doivent être remplies pour que les options contrôlées soient visibles.
- Ajoutez des conditions pour les autres options en cliquant à nouveau sur Ajouter une règle d'option.
- Cliquez sur Enregistrer.
Dans l'exemple ci-dessous, l'option « Deep » (« Profond ») n'est autorisée que lorsque la zone est définie par défaut ou supérieure. L'option « Standard » n'est autorisée que lorsque la zone est grande, par défaut ou petite. L'option « Shallow » (« Peu profond ») n'est autorisée que lorsque la zone est petite ou plus petite :
L'exemple suivant utilise des plages qui se chevauchent pour spécifier les conditions de visibilité :
L'exemple ci-dessous utilise une combinaison de commandes d'options et de plages pour définir la logique requise.

Les conditions d'entrée s'additionnent ; si nous ajoutons une troisième configuration à l'exemple ci-dessus et que nous définissons les conditions indiquées dans l'image ci-dessous, l'option Grand congé sera disponible uniquement pour les pièces qui ont à la fois les entrées Grande hauteur et Largeur extra large.
Lorsque la largeur par défaut est définie pour la hauteur haute, la configuration du congé est masquée.
Les entrées de configuration peuvent uniquement contrôler la visibilité des entrées qui apparaissent en dessous dans le panneau Configurations. Dans l'exemple, l'entrée Largeur peut être contrôlée par l'entrée Hauteur, mais pas par l'entrée Congé.

Les conditions de visibilité sont automatiquement réparées (supprimées) si les entrées ou options nécessaires sont introuvables.
Par exemple, si la visibilité de l'entrée Largeur dépend de l'entrée Hauteur et que l'entrée Hauteur est supprimée, les conditions de visibilité pour la Largeur sont automatiquement supprimées. Il en va de même pour les options individuelles qui sont supprimées ou déplacées. Dans cet exemple, l'entrée Hauteur a également été supprimée des options de congé.
Un avertissement s'affiche dans votre espace de travail et les conditions sont supprimées dans la boîte de dialogue :

-
Les conditions de visibilité et les règles d'options que vous définissez sont disponibles dans toutes les boîtes de dialogue Insérer (c'est-à-dire lors de l'insertion d'une pièce configurée dans un assemblage). Les modifications apportées aux conditions de visibilité sont automatiquement répercutées dans tous les documents existants qui font référence à l'élément configuré.
-
Les entrées masquées ont toujours leur valeur par défaut. Dans le premier exemple de cette page, les parties de hauteur courte et moyenne ont la largeur par défaut, même si aucune option de largeur n'est définie.
-
Si aucune option n'est visible sur une entrée de configuration, elle est masquée et prend sa valeur par défaut.
-
-
Un résumé des conditions de visibilité s'affiche dans la boîte de dialogue lorsque l'entrée ou l'option est réduite.
-
(Pièces et Ateliers des pièces uniquement) : les entrées de configuration qui ont été exclues des propriétés peuvent uniquement contrôler la visibilité des autres entrées situées en dessous d'elles qui ont également été exclues des propriétés. Dans l'exemple ci-dessous, si la largeur est exclue des propriétés (indiquée par l’icône
), elle ne peut contrôler la visibilité du congé que si celui-ci est également exclu des propriétés.
-
(Pièces et Ateliers des pièces uniquement) : les entrées de configuration qui ont été exclues des propriétés sont traitées comme ayant leurs valeurs par défaut dans les packages de release et les valeurs de référence de révision. Si les conditions de visibilité empêchent d'utiliser la valeur par défaut, la première valeur visible est utilisée.
- Utilisez la liste déroulante Entrées de la boîte de dialogue des conditions de visibilité de la configuration pour afficher les autres entrées. Vous pouvez sélectionner Toutes les entrées pour afficher toutes les entrées disponibles.
- Lorsque plusieurs entrées sont affichées dans la boîte de dialogue, cliquez sur le bouton à trois points pour développer ou réduire toutes les entrées.
- Vous pouvez utiliser la section d'aperçu de la boîte de dialogue Conditions de visibilité des configurations comme terrain de jeu pour tester vos configurations.
- Décochez la case Afficher les entrées masquées pour supprimer les entrées grisées de la boîte de dialogue.
- Décochez la case Afficher les entrées masquées pour supprimer les entrées grisées de la boîte de dialogue.
-
Lorsque vous ajoutez des pièces configurées à des assemblages, les entrées masquées sont grisées dans le panneau Configurations.
-
Cliquez sur
dans le sélecteur de configurations pour ouvrir la boîte de dialogue des conditions de visibilité de la configuration pour toutes les entrées. Cliquez sur
dans le panneau Configurations pour ouvrir la boîte de dialogue correspondant à cette entrée.

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.
Les entrées sont insérées dans le panneau de configuration. -
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.
Remarques :
- You can copy and paste configuration inputs: between Part Studios, assemblies and Variable Studios; within the same document; and between different documents.
- Tous les noms, conditions de visibilité, identifiants FeatureScript et définitions de variables sont copiés avec l'entrée.
- Les entrées copiées sont disponibles jusqu'à ce que l'utilisateur se déconnecte.
- Les références entre l'entrée copiée et l'entrée collée ne sont PAS conservées ; après le collage, les modifications apportées à l'entrée de configuration d'origine ne sont PAS reflétées dans les entrées collées.
- Les conditions de visibilité collées sont automatiquement réparées (supprimées) si la configuration cible ne possède pas toutes les entrées nécessaires pour calculer la visibilité.
- Les entrées de configuration ayant les mêmes identifiants FeatureScript internes ne sont pas collées. Pour corriger cela, vous pouvez supprimer l'entrée de configuration ayant le même identifiant FeatureScript interne et la coller à nouveau.

Vous pouvez copier et coller dans et depuis une configuration, pour faciliter la saisie ou la modification des valeurs.
Pour copier des valeurs et des paramètres :
- Open the
menu in the upper right corner of the Configuration panel.
- Select Copy table:
- Une fois le tableau copié, vous pouvez le coller dans une feuille de calcul :
Notez que les noms de colonne sont également fournis avec le tableau, comme indiqué ci-dessus. Maintenant, vous pouvez éditer le tableau et le copier/coller de nouveau dans Onshape :
- Sélectionnez uniquement les lignes et les colonnes contenant des données (pas les noms ou les en-têtes des colonnes), comme indiqué en bleu ci-dessous :
Vous pouvez également tamponner votre table avec des rangées vides supplémentaires, si vous le souhaitez. Il suffit d'inclure les lignes supplémentaires dans la feuille de calcul lors de la sélection pour la commande de copie.
- Issue a Copy command.
- Dans le tableau Configuration d'Onshape, cliquez sur la cellule supérieure gauche du tableau.
- Issue a keyboard Paste command:
Onshape remplace automatiquement les données contenues dans les lignes et colonnes de la table d'entrée de configuration par les données copiées. Onshape inclut également automatiquement les unités par défaut de chaque entrée.
Notez que s'il y a plus de lignes copiées à partir de la feuille de calcul que dans la table en entrée de configuration Onshape, ces lignes sont incluses dans le collage. Onshape crée les lignes de manière impromptue.
Toutefois, s'il y a plus de colonnes copiées à partir de la feuille de calcul que dans le tableau de données configurées Onshape, ces colonnes ne sont pas incluses dans le collage. Onshape ne crée pas encore de colonnes de manière impromptue. Vous pouvez toutefois créer des colonnes supplémentaires (paramètres) dans le tableau de configuration avant de coller.

- 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.
- Conditions de visibilité - Voir Configuration des conditions de visibilité.
- Expand/collapse all inputs - Expand or collapse all inputs in the Configuration panel.
- Delete - Delete the configuration input table.