Facts table
This function is used to describe the facts table which are to be used as base for the reports of the driven version of the software. A facts table is a data table loaded by one or several tables coming from one or several live folders and present in a datamart. It integrates:
- fields (which can be used in the management reports)
- links (to dimension tables used as analysis criteria)
- aggregates (in order to store the totaled amounts on criteria combinations for optimization purposes)
- indexes (also for optimization purposes).
The facts tables are not created in the folder itself but in a data structure called datawarehouse, which may be common to several folders.
The facts tables are loaded via a function integrated to the software (it is thus not necessary to use an external software of type ETL). Its parameters are defined by a dedicated function.
ABITUNNEL entry point
The ABITUNNEL entry point is used to modify the value of the OKK variable.
If [L]OKK = 0 then no tunnel can be defined on the dimension.
In any other case, it is possible to define a tunnel on the dimension.
Screen management
Header
Is used to define the code and the title of the table but also an abbreviation which will be used to access the facts table via the update processings.
Code (field CODABF) |
This code identifies the current record in a unique way. It corresponds to the name of the table that will be created in the datamart database. |
Abbreviation (field ABRABF) |
The table abbreviation must be composed of 1 to 4 characters (letters or numbers but must start with a letter). It is the unique identifier for all the table abbreviations of the data dictionary. The Adonix reserved words are prohibited. |
Description (field ZINTIT) |
field W |
Evaluated title (field INTEVAL) |
Tab Description
General information on the facts tables can be found here, notably on:
- the authorization conditions by site, if a field of this type is present. In the description of each report based on the corresponding data, it is possible to define if the restrictions by site must be applied to the users by specifying what is the function whose authorizations by site are under consideration.
- A date that ca be used for the purge of fact table data.
- A type of update used by the loading functions.
Characteristics
Activity code (field CODACT) |
An activity code is used to:
If the activity code is disabled:
|
Module (field MODULE) |
Authorizations
Authorization site (field AUZFCY) |
If this box is checked, a filtering by site can be made on the data in the facts table. This assumes that a site field exists in this table. The access rights for the site in the reports will be determined by means of a function code managing the data filtered by site : the sites authorized for the function in question for a given user will be assigned to the data in the report. |
Site field (field FLDFCY) |
Mandatory if an authorization by site is defined, this field is used to define the site field code to be used to filter the data. It must correspond to a field defined in the tab Fields in the facts table. This field must in addition be of the type FCY. |
Purge info
Date field (field FLDDAT) |
This date type field is used, where it exists, to base any purging of the facts table from this date. |
No. of storage days (field NBEPU) |
Number of information detention days. The superior data will be purged as that calculated date. |
Generation
Update type (field TYPMAJ) |
This field defines if the loading logic for the facts table must be :
|
Object "number of" (field NBRABF) |
If this box is checked, an object that is used to count the number of lines in the facts table is created in the universe. |
Tab Fields
Here is the detailed definition of the fields which can be:
- dimensions (that is analysis criteria which are as a general rule linked to an annex table).
- measures (values that can be displayed in detail or aggregated according to the dimension values).
- information (additional information fields).
Grid
Line no. (field NUMFLD) |
Field code (field CODFLD) |
Defines the code for the field in the facts table or the table describing dimensions. This code is that under which the field is known in the database (it is automatically suffixed with the characters "_0"). It is not visible when in the management reports (it is the title that is displayed) but can be viewed if looking at the SQL syntax that extract the data from the datamart. |
Normal title (field ZINTFLD) |
Type (field CODTYP) |
The field type is defined here, which characterize the entry format (numeric, any characters, date...) and the coherence controls (reference to a table for example). The principal generic types that exist : A : Alphanumeric In the case of the facts tables, it is necessary to enter the additional information for certain types (dates, miscellaneous tables, local menus). |
Lg (field LNGFLD) |
Used to define the length of a field when this field uses a generic data type where the length is not fixed. This is notably the case for the types A and DCB. |
Date (field TYPDAT) |
When a field from the facts or dimensions table is of the type date and is defined as dimension, it is automatically associated with a dimensions table named AX3DAT, which is automatically managed. It is then possible to specify here what are the time characteristics linked to the date that will be accessed in the analyses. A list of characters to be defined is given, not forgetting there are the following correspondences :
Thus, for example, YMW signifies that a direct access is available for the year, the month and the week defined by the date. |
Menu (field MENLOC) |
Defines the local menu number associated with the field defined on the line. When a field is of the type local menu (from 1 to 255) corresponding to the rank of a title in a table named local menu, stored in the messages table APLSTD. On entry or on display, the following are displayed according to the choices made in the user interface :
The interest of this type of entry is that the list of choices is displayed in the user connection language. Each local menu number characterises the list of available titles. For example, the local menu 1 corresponds to the choice No / Yes in this order. In this particular case, the user interface can also be a check box. |
Table (field TABDIV) |
If the field is associated with a miscellaneous table, the number that identifies it is defined here. |
Object type (field TYPFLD) |
Used to characterize the data in the facts table. The following values are possible:
It should be noted that a field of the type ACS (access code) is automatically defined as technical (it will not appear in the description of the fields in the facts table, but will be used to filter the data when used for queries in the facts table). |
Sub-class (field ZINTSSC) |
Tunnel toward object (field TUNNEL) |
Distinct account (field TYPOPE) |
Used to specify if a count of the number of lines available is required by criterion value. A measure of the account type is then created, to optimize the corresponding access. |
Activity code (field ACTFLD) |
An activity code is used to:
If the activity code is disabled:
|
Field Selection | ||||||||
Field descriptions
Block number 1
|
This function is used to add to the field grid fields coming from a table entered previously in the header of the window being opened from the current line. If the facts table has the name of one the tables of the software, this name is proposed by default.
Default values are applied to the grid containing the lines that are thus recovered:
- The main characteristics of the field are recovered as is (title, type, length, local menu, miscellaneous table, etc.)
- Once the field is characterized by a type linked to an object (or if it is of the type Date or Miscellaneous table, it is defined as a Dimension.
- If it is of type DCB, it is defined as a Measurement.
- Otherwise, it is defined as an Information.
If fields having the same title as a field to insert already exist, they are not inserted.
Tab Links
This tab is used to define the various links to the dimension tables managed by the software.
A link is characterized by the code of the dimension table and by a link expression. When there are several links to a same dimension table, it is necessary to give a distinct alias number.
Note that the automatic links do not need to be described here. Automatic links are the ones generated for the following fields:
- The fields of type date (D), which have an implicit join with an alias of the AX3DAT table.
- The fields of type Local menu (M), which have an implicit join with an alias of the AX3MNLxxx table.
- The fields of type Miscellaneous table (ADI), which have an implicit join with an alias of the AX3ADIyyy table.
- The fields of type Folder code (ADS), which have an implicit join with an alias of AX3DOS.
- The fields of type Access code (ACS), which have an implicit join with an alias of AX3ACC.
Grid
Line number (field NUMLNK) |
Dimension (field CODLNK) |
Define the table for thedimensions linked to the facts table. |
Link expression (field EXPLNK) |
Contains the links expression that is used to move up through the dimensions table by means of its key. A links expression can be composed of fields coming from the facts table and/or constants, separated by a semi-colon when there are several. |
Join option (field OPTJNT) |
Description (field ZINTLNK) |
Additional info (field ZINTCOMP) |
Tab Index
This type is used to define the indexes which are created in the facts table in order to optimize the access times.
Line number (field NUMIND) |
Description (field EXPIND) |
This is where the list of fields that make up the index are entered. The fields are separated by a '+' if there are several fields (for example, in the sites table FACILITY there is a key whose definition is LEGCPY+FCY). A descending sort field is preceded with the sign "-" (warning, it is used in the left list). The first field that makes up the index is without a sign and is therefore ascending. |
Activity code (field ACTIND) |
An activity code is used to:
If the activity code is disabled:
|
Storage characteristics
field STK |
A text describing the technical configuration of the table in the database is entered in this section. This text is recorded in a file "name.cfg" in the FIL directory for the application. This file is used by the "valfil" instruction. View the dedicated technical annex for more information. |
Tab Aggregates
In this tab the aggregates to be managed are to be defined. An aggregate is a table storing the intermediate totals based on the various values that a field or combination of fields can take. The advantage of these aggregates is that they help optimize the access times when a report concerns only the measures totaled on one of the aggregates: the access is direct since the data are not recalculated.
In this tab, one or several aggregates can be defined:
- a line of the upper grid represents an aggregate
- when the cursor is positioned on a grid line, the bottom grids (Dimensions and Index) are loaded with the characteristics of each aggregate.
The table Dimensions displays the list of dimensions whose crossing defines an aggregate. These dimensions can have a predefined type (date, local menu, miscellaneous table), or have type Other; this type is used to enter one of the dimensions listed in the corresponding tab.
Note that for each aggregate defined in the facts table:
- the site dimension is mandatory if an authorization by site is managed in the facts table.
- the dimensions having an access code are also mandatory.
The table Index is used to define the indexes in order to make faster the access to the aggregate data.
Grid Aggregates
field NUMAGG |
Name (field CODAGG) |
This code identifies the aggregate parameterized in the facts table. |
Activity code (field ACTAGG) |
This activity code is used to make the aggregates defined in a facts table optional. An activity code is used to:
If the activity code is disabled:
|
Grid Dimensions
Dim view type (field TYPDIM) |
This field defines the dimension type that is part of the aggregation. This can be either a dimension defined in the links tab (in this case, the type Other is used), or a dimension implicitly created from the particular data type (the type Date, on which time aggregates can be defined and the types local menu and miscellaneous tables). |
Dimension (field DIME) |
Used to give the code of the dimension that is part of the aggregate. When the type of dimension is not Other, the first dimension of the selected type is proposed by default (it is imposed if no others exist). |
Fields (field CHAMPS) |
Value displayed that gives the list of fields concerned by the dimension that is part of the aggregate. |
Aggregation level (field NIVEAU) |
Define the aggregation level for a dimension when it is of the type date. This can be either the day, the month, the quarter or the year (but only the levels defined in the grid containing the fields that can be used). |
Grid Index
Index (field INDEX) |
This is where the list of fields that make up the index are entered. The fields are separated by a '+' if there are several fields (for example, in the sites table FACILITY there is a key whose definition is LEGCPY+FCY). A descending sort field is preceded with the sign "-" (warning, it is used in the left list). The first field that makes up the index is without a sign and is therefore ascending. |
Specific Buttons
Copy
This button is used to copy the record definition from or to another folder. Block number 1
Block number 2
|