Creating variables by using a dialog in the list of the declared variables

1. Make the list of declared variables visible.
   Alternative for an →input variable, →output variable or →in-/out variable: Open the interface editor for the object (from within the project explorer).

2. From the context menu, select New Variable... Alternative: Press the Ctrl-key and the +-key.

3. In the dialog, enter the following properties for the variable and click OK.

   1. name – The name must be an →IEC-identifier.
      If you want to declare several variables in one go, enter the name with , separating the names. Example: UpErr, QuitErr, MotorUp, MotorDown

   2. section (= the variable section), e.g. LOCAL ( for →local variable, also known as →internal variable ), INPUT (for →input variable ) etc.

      Restrictions

      →Temporary variables are not possible in FBD. →In-out variables cannot be declared in a →program, →global variables cannot be declared in a →function block or →function.

   3. →data type
      Multi-dimensional array data types are not supported for connecting to a block in-/output with a →generic data type (e.g. the in-/output of the MOVE block).
      Enter one or several letters so that a selection list with the corresponding data types and function blocks is provided.
      See "STRING variables cannot be created within the graphical editor", if you require some assistance when creating STRING variables.

   4. →initial value (only optional required) – This initial value may be a →constant expression (in compliance with the →data type ).

Creating a Boolean local variable fast

1. Make the list of declared variables visible.

2. From the context menu, select New Variable (LOCAL, BOOL). Alternative: Press Ctrl+Shift and the +-key.
   If necessary, you are able to change the name as well as the data type later on. See under "Modifying variables".

Creating values fields with new variables (by using the content assist)

Use the content assist in order to create one or more →value fields with the new variables. The necessary variables are automatically declared.

1. Position the mouse pointer over an empty space of the →graphical FBD-editor – where you need the value field.
   Double-click or press Ctrl+Space.
   Result: An input field is opened.

   Declare the variables according to this syntax: X, Y : name_1, name_2, ..., name_n : type := initial-value (with the parts X, Y : and :=initial-value being optional).

   Examples

   • var1, var2 : BOOL
     2 value fields will be created; one to contain an internal variable (due to the missing prefix for X ) named var1, the other to also contain an internal variable but named var2. Both variables are of →data type BOOL. There is no →initial value and no keyword (due to the missing prefix for Y ) .

   • I: var3 : INT := 5
     One value field will be created; It is to contain the input variable (due to I ) named var3 of data type INT and the initial value 5. There is no keyword (due to the missing prefix for Y ) .

   • C : var4 : INT := 5
     One value field will be created; It is to contain the internal variable ( due to the missing prefix for X ) named var4 of data type INT and the initial value 5. Due to C, the variable is declared with the keyword CONSTANT, so it is a →constant internal v ariable.
     

   • L, C : var5 : BOOL
     One value field will be created; It is to contain the internal variable ( due to L) named var5 of data type BOOL . There is no initial value. Due to C, the variable is also declared with the keyword CONSTANT.
     

   • I, R : var6 : INT
     One value field will be created; It is to contain the input variable (due to I) named var6 of data type INT . There is no initial value. Due to R, the variable is also declared with the keyword RETAIN , so it is a →retentive input v ariable.
     

   • O, NR : var7 : SINT
     One value field will be created; It is to contain the output variable (due to O) named var7 of data type SINT . There is no initial value. Due to NR, the variable is also declared with the keyword NON_RETAIN, so it is a non-retentive out put variable.

     Explanation of the syntax...

   Prefix "X"

   Instead of X, enter the abbreviation for the required variable section:

   1. L for →local variables , also known as →internal variables (VAR)

   2. I for →input variables (VAR_INPUT)

   3. O for →output variables (VAR_OUTPUT)

   4. IO for →in-out variables (VAR_IN_OUT)
      It is not possible to declare in-out variables in a →program.

   5. G for →global variables (VAR_GLOBAL)
      It is not possible to declare global variables in a →function block or a →function.

   6. E for →external variables (VAR_EXTERNAL).
      It is only possible to declare an external variable in the function block or function, if there is already a global variable of the same name that has been declared in a →program or →resource (within a PLC-object). The declaration of an external variable in the program is only possible, if there is already a global variable of the same name that has been declared in a resource.
      Do you know the name of the global variable? If not, declare the external variable by using the next list of the content assist.

   If you omit the abbreviation X, the variables are automatically created as local variables (VAR). See the previous examples. Restrictions for variable section see above.

   Prefix "Y"

   Instead of Y, enter the abbreviation for the required keyword:

   1. C for a →constant variable

   2. R for a →retentive variable

   3. NR for a →non-retentive variable

   If you omit the abbreviation Y (incl. , in front of it), the variables are automatically created without a keyword. See the previous examples.
   It is possible to combine the abbreviation C with the abbreviation R or NR. It is not possible to combine the abbreviations R and NR with each other. See the appropriate glossary articles, if you need information which keyword is possible for which variable section.
   It is also possible to enter the abbreviation for the keyword in front of the abbreviation for the variable section. Hence: Y, X :name_1, name_2, ..., name_n : type := initial-value

   Name of variable

   Instead of name_1, name_2, ..., name_n enter the names for the variables. The name must be an →IEC-identifier. If you want to declare just one variable, just enter one name (without ,).

   Possible data types

   Instead of type, enter a data type. If necessary, you are able to change the data type later on.

   Initial value

   Instead of initial-value, enter a initial value. This specification is optional. You are able to enter the initial value later on.

2. Press the Enter-key.

3. Position the value field by pressing the primary mouse button or the Enter-key. The necessary variables are automatically declared. Hence, the variables are listed in the list of the declared variables.

See "Creating value fields or calls of blocks by using the content assist in FBD", if you need more information on creating value fields.