Development > Data and parameters > Development setup > Global variables  

This function is used to capitalize a set of global variables defined in the application and to generate automatically the declaration (or even to initialize it if it is planned so in the record) in the sub-program DEFVAR of the processing specified in the record. It is never possible to add processing lines in the generated processings.

This is a delicate function since it intervenes in the processing variable declaration. It is essentially designed for developers and should not under any circumstances be left in the hands of unauthorized users. It is strongly advised not to modify the standard or when doing it at all, do it on purpose.

When checked, the "public" checkbox indicates that the global variable can be reused, notably by the specific. The documentation linked to this variable is available.

The global variables used in the product are not all declared in this dictionary. It is necessary to identify:

  • those allocated to a setup
  • those going beyond a processing.

For the variables that are not in the dictionary, they should be declared directly in the functional processing.

Prerequisites

SEEREFERTTO Refer to documentation Implementation

Screen management

Entry screen

Presentation

A single screen is used to write the variable, specify it format, its size and if needed to setup 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 :

  • the standard starts with the letter "G"
  • commence par la lettre "X" pour le vertical
  • commence par l'une des lettres "Y" ou "Z" pour le spécifique.

This variable belongs to the class [V].

  • Description (field ZINTIT)

Enter the description of the relevant record.

This long description is used as a title in screens and reports.

Characteristics

An activity code is used to:

  • make optional an element in the dictionary if the value associated with the activity code is null.
  • identify the specific/custom elements if they are marked with a code starting with X, Y or Z.
  • size a maximum number of lines when the activity code marks elements from a grid.

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 (field MODULE)

[object Object]

  • Public (field PUBFLG)

This flag indicates that this element is published. It can therefore be re-used by the custom/specific. An associated documentation is available.

Description

  • field TEXTE

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.

  • Internal type (field TYPTYP)

Field displayed with the value coming from the data type.

  • Length (field LNGTYP)

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

  • Formula (field FORDIM0)

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.

  • From 1 (field FORDEB0)

 

Block number 8

Block number 9

  • Formula (field FORDIM1)

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.

  • From 1 (field FORDEB1)

 

Initialization

  • Parameter (field PARAM)

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 DES1

 

  • Formula (field FORINI)

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.

  • Initial processing (field TRTINI)

 

Generation

  • Script (field TRTSTD)

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 :

  • WWAGLOBUSR : for the parameters at the user level
  • WWAGLOBVAR : for all other parameters
  • field TRTINTIT

 

  • Sequence (field RANG)

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 included on the window opened through this button :

Block number 1

  • field OBJET

 

  • field CLES

 

Block number 2

  • From folder (field DOSORG)

Indicate the folder from which the record is going be copied. The possible syntaxes are described in the dedicated appendix.

  • All folders (field TOUDOS)

This option is used to copy the record to all the folders defined in the dictionary (ADOSSIER table from the current solution).

  • To folder (field DOSDES)

Indicate the folder in which the record is going be copied. The possible syntaxes are described in the dedicated appendix.

Close

The global variables declared by the standard are protected. Some fields only can be modified.

The following fields are included on the window opened through this button :

Block number 1

  • field OBJET

 

  • field CLES

 

Block number 2

  • From folder (field DOSORG)

Indicate the folder from which the record is going be copied. The possible syntaxes are described in the dedicated appendix.

  • All folders (field TOUDOS)

This option is used to copy the record to all the folders defined in the dictionary (ADOSSIER table from the current solution).

  • To folder (field DOSDES)

Indicate the folder in which the record is going be copied. The possible syntaxes are described in the dedicated appendix.

Close

It is used to create the record in the global variable table, but also to generate the documentation (paragraph PRE) if some text is entered.

It is used to create the lines for the variable declaration in the linked processing.

The following fields are included on the window opened through this button :

Block number 1

  • field OBJET

 

  • field CLES

 

Block number 2

  • From folder (field DOSORG)

Indicate the folder from which the record is going be copied. The possible syntaxes are described in the dedicated appendix.

  • All folders (field TOUDOS)

This option is used to copy the record to all the folders defined in the dictionary (ADOSSIER table from the current solution).

  • To folder (field DOSDES)

Indicate the folder in which the record is going be copied. The possible syntaxes are described in the dedicated appendix.

Close

It is used not only to delete the recording in the global variable table, but also

  • to delete the associated documentation,
  • to delete the declaration and the potential initialization of the variable in the processing

Caution: there is no Supervisor control on the use of this variable in the current processing or in any other processing.

The following fields are included on the window opened through this button :

Block number 1

  • field OBJET

 

  • field CLES

 

Block number 2

  • From folder (field DOSORG)

Indicate the folder from which the record is going be copied. The possible syntaxes are described in the dedicated appendix.

  • All folders (field TOUDOS)

This option is used to copy the record to all the folders defined in the dictionary (ADOSSIER table from the current solution).

  • To folder (field DOSDES)

Indicate the folder in which the record is going be copied. The possible syntaxes are described in the dedicated appendix.

Close

Is used to duplicate the definition of a global variable to another folder. It is then necessary to validate in order to generate the associated processing.

Is used to regenerate all processings known in this dictionary of global variables.

Menu Bar

Option / Formula Wizard setup

Used to tunnel to the function "contextual formula wizard".

Documentation / Paragraphs

This choice of menu allows to zoom to the documentation management, on the first documentation paragraph (if it exists) related to the current record.

Documentation / Links

This choice of menu allows to zoom on the dictionary link management function. This function allows to establish links between the current record and other records (for example links between functions and parameters). These links, dedicated for documentation purpose, allows the generation of documentation structure.

Documentation / Generation

This choice of menu allows to generate the documentation. Three types of generation can be separately or simultaneously started :

  • the generation of the structure of documentation from dictionary (tables ADOCUMENT, ADOCBLB, ADOCCLB).
  • the generation of the documentation itself from the previous table (they have been normally completed after the first generation).
  • the field help documentation generation.

The ranges and parameter proposed by default are defaulted according ti the current record, but they can be changed during the execution.

Error messages

In addition to the generic error messages, the following messages can appear during the entry :

Non-existent setup

If a setup is entered, it must be present in the setup definition table ADOPAR.

This setup is used by global variable xxxxxxxxx

This setup is already associated with a global variable. It can load only one variable.

Incorrect data type

The data type of the variable and the setup type must be fully compatible.

Incorrect value
The variable code must begin with G, X, Y, or Z

The name of a global variable must start with a G for the standard development, and an X, Y or Z for the specific development.

Tables used

SEEREFERTTO Refer to documentation Implementation