# Generate & Run Reports from Workbench Report Definitions

Learn how to generate a _Workbench Report_ from a _Workbench Report Definition_.

<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>: Depending on your Admin’s configuration, your Vault’s object, field, and section labels, lifecycle states, and workflows may differ from the general information in all articles. Refer to your organization’s business processes for guidance.</p>
    </div>
  </div>
</div>



## About Generating Reports from Report Definitions

You can generate and run a _Workbench Report_ from a _Workbench Report Definition_. The _Generate Report_ action creates a single _Workbench Report_ using the report definition parameters and filters from the associated _Workbench View_. You can access these reports from the _Workbench > Ad Hoc Reports_ tab. After report generation, you can navigate to the created report to enter required filter values, if any, and run the report.

## Prerequisites

Your Admin must <a href="/en/gr/860563/">configure</a> generating a report directly from a _Workbench Report Definition_.

## Create Workbench Report Definitions

To create _Workbench Report Definitions_ outside of _Workbench Report Sets_:
1. Navigate to **Workbench > Report Definitions**.
2. Select **Create**.
3. Complete the following information:
    * In the _Properties_ section, complete the following fields:
        * **Name**: Enter a **Name** for the _Workbench Report Definition_.
        * **Workbench View**: Select a value from the drop-down or use the **Advanced Search** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-binoculars-icon.png" alt="binoculars icon" style="" />) icon to use filters and refine your search.
        * **Report Category**: Select a value from the drop-down. Vault selects _Ad Hoc_ by default.
        * **Report Subcategory**: Select a value from the drop-down.
        * <a href="/en/gr/752963/#document-sensitivity">**Document Sensitivity**</a>: Select a value from the drop-down. When you generate reports from this report definition, the report inherits this value.
        * **API Name**: Enter an **API Name** ending in `__c`.
    * <a href="/en/gr/752971/">Set up the _Layout_</a> section.
    * In the _Advanced Options_ section, <a href="/en/gr/752963/#advanced-options">select a **Timezone**</a> from the drop-down.
4. Select **Save**.

## Generate Reports from Report Definitions

You can generate reports directly from a _Workbench Report Definition_ or a _Workbench Report Definition_ associated with a _Workbench Report Set_.

### Generate Reports Directly from Report Definitions

To generate reports from a _Workbench Report Definition_ that is not associated with a _Workbench Report Set_:
1. Navigate to **Workbench > Report Definitions**.
2. From the **All Actions** menu of a _Workbench Report Definition_, select **Generate Report**.

### Generate Reports from Report Set Definitions on Workbench Report Sets

See <a href="/en/gr/826869/#add-workbench-report-definitions">Configure Workbench Report Sets</a> for instructions on adding _Workbench Report Definitions_.

To generate reports from a _Workbench Report Definition_ on a _Workbench Report Set_:
1. Navigate to **Workbench > Report Sets > [Workbench Report Set]**.
2. Expand the **Reports to Generate** section.
3. From the **All Actions** menu of a _Workbench Report Definition_, select **Generate Report**.

### After Generating Reports from Report Definitions

When creating reports directly from a _Workbench Report Definition_ or from a _Workbench Report Definition_ on a _Workbench Report Set_, Vault executes this action asynchronously in the background.

After you trigger the _Generate Report_ action, Vault does the following:
* Creates a _Workbench Report_ with the following parameters:
    * Names the report using the _Workbench Report Definition_ name and a timestamp. If multiple users concurrently trigger this action on the same report definition, Vault creates different reports and notifies the respective users. If your Admin configured _Workbench Reports_ to require unique name values, in the scenario where multiple users attempt to generate a report from the same report definition in the same millisecond, this action would result in an error.
    * Includes the associated _Workbench View_ filters.
    * Copies the report definition's properties, layout, and advanced options.
* Sets the generated _Workbench Report_ to the _Pending_ state.
* Sends a Vault notification to the user who generated the report indicating successful or failed report generation.

## Run Reports Created from Report Definitions

To run the _Workbench Report_ created from the _Workbench Report Definition_:
1. Navigate to **Workbench > Ad Hoc Reports > [Ad Hoc Report]**.
2. Review the report. If the _Workbench View_ associated with the report definition contains required filters, you must enter these values before running the report.
3. See <a href="/en/gr/752975/#run-workbench-reports">Run, Download & Copy Workbench Reports</a> on how to run and download the report.
