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 finestra di dialogo Condizioni di visibilità delle configurazioni consente di aggiungere logica alle configurazioni che imposti, in modo da poter controllare quando sono disponibili determinati dati di configurazione e determinate opzioni.

Considera una parte con due dati di configurazione: altezza e larghezza.
Per impostazione predefinita, una parte di qualsiasi altezza può avere qualsiasi larghezza. Ma supponiamo che la larghezza Extra largo sia disponibile solo per l'altezza Alto. In tal caso, possiamo impostare le condizioni in base alle quali l'input Larghezza è visibile.
- Nel pannello Configurazione fai clic sul pulsante a tre punti della configurazione e seleziona Condizioni di visibilità nel menu.
Si apre la finestra di dialogo Condizioni di configurazione. Il riquadro destro mostra un'anteprima delle configurazioni attualmente selezionate. È possibile modificare le opzioni selezionate direttamente in questo pannello per visualizzare in anteprima le impostazioni. - Fai clic su Aggiungi condizione.
- Fai clic sul primo menu a discesa e seleziona l'input che dovrebbe controllare la visibilità di questo input. In questo esempio, selezioneremo l'input Altezza.
- Nel secondo menu a discesa, scegli tra è per selezionare opzioni specifiche oppure è compreso tra per selezionare un intervallo di opzioni:
- è: fai clic sul terzo menu a discesa che appare e seleziona le opzioni consentite per il dato di configurazione.
- è compreso tra: 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.
In questo esempio il dato di configurazione Larghezza è disponibile solo per l'altezza Elevata. L'anteprima sul lato destro si aggiorna e mostra le selezioni che hai effettuato. L'immagine qui di seguito mostra che il dato di configurazione Larghezza non è più disponibile per l'altezza predefinita.
- Fai clic su Salva. Ora, l'input Larghezza è visibile solo quando è selezionata l'altezza Alto e la tabella di input Larghezza mostra l'icona delle Condizioni di visibilità
.

È possibile utilizzare le impostazioni delle regole di opzione nella finestra di dialogo Condizioni di visibilità delle configurazioni per specificare le condizioni in base alle quali devono apparire determinate opzioni.
È possibile impostare la logica delle regole di opzione solo per i dati di configurazione a elenco.
- Nella finestra di dialogo Condizioni di visibilità delle configurazioni, espandi un dato di configurazione e fai clic su Aggiungi regola di opzione. Nella finestra di dialogo è visualizzata una nuova sezione:
- Nella riga Mostra, scegli quali opzioni sono controllate.
- Opzioni: fai clic sul menu a discesa che appare e seleziona le opzioni per le quali vuoi impostare condizioni.
- Intervallo: fai clic sul primo menu a discesa e seleziona la prima opzione dell'intervallo. Fai clic sul secondo menu a discesa e seleziona l'ultima opzione dell'intervallo. Gli intervalli includono le opzioni specifiche e sono consentiti intervalli sovrapposti.
- Nella riga Quando:
- Seleziona il dato di configurazione nel primo menu a discesa.
- Scegli tra è per selezionare opzioni specifiche o è compreso tra per selezionare un intervallo di opzioni.
- è: fai clic sul menu a discesa visualizzato e seleziona i valori consentiti per l'opzione.
- è compreso tra: fai clic sul primo menu a discesa e seleziona la prima opzione consentita nell'intervallo. Fai clic sul secondo menu a discesa e seleziona l'ultima opzione consentita nell'intervallo.
-
Continua ad aggiungere logica all'interno della configurazione facendo clic su Aggiungi condizione e ripetendo questa serie di passaggi.
Le condizioni all'interno di una regola di opzione sono combinate insieme come istruzioni AND; tutte le condizioni devono essere soddisfatte affinché le opzioni controllate siano visibili.
- Aggiungi condizioni per altre opzioni facendo nuovamente clic su Aggiungi regola di opzione.
- Fai clic su Salva .
Nell'esempio seguente, l'opzione Profondo è consentita solo quando l'area è Predefinita o superiore. L'opzione Standard è consentita solo quando l'area è Grande, Predefinita o Piccola. L'opzione Poco profondo è consentita solo quando l'area è Piccola o inferiore:
L'esempio successivo utilizza intervalli sovrapposti per specificare le condizioni di visibilità:
L'esempio seguente utilizza una combinazione di comandi di opzione e di intervallo per impostare la logica richiesta.

Le condizioni di configurazione sono aggiuntive; se aggiungiamo una terza configurazione all'esempio precedente e impostiamo le condizioni mostrate nell'immagine seguente, l'opzione Raccordo grande sarà disponibile solo per le parti in cui i dati di configurazione sono sia altezza Elevata che larghezza Extra larga.
Quando la larghezza predefinita è impostata per l'altezza Alta, la configurazione del raccordo è nascosta.
I dati di configurazione possono controllare solo la visibilità dei dati che appaiono sotto di essi nel pannello Configurazioni. In questo esempio il dato di configurazione Larghezza è determinabile dal dato Altezza, ma non dal dato Raccordo.

Le condizioni di visibilità sono riparate (rimosse) automaticamente se non è possibile trovare i dati di configurazione o le opzioni necessari.
Ad esempio, se la visibilità del dato di configurazione Larghezza dipende dal dato di configurazione Altezza e il dato di configurazione Altezza è eliminato, le condizioni di visibilità per la Larghezza sono automaticamente rimosse. Lo stesso vale per le singole opzioni che sono eliminate o spostate. In questo esempio, il dato di configurazione Altezza è stato rimosso anche dalle opzioni Raccordo.
Vedrai un avviso nella tua area di lavoro e le condizioni saranno rimosse nella finestra di dialogo:

