Variable

1. Dans un Atelier des pièces, cliquez sur pour ouvrir la boîte de dialogue Variable.

   

2. Dans la boîte de dialogue :

   1. Entrez un nom pour la variable (et par lequel la référencer).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. Sélectionnez un type :
      • Longueur - Valeur numérique représentant une longueur (valeur décimale, entière, fraction)
      • Angle - Valeur numérique représentant un angle (nombre décimal, entier, fraction)
      • Nombre - Une valeur numérique (valeur décimale, entière, fraction)
      • N'importe lequel - N'importe lequel des éléments ci-dessus, une valeur numérique avec différentes unités ou une valeur FeatureScript telle qu'un booléen, un mappage, un tableau, une chaîne ou une fonction. Voir https://cad.onshape.com/FsDoc/variables.html#standard-types et les exemples ci-dessous.
   3. Entrez une valeur (et éventuellement des unités dans les champs Longueur, Angle et N'importe lequel).
   4. Saisissez une description personnalisée pour votre variable.
3. Cliquez sur .

1. While in a Part Studio, click to open the Variable dialog box, then click Measured:

   

2. Dans la boîte de dialogue :
   1. Sélectionnez un type :
      • Distance : valeur numérique représentant une distance (décimal, entier, fraction)
      • Longueur - Valeur numérique représentant une longueur (valeur décimale, entière, fraction)
      • Diamètre : valeur numérique représentant un diamètre (décimal, entier, fraction)

   2. Entrez un nom pour la variable (et par lequel la référencer).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   3. Sélectionnez les entités entre lesquelles mesurer.
   4. Remplissez les autres champs selon vos préférences.
3. Cliquez sur .

The From table option in the Variable feature enables users to create a single variable that stores a subset of rows and columns from the CSV table. The Row options filter the rows and determine the Result type (Single value, Array, or Map) of the variable. The Column options then filter each row and determine the type of each entry in the final variable.

1. While in a Part Studio, click to open the Variable dialog, then click From table:

   

2. In the dialog:
   1. Enter a Name for the variable (and by which to reference it).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. Under CSV file, click the Select CSV file field to open the dialog:

      

      Select the CSV file from either the Current document, Other documents, or click the Import button at the bottom of the dialog to select a CSV file from your device.

      Once selected, click the file. It is loaded into the Select CSV file field.

   3. Fill out the Row and Column fields according to your requirements:
      • Access type - Select  By index, By index range, By label, or All values.
        • Index - If By index is selected, enter a single Index value.
        • Min/Max index - When By index range is selected, enter both the minimum and maximum index values.
        • Value - If By label is selected, enter the label's string value.
      • Regular expression - Check to pattern match a set of target strings.
      • Result type - Select Single value, Array, or Map.
        • Label column/row index - If the Result type is a Map, enter either a numerical index value or a variable.
   4. Check Conversion factor and enter a value with measurement units if you are converting from one measurement to another (for example, if the table uses inches, and you want these values converted to centimeters).

      

   5. Optionally, enter a Description to provide some details about the Variable or CSV file being used.
3. Click .

Examples

All examples below use the following 3x3 CSV table:

• An array of arrays - Setting Access type: All values and Result type: Array for both Row and Column creates an array of arrays that corresponds to the entire CSV file:

  

• Rows indexed by the first column - To index the CSV rows by the values in the first column, select Access type: All values, Result type: Map, and Label column index: 0 for Row. This sets the first column in the table as the map key.

  For Column, select Access type: By index range and set the Min/Max index range for the table columns (in the example below, a Min/Max index range of 1/2 is entered, which provides an array for the second and third columns in the table). Finally, select Result type: Array:

  

• First column - To access only the first column, set Access type: All values and Result type: Array for Row. Then select Access type: By index (0) and Result type: Single value for Column:

  

• First row - To access only the first row, set Access type: By index (0) and Result type: Single value for Row. Then select Access type: All values and Result type: Array for Column:

  

Notes

• To view the variable result, hover your mouse over the feature name. A tooltip displays the result from the CSV file:

  

• Since a variable is sourced from a table, its Variable type and Value in the Variable table are read-only (the Dimensions variable in the example below):

  

Créez une cote, dans le champ Cote entrez # et le nom de la variable (et éventuellement, dans le cadre d'une expression, comme indiqué ci-dessous) :

et

Sauvegardez la cote ; la variable est remplacée par la valeur et l'expression (le cas échéant) est résolue :

Lorsque vous double-cliquez sur la cote pour la modifier, la variable (et l'expression) s'affichent :

If an expression without a variable is used for a sketch dimension, it is indicated with the Expression without a variable icon () to the left of the dimension value. If an expression with a variable is used for a sketch dimension, it is indicated with the Expression with variable icon () to the left of the dimension value. See Displaying expressions in a sketch.

Utilisez des variables partout où vous utilisez des expressions dans un atelier de pièces. Par exemple, dans une opération d'extrusion ou de rotation.

Start the operation as usual (in this case, Revolve); in the numeric value field, enter # and the variable name (or optionally, as part of an expression):

Acceptez la fonction.

Lorsque vous modifiez la fonction, la solution s'affiche dans le champ de valeur numérique :

Cliquez dans le champ et la variable (et l'expression, le cas échéant) s'affichent.

Fonction de remplissage automatique variable

Lorsque vous avez défini des variables, la saisie d'un hashtag (ou d'un signe dièse, d'un trait de soulignement ou d'une lettre quelconque) dans un champ de dialogue numérique ouvre la fonction de remplissage automatique de variable comme indiqué ci-dessous :

Left: using a variable in a dialog. Right: using a variable in a dimension field in a sketch.

Vous pouvez continuer à taper pour filtrer la liste en fonction des options raisonnables, utilisez les touches de direction pour vous déplacer vers le haut et le bas dans la liste, et utilisez la touche Entrée pour accepter une variable de la liste lorsqu'elle est surlignée. Vous pouvez également utiliser la molette de défilement de la souris pour faire défiler la liste des variables et un clic de souris pour sélectionner une variable en particulier. Notez que les fonctions FeatureScript sont également incluses dans la liste lorsque le signe dièse n'est pas utilisé :

Notez également ce qui suit :

• L'utilisation de la touche Echap ferme la liste déroulante sans rien sélectionner. La suppression du focus de la liste déroulante la ferme également sans rien sélectionner.
• Les valeurs de calcul sont affichées en gris clair et ne seront pas insérées (seul le nom de la variable ou de la fonction est inséré). De même avec les entrées de fonction, car les noms des espaces réservés en entrée ne sont pas insérés.
• Seules les variables qui existent dans le contexte actuel sont affichées ; les variables plus bas dans la Liste des fonctions ne sont pas affichées

Les valeurs de variable peuvent contenir des expressions. Vous pouvez spécifier un tableau avec un index, et l'index peut être une variable. Cela vous permet de modifier la valeur de la variable en modifiant la valeur de la variable d'index.

Pour utiliser des tableaux dans des variables, vous devez d'abord configurer un index de base zéro.

1. Créez une variable et définissez le nom sur « config ». Sélectionnez Number comme type et définissez la valeur de #config sur 2.
2. Créez une variable et donnez-lui le nom « diamètre ». Définissez la valeur de #diameter sur « [0,25 ; 0,5 ; 1][#config] ».

Il s'agit de la deuxième valeur entre crochets [#config] qui sert de pointeur d'index dans le tableau.

3. Créez une variable et définissez le nom sur « length ». Définissez la valeur de #length sur « [2, 4, 10][#config] ».

4. Créez un cercle.
5. Créez une ligne.
6. Réglez le diamètre du cercle sur '#diameter'.

   Depuis #config = 2, le diamètre du cercle est de 1.

7. Définissez la longueur de la ligne sur '#length'.

   Depuis #config = 2, la longueur de la ligne est de 10.

Modifiez la valeur de la variable d'index pour modifier les indices de toutes les variables de tableau.

Vous pouvez créer des variables selon vos besoins, lors de la saisie d'une valeur numérique dans un champ d'une boîte de dialogue d'entité, par exemple. La variable est enregistrée avant l'opération en cours dans la liste des fonctions.

Par exemple, lors de la création d'une esquisse, lorsque le champ de cote apparaît, au lieu de saisir une valeur pour la cote, vous pouvez taper le signe dièse # et la liste des variables existantes s'affiche, ainsi qu'une option pour une nouvelle variable :

Sélectionnez Nouvelle variable pour ouvrir la boîte de dialogue Variable afin de créer une nouvelle variable et de l'utiliser dans le champ actuel. (Sinon, sélectionnez l'une des variables existantes, si elle est disponible.)

La boîte de dialogue Créer une variable permet de créer une variable pour une fonction (par défaut) ou une configuration.

Entrez un nom pour la nouvelle variable, ainsi qu'une valeur. Cliquez sur la coche pour enregistrer la nouvelle variable et l'utiliser dans la fonction ouverte.

Vous pouvez utiliser les fonctions FeatureScript dans une variable, en respectant la syntaxe FeatureScript.

Par exemple, vous pouvez créer une variable de type Tout, nommée « Ajuster », pour stocker une fonction qui double une longueur donnée et ajoute 2,5 mm, comme suit :

function(len) { return len * 2 + 2,5 mm; }

, puis référencez cette variable dans une expression, telle que :

#Adjust (20 mm)

• Lorsque vous modifiez la valeur d'une variable (modifiez-la comme vous le feriez pour n'importe quelle fonction), toutes les opérations qui utilisent la variable sont automatiquement mises à jour.
• When you change the name of a variable, you have the choice to propagate the change everywhere the variable is used:

  

  Cochez la case à côté de Mettre à jour toutes les références.

