---
title: "node-red-contrib-winccoa • FlowFuse Integrations"
description: "FlowFuse builds your first industrial solution with your team, proves it at one plant, then helps you roll it out to every plant, faster each time."
canonical_url: "https://flowfuse.com/integrations/node-red-contrib-winccoa/"
meta:
  "og:description": "FlowFuse builds your first industrial solution with your team, proves it at one plant, then helps you roll it out to every plant, faster each time."
  "og:title": "node-red-contrib-winccoa • FlowFuse Integrations"
---

> Index of every page on this site: [llms.txt](https://flowfuse.com/llms.txt)

# **node-red-contrib-winccoa**

FlowFuse Recommended

WinCC OA to Node-RED connector

**Version:** 3.2.3**Weekly Downloads:** 21**Updated:** Dec 19, 2025

## **FlowFuse Recommended Node **

FlowFuse recommends this node as a well-maintained, dependable choice for production Node-RED projects.

# node-red-contrib-winccoa

Node-RED nodes for exchanging data with a [*SIMATIC WinCC Open Architecture*](https://www.winccoa.com/) system.

## Primary Input Nodes

- **dpConnect:** Connect to datapoints on the WinCC OA server and get notified when their values change.
- **dpGet:** Get current or archived datapoint values on request (also includes *dpGetAsynch()* functionality).
- **dpGetPeriod:** Get archived datapoint values for a given time range.
- **dpQuery:** Submit an SQL-like query to a WinCC OA server.

## Output Node

- **dpSet:** Set datapoint values.

## Additional Nodes

- **alertGetPeriod:** Get alerts for a given time range.
- **dpNames:** Get names of datapoints matching a search pattern.
- **dpGetAlias:** Get datapoint aliases.
- **dpGetDescription:** Get datapoint descriptions.
- **dpGetFormat:** Get datapoint value formats.
- **dpGetUnit:** Get datapoint value units.
- **default server:** Define the WinCC OA server to be used by other nodes.

## Configuration Node

- **WinCC OA Server:** Configuration node for defining a connection to a WinCC OA WSS server.

## Installation

`npm install -g node-red-contrib-winccoa`

or install **node-red-contrib-winccoa** from the Node-RED palette or install Node-RED from WinCC OA GEDI.

Then configure a WinCC OA Secure WebSocket (WSS) server (see description of nodes *WinCC OA Server* and *default server*) when adding the first node. You need an installation of WinCC OA Version 3.17 or higher running a WSS server to which these nodes can connect.

See also the [*WinCC OA Online Documentation*](https://www.winccoa.com/documentation/WinCCOA/3.18/en_US/NodeRED/NodeRED_Basics.html).

## Examples

This package contains several example flows that demonstrate how to use these nodes. The connection information for the WinCC OA WSS server needs to be defined in the example flows, preferably by adding a *default server* node.

## Releases

- V1.x: Initial test implementation
- V2.0: Major rework, now using oaJsApi for communication with server
  - **NB: not compatible with V1**
  - **NB: needs WinCC OA Version 3.17** (or higher)
- V2.1: Support for Node-RED V1.0
- V3.0: **incompatible changes, needs WinCC OA Version 3.17 P003** (or higher)
  - Optional input port for *dpConnect* (shown when no datapoint is specified)
  - *select locale* node removed (locale now defined in server configuration)
  - Time values are now returned as milliseconds, not strings
- V3.1: first version to also work with **WinCC OA Version 3.18** servers

## Contributors

- Jürgen Steiner - [ETM](http://www.etm.at/)
- Martin Kumhera - [ETM](http://www.etm.at/)

## Licence

MIT

## **Installation **

Install in Node-RED via the [**palette manager**](https://flowfuse.com/docs/node-red/getting-started/library/#using-the-palette-manager).

![Node-RED Palette Manager dialog with the node selected and the Install button visible.](https://flowfuse.com/images/integrations/palette-manager-install.png)

## **Quick Stats**

Current Version**3.2.3**

Weekly Downloads**21**

First Published**Jan 17, 2018**

Last Updated**Dec 19, 2025**

## **External Resources**

[View on NPM](https://www.npmjs.com/package/node-red-contrib-winccoa)

## **Need Help?**

Get professional support for your Node-RED projects with FlowFuse.

[**Contact Us**](https://flowfuse.com/contact-us/)

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://flowfuse.com/#website","@type":"WebSite","description":"FlowFuse builds your first industrial solution with your team, proves it at one plant, then helps you roll it out to every plant, faster each time.","inLanguage":"en","name":"FlowFuse","url":"https://flowfuse.com/","alternateName":["FlowForge","Flow Fuse"],"publisher":{"@id":"https://flowfuse.com/#identity"}},{"@id":"https://flowfuse.com/integrations/node-red-contrib-winccoa/#webpage","@type":"WebPage","description":"FlowFuse builds your first industrial solution with your team, proves it at one plant, then helps you roll it out to every plant, faster each time.","name":"node-red-contrib-winccoa","url":"https://flowfuse.com/integrations/node-red-contrib-winccoa/","isPartOf":{"@id":"https://flowfuse.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://flowfuse.com/integrations/node-red-contrib-winccoa/"]}],"primaryImageOfPage":{"@id":"https://flowfuse.com/#logo"}},{"@id":"https://flowfuse.com/#identity","@type":"Organization","legalName":"FlowFuse Inc.","name":"FlowFuse","url":"https://flowfuse.com","alternateName":["FlowForge","Flow Fuse"],"logo":{"@id":"https://flowfuse.com/#logo"},"sameAs":["https://twitter.com/FlowFuseinc","https://github.com/FlowFuse","https://www.linkedin.com/company/flowfuse/","https://www.facebook.com/FlowFuse/","https://www.youtube.com/channel/UCbBzP8NZbv3WDtlt4UouA-g"]},{"@id":"https://flowfuse.com/#logo","@type":"ImageObject","caption":"FlowFuse","contentUrl":"https://flowfuse.com/handbook/images/logos/ff-logo--square--dark.png","inLanguage":"en","url":"https://flowfuse.com/handbook/images/logos/ff-logo--square--dark.png"}]}
```

## Sitemap

See the full [sitemap](https://flowfuse.com/sitemap.md) for all pages.
