User’s Guide – FileFixer for V8
Chapter 10 — Report File Settings
Factory defaults
Unless indicated otherwise, the settings illustrated in the following screen images reflect FileFixer’s factory default settings.
Report File Settings dialog box
“Report File Settings” dialog box for an HTML report file
“Report File Settings” dialog box for an ASCII report file.
Report file settings, factory defaults
FileFixer generates one or more reports each time you run it. The dialog box above shows the factory default report settings. When you use these defaults you get a single report in HTML file format from each FileFixer run.
The default report file name and path are as follows:
When processing a single file:
The report will be created in the directory with the design file and have the same name as the design file. The default extension is “.htm”. When you select ASCII as your output mode your extension is “.rep”.
When processing multiple files:
When you process multiple files in an “Edited File List” or by using a wildcard, FileFixer creates a single report file with information about all files processed. The report will be created in the directory of the active file and be named “fixer.htm”.
Other report default values
By default, FileFixer creates a summary of errors found at the top of the report.
The information from any previously existing seal-of-approval displays on the report.
If you are running in “Search for Problems” mode, a new seal-of-approval is created and the information written to it is also displayed.
FileFixer generates a list of all selected settings and some report explanation notes at the bottom of the report. This can be helpful in determining what you were running when looking at an old report.
Note: You can override automatic report file name generation by creating and setting the MicroStation configuration variable FIXER_DISABLE_AUTO_RPTFIL_NAME = “Yes”. When this configuration variable is set to “Yes” FileFixer will use the report file name you enter (won’t autogenerate report file names).
Format:
You can select HTML or ASCII format.
When you select “ASCII” and use .rep extension, reports will display in your computer’s default text editor.
Extension
When you select ASCII format the “Report file extension:” field defaults to “rep”. When you select “HTML” the extension defaults to “htm”. However, you can enter any extension you want.
Append the extension
By default in FileFixer’s main dialog box, the report file has the same base name as the active design file and the “.dgn” extension is replaced with “.htm”.
You have the option of appending report file extension to the base name plus extension of the active file. However, the option “Append the extension” is grayed out by default and is not available when using the “Put everything in one report file” setting (shown below):
The “Append the extension” check box becomes available when you change the “One or Multiple Report Files” setting “Create one report file per MicroStation file” (shown below):
When “Append the extension” is selected, FileFixer adds the extension to the active files base name plus extension (in FileFixer’s main dialog box):
As a pleasant reminder, the “Append the extension” option is only available when using the “Create one report file per MicroStation file” setting.
Report file style
By default, FileFixer’s “Report file style” is “detailed”. This means FileFixer will report each error per element. See the example below:
290, ID=3567 -- Cell "Chair". Shared cell definition has no shared cell instances. [303].
2000009, ID=229 -- Reference file <Floor.dgn> is missing. [343].
4000012, ID=1219 -- Current font library or resource has no font 10. [144].
4000767, ID=1720 -- Text string doesn't contain any visible characters.
[146].
4002775, ID=13803 -- Phantom element. Complex bit set for non-component.
[702].
If you the selected “Summary” as the “Report file style” then FileFixer only reports the number of occurrences of each error per file, instead of listing each error per element. See the example below:
File: V:\v8test\Fixer\Problem V8 format files\b01.DGN
Model: "Default" (2D)
Description: Created from V7 conversion
2 -- Element range doesn't match the min-max of its vertices. [705]
1 -- Complex header range is badly off. [720]
1 -- Element has too few vertices, points, boundaries, etc. [789]
Non-model section had 129 elements. FileFixer found 0 errors in it.
Model "Default" had 228 elements. FileFixer found 4 errors in it.
1 of the 1 files analyzed are in danger.
Put the report summary
Put the following report summary information at the beginning of the report file or after all the errors for the last design file or cell library:
Report Summary
3 -- Text element doesn't contain any visible characters. [146].
1 -- Shared cell definition has no shared cell instances. [303].
2 -- Complex header range is incorrect. [320].
1 -- Reference file is missing. [343]
By default, FileFixer puts the report summary at the beginning of the report file.
What to include
Each search and repair setting.
When selected, the state (on or off) of each search and repair setting is included in the report file.
Explanation notes.
When this setting is checked, explanations about FileFixer’s error numbers, error severities and definitions for FileFixer-specific terminology are added to the end of the report file.
Message for files with no anomalies.
If a design file or cell library has no errors in it then the name of the design file or cell library is not printed in the report file. The report file will normally contain the names of the design files and cell libraries that have some kind of corruption in them. This setting is provided so you can see the names of all the design files and cell libraries that were searched by FileFixer even if they had no errors in them.
New seal-of-approval information.
The seal-of-approval contains the following information: error numbers found, date and time when FileFixer was run on the file, and the level of error reporting that was done (e.g. “Fatal error only”, “Errors and fatal errors”, etc.).
Previous seal-of-approval information.
If the file being processed contains a FileFixer seal-of-approval from a previous “Search for Problems” run, you can use this setting to display a summary of information found in that run..
Total number of problems found.
FileFixer will add the following messages to the end of the report files:
999 problems found
999 elements modified
The number of problems found and the number of elements modified will only be the count for those design files and cell libraries specified in the report file. If you are using the setting to have one report file per design file then these counts will only be for the one file, not for all the files you are processing (if more than one).
One or Multiple Report Files
When you run FileFixer on a large number of files, the default format of “Put everything in one report file” may be inconvenient. FileFixer gives you the ability to create one report file for each file processed with an index containing a summary of all errors found and links to the individual reports.
Put everything in one report file
When you select this setting, FileFixer builds a single report file for all design files and cell libraries processed. This is the default. The report file will be in the directory of the active file and be named “fixer.rep” or “fixer.htm”.
Create one report file per MicroStation file
When you select “Create one report file per MicroStation file.”, FileFixer builds one report file for each design file and cell library processed. It also creates an “index” file containing a summary for each file processed.
Index file output directory
When you build one report file per MicroStation file, FileFixer creates an index file containing a copy of the report summary for each design file processed. (See image below.) When you use HTML format, the index file will also include a hyperlink to each individual, detailed report file.
If index file already exists
If the index file already exists then you have three options, (1) append the new report summaries at the end of the index file, (2) increment the index file number, or (3) overwrite the old index file with the new one.
The format for the index file name is “index9999.rep” or “index9999.htm” when you are incrementing the index file number, otherwise, it is just “index.rep” or “index.htm”. FileFixer allows up to 9,999 index files when you are incrementing the index file number.
Directory for individual reports
When you select “Create one report file per MicroStation file”, the report files can be placed in one of the following locations:
Your selections in the “When repairing a design file or cell library” section of the Settings | Change Settings | General... dialog box determine when the above settings are enabled or disabled.
If one of the above settings is specified, then the “Report file:” <Select...> button on the main FileFixer dialog box will be disabled. For example:
Put reports in the specified directory.
If you select “Put reports in the specified directory” then you need to also specify the directory path for the report files. You can do this by entering the directory in the “Report file output directory:” field or by pressing <Select>. After you press <Select> the following dialog box opens and allows you to specify a directory. The main FileFixer dialog box “Report File:” field shows the selected directory followed by a *.rep or *.htm.
Program to display and print the ASCII report file:
This field defaults to notepad.exe, but you can use the <Select...> button to choose a different text editor.