replaceString

A Workflow Engine function that replaces a string or regular expression in a field with a specified string.

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

Back to Workflow Engine Functions Reference.

Arguments

Workflow Engine function replaceString takes the following arguments:

Name

Required

Type

Description

field

Yes

String

Field to replace text in.

replace

Yes

String

Original string to replace. This value is treated as a regex. Do not include leading or trailing delimiters.

with

No

String

New string you want to use instead. If you leave this field blank, replaces the original string with a blank space.

Example

The following example demonstrates typical use of Workflow Engine function replaceString.

Some systems abbreviate "database" as "d.b." or "D.B.". If you had a class field that contains the value "A D.B. has failed", and you wanted to replace the abbreviation with "database", set the following:

  • field: class

  • replace: d\.b\.

  • with: database

The UI translates your settings to the following JSON:

{"field":"class","replace":"d\\.b\\.","with":"database"}

The function replaces any occurrences of "d.b." and "D.B.", so the resulting value reads "A database has failed".