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:
- Sign in to WorldSpace Comply on the Settings tab in Attest. For complete details, see Signing In to WorldSpace Comply.
- 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.
After you sign in, the Project selection section appears on the Settings panel.
The Scope Definitions functionality appears below the project selection and issue download sections on the Settings panel.
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.
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/bodyfor the body of the document, or
htmlto specify the whole page). Generally, you must know the
idof the element you want to evaluate. For example:
- /section[@id='content'] identifies a
sectiontag with an
/html/body/section/div/dividentifies an item without an
id: the third
divinside the second
sectiontag inside the
- + 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.