Scope Definitions

Defining a scope in Attest is done when you want to only test certain portions of a page instead of the entire page. On many websites, there are elements or "template" areas that are common to many pages of a site. This can be used to specifically test common template components, or to ignore them in order to focus on the content that is not a part of the common components (for example, header, footer, or navigation sections). Version 1.1 and later of the WorldSpace Attest browser extension is designed to use Cascading Style Sheet (CSS) Selectors for the purpose of defining scope.

XPath Version Support:

WorldSpace Comply v. 6.0 or later supports both CSS selector and XPath technologies, due to the fact that previously, version 1.0 of XPath was supported by v. 1.0 of the Attest browser extension. For more information, see XML Path Language (XPath) Version 1.0 - W3C.

To avoid violation duplication when analyzing multiple pages, the Scope definition feature of Attest provides you with a way to limit what is being analyzed to one or more specific sections of a page, while ignoring the common, repeated content that is not selected as a part of the scope. By having the scope definitions defined during scripted analysis it will have the same effect as static analysis. In other words, only including the defined portions of the page in the script. This process is particularly useful when testing only scope definitions that cover the content areas of the page, which eliminates the repetitious issues found in testing templates.

In this topic:

Enabling Scope Functionality

There are two basic prerequisite steps that are necessary to display the Scope functionality on the Settings panel. Otherwise, you will not be able to view the options and tools.

To enable the scope definitions functionality:

  1. Sign in to WorldSpace Comply on the Settings tab in Attest. For complete details, see Signing In to WorldSpace Comply.
  2. After you sign in, the Project selection section appears on the Settings panel.

  3. Select a Project by using the Select a project menu and button on the Settings panel. For complete details, see Selecting a WorldSpace Comply Project.
  4. the Sign In and Project Selection sections of the Settings panel as the two prerequisite steps for enabling the Scope functionality

    The Scope Definitions functionality appears below the project selection and issue download sections on the Settings panel.

    the location of the Scope section at the bottom of the Settings panel appearing below the project selection and issue download sections after signing in and selecting a project

Option Descriptions

the Analyze Scope options subsection of the Scope section

Once enabled, you will see the Scope section on the Settings panel in Attest, which displays an Analyze scope radio button option group with the following three available options from which to select:

  • Entire page: Select to refine the defined scope when performing an analysis on the Analysis panel to the entire page that is loaded in the browser.
  • Conent only: Select to refine the scope when performing an analysis on the Analyze panel to only the content items not a part of any templates defined in the Scope Definitions table below.
  • Template only: Select this option to refine the analysis performed on the Analyze panel to everything except the content definitions on the loaded page under test.

Column Descriptions

the template/content scope xpath table with one example row populated and its six columns

Below the Analyze scope options section, you will see the scope definitions table section, which displays a table with the following six columns of information:

  • Name: A text entry field used to give the scope definition a name that is clear and meaningful (for example, 'Header').
  • Category: A drop-down menu field used to specify the type of scope. Options include 'Template 1-4' (whole page) and 'Content 1-4' (body of page). These can be used to group related scope definitions together so that they can be easily sorted.
  • URL pattern: A text entry field used to specify a part or parts of a website that uses a different template set than the main portion of the site (for example, a shopping or secure member services area), defined with a string of text that appears immediately after the domain name in the page address for a pattern that uses a wildcard match (for example, '/products' would match '/products' as well as any string of text that comes after it).
  • CSS Selector(s): A text entry field used to specify the locator of the content to be targeted (for example, /html/body for the body of the document, or html to specify the whole page). Generally, you must know the id of the element you want to evaluate. For example:
    • /section[@id='content'] identifies a section tag with an id of "content": <section id="content">
    • /div[@id='header-panel'] identifies a div with an id of "header-panel": <div id="header-panel">
    • /div[@id='right-column'] identifies a div with an id of "right-column": <div id="right-column">
    • /html/body/section/div[2]/div[3] identifies an item without an id: the third div inside the second div inside the section tag inside the body of the html
  • + Frame: Click to add a new line below that provides a text entry field you can use to enter a selected CSS selector locator (the DOM node region data) if the region is within a frame. The plus symbol becomes a minus to indicate it is possible to remove the line after it has been added.
  • Actions: Within a blank row, the Save button appears in the Actions column, which allows you to add your selection/entries as a new scope definition row. After a row has been added, the Edit and Delete buttons appear.