convertHexToAscii

This action converts a set of hex pairs to the equivalent ASCII representation. Hex pairs are expected to be separated by colons or underscores (‘:' or '_’). For hex values that fall outside the printable ASCII character range, this action substitutes a single space (' ').

This action is designed primarily for use in event workflows, for events from the Trap LAM where a value might have been left as the originating hex over translation as part of the trap processing.

Note

You do not need to perform this action by default on every event. Scope it to events with untranslated hex values that are needed operationally for string fields such as descriptions.

This function is available as a feature of the Add-ons v2.3.5 download and later.

This function is available for event, alert, and Situation workflows.

Back to Workflow Engine Functions Reference.

Arguments

Workflow Engine function convertHexToAscii takes the following arguments:

Name

Required

Type

Description

source

yes

string

Source field name to convert

destination

no

string

Destination field for the converted string. If not supplied the source field will be used.

Example

Given a description being presented as a hex string:

"description": "54_68_69_73_20_69_73_20_61_20_74_65_73_74",

You could add a events workflow with the following action:

convertHexToAscii

  • source = description

  • destination = [blank -- to be updated]

In the UI this would appear as:

{"source":"description"}

Resulting in a translated description of:

"description": "This is a test",