In the application, some specific database information is displayed in the form of a restricted selection list: Yes / No, Round codes, Report groups, etc. These all correspond to tables that hold the limited list of items available for selection.

These datasets are called Local menus and are identified by a Chapter number, which is assigned to the corresponding table of available items. When a field in the database is linked to this type of data, the rank (row) number is actually recorded in the corresponding table. For instance, Local menu number 1 contains the two choices No and Yes (in this order): what is actually sorted in the database is '1' for the value No, and '2' for the value Yes.

A large number of local menus is used in the software. As with Miscellaneous tables, this system is used to avoid the creation of a large number of annex tables: the description of these local menus is stored in a single table in the database (table APLSTD). These local menus can be translated: as only the rank number is stored in the table, you only need to change your connection language to display or enter the table in this language.

When modifying these tables, make sure not to insert values but only add values at the end of the list. Inserting a value will move down all the following values and cause inconsistencies as only the row number is stored (unless no data has been assigned yet to the local menu). For example, if you enter Maybe on the first row of the No / Yes table, all the fields in the database set to Yes will be now set to No, and the ones set to No will display the value Maybe! The number of choices in a local menu is limited to 123.

Besides 'Local menus', some chapters in the table are used to store other messages, such as error messages. As a standard, when a specific message needs to be displayed to the user (for instance, a confirmation request, an error message, a comment in a log file, etc.), the message is stored in a chapter dedicated for that purpose, in order to make these messages translatable based on the connection language.

All the developers of specific functions are advised to follow this same process. To get easy access to the text in processes or calculation formula, the standard function mess provides access to the messages. Use mess(NUM,CHAP,1) to get access, in the current connection language, to the message number NUM coming from chapter CHAP.

As a general rule, all adonix technology softwares define their own chapter mapping by allocating number ranges to the functional modules for each product. Please refer to the appendix to know more about the assigned modules for each product.

Prerequisites

SEEREFERTTO Refer to documentation Implementation

Screen management

Entry screen

The entry is performed by chapter on a single tab. A chapter can be a local menu or even a group of messages. On exiting this function, if at least one local menu has been modified, the system will automatically launch an update of the local menus in order to update sequential files, used as caches for the local workstations depending on the languages managed in the folder.

Identifier

Chapter (field LANCHP)

Define the number of the chapter that is to be parameterized.
Description (field TITCHP)

Title associated with the previous code.
Local menu (field MENLOCAL)

When this box is checked, the chapter is usable as a local menu and not simply as a list of messages.

Characteristics

Module (field MODULE)

Select a module for the setup.

Use this field to specify if the screen has to be created in the folder database. This is the case when the module linked to the screen is active on the folder.
Activity code (field CODACT)

An activity code is used to:

  • Make an element optional 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

If the activity code is disabled:

  • The marked element will not be useable
  • The associated code will not be generated nor activated
Changeable (field AUZMOD)

This field is used to indicate if the local menu is modifiable by the user in a parameterization phase, directly in the menu Parameterization / General parameters.
Do not translate (field NONTRA)

Upon the creation of a new line, this indicates that the text will not be created in the other languages of the current folder.

Size

Length (field LONG)

This field makes it possible to specify the maximum text width in the different local menu choices.

Mini (field MINI)

This field makes it possible to indicate the minimum number of possible choices that the local menu must include.

Maxi (field MAXI)

This field makes it possible to indicate the maximum possible number of choices that the local menu include.

Grid List of values

Number (field LANNUM)

Define the message number in a chapter A local menu defines by this rank the value of the field corresponding to the title.
Code (field CODE)

Code on one character associated with the title.
Message (field LANMES)

Define the title associated with the message number in a chapter. It is this title that is displayed in a component of the type "rolling list" or "radio button" when the field is used as a local menu.

Reports

By default, the following reports are associated with this function :

  PRTSCR : Screen print

  APLSTD : Local menus

This can be changed using a different setup.

Specific Buttons

This button is used to copy the record definition from or to another folder.

Block number 1

field OBJET
field CLES

Block number 2

From folder (field DOSORG)

Use this field to define the folder from which the record will be copied. The possible syntaxes are described in the Dedicated appendix.
All folders (field TOUDOS)

Use this option to copy the record to all the folders defined in the dictionary (ADOSSIER table of the current solution).
To folder (field DOSDES)

Use this field to define the folder to which the record will be copied. The possible syntaxes are described in the Dedicated appendix.