- 4 minutes to read

Search Fields Overview

Gain full control over your integration landscape with the Nodinite Search Fields Overview. This page shows you how to manage, edit, delete, restore, and filter Search Fields for powerful correlation and end-to-end tracking—on-premise, hybrid, and in the cloud.

  • ✅ Instantly filter and find any Search Field
  • ✅ Quickly spot and resolve configuration issues
  • ✅ Add, edit, delete, or restore Search Fields with ease
  • ✅ Achieve end-to-end tracking and business correlation

What You Will Learn

  • How to use the Search Fields Overview to manage all Search Fields
  • How to filter, sort, and troubleshoot Search Fields
  • How to resolve configuration warnings and restore deleted fields

Understanding the Search Fields Section

A Search Field is a business value, such as "Order Number", that users search for in Log Views. Administrators define it here, add one or more Search Field Expressions that extract the value from each Message Type, and the Logging Service fills it in for every logged Log Event. Business users then search on it; the end-user side is described in Find an order by Order Id and Search in a Log View.

graph LR A["fa:fa-circle-question What is a<br/>Search Field?"] --> B["fa:fa-pen-to-square Add or manage<br/>Search Field"] A --> W["fa:fa-wand-magic-sparkles Search Field<br/>Wizard"] B --> C["fa:fa-gears Search Field<br/>Expressions"] W --> C C --> P["fa:fa-puzzle-piece Plugins<br/>XPath, JSON Path, RegEx, CSV, …"] C --> F["fa:fa-function Formula"] P --> X["fa:fa-list-check Allowed XPath<br/>expressions"] C --> L["fa:fa-magnifying-glass Log Views<br/>Non-Events, BPM"] style A fill:#2678BD,color:#fff style B fill:#E47528,color:#fff style W fill:#E47528,color:#fff style C fill:#3F827B,color:#fff style P fill:#3F827B,color:#fff style F fill:#3F827B,color:#fff style X fill:#3F827B,color:#fff style L fill:#93d16d,color:#000

Diagram: how the pages in this section fit together. Start with the concept (blue), configure with the editor or the wizard (orange), look up expression syntax in the reference pages (teal), and use the values where users search (green).

Page Read it when you want to…
What is a Search Field? Understand the concept, Search Field Links, and re-indexing
Add or manage Search Field Create or change a Search Field, its expressions, links, and re-index
How to use the Search Field Wizard Create a Search Field straight from a logged message
Search Field Expressions Learn how expressions run and choose a plugin
Formula Combine, transform, count, or look up values
Allowed XPath expressions Check which XPath syntax the XPath plugins accept

Search Fields List and Filtering

The Search Fields Overview displays all user-defined Search Fields. You can quickly narrow down the list by typing in the filter text box, or by picking a Data Type.

Search Fields Overview list with filter box, Data Type filter, and Action buttons
Example of the Search Fields Overview displaying all configured Search Fields.

Spot and Resolve Configuration Warnings

Search Fields with configuration problems are listed with a Warning icon. User action is required to resolve the issue.

Search Fields list with Incomplete warning badges and a Deleted Search Field
Example of Search Fields with configuration warnings requiring immediate attention.

  • Incomplete:
    • One or more Message Types no longer exist (Deleted)
    • No Message Type is set for a Search Field Expression, or the Expression Type is set as deleted

If a Message Type is deleted but still referenced by a Search Field Expression, you must alter or remove the expression from the Search Field.

Manage Search Fields: Actions

You can perform the following actions directly from the overview:

Add a new Search Field

Click the "Add Search Field" button to open the Search Field editor. To create one straight from a logged message instead, use the Search Field Wizard.

Add Search Field button in the Search Fields Overview header
Example of the 'Add Search Field' button in the Search Fields Overview.

Edit Search Field

Click the link in the Name column or use the "Actions" button and select "Edit" to update an existing Search Field.

Action menu of a Search Field with Edit selected
Example of clicking the 'Edit' menu item to edit an existing Search Field.

Delete Search Field

Open the "Actions" menu and select "Delete" to remove a Search Field. Deleting is a soft delete: the Search Field can be restored, and the change is recorded in the Log Audits.

Action menu of a Search Field with Delete selected
Example of clicking the 'Delete' menu item to delete a Search Field.

Restore Deleted Search Field

Check the Include deleted Search Field box to include deleted fields in the list (see Show deleted records). Then use the "Actions" menu and select "Restore".

Action menu of a deleted Search Field with Restore selected
Example of clicking the 'Restore' menu item to restore a deleted Search Field.

Next Steps