Using bulk creation for Activity, Submission, and Regulatory Objective records, you can standardize and minimize much of the local affiliate data entry required for global change events. If there are custom required fields on the Activity or Submission objects, you are able to populate these during bulk creation as well as required fields based on object type.

Creating Records in Bulk

The steps below apply to all registration types.

From an Event Record

To create Activity, Submission, or Regulatory Objective records in bulk:

  1. Open the associated Event record from Business Admin or a custom tab.
  2. Select Create Related Records from the Actions menu.
  3. Use the checkboxes to indicate whether you’re creating Activities, Submissions, or Regulatory Objectives. You can select multiple objects, but only objects you have permission to create are available.
  4. If creating Activities, select the Activity Scope Level. Vault may automatically select a scope, but you can choose a different one. See details about Activity record creation below.
  5. If your Vault has object types configured for the Submission or Activity objects, select an Activity Type, Type of Submission, or Regulatory Objective Type. Depending on your Vault’s configuration, object types may be determined automatically for Activity based on the related Event, or for Submission or Regulatory Objective based on the related Application.
  6. Select the Markets affected by the Event.
  7. Optional: Select Impacted Products. Vault automatically populates this field if the Event is associated with fewer than 100 Products. If the Event is associated with more than 100 Products, click the binoculars icon to select Products.
  8. If creating Submissions, select a Submission Type for all the records created through this bulk action. Because submission types vary across markets, you can use the generic Planned Submission or, when enabled, select from a pre-filtered list of preferred global terms. In either case, you must select a valid Submission Type (based on reference constraints) for the countries in the selected market, otherwise Submission creation fails.
  9. If necessary, populate any required fields for the selected Activity, Submission, or Regulatory Objective object types.
  10. Click Next.
  11. If creating Submissions and Regulatory Objectives, Vault displays the Select Relationships page. Vault shows a list of available relationship types for the Event object and automatically selects all active relationship types. Deselect any relationship types that you do not want to copy forward to the newly-created Regulatory Objectives and Submissions. In the next step, you’ll select specific related records to include.
  12. In Define Relationships, you’ll see the join records for each selected relationship type. Use the checkboxes to choose the specific items to copy as joins for the Regulatory Objectives or Submissions you’re creating.
  13. On the Additional Details page (or Application Details page, when record review is enabled), select an existing Application that corresponds to each market. The selected application becomes the parent record for the new Submission record. This selection is optional when only creating Activity records. If you selected Country level activity scope, Vault automatically filters the Application by Region. If you selected Application or Application and Product level activity scope, Vault automatically filters the Application for each Country by Region and Lead Market. You cannot remove the Region filter.
  14. If necessary, populate any additional required fields for the selected Submission or Regulatory Objective object types.
  15. Click Next to proceed.
  16. On the Confirmation page, review the details of the records that will be created or updated. Click Finish to start creating records, or select Generate Preview. The preview option appears only when enabled. See Reviewing & Refining Related Records for details and additional instructions.

See How Vault Creates Related Records for details on the records the wizard creates.

From an Impact Assessment Report

You can start this process from the one-click impact assessment reports or from a custom report with one of the impact assessment report types. When creating from a report, you’ll have fewer fields to populate, as Vault pulls most data from the report itself.

