User Tools

Site Tools


code:commercial:hse-error-code-helper:overview

This is an old revision of the document!


01 Overview

The HSE Error Code Helper Quick Drop Plugin tool integrates into the LabVIEW IDE and helps with managing and reusing (i.e. remembering) existing error codes as well as creating new error codes.

How it works

The plugin will bring up a dialogue window with a search field and a list of pre-defined error codes. Codes can either be specific to the code module from which the tool was invoked, or generic.

The user can search for errors by typing in numbers (error codes) or keywords (error descriptions). Pressing enter (or double-clicking an entry) will finish the selection process and close the dialogue.

What it does

Depending on the user action, there are three possible outcomes:

  1. Selecting an existing generic code
  2. Selecting an existing library-specific code
  3. Entering a new code

Selecting an existing generic code

If the user selects an existing code from the list of generic codes, the tool will create an error cluster constant with the code and source as selected and place the object on the cursor to drop.

If an error constant or error control was selected on the BD before invoking the QD, the tool will update it with the selected code instead of creating a new constant.

Selecting an existing library-specific code

If the user selects an existing code from the library or class, the tool will select the corresponding constant VI and place the object on the cursor to drop.

Entering a new code

If the user does not select a code but types in a new code (integer) into the search field, the tool will create a new error constant VI and place it into the lvlib/lvclass containing the VI from which the QD was invoked.

It will open an additional window and query the user for the error source string and if the newly created constant VI should have a string input for additional information. Eventually, it will place the new VI on the cursor to drop.

Error Code Definitions

The tool shows error codes from two different sources:

  1. Any error constant VIs found in the lvlib/lvclass that hosts the VI from which the QD was invoked
  2. Any generic error codes defined in the <LabVIEW>/project/errors directory

Error Constant VIs

The tool will parse the lvlib/lvclass that hosts the VI from which the QD was invoked and find all VIs which file name ends in “–error.vi”. For these VIs, the tool is able to extract the error code definition from error rings, error cluster constants or inputs wired to the 'Error Cluster From Error Code.vi'.

Error XML Files

Any generic - that is, non-library focused - Error code definitions need to be stored in NI's error XML format and installed into the <LabVIEW>\project\errors directory. These error codes are then facilitated by the HSE Quick Drop Plugin.

You can use the built-in editor via Tools → Advanced → Edit Error Codes…:

code/commercial/hse-error-code-helper/overview.1682978473.txt.gz · Last modified: 2023/05/01 22:01 by joerg.hampel