MissingFilesCorrection
 |
For a general, step-by-step guide on using the corrector module, see Using the Data Inconsistency Corrector Module.
|
Description
This tool generates a report table that contains information about missing files in the current Codebeamer instance, which can help restore those missing files.
When a file is uploaded to Codebeamer, a record is created in the object_table that stores its information, including the location of the file in the current Codebeamer instance. Errors can sometimes cause recorded file locations in a Codebeamer instance to become invalid, for example if a file is moved or deleted, but its previous location is still stored in the instance. In this case, it is possible that another copy of the file still exists in a different Codebeamer instance.
The report table generated by this tool helps to find corresponding files in other Codebeamer instances, so that the missing files can be restored. For example, if a file is missing from a Codebeamer development instance, a clone of that development instance can still contain that file, which can be used to restore the file.
|
|
This is a tool for reporting only. This means there is no restore phase and the Restore button does not appear after clicking Detect.
Restoring the detected missing files must be done manually.
|
Report Table
The report table for the MissingFilesCorrection correction is named missing_files_report_table. It contains the following information:
|
Column
|
Description
|
|---|---|
|
id
|
The ID number for the detected issue.
Detected issues are numbered, starting at 1.
|
|
artifact_file_link_id
|
The ID of the location of a missing file.
|
|
file_path
|
The recorded location of a missing file.
|
|
uploaded_file_hash
|
The hash value of the missing file.
|
|
referring_artifact_ids
|
The IDs of Codebeamer items that reference the missing file, separated by commas. For example, the ID of a comment that includes a missing image file.
The order of IDs corresponds to the order of names under referring_artifact_names.
|
|
referring_artifact_names
|
The names of Codebeamer items that reference the missing file, separated by commas. For example, the name of a comment that includes a missing image file.
The order of names corresponds to the order of IDs under referring_artifact_ids.
|