Development > Data and parameters > Tables > Local menus - messages 

Certain database information is displayed in the form of a list with restricted choice. For instance, the Yes / No choice, round codes, report groups, etc., are available in the form of a table holding the limited choices of items available.

This type of data is called a local menu and the table used is identified by a module number. For all the fields in the database storing data of this type, the title row is stored in the corresponding table. Thus, if for instance in local menu number 1, composed of the 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 all the miscellaneous tables, this system is used to avoid the creation of a large number of annex table, the description of these local menus being stored in a single table in the database : the APLSTD table. Furthermore, these local menus have the advantage of being translatable: indeed, as only the title row in the table is stored, it is only necessary to change the table to display or enter with another title translated into the appropriate language.

Warning, it is necessary to take care when modifying these tables, not to insert values but only to add values to the list of titles. Unless no data has yet been assigned to a given local menu, inserting a choice leads to titles being switched for data that has already been entered, because only the row number has been stored in the table. Thus if the choice Maybe is entered in the first row of the No / Yes table, all the fields in the database having been entered with the value Yes will be redisplayed with the value No, those entered with the value No taking the value Maybe ! The number of choices in a local menu is limited to 123.

Beyond the notion of local menu, 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.

It is of course recommended to all the developers of specific functions to do do. In order to have easy access to the texts in the processes or in any calculation formula, the standard function mess is available to provide access to the messages. Indeed, Mess(NUM,CHAP,1) provides access, in the current connection language, to the message number NUM from the chapter CHAP.

In any case, each software with the adonix technology defines its own mapping for the chapters, by allocating number ranges to functional modules of each offer. The module assignment specific to the software involved can be found in the annex.

Prerequisites

SEEREFERTTO Refer to documentation Implementation

Screen management

Entry screen

Presentation

The entry is made by chapter in 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.

Close

 

Fields

The following fields are present on this tab :

Identifier

  • Chapter (field LANCHP)

Define the number of the chapter that is to be parameterized.

  • Description (field TITCHP)

Title associated to 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)

[object Object]

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.

  • 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)

 

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.

Close

 

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

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

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

Error messages

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

incorrect value

A user has attempted to modify a non modifiable chapter (example: chapter 200).

Tables used

SEEREFERTTO Refer to documentation Implementation

Annex: number ranges used

The number ranges assigned to the supervisor module are common to all software written in adonix technology. The function Module range, that can be accessed via right click in the field Module, can be used to know these reserved ranges.

Chapter numbers vary from 1 to 29,999.

The standard local menus are grouped according to the distinct modules in the software. The table below defines the ranges common to all Sage X3 products:

Number ranges

Contents

1-99

Supervisor

900-949

Web

1000-1999

Reserved for vertical local menus

2281-2300

Crystal report

 2900-2954

Supervisor

 4000-4999

Reserved for Add-ons

 5200-5999

Reserved for vertical local menus

 6200-6999

Reserved for custom local menus 

8000-8099

Localization for the USA

8100-8199

Localization for England

8200-8299

Localization for Spain

8300-8399

Localization for Portugal

8400-8499

Localization for Italy

8500-8599

Localization for Argentina

          8600-8699

Localization for Germany 

8700-8799

Localization for Switzerland

In addition to the local menus, the messages can be entered in the chapters for the number groups reserved for them. The number range 160 to 169 is reserved for custom/specific developments. The messages can this be translated into the languages managed by the folder.
The table below defines the various ranges common to the Sage X3 products:

Number ranges

Contents

100-159

Supervisor messages

 160-164

Reserved for custom messages

165-169

Reserved for vertical messages

 5000-5199

Reserved for vertical messages

 6000-6199

Reserved for custom messages

7800-7999

Supervisor messages

8890-8899

Localization messages for Argentina

8900-8909

Localization messages for the USA

8910-8919

Localization messages for England

8920-8929

Localization messages for Spain

8930-8939

Localization messages for Portugal

8940-8949

Localization messages for Italy

8950-8959

Localization messages for Germany

          8960-8969

Localization message for Switzerland

9000-9149

Adonix engine and client messages

9300-9322

Portal

9700-9899

Web

9900-9909

Adonix console

9910-9912

Crystal Report runtime

9913

Outlook synchronization

9914-9949

--- Reserved for Supervisor

9950-9960

FLASH components

 9961-9965

Designer Process Components 

9966-9999

--- Reserved for Supervisor 

10000-10029

Supervisor: fusion client tests

10030-10035

--- Reserved for Syracuse 

10036-10037

--- Reserved for Eclipse 

The various ranges for the Sage X3 local menus are the following:

Number ranges

Contents

100-200

Miscellaneous

201-300

Common data

301-400

Manufacturing

401-500

Sales

501-600

Purchasing

601-700

Financials

701-800

Stock management

801-899

Fixed Assets

950-999

Customer Relation

2000-2280

Ext. Common data

2301-2400

Ext. Manufacturing

2401-2500

Ext. Sales

2501-2600

Ext. Purchasing

2601-2700

Ext. Financials

2701-2800

Ext. Stock management

2801-2899

Time / Cost / Ext. Financials

2955-3099

Ext. Customer Relation

3100-3389

Ext. Fixed Assets

3390-3400

--- not yet assigned ---

3401-3500

Warehousing interface 

3501-3600

Ext. Manufacturing

 3601-3700

Ext. financials 

 3701-3999

--- not yet assigned ---  

 10030-10300

--- not yet assigned ---  

 10301-11999

HRM 

 

 11500-11549 UK legislation

 

 11550-11599 Portuguese legislation

 

 11600-11649 Moroccan legislation

12000-29999

--- not yet assigned ---

The various ranges for the Sage X3 local menus are the following:

Number ranges

Contents

 170-199

Standard messages

7700-7709

Accounting messages

7710-7719

Common data messages

7720-7729

Manufacturing messages

7730-7739

Sales messages

7740-7749

Purchase messages

7750-7759

Stock messages

7760-7769

CRM messages

7770-7789

Fixed Assets messages

 9150

ILOG Messages

9151-9160

Weighing machine messages

The following table determines the various ranges that exist for Sage Warehousing:

Number ranges

Contents

301-310

Warehousing messages

311-400

Warehousing local menus

401-410

Warehousing messages

411-500

Warehousing local menus