Store External Data Entry

Overview

This action stores a value in the External Data sections of the Results tab through the Data Exchange API. This value is referred to as “External Data” in the Runtime and Results tabs. A typical use is to grab business-related metrics through a Variable Extractor or through the SQL action and store them for later analysis. The entry values can be structured in a tree by specifying different paths in the path parameter.

Type Advanced Action
Version 1.0.0
Maturity Stable
Author Neotys
License BSD Simplified
NeoLoad 5.0 (Ultimate, Enterprise or Professional Edition w/ Integration & Advanced Usage option required)
NeoSense Not Compatible
Requirements Java Client for Data Exchange API
Bundled in NeoLoad Bundled in NeoLoad 5.1 (See the documentation)
Download For NeoLoad 5.0: Jar, Sources

For NeoLoad 5.1+: Bundled in NeoLoad (See the documentation)

Parameters

  • value: The numerical value to store in the entry. Example: “${myVariable}”
  • path: The string representing the list of nodes that contains the entry. Path separator is ‘|’.
  • unit (optional): The unit of the entry.
  • url (optional): The url of the entry.
  • code (optional): The string code of the status associated to the entry.
  • message (optional): The message of the status associated to the entry.
  • state (optional): The state of the status associated to the entry. Possible values are PASS and FAIL.
  • DataExchangeAPIURL: The url of the DataExchange server. Typically the NeoLoad Controller.
  • DataExchangeAPIKey (optional): The identification key specified in NeoLoad.

Status Codes

  • NL-STORE-EXTERNAL-DATA-ENTRY-ACTION-01: There was an issue parsing the parameters.
  • NL-STORE-EXTERNAL-DATA-ENTRY-ACTION-02: The entry value is not a double-precision number.
  • NL-STORE-EXTERNAL-DATA-ENTRY-ACTION-03: There was an issue initializing the DataExchange API client.

Examples

    • An example of values stored from a variable:
      • value: ${time}
      • path: time
      • unit: ms
      • DataExchangeAPIURL: http://localhost:7400/DataExchange/v1/Service.svc/

 

  • A full example of values stored from a variable:
    • value: ${executionTime}
    • path: variables|int|executionTime
    • unit: ms
    • url: http://www.myapp/script1
    • code: ERROR_INVALID_HANDLE
    • message: The handle is invalid.
    • state: FAIL
    • DataExchangeAPIURL: http://localhost:7400/DataExchange/v1/Service.svc/
    • DataExchangeAPIKey: myKey

Changelog

  • 1.0.0 – Initial release

About

Customers

Events

Press

Jobs

Management Team

Partners

Strategic Alliances

Service Partners

Technology Partners

Certified Training Partners

Support

Contact Support

Documentation

Community

Managing Your Licenses

Customer Area

Download Center

Keep Me Informed