To create Activity, Submission, or Regulatory Objective records from a report:

  1. Run the report.
  2. Select Create Related Records from the Actions menu.
  3. If starting from a copy of the standard report, select a specific Event. Vault may populate this field automatically depending on the type of Impact Assessment Report your Vault uses.
  4. Use the checkboxes to indicate whether you’re creating Activities, Submissions, or Regulatory Objectives. You can select multiple objects, but only objects you have permission to create are available.
  5. If creating Activities, select the Activity Scope Level. Vault may automatically select a scope, but you can choose a different one. See details about Activity record creation below.
  6. If your Vault has object types configured for the Submission, Activity, or Regulatory Objective objects, select an Activity Type, Type of Submission, and Regulatory Objective Type. Depending on your Vault’s configuration, object types may be populated automatically for Activity based on the related Event or for Submission or Regulatory Objective based on the related Application.
  7. If creating Submissions, select a Submission Type for all the records created through this bulk action. Because submission types vary across markets, you can use the generic Planned Submission or, when enabled, select from a pre-filtered list of preferred global terms. In either case, you must select a valid Submission Type (based on reference constraints) for the related countries, otherwise Submission creation fails.
  8. If necessary, select a Regulatory Objective object type.
  9. If necessary, populate any required fields for the selected Activity, Submission, or Regulatory Objective object types.
  10. Click Next to proceed.
  11. If creating Submissions or Regulatory Objectives, Vault displays the Select Relationships page. Vault shows a list of available relationship types for the Event object and automatically selects all active types. Deselect the relationship types that you do not want to copy forward to the newly-created Regulatory Objectives and Submissions. In the next step, you’ll select specific related records to include.
  12. In Define Relationships, you’ll see the join records for each selected relationship type. Use the checkboxes to choose the specific items to copy as joins for the Regulatory Objectives and Submissions you’re creating.
  13. On the Confirmation page, review the details of the records that will be created or updated. Click Finish to start creating records, or select Generate Preview. The preview option is available only when enabled, and when the related Event is not already under preview. See Reviewing & Refining Related Records for details and additional instructions.

See How Vault Creates Related Records for details on the records the wizard creates.

The Create Bulk Records wizard includes additional functionality allowing you to preview the records Vault is proposing to create or update based on the Event and other selected records. Vault displays them in the wizard, allowing you to navigate through each Lead Market’s Application and remove any related records which Vault should not create or update. Once you’ve refined the list, Vault creates or updates the records according to the logic in How Vault Creates Related Records.

Review & Refine Related Records panel

When you click the Generate Preview button in the wizard, Vault:

  • Kicks off a job to create and gather the selected records and metadata. Once complete, you’ll receive an email and Vault notification with a link to preview them in Vault directly, as well as an attached CSV file summarizing the records included in the preview.
  • Transitions the Event record to the In Data Review state, which prevents all users from initiating the wizard for that Event or Impact Assessment Report.

You can also select the Review Related Records action from the Event record or report Actions menu. The action is available anytime an Event and its related records are available for preview.

To review and refine related records:

  1. Click the link in the email or Vault notification, or select Review Related Records from an Event in the In Data Review state.
  2. Vault displays the Review and Refine Related Records page. In the left-hand panel, select the Lead Market’s Application, then the related record type you’d like to review. Applications and their related records appear with various icons denoting their status prior to your review and confirmation: records are active, records are inactive, and records with a indicate a dependency warning.
  3. In the right-hand panel, use the various UI options to perform your review:
    • Add columns and apply filters within each section.
    • At the top of the panel, click the button to quickly display only the records with dependency warnings, or click the All button to return to a listing of all records in the preview.
    • To include a record, check the box to the left of the item, or uncheck the box to omit it. You can also click Select All or Deselect All to add or remove the selections for all records in that section.
    • If you encounter incorrect records requiring updates, click the Clear button to remove the preview file.
    • If you cannot complete your review in a single session, click the Save button to save your selections.
  4. When you’ve refined the list to your requirements for a given related record type, click Confirm. In the event of dependency warnings, the Dependency Issues dialog appears, requiring you to click Continue to confirm such records will be created, or Cancel to return to the Review and Refine Related Records page.
  5. Repeat Steps 2-4 until you’ve reviewed and confirmed the desired related record types. (The wizard does not require that you review and confirm all record types for all Applications.) As you proceed through the list, Vault adds a green checkmark next to each record in the left-hand panel to indicate you’ve confirmed that selection, and that there have been no further changes to it since confirming.
  6. When your review is complete, select Finish to create the records that are still selected in the preview.

Vault begins creating records according to your review. Once complete, you’ll receive an email and Vault notification with a CSV file confirming the records Vault created or updated.

About Dependency Warnings

A record dependency warning indicates that the wizard will create independent records, or records without a reference to a related record.

For example, if you deselect a Submission Product record, Vault flags any related Submission Inactive Ingredient records with a dependency warning . If you do not deselect the flagged records, Vault creates Submission Inactive Ingredient records with a blank Submission Product field. When you deselect a flagged record, Vault removes the dependency warning and does not create any such records.

Saving Preview Files

When a given user is working in the wizard, Vault prevents all other users from generating a new preview file or working with the current one.

