Clarity GlobalAccess Reports

Reports on this page:  Overall Compliance | Domain Pass/Fail | Domain Discovered PDFs | File Compliance

The Reports tab on the toolbar.

After setting up your domains and running your scans, CommonLook Clarity can generate a wide variety of reports ranging from a very broad overview of your organization’s compliance status to reports that are document specific and very detailed.  We’ll focus on four very helpful reports below:  Overall Compliance, Domain Pass/Fail, Domain Discovered PDFs, and File Compliance.

To begin, click the Reports tab on the toolbar and then, from the dropdown menu, select the report you’d like to create/ view.

In addition, every report can be saved by clicking the Save button near its top right corner.  Reports are saved as HTML files.

Overall Compliance Report

How to Create an Overall Compliance Report:

To generate the report, follow these steps:

  1. In the Reports tab on the toolbar, choose Overall Compliance.
  2. Select the Domain(s) to include in your report (#2 in the screenshot after this list).
  3. From the dropdown menu to the right of where you selected your domain, select the Task(s) you’d like included in your report (#3 in the screenshot after this list).
  4. Select the Standards that you’d like to report on. Check the checkbox to Select All or uncheck it and then choose individual standards as needed.  (#4 in the screenshot after this list).
    1. Note:  While it is possible to open standards and guidelines to further refine your reporting, it’s recommended that you leave these reporting options in their default settings.
  5. When done selecting your options, click Generate Report (#5 in the screenshot after this list).

Screenshot of the menu to create an Overall Compliance Report. The steps are numbered in according to their list numbers in the previous list.

What the Overall Compliance Report Tells You:

After generating an Overall Compliance Report, it will tell you the Domain’s Name and Address (URL) as well as the list of standards that were selected when generating the report.

The Overall Compliance Report screen as described in the preceding paragraph.

Click on a standard to expand it.

The Overall Compliance Report with the W C A G standard expanded.

When the standard is expanded, any checkpoints (or guidelines) that have been failed will be listed.  In the screenshot above, WCAG 2.0 is expanded and failures are shown for Guidelines 1.1, 1.3, and 2.4.

Click on a checkpoint (guideline) to open it for more detailed information.  A table will open showing the total number of tested PDFs in the scan, the number of documents that failed the particular checkpoint, and the total number of times each checkpoint failed.  For example, in the screenshot below, the WCAG 2.0 standard is expanded, Guideline 1.1 “Provide text alternatives for all non-text content” is also open, and the data reveals that there were two documents with Figures lacking Alternative Text and, in those two documents, there were a total of 22 images without Alt. Text.  In addition, there were seven documents that had hyperlinks missing Alt. Text and a total of 58 links that failed this checkpoint.

The Overall Compliance Report expanded to show the results as described in the preceding paragraph.

With the standards and guidelines expanded, under the column listing the number of documents that failed a particular checkpoint, click the number to go to another “checkpoint specific” report.

The W C A G 2.0 standard and Guideline 1.1 are expanded and the number in the "Documents Failing" column is highlighted.

This “checkpoint specific” report lists, by URL, the documents that failed.  Click on a URL to go to that PDF’s File Compliance Report.  (File Compliance Reports are explained in greater detail in a later section of this guide.)

Domain Pass/Fail Report

How to Create a Domain Pass/Fail Report:

To generate the report, follow these steps:

  1. In the Reports tab on the toolbar, choose Domain Pass/Fail.
  2. On the “Specify Criteria” screen, select the Domain(s) to include in your report (#2 in the screenshot after this list).
  3. From the dropdown menu to the right of the Domain(s) you selected, choose the Task(s) you’d like included in your report (#3 in the screenshot after this list).
  4. Check or uncheck the Display Metrics boxes as needed (#4 in the screenshot after this list).
  5. Select (or deselect) the Standards to customize your report. (#5 in the screenshot after this list).
    1. Note:  While it is possible to open standards and guidelines to further refine your reporting, it’s recommended that you leave these reporting options in their default settings.
  6. When done setting the criteria, click Generate Report (#6 in the screenshot after this list).

The W C A G 2.0 standard and Guideline 1.1 are expanded and the number in the "Documents Failing" column is highlighted.

What the Domain Pass/Fail Report Tells You:

The Domain Pass/Fail Report provides specific information about the tagged PDFs in the Domain.

After the report has been generated (following the steps in the previous section of this guide), at the top of the report will be the Domain’s Name and Address (URL).  Below this information, there will be a table with one tab at the top for each Standard Verifier that was selected in step 5 of creating the report.

The top of the Domain Pass/Fail Report showing the Domain Name and Address fields as well as the tabs that correspond to the standards that were chosen when creating the report.

Click on the tab for a particular standard to reveal a table displaying the Task Name(s), Run(s) and the number of Tagged, Passed, and Failed Files.

One of the tables in the Domain Pass/Fail Report showing the Task Name, four Runs in the first column of the table, and other column headers for Tagged Files, Passed Files, and Failed Files.

Click on a Run to open the table further, and view additional Display Metric data.  This additional data will be sorted separately by files that have passed and those that have failed.  The screen shot below shows the WCAG 2.0 tab has been selected, a Run’s data is expanded, and there is a report section showing the files that have passed (none) and a separate section showing data for those files that have failed (three).

Screenshot showing the expanded run under the W C A G 2.0 tab as described in the preceding paragraph.

Additional Features:

  • In the expanded tables sorted by passing and failing documents, clicking the URL for a PDF will take you to that document’s File Compliance Report (discussed in more detail later).
    The URLs are highlighted in the Failed Files section of the Domain Pass/Fail Report.
  • Below the table, click the button to “Generate a Pie Chart” displaying this report’s data in that format.
    The Generate Pie Chart button is highlighted below the table displaying the list of Failed Files.

Domain Discovered PDFs Report

How to Create a Domain Discovered PDF Report:

To generate the report, follow these steps:

  1. In the Reports tab on the toolbar, choose Domain Discovered PDFs.
  2. Select the Domain(s) to include in your report (#2 in the screenshot after this list).
  3. From the dropdown menu to the right of the domain you selected, choose the Task(s) you’d like included in your report (#3 in the screenshot after this list).
  4. Click Generate Report (#4 in the screenshot after this list).

The screen to set the criteria for the Domain Discovered PDF report.

What the Domain Discovered PDF Report Tells You:

When generated, the Domain’s Name and Address (URL) will be displayed at the top.

Below the name and URL for the Domain, there will be a table with the Task Name and Run(s).  Under each Run, the number of Discovered PDFs will be displayed along with the URL for each document.  Click a PDF’s URL to view it.

The Domain Discovered PDF Report showing the information as described in the preceding paragraph.

File Compliance Report

How to Create a File Compliance Report:

To generate the report, follow these steps:

  1. In the Reports tab on the toolbar, choose File Compliance.
  2. Select the Domain(s) to include in your report (#2 in the screenshot after the next step).
  3. From the dropdown menu to the right of the domain you selected, choose the Task(s) you’d like included in your report (#3 in the screenshot below).
    The File Compliance Report criteria screen with the Domain and Task Run options highlighted as described in steps 2 and 3.
  4. Depending on the Task(s) selected, a table will open listing the files that you can get a report for. Choose the file(s) that you’d like to see in the report.
    1. Tip 1: Click the checkbox next to File Name at the top of the table to choose them all.
    2. Tip 2: On the right side of the table, the PDF’s URL will be displayed.  Click the URL to view the document.
      The checkbox next to File Name, to select all of the files, is highlighted as are the sections in the screen where the file names and URLs are listed.
  5. Select (or deselect) the Standards to customize your report.
    The list of standards in the File Compliance Report criteria selection screen.

    1. Note:  While it is possible to open standards and guidelines to further refine your reporting, it’s recommended that you leave these reporting options in their default settings.
  6. Check or uncheck the Display Metrics boxes as needed.
  7. Click the Generate Report button.
    In the File Compliance Report criteria screen, the Display Metrics options are shown along with the Generate Report button.

What the File Compliance Report Tells You:

If, when specifying the report criteria, you chose multiple files to report on, when you open the File Compliance Report, each document chosen will have a tab at the top of the report.  Click the tab to view details about that particular document’s compliance.

The File Compliance Report provides a wealth of information about each document and can be sorted in a variety of ways.  Feel free to explore it more fully on your own!  Some of the more noteworthy items in the report are listed below.  (Note: the list numbers correspond to the numbers in the screenshot below the list.)

  1. The PDF’s File Name and URL.
  2. Below the file name and the URL, there will be one tab for each standard chosen when specifying the report criteria.
  3. Run data and the Display Metrics that were selected when setting up the report criteria will be listed.
  4. If selected, the “Number of Passed entries” and “Number of Failed entries” will be displayed. Furthermore, clicking the number shown for each of these will cause the table below to be sorted, showing only the Passed or Failed entries (depending on which you chose).
  5. A pie chart giving a quick graphical representation of the Passed, Failed, and Not Applicable checkpoint data is provided.
  6. Below the list of Display Metrics, a table gives specific checkpoint-by-checkpoint, page-by-page, or status-by-status data.  Explore the table – it can be sorted and/or displayed in a variety of ways!

The File Compliance Report with the elements highlighted that are mentioned in the preceding list.

Additional Features – Editing Checkpoint Status:

In addition to showing very comprehensive data for a particular document, it’s possible to edit checkpoint status results.  Consider this scenario:  While Figure tags that don’t have alternative text will be marked as failing, if Figure tags do have alternative text, the status of those Figure tags will be “User Verification Required.”  This is because CommonLook wants you to make sure that the alternative text provided for images is accurate. If you open the PDF, look at the alternative text for the images, and determine that the alt. text is correct, then you can change the checkpoint status in Clarity so that it’s reported as passing instead of needing verification.  (Similarly, if the alt. text isn’t ok, the status can be changed to “Failed.”)  This is a valuable feature for testing, reporting, and so that document remediators know more accurately the issues that need to be addressed in particular documents.  In addition, because Clarity will store this verification data for comparisons with future scans, this can help maintain more accurate information regarding the accessibility of your organization’s PDF holdings, even as those holdings change over time.

To edit a status:

  1. In the table, check the checkbox for an item whose status you’d like to change (#1 in the screen shot below).
  2. Click the “Edit Status” button (#2 in the screen shot below).
    The table in the File Compliance Report is shown, a checkpoint for User Verification is selected, and the Edit Status button is highlighted.
  3. In the Change Status screen that opens:
    1. Use the Verification Status dropdown menu (at the top) to change the status (#1 in the screenshot below).
    2. Enter a Reason for the change (#2 in the screenshot below).
    3. Click “Save Changes” (#3 in the screenshot below).

The Change Status dialog box showing the changed status, a comment added, and the Save Changes button is highlighted