View source for Error Codes Editor

[[File:Error Code Editor.png|thumb|Error Code Editor]]

The '''Error Code File Editor''' ('''Tools->Advanced->Edit Error Codes''') provides a simple GUI for creating and editing a custom error XML files. These files are useful if the user requires custom error codes to apply to several applications, if the codes are used by several software engineers in a team, or if the codes are to be distributed with an application.  Once custom error code files have been created and/or altered, LabVIEW must be restarted for the changes to take effect.

After creating the custom error XML file, place the file in the labview\user.lib\errors directory.  This will make the custom error codes show [[Error Ring]]s and when creating an instance of the error using the [[Error Cluster From Error Code function]].

For example, the XML filename must be in the format '''*-errors.txt''' (where '''*''' is user definable), and the internal file structure must adhere to the following format:
<blockquote>
<?XML Version="1.0"><br />
<nidocument><br />
<nicomment><br />
This is a custom error code definition file for my application.<br />
</nicomment><br />
<nierror code="5000"><br />
User Access Denied!<br />
Contact the Security Department to gain clearance to perform this function.<br />
</nierror><br />
<nierror code="5001"><br />
User Unknown.<br />
Contact the People Development Department.<br />
</nierror><br />
<nierror code="5100"><br />
Driver Unable to Contact Instrument Database.<br />
Contact the Software Engineering Department Helpdesk.<br />
</nierror><br />
<nierror code="5200"><br />
Plug-In Module in R&D mode – not to be used in Production Environment.<br />
Contact the New Product Development Group.<br />
</nierror><br />
</nidocument>
</blockquote>

As can be seen, a file comment can be created within the <nicomment> tag space. Each custom error is defined as an <nierror> with it’s associated error code, and its error message is then placed inside the <nierror> tag space.

[[Category:Error Handling]]