If you cannot complete your review in a single session, click the Save button at the top of the wizard’s Summary and Refine page. Vault keeps your selections until you or another user return to it by running the Review Related Records action.

Clearing Preview Files

In the event a preview includes incorrect or missing data, you can remove it and generate a new preview file.

To do so, click Clear at the top of the wizard’s Summary and Refine page, or select the Clear Preview action from an In Review Event record’s Actions menu.

Once cleared, the Event record returns to its previous lifecycle state and you can re-run the Create Related Records action.

The sections below describe how the wizard creates related records based on the originating record, as well as other Vault settings.

From an Event

Vault creates one (1) Submission record and one (1) Regulatory Objective record for each Application. If you defined relationships for the Event, Vault only copies the selected Event join records to the new Regulatory Objective and Submission records. When the Enable Application Relationships setting is in use, Vault also creates new Application relationship records if an existing match is not found.

The Activity Scope Level you selected when creating related records from an Event record determines how many Activity records Vault creates:

  • Application: Vault creates one (1) Activity record for each Application. Use this scope level in cases where you prefer to manage the fewest Activity records, and where task completion can be sufficiently tracked at this highest level of granularity.
  • Application and Product: Vault creates one (1) Activity record for each combination of Application and Product. These records are useful for changes to each Product involved in an Application which need to be tracked to completion.
    • When the Enable Application Relationships setting is in use, Vault creates one (1) Activity per unique combination of Application and Product selected in the wizard where the Product also exists in at least one Application Product relationship record’s Product (pharmaceutical_product__v) field.
  • Country, Application and Product: Vault creates one (1) Activity and its related details for each combination of Application, Market, and Product (drug_product__v)*. If you didn’t select Products*, Vault creates one record for each combination of Application and Market. This option creates the highest number of Activity records. Use this scope level for changes that need to be completed and tracked at the country level on a product-by-product basis.
    • When the Enable Application Relationships setting is in use, Vault creates one (1) Activity per unique combination of Country, Application, and Product selected in the wizard where the Product also exists in at least one Application Product relationship record’s Product (pharmaceutical_product__v) field.
  • Country and Application: Vault creates one (1) Activity for each combination of Country and Application, based on the Country records related to each Application record you selected on the Additional Details page. This is especially helpful for Mutual Recognition (MRP) and Decentralised (DCP) procedure types, as activity completion can be tracked for each member state included for those applications.

Vault does not create related Activity Registration records when you start the wizard from an Event record.

From an Impact Assessment Report

Vault creates one (1) Submission record and one (1) Regulatory Objective record for each Application. Vault also creates a relationship between the Registrations in the report and the relevant newly created Regulatory Objective. If you defined relationships for the Event, Vault only copies the selected Event join records to the new Regulatory Objective and Submission records. When the Enable Application Relationships setting is in use, Vault also creates new Application relationship records if an existing match is not found.

When you run the Create Related Records wizard from an Impact Assessment Report, Vault also applies validation logic before creating Regulatory Objective and Submission join records to prevent invalid relationships. See the Creating Activities, Submissions, and Regulatory Objectives from Impact Assessment Validation Logic file for more details.

The Activity Scope Level you selected when creating related records from an Impact Assessment Report determines how many Activity records Vault creates:

  • Application: Vault creates one (1) Activity record for each Application. Use this scope level in cases where you prefer to manage the fewest Activity records, and where task completion can be sufficiently tracked at this highest level of granularity.
  • Application and Product: Vault creates one (1) Activity record for each combination of Product and Application. These records are useful for changes to each Product involved in an Application which need to be tracked to completion.
  • Country, Application and Product: Vault creates one (1) Activity for each combination of Application, Market, and Product (drug_product__v)* related to the Registrations in the report. This option creates the highest number of Activity records. Use this scope level for changes that need to be completed and tracked at the country level on a product-by-product basis.
  • Country and Application: Vault creates one (1) Activity for each unique combination of Application and Country across the Registrations. This is especially helpful for Mutual Recognition (MRP) and Decentralised (DCP) procedure types, as activity completion can be tracked for each member state included for those applications.

