Advanced Graphic Validation Rules

Each Visio Advanced Graphic is validated with the following rules:

Info Rules:

All Validated Objects
Any objects that were found in the MSEA Binder Database that aren't graphic objects.

All Validated Graphic Objects
Any graphic objects that were found in the MSEA Binder Database.  Custom Property names of NavigationObjRef and GraphicObjRef are keys for a graphic object type.

External Links
All external hyperlinks.  Any user defined value that uses the LINK action code.

All Aliased Links
All links to a template graphic.  Any user defined value that uses the NAVIGATE action and at least one local variable is passed as a parameter are considered aliased links.

Elapsed Time
Total time in seconds to validate the graphic object

This Graphic Object Name
The name of the current graphic object being validated.  The value comes from the custom property GraphicObjRef in the page properties section.

Warning Rules:

Blank Object Reference
A blank object reference was found.

Template Links In Template File
Occurs if aliased links to another template graphic are found.

Missing Or Blank Graphic Object Reference
Occurs when the custom Property GraphicObjRef doesn't have a reference assigned.  Without this reference, a graphic mapping cannot be set in the MSEA Binder Database.

Graphic Object Name Doesn't Match Visio File Name
Occurs when the object name portion of the custom Property GraphicObjRef doesn't match the Visio file name (without extension).  

Aliased Links Were Found - Re-Run using Follow Links Enabled.
Occurs when at least one aliased link was found and the Follow Links function was not enabled.

A Reference to a Template Graphic object doesn't have a document name assigned.
Occurs when you try to validate a file and follow links to any template graphics that haven't been validated first.  Each template found must have already been entered in the graphic map table in the MSEA Binder database.  This table is where the validator looks to find the file name of the template graphic.

sys1 Local Variable wasn't used to set the alias.  Don't trust the validation results on the templates.
Occurs when something other than sys1 local variable was used to pass the alias to the template graphic.  Only sys1 is supported at this time.

More that one local variable was used to pass alias information
Occurs when more that one local variables are found passing alias information to a template graphic.  Only sys1 is supported.

Error Rules:

Invalid Binding
Object reference didn't match any object reference in the MSEA Binder Database.

Invalid Graphic Binding
Object reference didn't match any object reference in the MSEA Binder Database.

Failed To Set Binding Status
A validated point wasn't flagged as bound in the database.  Problem setting the flag.

Error Loading Visio Document
Problem loading the Visio document to validated.

Failed to Register Graphic
Failed to create an entry in the Graphic Mapping table in the MSEA Binder database.  If this error occurs, the points in graphics information won't be created in the database, but the validation for the objects will.

Other notes:

1.     Object references are read from the custom properties section.  Any custom property then ends with "ObjRef" is considered a target for binding validation.

Object reference sub-types:

GraphicObjRef - A page custom property that holds the graphic object reference of the Visio graphic.  This is used to validate the grpahic object and also map the Visio document to a graphic object.

NavigationObjRef - A custom property that holds a graphic object reference that a NAVIGATE action code will use to navigation to another graphic.

SummaryObjRef - A custom property that holds the parent object reference of an object (ie. the system).   This custom property is used when navigating to a template graphic or for use with a click action that opens the system summary of an object.

StsObjRef - A custom property that holds the status of an object.

CmdObjRef - A custom property that holds the command of an object.

FaultObjRef - A custom property that holds the fault or alarm status of an object.

SpeedObjRef - A custom property that holds the speed of an object.

2.     Template navigation links are read from the user defined section.  Any symbol that has a NAVIGATE action code and the local variable parameter that is passed is NOT blank will be considered as a template navigation link.

3.     External hyperlinks are read from the user defined section.  Any symbol with the LINK action code are external links.

4.     If the GraphicObjRef is BLANK then a warning will be generated.  The GraphicObjRef is used to map the graphic object to the Visio document in the MSEA Binding tool.

5.     If the object name portion of the GraphicObjRef does not match the Visio document filename (without path and extension) then a warning will be generated.  This is a standards rule.

6.     If an object reference (*ObjRef) isn't found in the MSEA Binder database, then an "invalid binding" error will be generated for that shape.

7.     If an object reference (*ObjRef) IS found in the MSEA Binder database, then the object in the MSEA Binder database is flagged as BOUND.  If the GraphicObjRef is valid and a mapping was made successfully, then the object reference of the shape is also added to the list of objects that are bound in the graphic.