Differences

This shows you the differences between two versions of the page.

--- code:commercial:hse-error-code-helper:overview [2023/04/30 13:26] – joerg.hampel
+++ code:commercial:hse-error-code-helper:overview [2026/07/27 11:46] (current) – [Error XML Files] alexander.elbert
@@ Line 1: / Line 1: @@
 ====== 01 Overview ======
-The //HSE Error Code Helper Quick Drop Plugin// tool integrates into the LabVIEW IDE and helps with managing, reusing (i.e. remembering) and also creating error codes.
+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.
-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.
+===== How it works =====
+The plugin will bring up a dialogue window with a search field and a list of pre-defined error codes (see [[#error_code_definitions|below]]). Codes are separated into several sections. The first section called "Library Errors" contains errors specific to the code module from which the tool was invoked. All following sections contain generic error definitions.
 {{:code:commercial:hse-error-code-helper:ech-dialog.png?500|}}
@@ Line 9: / Line 11: @@
 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.
+----
-=== Selecting an existing generic code ===
+===== What it does =====
+Depending on the user action, there are three possible outcomes:
+  - Selecting an existing generic code
+  - Selecting an existing library-specific code
+  - Entering a new code
+The F3 key will center the QDUI window, always on the primary monitor.
+==== 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, update it with the selected code instead of creating a new constant.
+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 ===
+==== 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 ===
+==== 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.
+To add a new code open the QD plugin and press enter, without a code. This 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.
+{{:code:commercial:hse-error-code-helper:ech-new.png?direct&600|}}
+----
 ===== Error Code Definitions =====
+The tool shows error codes from two different sources:
-showing error codes from two different sources:
   - Any error constant VIs found in the lvlib/lvclass that hosts the VI from which the QD was invoked
   - 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 ====
+Generic error code definitions are stored in NI's error XML format and installed into the ''<LabVIEW>/project/errors'' directory. The plugin will parse all XML files named ''*-errors.txt'' and show contents in alphabetical order.
-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.
+<WRAP>At HSE, we maintain our own set of [[code:hse-labs:hse-error-code-definitions|Error Code Definitions]].
+</WRAP>
-{{:code:commercial:hse-error-code-helper:ech-folderlocation.png?600|}}
-You can use the built-in editor via //Tools -> Advanced -> Edit Error Codes...//:
-{{:code:commercial:hse-error-code-helper:ech-ecdeditor.png?600|}}