---
title: "Screen Runs Table"
canonical: "https://help.agiloft.com/space/SD/44434100/Screen+Runs+Table"
format: markdown
---
The Screen Runs table stores the overall results of contract screen evaluations from [Astra](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/569933847). Each record summarizes the [screen results](https://agiloft-public.atlassian.net/wiki/spaces/SD/pages/44434110) for one run of a screen. Data from this table is typically viewed from related Contract records and used for reporting in dashboards.

# Record Creation

New Screen Run records are automatically generated each time a contract is screened with Astra. The records identify the screen that was run, the document that was screened, and the results of the evaluation.

The common area summarizes the results:

- Contract Stage lists the state of the contract, Pre-Signature or Post-Signature. The value is set by a rule when a Screen Run record is edited.
- The Screen Name lists the screen that was run.
- The Document Name and Attached File identify the document that was screened. You can click the Attached File to open 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/SD/pages/44434110). 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.

- 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://9cae1fdf-2c11-4183-85b6-1343630447cd)

# 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 (%)**: Reports on 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 (%)**: Reports on 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**: Reports on the number of screen runs per month for all contracts that are not Canceled.
- **Screens Utilization on Signed Contracts**: Reports on the number of screen runs by Screen Name for all contracts that are Active or Renewed and have passing or failed standards.

# Related Tables

The diagram below shows the default table relationships and linked fields in the Screen Runs table.

![Diagram of the default table relationships for the Screen Runs table](media://975c82d7-034c-4bd9-bfc6-4b15ed44e738)

# Fields

In addition to the [standard fields](https://agiloft-public.atlassian.net/wiki/spaces/SD/pages/44434023), 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: Yes, No | Indicates whether a community screen was run. |
| Confidence | Choice: 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 Stage | Choice: Pre-Signature, Post-Signature | System-managed flag that is set by a rule. The system compares the screen run date to the contract signature date and sets the value to either Pre- or Post-Signature. |
| Contract Start Date  
Contract Title  
Contract Type  
Contract Signature Date  
Contract ID  
Contract Status | Link to selected fields from other table: Contracts | These fields identify the Contract that was screened. |
| Document ID | Integer | The Astra 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. |
| Number of Obligations | Calculation on Multiple Linked Records: Obligations | Shows the number of obligations extracted. |
| Obligations | Related Table: Obligations | Lists any related obligations. |
| 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 Astra-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 | If Contract Stage is Pre-Signature or Post-Signature, this field displays the Screen Results for all elements evaluated in this run. |
| Screen Version ID | Integer | The identifier of the version of the screen that was run. |
| Status | Choice: 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.
- **Edit: All Screen Run Edit actions by Web and API**: This rule runs when records are edited. It sets the appropriate Contract Stage value. If the run resulted in extracted obligations, it sets the value to Obligations. Otherwise, it compares the screen run date to the Contract Signature Date and sets the value to either Pre-Signature or Post-Signature.