Configuration options

This section provides brief descriptions of all attributes in the configuration file (portalconfig.xml). Longer descriptions of the options appear 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 appear in the file.

Note: Do not make changes to any options (parameters) you see in the configuration file that are not described here. These options are for Lawson internal use only.

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 appear 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 his or her 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 Customer Updates (CUs) 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 will be 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.

max_list_view_edit_values

This option sets the values for the Maximum List View edits selection in the User Options and Role Manager. Users can select from the default values: 25, 50, 75, and 100; or put additional values by using pipe character (|) as delimiter with a maximum accepted value of 100.

maxbookmark

This option allows specification of the maximum amount of bookmarks that can be loaded in the Users > Content page.

The default is 5000.

show_form_token_id

This option configures if a form's token will be shown or hidden as part of the form's title.

1 = Show form tokens (default)

0 = Hide form tokens

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 will be 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 need it; enable it on a role basis for those users.

If you do need to enable it for an entire system:

1= Enabled

0 = Disabled

Disabled by default

allow_tabbed_browsing

This option allows multiple forms and pages to be displayed in the same window.

1= Enabled

0 = Disabled

Enabled by default

allow_list_view

Enables or disables users' ability to access List View.

1 = Enabled

0 = Disabled

Enabled by default

allow_list_view_editing

Enables or disables users’ ability to edit Infor Lawson application records in List View.

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 will appear grayed-out in User Options.

  • Setting a required value: If you want to require users to use a particular value at all times, not just initially, specify 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, specify the name of the language between the quotation marks for the appropriate value. Make sure 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. Make sure 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. Make sure the name is within quotation marks.

separator

Determines whether commas, tabs, or semicolons will be used to separate columns for data import. Specify 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

Make sure the value is within quotation marks.

reportformat

Determines output format for Lawson system reports.

0 = text

1 = PDF

"" = no default

The value must be within quotation marks.

autoselect

Determines whether required fields on Lawson applications are automatically selected.

0 = auto-select disabled

1 = auto-select enabled

"" = no default

Make sure 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 will appear 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.
maxeditslistview

Determines the maximum number of records that can be edited on the list in one transaction. The default value is 25.

findfilter

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

Shows the users current product line in the page title.

1= Enabled

0 = Disabled

Disabled by default

accessibilitybehaviors

Enables various accessibility enhancements.

1= Enabled

0 = Disabled

Disabled by default

usertimezone

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

localdata

Allows the user to access Frequent and Recent forms.

1 = Enables access to Frequent and Recent forms

0 = Disables access to Frequent and Recent forms

Enabled by default.

theme

Determines the theme used in Lawson Portal.

Light = Default theme

Dark = Dark color scheme

High contrast = High contrast color scheme

colors

Determines the color used in Lawson Portal. Can contain any HEX value, such as #368AC0.

The field is blank by default.

labelsize

Determines the size of form field labels

Exact font size values for default, small, medium and large are dependent on the selected theme

The field is set to Default.

labelstyle

Determines the style of form field labels.

Default = default

Bold = bold

Normal = normal

Light = light

The field is set to Default.

labelcolor

Determines the color of form field labels.

Can contain any HEX value, such as #368AC0.

The field is set to Default.

detailheaderscolor

This option determines the color of detail area headers

Can contain any HEX value, such as #368AC0.

The field is set to Default.