The signal detection process identifies Product-Event Combinations (PECs) by looking for Signal Reporting Periods linked to a Signal Product Profile and running the calculations and alerts that are associated with the Signal Product Profile. For Veeva SafetyDocs and Veeva Safety Signal, Vault can create Signal Reporting Periods on a schedule to reduce manual effort for routine signal surveillance reviews.
You must configure Signal Product Profiles before completing the steps in this article.
Configuration Overview
Configuring your Vault to schedule Signal Reporting Period creation involves the following steps:
- Activate the Safety Scheduler Job
- Configure object layouts
- Update the Signal Product Profile validation rule
- Configure object actions
- Configure the Signal Reporting Period object lifecycle
- Schedule Signal Reporting Period creation using the Schedule Signal Review action
- Optional: Update the scheduled signal review (for example, if you want to change the frequency of creation)
- Optional: Cancel the scheduled signal review action
- Configure user permissions
Note: Depending on your Vault’s creation date and which features are currently enabled and configured, some of the steps described in this article may be unavailable or already complete in your Vault.
Activate the Safety Scheduler Job
You must ensure the Safety Scheduler Job is active.
Configuring Object Layouts
You must configure the following object layouts:
Configuring the Signal Product Profile Object Layout
To update the Signal Product Profile object layout:
- Insert the Schedule detail form section.
- In the Schedule section, add the following fields:
- Schedule
- Schedule Start Date
- Schedule Initiated By
- Schedule Initiated Date/Time
- Schedule Terminated Date/Time
- Set the Schedule and Schedule Start Date fields to required by hovering next to the fields and selecting the Edit icon. Then, select Display As Required and select Done.
- In the Signal Reporting Periods section, edit the default columns to include:
- Review Type
- Start Date
- End Date
- Lifecycle State
- Previous Signal Reporting Period
- Next Signal Reporting Period
- After the Details section, insert the Schedule Recurrence related object section as follows:
- Section Label: Enter
Signal Review Schedule Recurrences - Creation Option: Select Prevent record creation. Vault will create the record when users trigger the Schedule Signal Review action.
- Section Label: Enter
- In the Schedule Recurrence section, edit the default columns to include:
- Name
- Schedule
- Start Date
- Lifecycle State
Configuring the Signal Reporting Period Object Layout
To update the Signal Reporting Period object layout, in the Details section, add the following fields:
- Review Type
- Previous Signal Reporting Period
- Next Signal Reporting Period
Updating the Signal Product Profile Validation Rule
Standard schedules are available for creating Signal Reporting Periods. To support creation on a weekly basis, on the Signal Product Profile object, update the Validation Expression on the Schedule is Not Supported validation rule to include schedule__vr.api_name__v='weekly__v'.
Configuring Signal Review Actions
You can configure the Schedule Signal Review and Cancel Scheduled Signal Review actions as part of a workflow and then add these actions as user actions on the Signal Product Profile object lifecycle. This configuration displays the actions in the Workflow Actions menu (
).
Alternatively, assign the actions to the Signal Product Profile object and add them as a user action to the applicable states of the Signal Product Profile object lifecycle using the following table:
| Condition Type | Condition | Allow the following actions | Action Label |
|---|---|---|---|
| All conditions are met | Schedule Initiated Date/Time > is blank | Schedule Signal Review | Schedule Signal Review |
| Schedule Start Date > is not blank | |||
| All conditions are met | Schedule Initiated Date/Time > is not blank | Cancel Scheduled Signal Review | Cancel Scheduled Signal Review |
| Schedule Terminated Date/Time > is blank |
Configuring the Signal Reporting Period Object Lifecycle
This section applies only to Vaults with Veeva Safety Signal enabled. For the Signal Reporting Period object lifecycle, associate the Queued state with the Queued state type.
Scheduling Signal Reviews
To schedule creation of Signal Reporting Periods for a Signal Product Profile:
- Navigate to Business Admin > Objects > Signal Product Profiles > [Signal Product Profile].
- Select the Schedule Signal Review (
) icon or from the All Actions menu, select Schedule Signal Review.
You can also update or cancel the signal review schedule. After the action runs, Vault creates schedule-related records and Signal Reporting Periods.
How Vault Creates Scheduled Signal Reporting Periods
After running the Schedule Signal Review action on a Signal Product Profile, Vault:
- Creates a Schedule Recurrence record for the Signal Product Profile with the following information:
- Schedule: Vault maps this value from the Signal Product Profile.
- Start Date: Vault populates the current date.
- Signal Product Profile
- Recurrence Type: Vault populates Signal Product Profile Recurrence.
- Lifecycle State: Vault sets the state to Initialized.
- For the Schedule Recurrence, creates Scheduled Events for up to one year in advance based on the Schedule of the Signal Product Profile. For example, if the Schedule is Monthly and the Start Date is 05 Dec 2025, Vault creates a Scheduled Event for each fifth of the month until 05 Nov 2026.
- On the Scheduled Date of each Scheduled Event, runs the Safety Scheduler Job.
- After the job runs, creates a Signal Reporting Period if one does not already exist for the Signal Product Profile, Product Family or Aggregate Reporting Group, Start Date, and End Date combination. Vault then completes the reporting period with the following information:
| Field | Description |
|---|---|
| Lifecycle State | If Veeva Safety Signal is enabled in your Vault, Vault sets the lifecycle state to the Queued state type. If only Veeva SafetyDocs is enabled, Vault sets the lifecycle state to the Initial state type. |
| Start Date | Vault populates the Start Date with the Scheduled Date of the Scheduled Event. |
| End Date | Vault populates the End Date by subtracting 24 hours from the Scheduled Date of the next Scheduled Event. |
| Review Type | Vault populates Routine, indicating this reporting period was created from a schedule. |
| Next Signal Reporting Period | Once the next Signal Reporting Period is created from the schedule, Vault uses it to populate this field. |
| Previous Signal Reporting Period | Vault populates the Signal Reporting Period from the previous scheduled review. |
Updating Scheduled Signal Reviews
To update the initiated signal review schedule, update the Schedule or Schedule Start Date for this Signal Product Profile and then schedule the signal review.
Vault cancels the current scheduled review and initiates a new review with the updated information. Any incomplete Scheduled Events associated with the cancelled review will be deleted.
Vault does not delete any Signal Reporting Periods from the Signal Product Profile even after updating the signal review schedule.
Canceling Scheduled Signal Reviews
You can cancel the current signal review schedule for this Signal Product Profile at any time:
- Navigate to the desired Signal Product Profile.
- Select the Cancel Scheduled Signal Review (
) icon or from the All Actions menu, select Cancel Scheduled Signal Review. You can run this action only if a Signal Review Schedule has already been initiated.
Vault updates the Signal Product Profile as follows:
- Sets the existing Signal Review Schedule Recurrence to Cancelled.
- Deletes incomplete Scheduled Events from the existing Signal Review Schedule Recurrence.
- Sets the Schedule Termination Date/Time.
Vault does not delete any Signal Reporting Periods from the Signal Product Profile even after canceling a signal review schedule.
If you want to reinitiate the signal review schedule for this Signal Product Profile, you can schedule the signal review again.
Configuring User Permissions
You must ensure users have the appropriate permissions to access the appropriate objects and fields according to your organization’s process. We recommend granting the following object and field permissions:
| Object | Fields | Object Permissions |
|---|---|---|
| Schedule | N/A |
|
| Schedule Component | N/A |
|
| Schedule Recurrence of type Signal Product Profile Recurrence | N/A |
|
| Scheduled Event | N/A |
|
| Scheduler Exception | N/A |
|
| Signal Product Profile |
|
|
| Signal Reporting Period |
|
|