APOGEE Graphics Importer Overview

The APOGEE Graphics Importer conversion tool allows you to import and convert Insight graphics to use in the management station. Graphics that have been exported out of the Insight Management workstation, and reside in a Graphics folder locally, can be imported. Each graphic has a folder that contains an .XML file with all the information about the graphic, associated data points, controls, and links. This information is then used during the import process to associate the controls with the management station Symbols from the BA_Device_APOGEE_Graphics HQ_1.gms library, and then generates a Desigo CC graphic (.CCG) that is viewable and editable in the Graphics Viewer and the Graphics Editor.

For a list of the controls and how the attributes and links associated with the graphic are converted, see the section Support and Limitations When Converting APOGEE Graphics.

Prerequisites

In order to import the APOGEE Graphics, there are several tasks you must perform prior to importing to the management station.

• You will need to export the Insight graphics out of the Insight database, using the Desigo CC Export Utility and Commissioning Tool in online mode. The exported graphic files are stored in a Graphics folder, ready for import into the management station.
• If you have restored your Insight database, you must have copied your files from the CT "Jobs" folder to your default database folder.
• The APOGEE Graphics extension module is installed. This is done either during a Desigo CC installation, or if the software is already installed, you can run the installation wizard again, and just install the extension module. The supporting library: BA_Device_APOGEE_Graphics HQ_1.gms/ is included in the installation. This library contains the Symbols that are associated with the APOGEE graphic controls during the import process and added to the final graphic that is generated in Desigo CC.
• The APOGEE Driver has been created and installed.
• You have created a Symbols folder in the System Settings > Libraries > L4-Project > Common > Common > Common_Data_Project_1 folder. Otherwise, during the import you will be prompted to create a Symbols folder. If a Symbols folder does not exist, the Symbols are not imported.

Export Folder File Structure

Once you have extracted your APOGEE graphics out of Insight using the Desigo CC Export Utility, a Graphic folder containing all the exported graphics is generated.

The following file structure applies for the exported graphics:

Graphics – This is the root folder that contains one folder for each graphic exported out of the Insight database.

• Individual graphic folder using the graphics name – This folder contains all the information and graphics related to the graphic, as follows:
• XML file that contains all the data pertaining to the graphic
• A .PNG version of the graphic that is used as a thumbnail for use with Desigo CC
• Folder for each graphic attribute or controls, such as Background, Pictures, Animation, Links, and so on. For example, if an APOGEE graphic has a background and animation associated with it, the graphic will have two subfolders: one Background, and one Animation folder.
• Each attribute folder contains the graphic in the original file format, such as Micrografx™, .DSF, IMG, .GIF, and so on.

Graphics Import Conversion Tool

The conversion tool to import your exported APOGEE Insight graphics is located in the in the Desigo CC System Settings directory, under Conversion Tools. The tool allows you to select all or individual Insight graphics to import into Desigo CC. Once you have made your selection(s) in the tool, a status message for each graphic displays, letting you know if the import was successful, failed, or partially successful. If the import of the graphic was a success, a Desigo CC graphic (.CCG) is created and automatically displays in your Application view, Graphics folder. The Symbols, however, display in the System Settings > Libraries > L4-Project > Common > Common > Common_Data_Project_1.

Status Messages

When you import an APOGEE graphic using the Graphics Importer conversion tool, there are two status messages you may see related to the import of a particular graphic: Failed or Migrated with Errors. To view what the errors are, navigate to the Graphics Import log: GMSMainProject > _[DefaultProject] > Temp > GraphicsImportLog

The two error statuses generally indicate the following:

• Failed – There is a problem with the graphic name, and nothing has been imported.
• Migrated with Errors – Indicates that there was a partial import of the graphic file. Generally, the graphic image has been imported, but the data points have either not been found or, in the case of some EGO controls, truncated and will not display.

Support and Limitations When Converting APOGEE Graphics

Once you have imported your APOGEE Insight graphics, you can view and use the graphics, along with the associated data points. Most Insight graphics features are fully supported in Desigo CC. However, there are some limitations. The table below lists the support and limitations in migrating APOGEE Insight graphics to a Desigo CC management station.

The font color and general color properties for Point Information Blocks are taken from the information contained in the Insight State Text tables for that control. If you want to change the color settings, you must either do so in the State Text tables in the Insight software, or, once you have imported the graphic, you can change the color settings in the Graphics Editor.