Difference between revisions of "TestIT:Configuration DLL"

From Nolek Wiki
Jump to navigation Jump to search
(Created page with "===6.3.20 DLL=== A DLL device can use methods from a DLL file, allowing you to test them directly or store them as “commands” for later execution. A timeout option allows...")
 
 
(One intermediate revision by the same user not shown)
Line 25: Line 25:
 
# Enter a command name, and optionally a description (MAX 50 characters)
 
# Enter a command name, and optionally a description (MAX 50 characters)
 
# Input:  
 
# Input:  
# If the method requires any parameter(s): Select the desired symbol that will hold these values
+
## If the method requires any parameter(s): Select the desired symbol that will hold these values
# If the “Required” checkbox is off, you can choose to not select a symbol, and the default value will be sent instead
+
## If the “Required” checkbox is off, you can choose to not select a symbol, and the default value will be sent instead
 
# Output:
 
# Output:
 
## If the method will return multiple values (received in a single string): Write the total amount of outputs in “Output Count”, then write the character(s) that separates these outputs. Example: “;”
 
## If the method will return multiple values (received in a single string): Write the total amount of outputs in “Output Count”, then write the character(s) that separates these outputs. Example: “;”
Line 50: Line 50:
  
 
* [[TestIT:Programming_InternalDevice#DLL_Execute|DLL_Execute]]
 
* [[TestIT:Programming_InternalDevice#DLL_Execute|DLL_Execute]]
 +
 +
 +
[[TestIT:Configuration#Devices_in_TestIT%3A|Back to Configuration]]

Latest revision as of 15:59, 11 September 2019

6.3.20 DLL

A DLL device can use methods from a DLL file, allowing you to test them directly or store them as “commands” for later execution. A timeout option allows the program to interrupt a non-responsive method call.

The device can receive any amount of values from a method and store them in a symbol, by dividing a return string between the desired split characters.

Setup fields:

  • Device Configuration
  • Command Configuration
  • Test Method/Command

Device Configuration:

  1. Write the device name and device description (required)
  2. Select if the device is active or not
  3. Click the box next to “FilePath” and a small button “…” appears, click to browse for the .dll file you want this Device to use
  4. Select a Timeout in milliseconds, correlating to the time before any DLL-method execution will be interrupted and aborted. When the time set in the timeout has run out, the method will be aborted if there has been no result yet. Aborting this way is not recommended, but used in case the method itself does not handle timeouts.
  5. Press Save

Command Configuration:

When a valid DLL file has been selected, its classes and methods can be displayed. These can be stored as commands for future method execution:

Setup:

  1. Press the “Class name” dropdown under “DLL Contents” and select a Class, then select a Method from the grid
  2. Enter a command name, and optionally a description (MAX 50 characters)
  3. Input:
    1. If the method requires any parameter(s): Select the desired symbol that will hold these values
    2. If the “Required” checkbox is off, you can choose to not select a symbol, and the default value will be sent instead
  4. Output:
    1. If the method will return multiple values (received in a single string): Write the total amount of outputs in “Output Count”, then write the character(s) that separates these outputs. Example: “;”
    2. Select the desired symbols for each output, and optionally give the parameter(s) a name

Test of and saving the setup:

  1. Press “New Command” to save the method. If you want to test it before saving, look at “Test Method” below
  2. Verify that your command appeared under “Stored Commands” on the right

Test Method:

A method or stored command can be tested directly.

  1. Select a DLL-method or stored command
  2. Click the “Test” tab on the top, next to “Config”
  3. Enter values (if any) in the “Value” box of input parameters.
  4. Click Send.

Any return values will be put in Output and be split according to your configurations.

6.3.20.1 Commands

Command in DLL is:


Back to Configuration