Web UI Getting Started

There are some prerequisites to Web UI configuration / usage.

Privileges

Privileges configured in STEP Workbench also apply when working with data in a Web UI. For instance, if a user can edit attributes in STEP Workbench, they will also be able to edit attributes through a Web UI.

Web UI configurations will, by default, not be user / user group specific. Apart from the fact that the standard privilege setup can influence what a user accesses / is able to do, the Web UI will be the same for all users logging in.

Users need privileges to be able to access and use Web UI. Different privileges can be set up for different users and user groups depending on the users' roles. As an example, if a user will maintain Web UI configurations in an admin role, the user will need the proper privileges to access Web UI Designer. Or, if an end user will be using workflows or viewing / maintaining objects, then there are separate privileges for these tasks. Furthermore, users can be prevented from accessing specific Web UI instances they do not need to use.

To follow any of the steps in the Web User Interfaces documentation, the proper privileges have to be granted (e.g., you cannot create a new Web UI unless you have the privilege to do so). For more information about privileges and user setup, refer to the Users and Groups section (here) and Adding User Privileges for a Group section (here) of the System Setup documentation.

Web UI Access Privileges

At a minimum, the actions, 'Access Web UI' and 'View context' must be added to a user group's privileges before a user is able to log in to a Web UI. If these actions do not already exist as a standalone item or as part of an existing Action Set, then they need to be set up.

Below are the steps for creating an Action Set and applying it to a User Group.

  1. Go to System Setup in the STEP Workbench.
  2. Under Action Sets, right-click Setup Actions and add a New Action Set.
  3. Type in an ID and Name then click Create. In this example, the name is 'Web UI Access.'
  4. Click on the new action set that was just created (Web UI Access) and go to the Action Set tab.
  5. Click on the Add Action link and select 'View context' then click Select.
  6. Click on the Add Action link and select 'Access Web UI' then click Select.
  7. Go to the User & Groups section of System Setup and click on the user group that needs Web UI access.
  8. On the Privilege Rules tab, click the Add Privilege link under the Setup Privileges flipper.
  9. In the 'Add Privilege Rule' dialog box, click the ellipsis button () next to the Action Set field and choose the Action Set you just created (Action Sets > Setup Actions > Web UI Access). Then, click Select.

Note: If the user(s) should only have access to specific Web UI instances, define the Setup Group in which those Web UIs reside. Click the ellipsis button () next to the Setup Group field and select the relevant Web UI Setup Group.

  1. Click Save.

Important: If restricting user access to specific Web UIs, make sure there are no competing Action Sets set for the user group. The action set with the most generous access applies, not the Action Set with the most restrictive access.

For admin users who will be using the Web UI Designer, refer to the Designer Access section of the Web User Interfaces documentation here.

Timeout

The configuration property Portal.Timeout defines the number of minutes that the Web UI is allowed to remain idle before timing out. Upon time out, all credentials granted to the current Web UI user until the next log in. This property is also used for the timeout of the admin portal.

For example: Adding the property Portal.Timeout=30 to the sharedconfig.properties file means that a Web UI will remain accessible for 30 minutes of idle time before logging the current user out. The default time is 15 minutes, and if 15 minutes is the desired time, then no configuration property has to be added to the sharedconfig.properties file.