When you start the wizard from an Impact Assessment Report, Vault also creates related Activity Registration records when the Application on the Activity matches the Application on the Registration. When creating Activity records with a defined Country and Application scope, Vault creates Activity Registration records only for the Activity and Registration pairings with matching Country and Application field values.

Copying Custom Fields

Vault copies custom field values from Event join records to the corresponding Submission join records or Regulatory Objective join records when custom fields with matching names and field types are configured on both objects. Vault supports copying custom fields for Picklist, Object, Date, DateTime, Yes/No, Text, and Number field types.

Field & Relationship Defaulting

Vault populates these fields during bulk creation:

Object Field Details
Activity, Submission, Regulatory Objective Name Vault assigns record names based either on a static pattern as displayed in the wizard UI or on system-managed naming defined on the relevant object. Depending on the configuration of your Vault, record name uniqueness is enforced as necessary by appending a six (6) digit unique number on the end of the name. Vault may truncate names if required due to character limits. For Regulatory Objective and Submission records, your Admin can also configure a naming pattern that Vault only uses when creating records through this wizard.
Activity Event New Activities become child records of the Event from which you started the process.
Activity Activity Status If applicable, this field defaults to Planned.
Activity Impacted Market Vault creates one (1) Activity record for each selected market. When creating from a report, this reflects the report data.
Activity Impacted Product This field is populated with the Product (drug_product__v)* record optionally added in the wizard or based on the Product related to the Registrations in the report data. Vault only populates this field when the Activity Scope Level is Application and Product.
Activity Planned Completion Date This field inherits the value from the same field on the Event record, if any.
Activity Related Application This field points to the Application record associated with the market during bulk creation, if any. When creating from a report, this reflects the report data.
Activity Related Submission This field points to the Submission record created for the same market. If creating only Activities, this field is blank. If bulk creation includes Activities and Submissions (or Submissions without Activities), Vault updates any existing Activity records in the Country Impacted lifecycle state type for the same Event and Application.
Activity Regulatory Objective This field points to the Regulatory Objective record created for the same market. If creating only Activities, this field is blank. If bulk creation includes Activities and Regulatory Objectives (or Regulatory Objectives without Activities), Vault updates any existing Activity records in the Country Impacted lifecycle state type for the same Event and Application.
Submission, Regulatory Objective Application Number This field points to the Application record associated with the market during bulk creation. When creating from a report, this reflects the report data.
Submission, Regulatory Objective Manufacturing Site Role This field uses the selection made during bulk creation. When enabled, Vault populates the field with the local term mapped to the preferred global term you selected in the wizard. Otherwise, Vault populates this field with the Global Manufacturing Site Role value from the Event relationship record when there are multiple matches, or if a match does not exist.
Submission Submission Type, Submission Subtype These fields use the selection made during bulk creation. When enabled, Vault populates them with the local term mapped to the preferred global term you selected in the wizard. Otherwise, Vault populates this field as Planned Submission when there are multiple matches, or if a match does not exist.

Bulk Action Processing Time & Notifications

Bulk creation occurs asynchronously, meaning that there may be a delay before you see the new records, particularly on Vaults with a lot of activity. Once you confirm a bulk creation, Vault puts the action in a queue with other asynchronous tasks. When the changes are complete, a note appears in your Notifications page and Vault sends you an email with a link to download a CSV summary file.

If Vault is unable to complete any of the creation tasks, the CSV will include an explanation of the errors. Known reasons for these errors include:

  • Records that are in an active workflow will not be modified
  • Records already in the specified state will not be modified

Bulk creation requires that your security profile grant Create permission on the objects you’re creating, for example, Submission. Vault checks for the required permissions during the asynchronous record creation phase of the process. You may be able to view the action even if it is not available to you. Any field-level security your Admin has configured on these objects may impact record creation as well.

You must also have Read permission on the source records from which you initiate the wizard, for example, Event, and the records from which the wizard pulls data, for example, Event Active Substance. If the objects use Dynamic Access Control, you must also have at least the Viewer role on the specific records. If your Vault uses field-level security, you must have Read permission on the fields from which Vault pulls data.

*In Vaults created after the 19R1 release, the following objects are relabeled to support medical devices:

  • The Product (product__v) object is now Product Family.
  • The Drug Product (drug_product__v) object is now Product.

In existing Vaults, Admins can update these objects manually.