NetXMSInstall

Summary

Expands NetXMS macros in a text string within the context of a given object by calling the NetXMS REST API, and returns the server's response.

Inputs

• Object ID (required) — Numeric ID of the NetXMS object that provides context for macros such as %{node.name}.
• Text (required) — Text containing NetXMS macros to expand, e.g. 'Host: %{node.name} — Status: %{node.status}'.
• Additional Fields > Alarm ID — Alarm ID used to expand alarm-related macros. Sent only if non-zero; 0 or unset is omitted.

Output shape

One or more output items per input item, containing the JSON returned by the NetXMS expand-text endpoint (POST /v1/objects/{objectId}/expand-text).

The exact response fields are defined by the NetXMS server and not shown in the node code. The node logs in per execution to get a session token. With Continue On Fail enabled, failed items return {error: message}.

Examples

Example 1: Build a readable notification message for a node

Object ID = 123; Text = 'Host: %{node.name} — Status: %{node.status}'

Example 2: Expand alarm-specific macros in the context of an alarm's source object

Object ID from alarm source; Text containing alarm macros; Additional Fields > Alarm ID = alarm ID from a previous Alarm Get step

Links

• n8n community nodes installation guide