# About the TMF Homepage

With the TMF Homepage, you can easily view critical metrics related to your trial master file. The TMF Homepage displays graphs that visualize the timeliness, completeness, and quality of your TMF documents, in addition to your tasks and upcoming milestones. This provides at-a-glance insight into your team's progress and your most important action items.

You can apply filters to the homepage to show metrics based on _Study_, _Study Country_, and _Study Site_, using the fields at the top of the page. The _Study_ field is required, while _Study Country_ and _Study Site_ are optional.



<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>: This feature is only available on Clinical Operations eTMF Vaults and requires some <a href="/en/lr/64378/">configuration by an Admin</a>.</p>
    </div>
  </div>
</div>



## Related Object & Document Fields

  * **Overcount**: Yes/No field on the _EDL Item_ object. Vault sets this field to "Yes" if the number of all documents is greater than the number of expected documents, and to "No" if the number of all documents is less than or equal to the number of expected documents.
  * **Expected vs All Documents**: Number field on the _EDL Item_ object. Vault sets this field with the difference between all documents and expected documents.
  * **Timeliness**: Number field available on documents. Vault sets this field based on the number of days it took to file the document in TMF.

## Study Selector

Vault shows metrics for the study you choose from the context selector. You can narrow your search further by selecting a study country and site. For example, if you select Study: _AVEG 027_ > Study Country: _United States_ > Study Site: _US-101_, all components of your homepage will be specific to the study site, _US-101_.

## TMF Homepage Widgets

The homepage contains several widgets that track and display real-time metrics related to your trial master file.

### Upcoming Milestones

This widget displays a list of milestones that do not yet have an _Actual Finish Date_. Hover over the **Completeness** column of a milestone to view details of its completeness. Select a **Milestone Category** to filter the list of _Milestones_ displayed.

<a href="https://platform.veevavault.help/assets/images/etmf-homepage-upcoming-milestones.png" data-lightbox="etmf-homepage-upcoming-milestones.png" data-title="" data-alt="Upcoming Milestones Widget">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/etmf-homepage-upcoming-milestones.png" alt="Upcoming Milestones Widget" style=""  />
</a>

### Completeness

This widget displays the percentage of EDL items based on the milestone you select from the _Upcoming Milestones_ widget, whose **Requiredness** is set to _Required_. The number listed above _Unapproved Documents_ is a count of all the documents, to which the user has access, whose latest version is not in the _Steady State_ type based on its lifecycle configuration. This count does not include documents in the _Superseded_ or _Obsolete_ lifecycle state.

<a href="https://platform.veevavault.help/assets/images/etmf-homepage-completeness.png" data-lightbox="etmf-homepage-completeness.png" data-title="" data-alt="Completeness Widget">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/etmf-homepage-completeness.png" alt="Completeness Widget" style=""  />
</a>

From this widget, click **Unapproved Documents** to view all documents contributing to the *Unapproved Document* count in the _Documents_ page. The _Documents_ page only displays documents the user has view permissions for. You can also _Review Overcount_ or _Review Pending Decisions_. Click **Review Overcount** to go to a pre-filtered list of EDL items with an _Overcount_ value of **Yes**. Click **Review Pending Decisions** to go to a pre-filtered list of EDL items with _Requiredness_ set to **Pending Decision**.

### Timeliness {#Timeliness}

