# How Expectedness Rolls Up to Case Expectedness and Listedness

Vault uses _Expectedness_ records to populate the _Expectedness_ and _Listedness_ fields on a _Case_.

How Vault populates these fields depends on the _Datasheets_ available, and whether the _Case_ is associated with a _Study_. The following section provides more information on the auto-calculation logic for _Study Cases_ and non-Study Cases.

The _Listedness (Status)_ and _Expectedness (Status)_ fields become "Auto-Calculated" when Vault automatically populates these fields. Users can [override the field values][1] manually.

### Expectedness Roll-Up Evaluation

The following illustrations show the auto-expectedness process for a Case using the Product, Study, or Study Product Datasheets:

**Non-Study Case**

<a href="https://platform.veevavault.help/assets/images/saf-expectedness-from-core-product-datasheet.png" data-lightbox="saf-expectedness-from-core-product-datasheet.png" data-title="Expectedness from Core Product Datasheet" data-alt="Expectedness from Core Product Datasheet">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/saf-expectedness-from-core-product-datasheet.png" alt="Expectedness from Core Product Datasheet" style="max-width: 70%;"  />
</a>

See an [explanation of the steps][2] below.

**Study Case**

<a href="https://platform.veevavault.help/assets/images/saf-study-expectedness-from-core-datasheet.png" data-lightbox="saf-study-expectedness-from-core-datasheet.png" data-title="Expectedness from Study Datasheet" data-alt="Expectedness from Study Datasheet">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/saf-study-expectedness-from-core-datasheet.png" alt="Expectedness from Study Datasheet" style="max-width: 70%;"  />
</a>

See an [explanation of the steps][2] below.

**Multi-Product Clinical Trial Study Case**

<a href="https://platform.veevavault.help/assets/images/saf-study-expectedness-from-study-product-datasheet.png" data-lightbox="saf-study-expectedness-from-study-product-datasheet.png" data-title="" data-alt="Expectedness from Study Product and Study Core Datasheets">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/saf-study-expectedness-from-study-product-datasheet.png" alt="Expectedness from Study Product and Study Core Datasheets" style="max-width: 70%;"  />
</a>

See an [explanation of the steps][2] below.

<a id="expectedness-eval-illustration-steps"></a>

<img class="inline" src="https://platform.veevavault.help/assets/images/saf-orange-1.png" alt="1" style="" /> **Expectedness Generation** 

Vault generates <a href="/en/gr/737264/">_Case Assessment Expectedness_ records</a> for each relevant _Datasheet_:
* **Non-Study Cases**: For each product _Datasheet_ (product family, product core, or local) related to _Case Products_.
* **Study Cases**: Based on the following _Datasheets_, when configured:
    * Study product
    * Study core
    * Product (product family, product core, or local) related to _Case Products_

<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: When both <em>Study Product Datasheets</em> and <em>Study Core Datasheets</em> are set up, <em>Case Assessment Expectedness</em> records are generated for both. If your Admin has enabled <a href="/en/gr/737256/">Agency-Based Auto-Expectedness for Clinical Trial Study Cases</a> or <a href="/en/gr/774366/">Datasheet Expectedness for Blinded Study Products</a>, see <a href="/en/gr/822874/">Expectedness Evaluations for Clinical Trial Study Cases</a> for how Vault may generate additional <em>Case Assessment Expectedness</em> records.</p>
    </div>
  </div>
</div>



<img class="inline" src="https://platform.veevavault.help/assets/images/saf-orange-2.png" alt="2" style="" /> **Case Assessment Listedness and Expectedness**

To automatically populate the **Expected** and **Listedness** fields on a Case Assessment, Vault looks at the Case Assessment's **Expectedness** records using the following logic:

To populate the **Listedness** field on the Case Assessment:
<table>
                    <thead>
                        <tr>
                            <th>Case Report Type</th>
                            <th>Auto-Population Logic</th>
                        </tr>
                    </thead>
                    <tbody>
                        <tr>
                            <td>Non-Study Case</td>
                            <td><p>If there is an <strong>Expectedness</strong> record corresponding to the Product's Core or Product Family Datasheet, this rolls up to populate the <strong>Listedness</strong> field on the Case Assessment.</p>
                                <p>If there are no <strong>Expectedness</strong> records, the <strong>Listedness</strong> field is not automatically populated.</p></td>
                        </tr>
                        <tr>
                            <td>Study Case</td>
                            <td><p>If there is an <strong>Expectedness</strong> record corresponding to the Study Core Datasheet, this Expectedness rolls up to populate the <strong>Listedness</strong> field on the Case Assessment.</p>
                                <p>If there is no Study Product or Study Core Datasheet, but there is an <strong>Expectedness</strong> record corresponding to the Product's Core or Product Family Datasheet, this value rolls up to the <strong>Listedness</strong> field.</p>
                                <p>If there are no <strong>Expectedness</strong> records, the <strong>Listedness</strong> field is not automatically populated.</p></td>
                        </tr>
                    </tbody>