1. Dans un Atelier des pièces, sélectionnez l'icône de l'outil Variable () pour ouvrir la boîte de dialogue de cet outil.

   

2. Dans la boîte de dialogue :
   1. Sélectionnez un type :
   • Longueur - Valeur numérique représentant une longueur (décimale, nombre entier, fraction)
   • Angle - Valeur numérique représentant un angle (nombre décimal, entier, fraction)
   • Nombre - Une valeur numérique (valeur décimale, entière, fraction)
   • N'importe lequel - N'importe lequel des éléments ci-dessus, une valeur numérique avec différentes unités ou une valeur FeatureScript telle qu'un booléen, un mappage, un tableau, une chaîne ou une fonction. Voir https://cad.onshape.com/FsDoc/variables.html#standard-types et les exemples ci-dessous.
   2. Entrez un nom pour la variable (et par lequel la référencer).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   3. Entrez une valeur (et éventuellement des unités dans les champs Longueur, Angle et N'importe lequel).
3. Appuyez sur la case.

La variable que vous avez créée est répertoriée dans la Liste des fonctions et affiche le nom et la valeur de la variable.

1. While in a Part Studio, select the Variable tool icon () to open the Variable tool dialog box, then tap Measured:

   

2. Dans la boîte de dialogue :
   1. Sélectionnez un type :
   • Distance : valeur numérique représentant une distance (décimal, entier, fraction)
   • Longueur - Valeur numérique représentant une longueur (valeur décimale, entière, fraction)
   • Diamètre : valeur numérique représentant un angle (décimal, entier, fraction)

3. Entrez un nom pour la variable (et par lequel la référencer).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   1. Sélectionnez les entités entre lesquelles mesurer.
   2. Remplissez les autres champs selon vos préférences.
4. Appuyez sur la case.

La variable que vous avez créée est répertoriée dans la Liste des fonctions et affiche le nom et la valeur de la variable.

The From table option in the Variable feature enables users to create a single variable that stores a subset of rows and columns from the CSV table. The Row options filter the rows and determine the Result type (Single value, Array, or Map) of the variable. The Column options then filter each row and determine the type of each entry in the final variable.

iOS support for creating a Variable from a CSV file (From table) is limited to editing and viewing variables created on the desktop (browser) platform.

1. Tap to open the Variable dialog, then tap From table:

   

2. In the dialog:
   1. Enter a Name for the variable (and by which to reference it).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. Under CSV file, tap the Select CSV file field to select and open an existing CSV file. It is loaded into the Select CSV file field.

      Fill out the Row and Column fields according to your requirements:

      • Access type - Select  By index, By index range, By label, or All values.
        • Index - If By index is selected, enter a single Index value.
        • Min/Max index - When By index range is selected, enter both the minimum and maximum index values.
        • Value - If By label is selected, enter the label's string value.
      • Regular expression - Check to pattern match a set of target strings.
      • Result type - Select Single value, Array, or Map.
        • Label column/row index - If the Result type is a Map, enter either a numerical index value or a variable.
   3. Toggle Conversion factor and enter a value with measurement units if you are converting from one measurement to another (for example, if the table uses inches, and you want these values converted to centimeters).
   4. Optionally, enter a Description to provide some details about the Variable or CSV file being used.
3. Tap the checkmark.

Créez une cote, dans le champ Cote entrez # et le nom de la variable (et éventuellement, dans le cadre d'une expression, comme indiqué ci-dessous) :

et

Sauvegardez la cote ; la variable est remplacée par la valeur et l'expression (le cas échéant) est résolue :

Lorsque vous double-cliquez sur la cote pour la modifier, la variable (et l'expression) s'affichent :

Utilisez des variables partout où vous utilisez des expressions dans un atelier de pièces. Par exemple, lors d'une extrusion ou d'un pivotement :

Démarrez l'opération comme d'habitude (dans ce cas, Pivoter) ; dans le champ de valeur numérique, saisissez # et le nom de la variable (ou éventuellement, dans le cadre d'une expression). Par exemple : (#x) deg.

Acceptez la fonction.

Lorsque vous modifiez la fonction, la solution s'affiche dans le champ de valeur numérique. Par exemple : 4 deg.

Cliquez dans le champ et la variable (et l'expression, le cas échéant) s'affichent.

Les valeurs de variable peuvent contenir des expressions mais doivent être évaluées à une valeur scalaire. Vous pouvez spécifier un tableau avec un index, et l'index peut être une variable. Cela vous permet de modifier la valeur de la variable en modifiant la valeur de la variable d'index.

Pour utiliser des tableaux dans des variables, vous devez d'abord configurer un indice de base zéro.

1. Appuyez sur l'outil Variable et définissez le nom sur « config ». Définissez la valeur de #config sur 2.
2. Appuyez sur l'outil Variable et définissez le nom sur « diamètre ». Définissez la valeur de #diameter sur [0.25, 0.5, 1] [#config].

Il est important que vous incluiez la deuxième série de crochets contenant « #config ». C'est ce qui permet à la valeur de la variable #config de pointer vers le bon endroit dans le tableau.

3. Appuyez sur l'outil Variable et définissez le nom sur « longueur ». Définissez la valeur de #length sur [2, 4, 10] [#config].

Il est important que vous incluiez la deuxième série de crochets contenant « #config ». C'est ce qui permet à la valeur de la variable #config de pointer vers le bon endroit dans le tableau.

4. Appuyez sur l'outil d'esquisse et esquissez un cercle.
5. Appuyez sur l'outil d'esquisse et esquissez une ligne.
6. Réglez le diamètre du cercle sur « #diameter ».
7. Définissez la longueur de la ligne sur « #length ».

   Le diamètre du cercle est défini sur 1, et la longueur de la ligne est définie sur 10.

8. Modifiez la variable #config, définissez la valeur sur 0.

L'esquisse se met à jour, le diamètre du cercle est désormais défini sur 0,25 et la longueur de ligne est définie sur 2.

Vous pouvez le faire pour autant de tableaux que vous le souhaitez, et vos tableaux peuvent contenir un nombre illimité d'emplacements (ils ne sont pas limités à seulement trois valeurs comme le montre cet exemple).

Vous pouvez utiliser les fonctions FeatureScript dans une variable, en respectant la syntaxe FeatureScript.

Par exemple, vous pouvez créer une variable de type Tout, nommée « Ajuster », pour stocker une fonction qui double une longueur donnée et ajoute 2,5 mm, comme suit :

function(len) { return len * 2 + 2,5 mm; }

, puis référencez cette variable dans une expression, telle que :

#Adjust (20 mm)

• Lorsque vous modifiez la valeur d'une variable (modifiez-la comme vous le feriez pour n'importe quelle fonction), toutes les opérations qui utilisent la variable sont automatiquement mises à jour.
• Les noms des variables sont sensibles à la casse.
• Vous pouvez entrer une variable en tant que valeur autonome ou dans le cadre d'une équation.
• Vous pouvez utiliser une variable dans une cote, une expression ou une fonction.

• Dans les cas où vous spécifiez une variable sans unité, les expressions sont également sans unité ou supposent l'unité de l'espace de travail. Mais si vous ajoutez explicitement des unités à une valeur variable, alors toute expression doit également correspondre à cette unité lors de l'écriture afin d'être valide.

• When you change the name of a variable, you have the choice to propagate the change everywhere the variable is used:

  

  Sélectionnez Mettre à jour toutes les références.

1. While in a Part Studio, select the Variable tool to open the Variable tool dialog box:

   

2. Dans la boîte de dialogue :
   1. Sélectionnez un type :
   • Longueur - Valeur numérique représentant une longueur (décimale, nombre entier, fraction)
   • Angle - Valeur numérique représentant un angle (nombre décimal, entier, fraction)
   • Nombre - Une valeur numérique (valeur décimale, entière, fraction)
   • N'importe lequel - N'importe lequel des éléments ci-dessus, une valeur numérique avec différentes unités ou une valeur FeatureScript telle qu'un booléen, un mappage, un tableau, une chaîne ou une fonction. Voir https://cad.onshape.com/FsDoc/variables.html#standard-types et les exemples ci-dessous.
   2. Entrez un nom pour la variable (et par lequel la référencer).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   3. Entrez une valeur (et éventuellement des unités dans les champs Longueur, Angle et N'importe lequel).
3. Appuyez sur la case.

La variable que vous avez créée est répertoriée dans la Liste des fonctions et affiche le nom et la valeur de la variable.

1. While in a Part Studio, select the Variable tool to open the Variable tool dialog box, then click Measured:

   

2. Dans la boîte de dialogue :
   1. Sélectionnez un type :
   • Distance : valeur numérique représentant une distance (décimal, entier, fraction)
   • Longueur - Valeur numérique représentant une longueur (valeur décimale, entière, fraction)
   • Diamètre : valeur numérique représentant un angle (décimal, entier, fraction)

3. Entrez un nom pour la variable (et par lequel la référencer).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   1. Sélectionnez les entités entre lesquelles mesurer.
   2. Remplissez les autres champs selon vos préférences.
4. Appuyez sur la case.

La variable que vous avez créée est répertoriée dans la Liste des fonctions et affiche le nom et la valeur de la variable.

The From table option in the Variable feature enables users to create a single variable that stores a subset of rows and columns from the CSV table. The Row options filter the rows and determine the Result type (Single value, Array, or Map) of the variable. The Column options then filter each row and determine the type of each entry in the final variable.

Android support for creating a Variable from a CSV file (From table) is limited to editing and viewing variables created on the desktop (browser) platform.

1. Tap to open the Variable dialog, then tap From table:

   

2. In the dialog:
   1. Enter a Name for the variable (and by which to reference it).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. Under CSV file, tap the Select CSV file field to select and open an existing CSV file. It is loaded into the Select CSV file field.

      Fill out the Row and Column fields according to your requirements:

      • Access type - Select  By index, By index range, By label, or All values.
        • Index - If By index is selected, enter a single Index value.
        • Min/Max index - When By index range is selected, enter both the minimum and maximum index values.
        • Value - If By label is selected, enter the label's string value.
      • Regular expression - Check to pattern match a set of target strings.
      • Result type - Select Single value, Array, or Map.
        • Label column/row index - If the Result type is a Map, enter either a numerical index value or a variable.
   3. Toggle Conversion factor and enter a value with measurement units if you are converting from one measurement to another (for example, if the table uses inches, and you want these values converted to centimeters).
   4. Optionally, enter a Description to provide some details about the Variable or CSV file being used.
3. Tap the checkmark.

Créez une cote, dans le champ Cote entrez # et le nom de la variable (et éventuellement, dans le cadre d'une expression, comme indiqué ci-dessous) :

et

Sauvegardez la cote ; la variable est remplacée par la valeur et l'expression (le cas échéant) est résolue :

Lorsque vous double-cliquez sur la cote pour la modifier, la variable (et l'expression) s'affichent :

Utilisez des variables partout où vous utilisez des expressions dans un atelier de pièces. Par exemple, lors d'une extrusion ou d'un pivotement :

Démarrez l'opération comme d'habitude (dans ce cas, Pivoter) ; dans le champ de valeur numérique, saisissez # et le nom de la variable (ou éventuellement, dans le cadre d'une expression). Par exemple : (#x) deg.

Acceptez la fonction.

Lorsque vous modifiez la fonction, la solution s'affiche dans le champ de valeur numérique. Par exemple : 4 deg.

Cliquez dans le champ et la variable (et l'expression, le cas échéant) s'affichent.

Les valeurs des variables peuvent contenir des expressions mais doivent être évaluées en tant que valeur scalaire. Vous pouvez spécifier un tableau avec un index, qui peut être une variable. Cela vous permet de modifier la valeur de la variable en modifiant la valeur de la variable d'indice.

Pour utiliser des tableaux dans des variables, vous devez d'abord configurer un indice de base zéro.

1. Appuyez sur l'outil Variable et définissez le nom sur « config ». Définissez la valeur de #config sur 2.
2. Appuyez sur l'outil Variable et définissez le nom sur « diamètre ». Définissez la valeur de #diameter sur [0.25, 0.5, 1] [#config].

Il est important que vous incluiez la deuxième série de crochets contenant « #config ». C'est ce qui permet à la valeur de la variable #config de pointer vers le bon endroit dans le tableau.

3. Appuyez sur l'outil Variable et définissez le nom sur « longueur ». Définissez la valeur de #length sur [2, 4, 10] [#config].

Il est important que vous incluiez la deuxième série de crochets contenant « #config ». C'est ce qui permet à la valeur de la variable #config de pointer vers le bon endroit dans le tableau.

4. Appuyez sur l'outil d'esquisse et esquissez un cercle.
5. Appuyez sur l'outil d'esquisse et esquissez une ligne.
6. Réglez le diamètre du cercle sur « #diameter ».
7. Définissez la longueur de la ligne sur « #length ».

   Le diamètre du cercle est défini sur 1, et la longueur de la ligne est définie sur 10.

8. Modifiez la variable #config, définissez la valeur sur 0.

L'esquisse se met à jour, le diamètre du cercle est désormais défini sur 0,25 et la longueur de ligne est définie sur 2.

Vous pouvez le faire pour autant de tableaux que vous le souhaitez, et vos tableaux peuvent contenir une infinité de places (ils ne sont pas limités à trois valeurs, comme le montre cet exemple).

Vous pouvez utiliser les fonctions FeatureScript dans une variable, en respectant la syntaxe FeatureScript.

Par exemple, vous pouvez créer une variable de type Tout, nommée « Ajuster », pour stocker une fonction qui double une longueur donnée et ajoute 2,5 mm, comme suit :

function(len) { return len * 2 + 2,5 mm; }

, puis référencez cette variable dans une expression, telle que :

#Adjust (20 mm)

• Lorsque vous modifiez la valeur d'une variable (modifiez-la comme vous le feriez pour n'importe quelle fonction), toutes les opérations qui utilisent la variable sont automatiquement mises à jour.
• Les noms des variables sont sensibles à la casse.
• Vous pouvez entrer une variable en tant que valeur autonome ou dans le cadre d'une équation.
• Vous pouvez utiliser une variable dans une cote, une expression ou une fonction.