Migrating Links
The EDC Migrator supports linking Forms to Forms (Form-to-Form linking) and Items to Forms(Item-to-Form linking) as part of the migration process. This functionality reduces the amount of manual intervention required to create links in migrated studies.
Item-to-Form linking is used to link an item on one form, to a completely different form, whereas Form-to-Form linking links two separate forms. Form-to-Form linking is useful for linking an adverse event (on an AE form) to a Medical History form or to link an AE form to a Medical History or ConMed form. Linking allows you to group related data or indicate a cause and effect.
Linking is performed automatically as part of the data migration process using a single Links CSV file.
Preparing the Links CSV File
The CSV file (links.csv) maps links between form or item instances in your source data. This file is required to create links during migration. If a study has links but the file is not provided, the load continues with a warning.
The columns required for the first form instance in the link have “_REF” appended to the column header (e.g., SITENUM_REF). Columns required to identify the associated form or item instance have “_LINK” appended to the column header (e.g., FORM_LINK). All required columns must be populated, otherwise, an error occurs.
Use this template to create your CSV file:
Required Columns
Your CSV file must include the following columns, with the exact header values specified in the table:
| Column | Description | 
|---|---|
| STUDYID | Identifies the study. | 
| SUBJID | Identifies the subject. | 
| SITENUM_REF | Identifies the data collection site. Used to identify the first form. | 
| EGROUP_REF | Identifies the repeating group. Used to identify the first form. | 
| EGROUPSEQ_REF | Sequence number for the reference repeating group. Used to identify the first form. | 
| EVENT_REF | Identifies the specific event or visit. Used to identify the first form. | 
| FORM_REF | Identifies the name of the source form. Used to identify the first form. | 
| FSEQ_REF | Sequence number for the reference form. Used to identify the first form. | 
| SITENUM_LINK | Identifies the site of the linked data. Identifies the additional form to link or the form for the item to link. | 
| EGROUP_LINK | Identifies the repeating group of the linked data. Identifies the additional form to link or the form for the item to link. | 
| EGROUPSEQ_LINK | Sequence number for the linked repeating group. Identifies the additional form to link or the form for the item to link. | 
| EVENT_LINK | Identifies the event of the linked data. Identifies the additional form to link or the form for the item to link. | 
| FORM_LINK | Identifies the name of the target form. Identifies the additional form to link or the form for the item to link. | 
| FSEQ_LINK | Sequence number for the linked form. Identifies the additional form to link or the form for the item to link. | 
| IGSEQ_LINK | Sequence number for the item group within the linked form. Identifies the form for the item link. | 
| ITEM_LINK | Identifies the specific item being linked. Must be the definition name of the item-to-form link. |