node-red-contrib-piwebapi

Node-RED nodes for OSIsoft PI Web API with OMF support and real-time subscriptions.

Installation

npm install node-red-contrib-piwebapi

Or install via the Node-RED palette manager.

Nodes

| Node | Description | |------|-------------| | PI Web API Config | Connection settings (URL, credentials, SSL) | | PI Point List | List PI Points by name pattern, store in global context | | PI Point Read | Read current, recorded, interpolated, or plot values | | Asset Read | Read AF element attribute values | | Attribute List | List AF element attributes | | Write | Write values to PI Points (numeric, digital state, system state) | | OMF Writer | Send OMF type, container, and data messages | | Subscribe | WebSocket subscription to PI Point value changes | | Event Frame Add | Create event frames | | Event Frame Get | Retrieve event frames | | Message Serializer | Serialize messages for batch processing |

Quick Start

Read a PI Point value

[Inject] → [PI Point Read] → [Debug]

Write to a PI Point

[Inject] → [Function: Set Value] → [Write] → [Debug]

OMF workflow (create new stream)

[Inject] → [OMF Type Builder] → [OMF Writer] → [Debug]
[Inject] → [OMF Container Builder] → [OMF Writer] → [Debug]
[Inject] → [Function: Build Data] → [OMF Writer] → [Debug]

PI Web API Configuration

For OMF support, configure these in PI Web API Admin:

| Setting | Value | |---------|-------| | CorsMethods | GET,OPTIONS,POST,PUT | | DisableWrites | False | | OmfCreateMode | Insert |

If EnableCSRFDefense is True, the nodes automatically include the X-Requested-With: XMLHttpRequest header.

License

MIT

Author

Holger Amort