Skip to main content
close Search
Close search


Enabling accessibility features in an application

5 Tasks

30 mins

Visible to all users
Intermediate Pega Platform 8.2 English


Some users with screen readers have difficulty completing several forms in the application. ReserveIt wants to improve the user experience (UX) for users with assistive devices.

The following table provides the credentials you need to complete the exercise.

Role Operator ID Password
System Architect admin@reserveit rules

Your assignment

Switch to the ReserveIt:AdministratorsAccess access group, which is configured with the PegaWAI ruleset to provide assistive device users with additional form guidance.

Due to security concerns, users are unable to update access group records in the exercise environment. As a workaround to this limitation, an alternate access group has been staged in the exercise environment. This alternate access group is configured with the PegaWAI ruleset as a production ruleset. In a real-world environment, you must update the access group to add the production ruleset.

Update the Number of guests field on the initial application screen to display a drop-down list. Configure the property to populate the drop-down list with the numbers 1 to 4.

A screen reader is required to gain the most from this exercise. Screen readers are generally available as browser extensions. If you are using Chrome, you can download a Chrome extension called ChromeVox. If you are unable to obtain a screen reader, disregard this exercise.

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Detailed Tasks

1 Listen to a screen reader read a Pega case

  1. Create a new Booking case.
  2. On the first screen, click in the Number of guests field and listen to the guidance the screen reader provides to the user.
  3. Click Cancel to close the case and listen to how the application reacts to canceling the case.

2 Add the PegaWAI ruleset to the application definition

  1. Switch to the ReserveIt Administrator access group that has accessibility enabled.

    From the Application menu, click Switch Application > ReserveIT (Administrator - Accessibility enabled).
  2. Edit the ReserveIt application Definition.
  3. Add the PegaWAI:07-10 ruleset as a production ruleset.
    Expand the Advanced section to add a production ruleset to the application definition. The ruleset PegaWAI is included in your exercise image. Add it and set the version to 07-10.
  4. Save your changes.

3 Update a property to include a list of local values

  1. Edit the ABB-ReserveIt-Work-Booking NumberOfGuests property.
  2. Add a Local List of values to the property.
  3. Add four Table values: 1, 2, 3, and 4.
  4. Save your changes.

4 Update a section to use a drop-down list control

  1. Open the pyEnterCaseDetailssection in the ABB-ReserveIt-Work-Booking class.
  2. Edit the cell properties for the Number of guests field, and change the control type to dropdown.
    By default, the list source is set to As defined on property. This default setting is sufficient to verify your work.
  3. Save your changes.

5 Confirm your work

  1. Create a new Booking case.
  2. Observe the additional guidance that Dev Studio provides to users with the PegaWAI ruleset enabled.
  3. On the first screen, click in the Number of guests field and listen to the change in the guidance the screen reader provides to the user. The screen reader can now inform the user of the valid choices, and the current value is selected when the user attempts to change the selection.
After you finish enabling accessibility features in your application, switch back to the ReserveIt:Administrators access group.

If you are having problems with your training, contact Pega Academy technical support.

Did you find this content helpful?

Want to help us improve this content?

Suggest an edit

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice