Migrating Safety Cases

New Studies that are migrating from a third party EDC system and have an automated solution for the transfer of safety data can now enable E2BLink after the migration to Vault CDMS. Vault administrators can use Vault Loader to load Safety Cases from the originating system into Vault CDMS, which Vault uses to also create Safety Messages. After the CDMS vault and safety system are connected, Vault automates all new and existing Safety Cases for the life of the Study.

Creating the Loader File

You will use two loader files (CSV) to create records in the Safety Case and Safety Case - Form objects.

Safety Case File

Include the following columns in your Vault Loader file:

Column Header Expected Value
cdms_safety_case_unique_id__v Enter a unique identifier for the Safety Case.
first_reporter_first_name__v Enter the first name of the first reporter.
first_reporter_last_name__v Enter the last name of the first reporter.
first_reporter_country__v Enter the 2-letter abbreviation of the country for the first reporter.
safety_definition__v Enter the ID of the Safety Definition (safety_definition__v.id). This can be obtained from Admin > Business Admin > Safety Definitions.
study__v.name__v Enter the Name of the Study that (study__v.name__v).
date_report_first_received_from_source__v Enter the date and time when the SAE was first captured by EDC.
site__v.name__v Enter the Site Number (site__v.name__v) of the Site for this Safety Case.
study_country__v.name__v Enter the Study Country (study_country__v.name__v) of the Study Country for this Safety Case.
subject__v Enter the ID (subject__v.id) of the Subject for this Safety Case. This can be obtained from Admin > Business Admin > Subjects.
subject_name__v Enter the Subject ID (subject__v.name__v) of the Subject for this Safety Case.
case_status__v Enter one of the following statuses: case_accepted__v, closed__v, rejected__v.
message_starting_number__v Enter a number for EDC to use as the next Message Number if the originating EDC system creates a new follow up, For the first message in the case created by CDMS (when the starting number is null), use 0. If not null, use message_starting_number + 1. This value is null if the case was created by CDMS. If the case was migrated, this value is not null.

Safety Case - Form File

Include the following columns in your Vault Loader file:

Column Header Expected Value
ae_form_def_name__v Enter the Name of the Form Definition (form_def__v.name__v) for your Serious Adverse Event form.
ae_form_id__v Enter the ID for your Serious Adverse Event form (form__v.id). This can be obtained from Admin > Business Admin > Forms.
ae_form_seq_num__v Enter the Sequence Number (Reference #) for the Serious Adverse Event form (form__v.form_seq__v).
safety_case__v Enter the ID for the Safety Case (safety_case__v.id). This can be obtained from Admin > Business Admin > Safety Cases.

Load the Files

First load the Safety Case loader file, then load Safety Case - Form.

To load a file:

  1. In the left panel of the Loader tab, click Load.
  2. For the CSV File, click Choose and select the CSV input file.
  3. In the Object Type drop-down, select the object on which to perform bulk actions.
  4. In the Action Type drop-down, select Create.
  5. Click Start Load.

Before processing the request, Vault validates the selected CSV file. If the file is valid, Vault begins processing the request. When finished, you’ll receive a Vault email with request details and CSV output files.

File Validation

Before beginning the Vault Loader job to create object records, Vault checks that the selected CSV file meets certain criteria:

  • If creating object records, the total number of records in the vault, plus new records created by the CSV, would not exceed your vault’s limits
  • If creating object records, includes at least one record
  • Is not empty
  • Does not contain empty columns
  • Includes a valid header row (Invalid header rows are those with no columns that match to metadata for the records you’re loading.)

If your file is not valid, Vault displays a notification, stops the process, and allows you to select a new CSV file. If some of the column headers do not match metadata for your vault, the notification will allow you to stop the load or ignore those columns and proceed.

Message Creation

After you load the files, Vault creates the necessary object records. Vault uses the number you entered for message_starting_number__v when creating a Safety Message for the case. Vault then treats this as a follow-up, instead of the first send. If you used the Closed case status, Vault doesn’t create a Safety Message for the case.