Customizer 

File Definitions

 

Layout of a Customizer Definition File

Customizer definition files correspond to their associated panel library; that is, if there are custom definitions for panels in a library called mypanels.en, then the custom definitions will be stored in a file called mypanels.cus.en. Potentially, there could be one customer definition file for each panel library.

library_name.cus.language_suffix

External Key:

27

panel name (12) + owner (12) + sequence (3)

Where:

 

panel name

12

Uppercase/Padded with spaces.

 

owner

12

mid(WHO,1,12) for Personal, blank (dim(12," ") for Public/Padded with spaces.

 

sequence

3

Sequence number/Leading zeros.

Customer definition records have two layouts: one for items from Application and User Files, and one for Formulas.

Application and User File Fields:

 

Source

Information source (A = Application File, U = User File, F = Formula).

 

File_id

6-digit file identifier (from providex.ddf or providex.udf files).

 

Phys_File

Physical file name (simple path).

 

Item_Name

Name of the file element to be displayed.

 

KeyDef

Key definition for accessing records (PxPlus expression).

 

Flags

U = Allow update for User file.

 

Security

Not Applicable

 

Display_Option

Special display option Pcolor ("P" followed by a color, e.g. PLight Red). Display value using a Percent Bar in the specified color.

(Display_Optionwas added in PxPlus 2017.)

Formula Fields:

 

Source

Information source (A = Application File, U = User File, F = Formula).

 

Desc

Short description used as a label in the Custom Information grid.

 

Type

Data type (S = String/Text, N = Numeric).

 

Formula

Formula definition (PxPlus expression).

 

Len

Maximum length of data to be displayed.

 

Format

Optional display format (PxPlus format string).

 

Security

Security classifications assigned to the formula.

 

Display_Option

Special display option Pcolor ("P" followed by a color, e.g. PLight Red). Display value using a Percent Bar in the specified color.

(Display_Optionwas added in PxPlus 2017.)

Layout of a User File

User files are keyed files with an external key size of 127 characters and a variable record size with a maximum of 4000 bytes. By default, these files are created in the Custom directory, which is located in the same directory as the PxPlus executable or where the Lib directory is kept (on a Vista system). This may be changed by loading the %NOMAD_Custom_Dir$ global variable with the path to an alternate directory.

The Customizer generates a default file name of the format _Unnnnnn.dat (where nnnnnn is a sequence number such as 000001). This can be overridden when the file is defined.

User Data Dictionary Files

The User data dictionary files (providex.udf and providex.ude) are created in the same directory as the Application data dictionary files (providex.ddf and providex.dde).

 

providex.udf

Contains file information on the Customizer User files. (The field layout is the same as for the providex.ddf data dictionary file.)

 

External Key:

6

6-digit File ID

 

Alternate Key 1:

[1:1:30:"CU"]+[5:1:12]

Logical Name + Owner

 

Alternate Key 2:

[5:1:12]+[1:1:30:"CU"]

Owner + Logical Name

 

Alternate Key 3:

[2:1:30:"LU"]

Physical File Name

 

providex.ude

Contains element information for the Customizer User files. (The field layout is the same as for the providex.dde data dictionary file.)

 

 

External Key:

12

6-digit File ID + 6-digit Sequence Number

 

 

Alternate Key 1:

[Key:1:6]+[2:1:30]

6-digit File ID + Element Name