Certain characteristics in the software objects are modifiable using the setup. These characteristics, stored in the objects table, are never updated when changing the version or when installing a patch (they remain unchanged in the case of version evolution).

The object personalization function is used to define these characteristics, which are essentially those linked to the selection windows and the left lists, as well as the presence of the associated functions (print, list, statistics) and the automatic links for the link explorer.

Prerequisites

SEEREFERTTO Refer to documentation Implementation

Screen management

Header

Presentation

The modification of the object characteristics is carried out by entering the following information in 2 tabs.

Close

 

Fields

The following fields are present on this tab :

The object code is comprised of 1 to 3 alphanumeric characters. The Adonix reserved words are prohibited.

  • Description (field ZLIBEL)

Title associated to the previous code.

Close

 

Tab Selection

Presentation

In this first tab it is necessary to define:

  • the order to follow to go through the data in the left list and the selection windows.
  • the information displayed in these selections (it is possible to have up to 15 columns in the left lists and selections).
  • functions available from the menu File.

The data displayed in the left list are fields coming from the object main table or a linked table, or even from expressions using fields coming form these tables.

Close

 

Fields

The following fields are present on this tab :

Selection screen

  • Index (field SELCLE)

This field is used to define an index for the principal file for the display in the left list and in the selection windows. If this field is empty, it is the first index in the table that is used.

  • Sign (field SELORD)

This field is used to define the direction from moving through the principal table for the display in the left list and the selection windows for the object.

  • Hierarchical list (field SELTREE)

When the key chosen for the let list is composed of several parts, the list presents only the first part of the key initially. By double clicking on one of the values of the key there is the possibility to explore the sub-values of the key and thus through the number of levels of existing sub-keys. When all the key levels are explored, a record can be selected from the table.

An example of this functioning can be seen in the site management object : each site being attached to a company, the initial display is the list of companies and there is then the possibility to expand a company by double clicking it : the list of sites then appears and it is possible to select one of these.

if the box is not checked, it is a simple list.

  • No. characters (field SELCAR)

Any field in a screen where the type is linked to a object has available a selection field accessible by right click or by.

This value is used to define the number of characters used to specify where the selection should start, as a function of what has been entered in the field before the selection. If this value is N, the selections starts from the first key where the first N characters are greater than or equal to the string entered. Indeed :

  • If the value 2 is entered and if the string DEF is entered before opening the selection, the selection window will start the search from the first value of the key greater than or equal to DE (if keys starting with DEA exist, it is these that appear first in the window). If H has been entered, the selection will start with the first key greater than or equal to H.
  • If this field has the value 0 and a string UVW is entered before opening the selection, the selection starts at A and is not limited.

Grid Selection fields

The table in which the field to be displayed is located is entered here. This table is either the principal table or one of the tables defined as linked to the principal table in the object definition.

This field can be empty if a calculated expression is displayed.

  • Field (field SELZON)

The fields present in the left list are entered here. They come from the table previously defined.

  • Expression (field SELEXP)

When a column from the left list is evaluated, a calculated expression is defined here whose result is placed in the column. A data type is then required to format the field.

  • Description (field ZSELINT)

This label is used as a column title both in the left list and in the selection windows for the object.

By default, the field label is used. It should be noted that this title can be translated. Thus if an unknown title is entered, the window that is used to create a new text in the dictionary opens automatically.

This data type is used to forma the previous expression in the left list.

  • Options (field SELSAI)

 

  • Length (field SELLNG)

 

  • Level (field SELPCK)

This label is used as a column title both in the left list and in the selection windows for the object.

By default, the field label is used. It should be noted that this title can be translated. Thus if an unknown title is entered, the window that is used to create a new text in the dictionary opens automatically.

Reports

  • Report (field RPT1)

This print code defines the report(s) launched when the File / Print menu option. It should be noted that the report ranges can be entered from the current record : in fact, the File / Print choice is only accessible if a current record is displayed on the screen.

By default, when using these button, the software will attempt to print the reports whose names are given here. But a non-direction table exists that is used to redefine, from the internal code given here, one or more reports (e.g. the printing of the picking lists, and delivery advice notes in the shipments object).

  • List (field RPT2)

This print code defines the report(s) launched when the File / List menu option. The File / Listchoice is always accessible and it is designed to be used to print general lists linked to the online tables.

By default, when using these button, the software will attempt to print the reports whose names are given here. But a non-direction table exists that is used to redefine, from the internal code given here, one or more reports (e.g. the printing of the picking lists, and delivery advice notes in the shipments object).

