# 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 |