Imagix 4D User Guide


Saving and Importing Reports

The Import Report function serves two purposes. First, it allows appropriately saved Flow Check reports to be reopened and viewed in different sessions than where they were created, without rerunning the actual report. Secondly, it enables properly formatted external reports to be loaded and viewed in Imagix 4D, in a way that integrates to Imagix 4D's full source code exploration capabilities.

Saving and Reopening Flow Check Reports

Because of the extensive data flow analysis underlying many of the Flow Check reports, they can take a significant amount of time to generate. While the results can be printed to an ASCII file, the understanding and navigation available through the color-coded links is lost.

The Import Report feature provides a way to reopen a report in a later, separate session of Imagix 4D without needing to regenerate the report. By using the special report format (.4dr) while saving the initial report, information about all of the links is saved along with the report contents themselves. The resulting .4dr file can be then be imported when that project is later opened, even by a different user on a different machine.

Importing External Reports

The Import Report mechanism provides an easy way to integrate Imagix 4D with data generated by external tools. In particular, it simplifies the use of Imagix 4D's software understanding capabilities to examine issues flagged by the external data. After importing the data, you're able to directly navigate from the items displayed in the report to the corresponding source code, and begin your use of Imagix 4D there.

Import Report requires that data exist in a comma separated value (.csv) file having a specific format. Consider this sample:

Anything here is ignored.
File,Line,Col3 Descr,Col4 Descr,Col5 Descr
C:/full/path/to/file.c,123,something,something else,third thing
C:/full/path/to/anotherfile.c,456,again,xxx,anything thing
The data section in the .csv file must contain at least three columns. When more than three columns exist, the import process will inquire about which column to import along with the file and line number information. The full file pathname must appear in the first column, and must correspond to the pathnames being used in the Imagix 4D project. The line number must appear in the second column. Preceding the lines of data must be a header line containing the names of the data columns, which must start with "File,Line,". Any lines in the .csv file preceding this header line will be ignored.