- 3 minutes to read

RegEx on Message Context search field expression type plugin

Easily extract unique values from context properties using the Nodinite RegEx on Message Context Search Field Expression Plugin. This page shows you how to configure, test, and use this plugin with clear input, configuration, and result examples.

✅ Extract single or multiple unique values from named context properties
✅ Use powerful RegEx expressions for advanced extraction
✅ Designed for high performance and self-service log views


What is the RegEx on Message Context Plugin?

The Nodinite RegEx on Message Context plugin lets you extract one or more unique values from context properties in the payload of Log Events. Use it to process messages where you need to target specific context properties and extract values using RegEx.

  • Extract single or multiple unique values from named context properties
  • Use RegEx expressions to match and style data
  • Ideal for small payloads and business integration scenarios

Use this plugin for extracting values from messages with context properties using RegEx.


How It Works: Input → Context Property → RegEx Expression → Result

Each example below clearly separates the Input (context property value), the Context Property (property name), the RegEx Expression (pattern), and the Result (output value).


Quick Example

Input:

\\nodinitesrv01\ftp\public\INT001\Order\OrderFile_123.xml

Context Property:

FileName

RegEx Expression:

([^\\]+$)

Result:

OrderFile_123.xml

Examples

Example 1: Extract File Name from Context Property Using RegEx

Input:

\\nodinitesrv01\ftp\public\INT001\Order\OrderFile_123.xml

Context Property:

FileName

RegEx Expression:

([^\\]+$)

Result:

OrderFile_123.xml

Test Expression
Valid expression with state output, unique values, and total count.


Features

  • Extract single or multiple unique values from named context properties
  • Use RegEx expressions to match and style data
  • Designed for small payloads and high performance

Note: This plugin loads the entire message into RAM. Only use it for small payloads.


How to Use

  1. Select the 'RegEx on Message Context' expression type plugin when configuring a Search Field.
  2. Enter the name of the context property to extract the value from.
  3. Enter the RegEx expression to match/style the content.
  4. Finalize the configuration and select the Message Types to apply the expression.
  5. Optionally, perform a re-index operation (Add or manage Search Field).

Extracted values are stored for as long as the Message Type retention is configured.


Test Expression

You can test your configuration in the 'Test Expression' tab when setting up a Search Field:

  1. Enter a sample payload in the 'Message Body' tab
  2. Select the 'RegEx on Message Context' plugin
    Select
    Here's an example selecting the 'RegEx on Message Context' expression type plugin.
  3. Enter the name of the context property and the RegEx expression
  4. Review the output and adjust as needed

If the expression is valid, you will see the unique values and total count:

Test Expression
Valid expression with state output, unique values, and total count.

If the expression is invalid or does not match any data, you will see:
No Result
Example of an invalid expression yielding no result.



Mermaid Diagram: Search Field Expression Flow

This diagram shows how the RegEx on Message Context plugin fits into the overall search field expression process.

graph LR subgraph "Search Fields" sf(fal:fa-magnifying-glass-plus Order Number) end subgraph "Search Field Expressions" sfe(fal:fa-flask RegEx on Message Context plugin) end subgraph "MessageTypes" mt1(fal:fa-file Orders) end sf --- sfe sfe ---|Expression| mt1

Next Step


Learn More