Global variable
This function is used to capitalize on a group of global variables defined in the application and to automatically generate the declaration (ie initialise if this is planned in the record), in the sub-program DEVAR for the process specified in the record.
This function is fragile because it intervenes in the declaration of the variable in the processes. It is essentially designed for the developers and must not in any situation be left in the hands of unexperienced users. It is strongly recommended that the standard is not modified or to do so only with good understanding of why.
The check box "public", if it is set, indicates that the global variable can be re-used, notably by a customization ; There is a document linked to this variable available.
All the global variables used in the product are not all declared in this dictionary. The following are identified :
- those assigned to a parameter
- those that must exist beyond a process.
Where variables are absent from the dictionary, their declaration is made directly in the functional process.
Prerequisite
Refer to documentation Implementation
Screen management
Entry screen
Presentation
A single screen is used to write a variable, indicate its format, its sizing and any parameter used in its initialization.
Close
Fields
The following fields are present on this tab :
Block number 1
| The following standard is used to name the global variable :
This variable belongs to the class [V]. |
| Destined notably to figure in the reports and the screens in which the record code can be entered or selected. This text is used to give a clear description to the record concerned. |
Characteristics
| An activity code is used to:
In this way, if the activity code is disabled, the marked element will not be useable, and the associated code (if any) will neither be generated nor can be activated. |
| Module belonging to the setup. This field is used to specify whether the screen has to be created in the folder database. It is specified when the module linked to the screen is active in the folder. |
| This flag indicates that this element is published. It can therefore be re-used by the custom/specific. An associated documentation is available. |
Description
| This text field is used to display the comments relative to the current record. |
Format
| Defined here is the data type of the global variable. If the data type is the alphanumeric type and defined with a length, the global variable is then generated with a length defined by GLONxxx (xxx=data type). The length is mandatory if the data type indicated in the record is of the type internal alphanumeric, clob or blob and does not have a length entered. On the other hand, the length is not entered where the data type is of an internal type other than alphanumeric, clob and blob. |
| Field displayed with the value coming from the data type. |
| The length is mandatory if the data type indicated in the record is of the type internal alphanumeric, clob or blob and does not have a length entered. On the other hand, the length is not entered where the data type is of an internal type other than alphanumeric, clob and blob. |
Sizing formulas
| Possibly to define the variables of one or two dimensions, the first line starting with 0 by default, but according to the parameterization can start with 1. Used to define a value by means of a calculated expression can contain constants and variables. |
|
|
|
|
|
|
Initialization
| Used to link a variable to a parameter, in order to automatically recover the value of the parameter in this global variable during the connection to the folder.
|
|
|
| Field that is used to initialize the field. Generation of the global variable loading in the subprog DEFAR for the process named in the record. For the standard, in order to conserve a homogeneity, it is recommended to no initialize the variable in the dictionary except for the variable used in the declaration of another variable. The initialization will be made in one of the processes GLOBxxx (xxx=module). Used to define a value by means of a calculated expression can contain constants and variables. |
|
|
Generation
| Process in which the variable will be declared. Must have been created in the process dictionary. Must be named WWAGLOBxxx. Even though it can be assigned to new processes, the standard is limited to the available list. It is advised that or specific/custom, to generate their own processes. Two processes exist reserved for the global variables associated with a parameter :
|
|
|
| Rank for the declaration and initialization of the variable in the process named in this record. This information is of importance, when a variable serves to size or initialize a second variable. |
Close
Specific Buttons
The following fields are present on the window opened through this button : Block number 1
Block number 2
Close The global variables declared by the standard are protected. Only certain fields can be modified. |
The following fields are present on the window opened through this button : Block number 1
Block number 2
Close Used not only to create the record in the global variables table, but also to generate the documentation (PRE paragraph), if the text is entered. Used to create the declaration lines for the variable in the linked process. |
The following fields are present on the window opened through this button : Block number 1
Block number 2
Close Used not only to delete the record from the global variables table, but also
Warning, there is no control of the supervisor, whether the use of this variable is in the current process or in another process. |
The following fields are present on the window opened through this button : Block number 1
Block number 2
Close Used to recopy the definition of a global variable to another folder. A validation is then necessary to generate the associated process. |
Used or the re-generation of all the processes known to this global variables dictionary. |
Menu Bar
Option / Context of formula assistant
Used to access by tunnel on the function "formula assistant context".
Documentation / Paragraphs
This function is used to access the documentation management on the first paragraph of the documentation (if there is one) associated to the current record.
Documentation / Links
This function is used to access the links management. It is used to define the links between the current and other records (for example the links between functions and setups). These links are specific to the documentation and are used to load the generation of documentation structures.
Documentation / Generation
This menu is used to launch a documentation generation. The generation can also be launched from the [Generation] button at the bottom of the window.
Three types of generation can be launched one by one or simultaneously:
- the generation of the documentation structure from the dictionary (tables ADOCUMENT, ADOCBLB, ADOCCLB).
- the generation of the documentation from the previous tables.
- the generation of the field documentation.
The range suggested by default takes into account the current record but it can be modified upon launch.
Error messages
In addition to the generic error messages, the following messages can appear during the entry :
Non-existent parameter
If a parameter is entered, it must exist in the parameters definition table ADOPAR.
This parameter is used by the global variable xxxxxxxxx
This parameter is already associated with a global variable. It can only load one variable.
Incorrect data type
There must be complete compatibility between the variable data type and the parameter type.
Incorrect value
The variable code must start with G, X, Y, or Z
The name of a global variable must start with G for the standard and X, Y or Z for the specific/custom.