---
title: "Screen Runs Table"
canonical: "https://help.agiloft.com/space/A2508SD/134057544/Screen+Runs+Table"
format: markdown
---
The Screen Runs table is a background table that stores the overall results of a document screen. Each record in the table summarizes the [screen results](https://agiloft-public.atlassian.net/wiki/spaces/A2508SD/pages/134057621) for one run of a screen. There are no workflows or automation rules implemented out-of-the-box for Screen Runs. Data from this table is typically viewed from related Contract records and used for reporting in dashboards.

# Record Creation

Users don't create or edit records directly in the Screen Runs table. New records are automatically generated each time a contract is screened with the [Screens](https://agiloft-public.atlassian.net/wiki/spaces/DT/pages/43719552) app when logged in with Agiloft. Each record includes a summary of the results of the evaluation.

If a Contract has been screened, a Screens tab is displayed in the Contract record. The tab shows all of the Screen Run records for the Contract.

# Record Layout

Screen Run records identify the screen that was run and document that was screened. They also include information about the results of the evaluation.

![Screen Run record showing Screen Results](media://9efa1200-76da-429b-abfd-bbbb69f6ce83)

The common area summarizes the results of the screen evaluation.

- The Screen Name lists the screen that was run.
- The Document Name and Attached File identify the document that was screened. Clicking the Attached File value opens the document in the [document viewer](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718038).
- If a screen is run multiple times on the same document, records for the latest run have a Status of Active, and records for previous runs have a Status of Superseded.
- The Overall Score, Passing Standards, and Failed Standards fields summarize the results of the run.
  - Passing Standards shows the number of standards in the screen that passed.
  - Failed Standards lists the number of standards that failed.
  - The Overall Score displays a weighted average that represents the overall performance of the screen. It takes into account not just whether standards pass or fail but also their risk level. The higher the risk level, the more influence the standard has on the score.

## Screen Results

The Screen Results tab displays related records from the [Screen Results Table](https://agiloft-public.atlassian.net/wiki/spaces/A2508SD/pages/134057621). You can click the Edit icon or ID for an element to view the Screen Result record.

## Market Data

For evaluations against community screens, the Market Data tab presents information about how your results compare to the results of community contracts evaluated by the same screen.

![Market Data tab](media://6292479d-fd68-4b8b-96f2-837741cf3681)

- The Overall Score Market Percentile field shows the performance of the screen run's overall score compared to the Overall Score Market Average.
- The Overall Score Market Average field displays the average overall score of all contracts in the market dataset.
- Confidence shows the confidence rating of your screen evaluation based on the size of the market dataset.
- Market Dataset Size (Contracts) shows an approximation of the number of contracts in the dataset.

# Views

The out-of-the-box Screen Runs table includes the [standard views](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718574). The Default View is used to display the Screen Runs related table in Contracts. The view includes the Edit icon, ID, Screen Name, Document Name, Passing Standards, Failed Standards, Overall Score, and Status fields.

![Default View of the Screen Runs table](media://b0d51d88-7f37-4e37-8a3e-4783efd9c89b)

# Charts/Reports

In the out-of-the-box system, the Screen Runs table includes the following charts and reports.

- **Average Screens Weighted Pass Score by Screen (%)**: Bar chart that shows the average Overall Score by screen for contracts that are Active or Renewed and have passing or failed standards.
- **Screens Pass Results by Year – All Screens (%)**: Bar chart that shows the average Overall Score by year for contracts that are Active or Renewed and have passing or failed standards.
- **Screens Use by Month – All Screens**: Bar chart that shows the number of screen runs per month for all contracts that are not Canceled.
- **Screens Utilization on Signed Contracts**: Bar chart that shows the number of screen runs by Screen Name for all contracts that are Active or Renewed and have passing or failed standards.

# Fields

In addition to the [standard fields](https://agiloft-public.atlassian.net/wiki/spaces/A2508SD/pages/134054074/Table+Concepts#standard_fields), the out-of-the-box Screen Runs table includes the following fields.

| **Field Label** | **Data Type** | **Description** |
| --- | --- | --- |
| Attached File  
Agiloft Attachment Contract ID  
Agiloft Attachment ID | Link to selected fields from other table: Attachments | These fields identify the attachment for which the screen was run. |
| Community Screen | Choice:<br>- Yes
- No | Indicates whether a community screen was run. |
| Confidence | Choice:<br>- Low
- Medium
- High | The confidence rating of a community screen run based on Market Dataset Size.<br>- Low if the dataset is less than 100 contracts
- Medium if the dataset is 100-1000 contracts
- High for datasets that are larger than 1000 contracts |
| Contract Start Date  
Contract Title  
Contract Type  
Contract ID  
Contract Status | Link to selected fields from other table: Contracts | These fields identify the Contract that was screened. |
| Document ID | Integer | The Screens identifier for the document that was screened. |
| Document Name | Text | The name of the attachment that was screened. |
| Failed Standards | Integer | The number of failed standards for the run. |
| Market Dataset Count | Integer | The number of contracts included in the market dataset. Used in the Confidence calculation. |
| Market Dataset Size (Contacts) | Text | An approximation of the number of contracts in the market dataset. |
| Overall Score | Integer | The weighted average of the screen’s overall performance for the standard results. The calculation takes into account the pass/fail rate in addition to the risk level of the standards. The higher the risk level, the more it influences this score. |
| Overall Score Market Average | Integer | The average overall score of contracts in the market dataset. |
| Overall Score Market Percentile | Integer | The performance of the run's Overall Score compared to the performance of the overall score for the market dataset. |
| Passing Standards | Integer | The number of passing standards for the run. |
| Screen Description | Text | The description of the screen that was run. |
| Screen Document Screen Version ID | Short Text | These fields uniquely identify the screen for this document. |
| Screen ID | Integer | The Screens-generated unique ID for the screen that was run. |
| Screen Name | Text | The name of the screen that was run. |
| Screen Results | Related Table: Screen Results | Displays the Screen Result records for all elements evaluated in this run. |
| Screen Version ID | Integer | The identifier of the version of the screen that was run. |
| Status | Choice:<br>- Active
- Superseded | The state of the record.<br>- Active indicates the record is the only record for a screen run or it's the most recent version of a screen that has had multiple runs for the same attachment.
- Superseded means the record has been superseded by a more recent run of the screen on the same attachment. |

# Automation

This section describes the rule that is implemented for the out-of-the-box Screen Runs table. For details about rule configuration options, see [Rules](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43714473) in the Help Guide.

- **Create: Supersede previous Screen Runs (web, API)**: This rule runs when records are created. If there's a previous, active run of the same screen on the same attachment, this rule changes the Status of the previous run to Superseded.

# Ownership

Screen Run records are owned by the user who creates them. Specifically, Creator Login is set to the Login of the user who creates the record. For more information on record ownership, see [Record Ownership](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718158) in the Help Guide.