Consistency Checker Diagnostic Tool

The Consistency Checker is an engineering, diagnostic tool that is used to check and attempt to fix the software for errors that may exist between the graphics stored in the project folder and System Browser. The tool uses a specific task files (.DLL) that you load and unload, to determine the tasks (or checks) that the Consistency Checker performs on your system.

The Consistency Checker also allows you to convert all graphics files in a project or library to any of the supported graphic file formats. A HQ librarian can use this tool to convert all symbols to the current management station graphic file formats.

The task files must be located in the GMSMainProject > BIN folder in order for the Consistency Checker tool to load them.

Task File

The management station provides a default .dll file that is loaded into the Consistency Checker.

Information

NOTE:
You should always run a backup of your graphic libraries before running any of the task files. Additionally, you should only run one task at a time.

The default file contains the following checks and tasks:

  • Check *.CCG and *.CCT files against System Browser nodes
    This task checks to see that a node exists in the System Browser for every graphic (.CCG and .CCT) that is located in the Graphics project folder. If there is no existing node in the System Browser, the missing node is added.
  • Check System Browser nodes against *.CCG and *.CCT files
    This task checks all graphic nodes in the System Browser against the graphic files (.CCG and .CCT) in your Graphics project folders. If you have an orphan node—a node that does not have an equivalent graphic—the orphan node is deleted from System Browser.
  • Check the Related Items of each System Browser node
    This task checks that all System Browser nodes have valid links to any graphics that have been associated with the node. If a graphic no longer exists because the link is invalid, the invalid link is removed from the node’s Related Items display.
  • Change System Name
    This task allows you to update graphics, symbols, and graphic templates that may be associated with a management platform the name of which has been changed.
  • Check thumbnails (*.PNG files) for Symbols and Graphic Templates
    This task checks whether all graphic files have a thumbnail (.PNG) and whether it is current. The task can be used to update all missing or old thumbnails.
  • File Conversion
    This task is used when you upgrade graphic specific project data from library from Desigo CC 1.1 or earlier to Desigo CC 2.0. The Consistency Checker checks all the graphics, symbols, templates, and sample graphics in the specified folder and library and updates them as needed. This is part one of a two step process to update symbols and then update the subsequent graphics with the symbols from the custom libraries.
    The following are the properties of this task that you can optionally use to control which files are being converted during the task execution.

Key

Value

Function

Conversion Method

To Bin (Default)

Type one of the desired file format for the conversion:

ToBin -Converts file to binary format

To ZIP - Converts files to ZIP file

ToXml - Converts files to XML

ToSvg - Converts files to SVG

Path Graphics

-Symbols

-GraphicTemplates

-SampleGraphics

Graphics\*ccg

Libraries\*.ccs

Libraries\*.cct

Libraries\*.ccg

For each path, type path of the location of the files.

Force Conversion

False (Default) \ True

Checks if the actual file format matches the one you want to convert to, for example, Binary.

False - If match found, then not saved.

True - Match or no match, all files are re-saved.

 

  • Symbol Statistics
    This task allows you to generate a list of symbols in the Findings section and then run a report that displays statistical information about all or selected symbols. Statistics include: number of elements, latest version, usage information, etc. The report is saved as a .CSV file in the Local\Temp directory.
    NOTE: To generate a report on all the symbols displayed in the Findings section could take up to an hour. It is recommended you only select the symbols from the list whose statistics you want to see in a .CSV file, or you can specify a subset of symbols using a specific path in the Task Properties section.
    • Click Check to generate the list of symbols, and then
    • Click Fix to generate the report.
  • Update Symbol Dependencies
    This task checks to see that any graphic or symbol containing embedded symbols has the most current version of the embedded symbols. If any of the embedded files are out of sync, the Fix button resaves the dependencies among them, thereby maintaining the integrity of the database and allowing for the rendering of the files to be optimized. The following are the properties of this task. It is recommended that you leave them at their default value.

Key

Value

Function

Path Graphics

-Symbols

-GraphicTemplates

-SampleGraphics

Graphics\*ccg

Libraries\*.ccs

Libraries\*.cct

Libraries\*.ccg

For each path, type path of the location of the files.

 

Related Topics

For related workflows and procedures, see Running the Consistency Checker.

For workspace overview, see Consistency Checker Workspace