Miscellaneous

  • Statistics (field STA)

This tick box allows the activation of the "Statistics" button in the object. This button is used to call the statistics interrogations where the first criteria are defined by the data linked to the principal table or to the tables linked to the object.

  • Lock in modification (field MLOCK)

Used to trigger the logical lock when going to modify a record, where as standard it is set to the display of the record. In order to use modification mode, it is necessary to click on the key.

 

Archiving URL

  • field ARCURL

If this field is entered, the menu File/Attachments starts the ARCVISUOBJ action.
This formula is evaluated, the result of the evaluation is prefixed by the string contained in the GARCROOT global variable to define the URL that grants access to the archive base and to allow the inquiry of the attachments archived.

Close

 

When the GED connector is activated, in this tab is also defined a formula used to calculate the search URL of the documents linked to the object.

Tab Browser

Presentation

In this tab it is necessary to define the size of the left lists and the presence of additional left lists in the object:

  • the list of the last records read (displaying the last records accessed by the user, much like an Office software making it possible to view the last accessed documents).
  • the link explorer, which is a pane making it possible to access other records linked to the current record through parameterizable hyperlinks.

The following grid is used, when the link explorer is present, to define how to create automatically links between a current record (upon creation and/or modified) and other records. These automatic links are created in the link group defined by the LIAISAUTO setup, which can be different from the group link that the user sees (defined by the GRPLIAISON setup).

Close

 

Fields

The following fields are present on this tab :

Link explorer

  • Active (field EXPLORE)

This field allows the entry of the current object links with the destination objects.

The current object records linked with these objects are found in the link left list of these objects if this left list is declared in the object and the user has the good link group.

  • Short description (field ZLIBSHO)

This field is used to define a short title that will be subsitute, if it is entered, to the title for the object in the link description present in the link explorer. Thus, if there are links to an object whose title is long (Currency exchange rate for example), it is useful to give a short name (rate for example), in order to view in the link explorer a title such as Use rate XXX rather than Use exchange rate XXX that risks being too long to be displayed completely in the left list.

Last read

  • Active (field DERLU)

This box is used to activate/de-activate the Last read left list.

  • In first position (field FIRLIS)

This field makes it possible to place the left list 'Last read' in first position.

Grid Automatic links

This object is used to enter the object from where the link starts (automatic links are always considered to be made from a link object to the current record). Thus, for example, if wishing to make a link to another company (CPY object currently in parameterization) and a user (CREUSR field in the company record), an automatic link is defined in the company object by giving AUS as the link object and [CPY]CREUSR as the key for the link : the result will be a link to the company in the link explorer of the user record.

  • Link expression (field EXPLIEN)

The key is used to enter the link object, in the form of an expression (or a group of expressions separated by a semi-colon if the link key is composed of several parts). This is used to identify the record (of the link object) from which the link will start.

Warning there are limits to the definition of these automatic links. In fact, it can only be used on link expressions for fields in the principal fields. In view of the very simple structure of the link table, it is always possible to fill this table using a personalisation.

The like code is used to give a significance to the automatic link that has been defined. This code is defined in the miscellaneous table number 61.

  • Line field (field BASPAG)

This optional field is used to define, when a filed is sized, the variable "bottom of the grid" defines the number of occurrences entered in the grid. This is used to vary the current index to obtain several links. This supposes that an index variable is used in the link expression.

Close

 

Comments

Mandatory fields in the quick select list

It is important (in order to avoid execution errors in object management) that all the fields that make up the key used to move through the left list are defined in it.

Reports launched from the objects

The report codes defined in the object management are the internal codes associated by default with a report of the same code, but this assignment is modifiable using a re-direction table. This table, accessible using the Print codes function, is used to associate an internal code with the code of another report or several reports as a function of the language used by the operator. In the case when several reports are given, a choice will be possible on execution. The Default values function is used to define, in the form of calculated expressions coming from the object context, the default values for the report launch setups.

Default values

Another function is used to personalize the objects by authorizing:

  • the definition of default values upon record creation.
  • the application of filters by default.

But this function, called Navigation, is a development function. It is thus more difficult to use and makes it necessary to take specific precautions for the result to be kept as is upon version change.

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 transfer the set up elements from one object to another folder accessible from the server of the current folder.

Error messages

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

Table not defined

This message signifies that an attempt has been made to use a table to fill the left list that is not linked for the context of the object.

Tables used

SEEREFERTTO Refer to documentation Implementation