As an administrator, you can configure the GL Lines component integrated with your app to customize different functionalities of the GL Lines grid. You must add these configurations in the configuration file of the app that includes the GL Lines component.
You can configure the grid, fields, and validators associated with each field. Refer to the appropriate properties and their subelements listed below in conjunction with the configuration file. In your app, these properties might be available with different names. Refer to your app documentation to identify the properties that you require to map with the properties listed here.
viewerConfig
This GL Lines property allows you to customize the grid.
The following elements, when associated with this property, allow you to modify the functionality of the GL Lines grid.
- moduleName. Specifies the name of the app that includes GL Lines.
- glFieldsConfig. Specifies the field configuration for GL grid.
- glLineMobileSummaryFieldsConfig. Contains display configuration for the GLViewer property on mobile devices. This is an optional subelement.
- glFieldsValidatorConfig. Contains the mapping of GL field names and their corresponding validators. Each field can be mapped with an array of validators. This is an optional subelement.
- validationTypeToErrorCodeMap. Contains mapping of standard validators and their corresponding error codes. This is an optional subelement.
- remoteFetch. Allows you to specify whether GL Lines collects settings related to glFieldsValidatorConfig and validationTypeToErrorCodeMap from the FPA service or from your app. The values that you can assign to this subelement are true and false.
- interactiveSaveDisabled. Allows you to disable or enable the user-interactive save feature. The values that you can assign to this subelement are true and false. Associate a false value to enable the Save button. If you associate a true value, the Save button is disabled and the button does not appear on the grid toolbar. This is an optional subelement.
- autoSave. Allows you to enable autosave feature for the GL Lines grid. This is an optional subelement.
- validate. Allows you to specify whether you want to perform external validation when the grid loads. The values that you can assign to this subelement are true and false.
- demoMode. Allows you to render all GL viewers in your app in demo mode. The values that you can assign to this subelement are true and false. Associate a true value to enable demo mode. You can customize the default demo data by editing the demo data configuration files that are located in the [Drive:]\Program Files\Apache Software Foundation\[Tomcat Installation]\webapps\apapproval\packages\les-rdk-fpa-ap-core\src\demoData directory.
- mode. Allows you to configure the availability of access modes to the user. The three access modes are viewOnly, modifyOnly, and fullEdit. Based on the configuration, users can access GL lines in any or all of the modes. In viewOnly mode users can only view the grid lines and show or hide columns. In modifyOnly mode users can also edit GL lines and can perform undo, redo, and save operations. In fullEdit mode users can also add, delete, copy, cut, and paste GL Lines.
glFieldsConfig
This element contains configuration for the columns of the GL Lines grid. The following subelements, when associated with glFieldsConfig, allows you to modify the functionality of the fields in the GL Lines grid.
- name. Allows you to specify the GL field names.
- label. Allows you to specify GL field label.
- visibility. Allows you to hide or show a field. The values that you can assign to this subelement are visible, hidden, alwaysVisible, and alwaysHidden.
- disabled. Allows you to control whether the end-user can edit a field or not. The values that you can assign to this subelement aretrue and false. Assign the true value to disable editing on a field or assign the false value to enable it.
- align. Allows you to specify the text alignment of the fields. You can align field text to the left, right, or center by assigning the left, right, or center value, respectively.
-
searchConfig. Determines a lookup field. This subelement includes the
configuration objects "minLength," "style," "maxResults," and "descField." The
"descField" configuration object also includes configurable properties that you
can find in the following code snippet.
"descField": {"showDescInField": true, "showDescInResults": true, "label": "G/L Account Desc", "delimiter": " | "}
glFieldsValidatorConfig
This element defines mapping between GL field names and their validators. Each field name is mapped to an array of validators. The field names must be same as the field names mentioned in the glFieldsConfig property. The following subelements, when associated with this property, allows you to specify validation type, validation parameters, severity of validation failure, and validation message for each field.
- type. Allows you to specify the type of validation that is associated with a field, line, or grid. The values that you can assign to this subelement are Required, RegularExp, Length, MinLength, MaxLength, RangeLength, Numeric, Alphabetical, and Alphanumeric.
- severity. Allows you to specify the severity of a validation failure. The values that you can assign to this subelement are error and warning.
- params. Allows you to specify the parameters of the configured validators.
validationTypeToErrorCodeMap
This element defines the mapping between standard validators and the error codes.