About an Import
Code Insight 2021 R2
The Code Insight project-data import feature is available through these interfaces:
| • | Code Insight Web UI, as described in Importing Project Data Using the Web UI |
| • | Code Insight REST interface, as described in Importing Project Data Using the REST API |
The following sections provide overview information about the import process.
Input Used in the Import Process
The input for a project data import is an archived JSON data file containing project data. During the import process, this JSON data file (called the import data file in this documentation) is extracted from the archive and imported to a specific Code Insight project, called the target project.
You can create this input archive in a couple of ways:
| • | Use the Code Insight project-data export feature (see Exporting Project Data) to export data from a Code Insight v7 project. |
| • | Export data from a Code Insight v6 project (see the Code Insight 6.14.x documentation for instructions). Then use the Audit Migration Tool to convert the exported data into the format required for importing in a v7 project. |
| • | Manually create the import data file using data exported from an external system and formatting it as JSON code. Then compress the data file as a .zip archive. |
In all cases, the input for the import process must be a data file whose contents are in the expected JSON format and that has been archived as a .zip file.
The project data import is performed on a project—called the target project—that has been created in Code Insight. This target can contain the results of a server or remote scan (or both types of scans) performed on the target codebase prior to the import. (See Scan Types for a description of server and remote scans.) The import process creates inventory with file associations and provides access to codebase files through the Analysis Workbench in the target project. The inventory is live—that is, ready to be edited and reviewed.
About Importing Data to Current and pre-2020 R3 Projects
The following are the allowed and disallowed import scenarios involving current projects and projects created before Code Insight 2020 R3. (Also see Legacy Projects.)
| • | You can import data exported from a project created in 2020 R3 or later into another 2020 R3 or later project. |
| • | You can import data exported from a project created in 2020 R3 or later to a standard project (created in 2020 R2 or earlier) that has been migrated to 2020 R3 or later. |
| • | You cannot import data exported from a project created in 2020 R3 or later to a legacy inventory-only project that has been migrated to 2020 R3 or later. |