Adding a Scope Definition

Follow this procedure any time you want to limit or restrict the portion of the page that is analyzed to a CSS selector and/or URL pattern categorized by content, template and/or the entire page. Adding a scope definition is a matter of populating five columns of information in the Scope section table on the Settings panel in Attest, then clicking the Save button.

Scope Definitions and Auto-Association with Comply Projects

The Scope section of the Settings panel only appears after a connection with WorldSpace Comply has been established and a project selected. Defining and saving a scope by following this procedure adds the Scope Definition to the selected project in WorldSpace Comply, so that when you subsequently select the project again in the Attest browser extension, the existing scope definitions are automatically loaded on the Settings tab. Any time you select the project, this scope definition will automatically be downloaded into Attest from WorldSpace Comply. For complete details about how to work with saved scope definitions in WorldSpace Comply, refer to the Scope Definitions topic in the Managing Organization Projects section of the Comply 6.0 User Guide.

Added scope definitions refine the analysis performed on the Analyze panel in Attest to the areas of the loaded page that match the scope.

Before you begin, it is important that you understand how to enable the scope definitions functionality and understand the purpose of each option and table column field. For complete details, see the parent Scope Definitions topic of this guide.

To add a scope definition:

  1. In the Scope section of the Settings panel, enter meaningful text in the Name column (for example, 'Header').
  2. In the Category column, click the down arrow to expand the drop-down menu options, then click on an item in the list to highlight it and select it (for example, 'Template 1').
  3. The Category drop-down list closes and your selection is populated within the field display.

  4. In the URL pattern field, enter the text string after the domain name, if desired (for example, '/html/head').
  5. Optionally, click the + Frame button to cause a new, blank CSS Selector field to display on a new line below, then enter the selector for the component, if it is contained within a frame.
  6. clicking the plus Frame button adding a blank CSS Selector field on a new line below in the Scope table
  7. In the CSS Selector(s) field, enter the selector you have selected using your tool of choice (for example, via right-click > Copy > Copy selector in Chrome DevTools after highlighting the source code in the Elements tool).
  8. In the Actions column, click the Save button.
  9. Example of populating the fields in the Scope section table , then clicking the Save button on the Settings panel

The scope you added appears as a new row within the table, and the Actions column displays buttons that allow you to either Edit or Delete it. Additionally, a new, blank line appears below your saved scope line, which allows you to specify and save another, etc.

Example of the Scope Definition table populated showing the previously entered and added information in the Name, Category, URL pattern, and XPath columns along with an Edit and Delete button in the Actions column

You may now select the desired option in the Analyze scope section above the table, then perform an analysis on the loaded page that is refined by the scope you specified. For more information, see Analyzing a Page for Accessibility Rule Violations.

Next Subtopic:

Editing a Scope Definition