This widget displays the timeliness of document approval as a pie chart with two calculated values: _Approved in less than or equal to {#} days_ and _Approved in greater than {#} days_. Your Vault's Admin will define these values.

<a href="https://platform.veevavault.help/assets/images/etmf-homepage-timeliness.png" data-lightbox="etmf-homepage-timeliness.png" data-title="" data-alt="Timeliness Widget">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/etmf-homepage-timeliness.png" alt="Timeliness Widget" style=""  />
</a>

### Tasks Requiring Attention

This widget displays the number of document and clinical user tasks that are _Overdue_, _Unassigned_, and _Due Today_ based on the study, study country, or site you choose in the **Study Selector**.

Click on a number to display a list of tasks filtered on the respective metric. Note that these lists are not comprehensive. We recommend that you utilize reports to capture the exact number of tasks that are _Overdue_, _Unassigned_, and _Due Today_.

<a href="https://platform.veevavault.help/assets/images/etmf-homepage-tasks-requiring-attention.png" data-lightbox="etmf-homepage-tasks-requiring-attention.png" data-title="" data-alt="Tasks Requiring Attention Widget">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/etmf-homepage-tasks-requiring-attention.png" alt="Tasks Requiring Attention Widget" style=""  />
</a>

### My Tasks

Displays up to ten (10) of your assigned tasks. Note that _My Tasks_ only shows document, envelope, and clinical user tasks assigned to you. View quality issue tasks from the [Quality Issues][7] widget.

<a href="https://platform.veevavault.help/assets/images/etmf-homepage-my-tasks.png" data-lightbox="etmf-homepage-my-tasks.png" data-title="" data-alt="My Tasks Widget">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/etmf-homepage-my-tasks.png" alt="My Tasks Widget" style=""  />
</a>


### Quality Issues {#quality-issues}

The [_Quality Issues_](/en/lr/50384/) widget shows a pie chart of the quality issues in your Vault. The chart groups issues by type (_Duplicate_, _Expired_, _Misclassified_, etc.). You can filter to show _Open_ or _Closed_ issues, all issues, or issues assigned to you.

You must [add the _Quality Issue_ shared field](/en/lr/4884/) to relevant document types before Vault will display quality issues for documents of those types on the homepage. Any quality issues that you create for a document prior to the configuration of this field will not appear on the homepage.

<a href="https://platform.veevavault.help/assets/images/etmf-homepage-quality-issues.png" data-lightbox="etmf-homepage-quality-issues.png" data-title="" data-alt="Quality Issues Widget">
  <img class="docimage" src="https://platform.veevavault.help/assets/images/etmf-homepage-quality-issues.png" alt="Quality Issues Widget" style=""  />
</a>

## Related Permissions {#related-permissions}

The following permissions control your ability to use the TMF Homepage:

<table class="wbord">
  <tr>
    <td style="width: 108px;">
      <p>
        <strong>Type</strong>
      </p>
    </td>
    <td style="width: 244px;">
      <p>
        <strong>Permission Label</strong>
      </p>
    </td>
    <td style="width: 684px;">
      <p>
        <strong>Controls</strong>
      </p>
    </td>
  </tr>
  <tr>
    <td style="width: 108px;">
      <p>
        Security Profile
      </p>
    </td>
    <td style="width: 244px;">
      <p>
        Tabs: TMF Homepage: View
      </p>
    </td>
    <td style="width: 684px;">
      <p>
        Ability to view and access the TMF Homepage tab on the navigation bar.
      </p>
    </td>
  </tr>
  <tr>
    <td style="width: 108px;">
      <p>
        Security Profile
      </p>
    </td>
    <td style="width: 244px;">
      <p>
        Objects: Activity: User Task: Read
      </p>
    </td>
    <td style="width: 684px;">
      <p>
        Ability to view <em>Tasks</em> in the <em>Tasks Requiring Attention</em> and <em>My Tasks</em> widgets.
      </p>
    </td>
  </tr>
  <tr>
    <td style="width: 108px;">
      <p>
        Security Profile
      </p>
    </td>
    <td style="width: 244px;">
      <p>
        Objects: Clinical User Task: Read
      </p>
    </td>
    <td style="width: 684px;">
      <p>
        Ability to view <em>Clinical User Tasks</em>.
      </p>

      <p>
        Note that you must assign the read permission on all object types for the <em>Clinical User Tasks</em> object.
      </p>
    </td>
  </tr>
  <tr>
    <td style="width: 108px;">
      <p>
        Security Profile
      </p>
    </td>
    <td style="width: 244px;">
      <p>
        Objects: Expected Document: Read
      </p>
    </td>
    <td style="width: 684px;">
      <p>
        Ability to view EDL items.
      </p>

      <p>
        Note that you must assign the read permission on all object types for the <em>Expected Document</em> object.
      </p>
    </td>
  </tr>
  <tr>
    <td style="width: 108px;">
      <p>
        Security Profile
      </p>
    </td>
    <td style="width: 244px;">
      <p>
        Objects: Milestones: Read
      </p>
    </td>
    <td style="width: 684px;">
      <p>
        Ability to view <em>Milestone</em> records.
      </p>

      <p>
        Note that you must assign the read permission on all object types for the <em>Milestone</em> object.
      </p>
    </td>
  </tr>
  <tr>
    <td style="width: 108px;">
      <p>
        Security Profile
      </p>
    </td>
    <td style="width: 244px;">
      <p>
        Objects:  Quality Issue: Read
      </p>
    </td>
    <td style="width: 684px;">
      <p>
        Ability to view <em>Quality Issues</em>.
      </p>

      <p>
        Note that you must assign the read permission on all object types for the <em>Quality Issue</em> object.
      </p>
    </td>
  </tr>
</table>

 [7]: #quality-issues