-
Le condizioni di visibilità e le regole di opzione impostate sono disponibili in tutte le finestre di dialogo Inserisci (ad esempio, quando inserisci una parte configurata in un assieme). Le modifiche apportate alle condizioni di visibilità si riflettono automaticamente in tutti i documenti esistenti che fanno riferimento all'elemento configurato.
-
I dati di configurazione nascosti hanno sempre un proprio valore predefinito. Nel primo esempio di questa pagina, le parti con altezza bassa e media hanno la larghezza predefinita, anche se non è impostata alcuna opzione di larghezza.
-
Se un dato di configurazione non ha opzioni visibili, il dato è nascosto e assume il proprio valore predefinito.
-
-
Quando il dato di configurazione o l'opzione sono compressi, la finestra di dialogo visualizza un riepilogo delle condizioni di visibilità.
-
(Solo Parti e Part Studios): gli input di configurazione esclusi dalle proprietà possono controllare solo la visibilità degli altri input sottostanti che sono stati anch'essi esclusi dalle proprietà. Nell'esempio seguente, se Larghezza è esclusa dalle proprietà (indicato dall'icona
), può controllare la visibilità del raccordo solo se anche il raccordo è escluso dalle proprietà.
-
(Solo Parti e Part Studios): i dati di configurazione che sono stati esclusi dalle proprietà sono considerati come se avessero i loro valori predefiniti nei pacchetti di rilascio e nei valori dei riferimenti di revisione. Se le condizioni di visibilità impediscono l'utilizzo del valore predefinito, è utilizzato il primo valore visibile.
- Usa il menu a discesa Input nella finestra di dialogo Condizioni di visibilità della configurazione per visualizzare altri input. È possibile selezionare Tutti gli input per visualizzare tutti gli input disponibili.
- Quando nella finestra di dialogo sono visualizzati più dati di configurazione, fai clic sul pulsante con tre punti per espandere o comprimere tutti i dati di configurazione.
- È possibile utilizzare la sezione anteprima della finestra di dialogo Condizioni di visibilità della configurazione per testare le configurazioni.
- Deseleziona la casella di controllo Mostra dati di configurazione nascosti per rimuovere i dati di configurazione in grigio dalla finestra di dialogo.
- Deseleziona la casella di controllo Mostra dati di configurazione nascosti per rimuovere i dati di configurazione in grigio dalla finestra di dialogo.
-
Quando si aggiungono parti configurate agli assiemi, i dati di configurazione nascosti sono disattivati (in grigio) nel pannello Configurazioni.
-
Fai clic
nel selettore Configurazioni per aprire la finestra di dialogo Condizioni di visibilità della configurazione per tutti gli input. Fai clic su
nel pannello Configurazioni per aprire la finestra di dialogo relativa a tale input.

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.
I dati di configurazione sono inseriti nel pannello di configurazione. -
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.
Note:
- You can copy and paste configuration inputs: between Part Studios, assemblies and Variable Studios; within the same document; and between different documents.
- Tutti i nomi, le condizioni di visibilità, gli ID FeatureScript e le definizioni delle variabili sono copiati con i dati di configurazione.
- I dati di configurazione copiati sono disponibili fino alla disconnessione dell'utente.
- I riferimenti tra i dati di configurazione copiati e i dati di configurazione incollati NON sono mantenuti; dopo l'incollaggio, le modifiche ai dati di configurazione originale NON si riflettono nei dati di configurazione incollati.
- Le condizioni di visibilità incollate sono riparate (rimosse) automaticamente se la configurazione di destinazione non dispone di tutti i dati di configurazione necessari per calcolare la visibilità.
- I dati di configurazione con gli stessi ID FeatureScript interni non sono incollati. Per risolvere questo problema, è possibile eliminare i dati di configurazione con lo stesso ID FeatureScript interno e incollarli nuovamente.

È possibile copiare e incollare dentro e fuori una configurazione per facilitare l'immissione o la modifica dei valori.
Per copiare valori e parametri:
- Open the
menu in the upper right corner of the Configuration panel.
- Select Copy table:
- Dopo aver copiato la tabella, puoi incollarla in un foglio di calcolo:
Nota che anche i nomi delle colonne sono riportati nella tabella, come mostrato sopra. Ora puoi modificare la tabella e copiarla/incollarla di nuovo in Onshape:
- Seleziona solo le righe e le colonne con i dati (non i nomi delle colonne o le intestazioni), come mostrato in blu di seguito:
Puoi anche riempire la tabella con righe vuote aggiuntive, se vuoi. Basta includere le righe aggiuntive nel foglio di calcolo quando selezioni il comando per la copia.
- Issue a Copy command.
- Nella tabella Configurazione Onshape fai clic sulla cella in alto a sinistra della tabella.
- Issue a keyboard Paste command:
Onshape sostituisce automaticamente i dati presenti nelle righe e nelle colonne della tabella dei dati di configurazione con i dati copiati. Onshape include anche automaticamente le unità predefinite per ogni dato immesso.
Se sono presenti più righe copiate dal foglio di calcolo rispetto alla tabella di dati di configurazione Onshape, tali righe vengono incluse nell'operazione di incollaggio. Onshape crea le righe istantaneamente.
Tuttavia, se sono presenti più colonne copiate dal foglio di calcolo rispetto alla tabella dei dati di configurazione Onshape, tali colonne non sono incluse nell'operazione di incollaggio. Onshape non è ancora in grado di creare colonne all'instante. Tuttavia, puoi creare colonne aggiuntive (funzioni configurate) nella tabella di configurazione prima di incollare.

- 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.
- Condizioni di visibilità: vedi Impostare le condizioni di visibilità.
- Expand/collapse all inputs - Expand or collapse all inputs in the Configuration panel.
- Delete - Delete the configuration input table.