Configuration options
This section provides brief descriptions of all attributes in the configuration file (portalconfig.xml). Longer descriptions of the options show elsewhere in this document.
The subsections that follow represent sections within the configuration file. Within each subsection, attributes are listed in the order in which they show in the file.
SERVICES
The SERVICES section of the portalconfig.xml file contains important information about your installation that was configured when Lawson Portal was installed. Do not change any values in this section unless instructed to do so by a Lawson representative.
SCRIPTS
The SCRIPTS section contains information used by Lawson Portal that was configured at installation. Generally, you would not make changes to the SCRIPTS section unless instructed to do so by a Lawson representative.
However, if you are a site that performs custom development, you can use this section to add your JavaScript files to Lawson Portal. You would do this by adding a new entry to this section.
SETTINGS
Settings are global attributes that affect how Lawson Portal functions generally.
Any changes you make here affect all users. All administrators configure these attributes by editing portalconfig.xml.
| Attribute Name | Values Description / Default |
|---|---|
| drill_values | You can change the selectable number of records per page that users can choose from when they perform an operation that retrieves records (data query, list selection, or drill transaction). |
| erp_button_order | You can change the order that buttons for Add, Delete, Change, Inquire, Previous, and Next show in all Lawson-delivered ERP forms. |
| perform_key_check | For Lawson internal use. Do not configure this attribute. |
| role_based_options |
If this option is disabled, the Lawson-delivered role file (default.xml) is in effect for all users and any customization is made through portalconfig.xml and applies to all users. This attribute should be disabled only for installations that do not use any custom roles and that are making some changes to default settings for Role or User options. 1 = Enabled 0 = Disabled Enabled by default |
| updates_prompt |
Lawson Portal prompts at log-in if a user, in a previous session, made changes to their layout that have not been saved. A user would also receive this prompt if a layout change was made by the administrator. If you as an administrator frequently change users’ layouts, you might want to disable this prompt to prevent confusion for users. 1 = Enabled 0 = Disabled Enabled by default |
|
use_sso_authentication |
This option is not used. Do not change any settings. |
| allow_enter_hotkey |
If this option is enabled, you can use the Enter key to assign a specific Hotkey in Lawson Portal. This option is enabled by default in new installs. However, users who are applying updates or patches must include this new element under the SETTINGS node: <SETTING id="allow_enter_hotkey" value="1"/>
1 = Enabled 0 = Disabled |
| allow_LSR | If this option is enabled (set to "1"), all users can access Lawson Smart Reports. |
| context_messages |
If this option is enabled (set to "1"), context messaging is allowed. This option is enabled by default. |
| listview_values |
This option sets the values for the List View Number of Records selection in the User Options and Role Manager. Users can select from the default values: 250 and 500; or put additional values by using pipe character (|) as delimiter. |
| maxbookmark |
Allows specification of the maximum amount of bookmarks that can be loaded in the Users > Content page. The default is 5000. |
ROLE OPTIONS
Role options are attributes that are intended to be configured on a per-role basis. Installations that do not use custom roles can configure these options globally through portalconfig.xml.
Installations that use custom roles should use Role Manager to configure these attributes.
| Attribute Name | Values Description/ Default |
|---|---|
| allow_jobdef |
Enables / disables users' ability to access the job definition menu. 1= Enabled 0 = Disabled Enabled by default |
| allow_joblist |
Enables / disables users' ability to access the job list. 1= Enabled 0 = Disabled Enabled by default |
| allow_jobschedule |
Enables / disables users' ability to access the job scheduler. 1= Enabled 0 = Disabled Enabled by default |
| allow_printfiles |
Enables / disables users' ability to access the print file menu. 1= Enabled 0 = Disabled Enabled by default |
| allow_recdef |
Enables / disables users' ability to access recurring job definition . 1= Enabled 0 = Disabled Enabled by default |
| allow_jobpolling |
Enables / disables users' ability to have the job scheduler window refreshed automatically. 1= Enabled 0 = Disabled Enabled by default |
| allow_context_messages |
If this option is enabled (set to "1"), context messaging is allowed. 1= Enabled 0 = Disabled Enabled by default |
| use_compact_transaction |
Enables / disables use of compact transactions. It is unlikely that it would make sense to enable this feature for an entire system. Typically, only a few users (for example, those who connect from a remote site) would ever require it; enable it on a role basis for those users. If you must enable it for an entire system: 1= Enabled 0 = Disabled Disabled by default |
| allow_tabbed_browsing |
You can use this option to allow multiple forms and pages to be displayed in the same window. 1= Enabled 0 = Disabled Enabled by default |
USER OPTIONS
User options are attributes that users can change per their preferences.
The administrator can globally configure these options by:
-
Disabling users' ability to change them. You do this by setting the disable flag to "1" (disable="1"). The attribute is grayed-out in User Options.
-
Setting a default value: A default value is the initial value that the user sees for an option. To change it, type the appropriate value, as described in the table below, for "defval=".
-
Setting a required value: If you want to require users to use a particular value at all times, not just initially, type the appropriate value, as described in the table below, for "reqval=". If you choose to set a required value, it is a good idea to set the disable flag to "1" to prevent users from changing it.
Installations that do not use custom roles can configure these options globally through portalconfig.xml. Installations that use roles should use Role Manager, not portalconfig.xml, to configure these attributes.
Follow the instructions in the table to set default [or required] values.
| Attribute Name | Values Description / Default |
|---|---|
| locale |
The language used in Lawson Portal. If no default value (defval="") or required value (reqval="") is specified (defval="") and the user has not specified a locale in User Options, Lawson Portal checks user information stored in Resource Management. To set a default or required value, type the name of the language between the quotation marks for the appropriate value. Ensure the name is within quotation marks. If your site is not multi-lingual, you might want to disable users’ ability to change this option by setting Disable="1". |
| pdl |
Product line (or data area) for all users. If no default value (defval="") or required value (reqval="") is specified and the user has not specified a product line or data area in User Options, Lawson Portal checks user information stored in Resource Management. To change the default or required value, populate the appropriate value with the name of the product line or data area. Ensure the name is within quotation marks. |
| printer |
Default printer for all users. If no default value (defval="") or required value (reqval="") is specified and the user has not specified a printer in User Options, Lawson Portal checks user information stored in Resource Management. To set a default or required value, populate the appropriate value with the name of the printer. Ensure the name is within quotation marks. |
| separator |
Determines whether commas, tabs, or semicolons will be used to separate columns for data import. Type the appropriate value within the quotation marks for defval or reqval with the appropriate value. 0 = comma 1 = tab 2 = semicolon "" = no default or required value Ensure the value is within quotation marks. |
| reportformat |
Determines output format for Lawson system reports. 0 = text 1 = PDF "" = no default Ensure the value is within quotation marks. |
| autoselect |
Determines whether required fields on Lawson applications are automatically selected. 0 = auto-select disabled 1 = auto-select enabled "" = no default Ensure the value is within quotation marks. |
| uselistmode |
Determines behavior of Lawson application when a user opens a form. 0 = Records display in a list format for quick selection 1 = Application form is blank and the user must enter a key field or perform a search. Make sure the value is within quotation marks. |
|
explorer select listmoderecs |
Determines the default number of records per page that will be available to select when a user performs a drill transaction (explorer), selects from a list (select), or displays a data query results list (listmoderecs). This is the number that is displayed if the user does not select another of the available values. Lawson delivers defval="50" for "explorer" and "25" for both "select" and "listmoderecs." You can change the default or set a required value to be any of the page counts that are available for selection at your site. |
| uselistview |
Enables the List View functionality. By default, the uselistview value is set to zero. 0 = Disables the List View 1 = Enables the List View |
| listviewrecs | Determines the number of records returned in List View. The default value is 500. |
| findfilter |
This user option is used in Advanced Search for a Drill Select or a Drill Explorer 0 = Disables the filter 1 = Enables the filter; Default value |
| consolelog |
Allows information (warnings, errors, or debug details) to be written to the browser console log. 0 = Turns off writing to the console log 1 = Turns on writing to the console log |
| showproductline |
This user option shows the users current product line in the page title. 1= Enabled 0 = Disabled Disabled by default |
| accessibilitybehaviors |
This user option enables various accessibility enhancements. 1= Enabled 0 = Disabled Disabled by default |
| usertimezone |
This user option determines the time zone to be used when submitting jobs and displaying timestamps in Print Manager and Job Scheduler. 0 = Uses the time zone of the server 1 = Uses the time zone of the client machine |