</table>

To populate the <strong>Expected</strong> field on the Case Assessment:
<table>
                    <thead>
                        <tr>
                            <th>Case Report Type</th>
                            <th>Auto-Population Logic</th>
                        </tr>
                    </thead>
                    <tbody>
                        <tr>
                            <td>Non-Study Case</td>
                            <td><p>Vault evaluates all <strong>Expectedness</strong> records under the Case Assessment to set the <strong>Expected</strong> field, using the following logic:</p>
                            <ul>
                                <li><strong>Unexpected</strong>: If one (1) or more <strong>Expectedness</strong> records are set to <strong>No</strong> or blank</li>
                                <li><strong>Expected</strong>: If all <strong>Expectedness</strong> records are set to <strong>Yes</strong></li>
                            </ul>
                        </td>
                        </tr>
                        <tr>
                            <td>Study Case</td>
                            <td><p>If there are <strong>Expectedness</strong> records, Vault roll-up for Study Products is as follows:</p>
                                <ul>
                                <li>Based on the Study Product Datasheet, if one exists, otherwise,</li>
                                <li>Based on the Study Core Datasheet, if one exists, otherwise,</li>
                                <li>Based on the most conservative of the Product Core Datasheet and Local Datasheet, if one exists</li>
                            </ul>
                                <p>If there is no Study Product or Study Core Datasheet, Vault evaluates all <strong>Expectedness</strong> records under the Case Assessment to set the <strong>Expected</strong> field as follows:</p>
                                <ul>
                                    <li><strong>Unexpected</strong>: If one (1) or more <strong>Expectedness</strong> records are set to <strong>No</strong> or blank</li>
                                    <li><strong>Expected</strong>: If all <strong>Expectedness</strong> records are set to <strong>Yes</strong></li>
                                </ul>
                            </td>
                        </tr>
                    </tbody>
</table>

<img class="inline" src="https://platform.veevavault.help/assets/images/saf-orange-3.png" alt="3" style="" /> **Case Listedness and Expectedness**

At the _Case_-level, for both study and non-study _Cases_, both the _Listedness (Core)_ and _Case Expectedness_ fields are synced with the primary _Case Assessment_. Unless the _Case_ fields are [overridden][1], any time the primary _Case Assessment_ changes, Vault updates the associated _Case_-level fields to match.

## <a id="spp-roll-up"></a>Study Product Placeholder Expectedness Roll-Up Evaluation

If your Admin has enabled <a href="/en/gr/774366/">Datasheet Expectedness for Blinded Study Products</a>, for double-blinded clinical trial study _Cases_ without _Study Arms_, Vault generates _Case Assessment_, _Case Assessment Result_, and _Expectedness_ records based on each _Datasheet_ associated with _Study Product Placeholders_ on the blinded _Case_. Vault rolls up the most conservative _Expected_ value across all _Expectedness_ records, including overridden values, to the _Expected_ field of the associated _Case Assessment_. For example, if there are multiple _Expectedness_ records and only one (1) has _Expected_ set to _No_, Vault rolls up _No_ to the _Case Assessment_ regardless of the _Datasheet_ type.

## <a id="override-expectedness"></a>Override Case Expectedness or Listedness

There are two ways to update the Case Expectedness or Listedness fields:

* Edit the field on the primary Case Assessment to override the calculated expectedness. The associated **(Status)** field updates to "Overridden" on the Case Assessment but remains Auto Calculated on the Case.<br>This will automatically update the associated field at the Case-level, because the Case fields are synced with the primary Case Assessment.
<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: Overridden Case Assessment Expectedness records are not deleted or re-created, unless an associated Product or Adverse Event is updated.</p>
    </div>
  </div>
</div>


* Edit the field directly on the Case to override the value, and prevent Vault from syncing the value with the primary Case Assessment. The associated **(Status)** field updates to "Overridden" on the Case.
<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: If you use this option, Vault will not update the Case Expectedness or Listedness to match any future changes to the associated fields on the primary Case Assessment.</p>
    </div>
  </div>
</div>



### How-To Video: Overriding Auto-Expectedness Evaluations

Watch our quick video tutorial on <a href="/en/gr/01302/#overriding-auto-expectedness-evaluations">Overriding Auto-Expectedness Evaluations</a>.

[1]: #override-expectedness
[2]: #expectedness-eval-illustration-steps