Nutella with Pepperoni and Mushrooms
Wondering what’s next for npm?Check out our public roadmap! »

@alpine-code/node-red-contrib-zeebe

1.0.0 • Public • Published

node-red-contrib-zeebe

Build Status

This module leverages the zeebe-node client library to bring Zeebe awesomeness to Node-RED!

Currently supported Zeebe version: 0.23.x

Learn more about how these nodes can be used from basic example flows.

worker / complete

task-worker and complete node

Creates a task worker and subscribes to specific tasks/jobs. The worker node outputs a Node-RED message for each newly received task/job. When a Node-RED message is received at the complete nodes's input, that task/job gets completed in Zeebe (with either success, failure or error).

Please note: These nodes only work in combination. Make sure, the complete object from the worker node output payload gets injected into the input of the complete node.

See example flow.

publish message

publish-message node

This node publishes a message to Zeebe, when a Node-RED message is received at the input.

The message must contain a name and a correlation key. Optionally you can pass in variables and configuration options like timeToLive.

See example flow.

publish start message

publish-start-message node

This node publishes a start message to Zeebe, when a Node-RED message is received at the input.

The message must contain a name, no correlation key needed. Optionally you can pass in variables and configuration options like timeToLive.

See example flow.

deploy

deploy node

Inject a bpmn workflow definition string to the input of this node to deploy it to Zeebe.

You can use the 'file in' node from Node-RED to read a bpmn file from disk, or get the workflow definition from anywhere you want.

See example flow.

create instance

workflow-instance node

A new workflow instance gets started in Zeebe, when a Node-RED message is received at the input.

Once the workflow instance has been created, the output sends a Node-RED message containing some meta-info, i.e. the workflowInstanceKey.

See example flow.

Developing

To test these nodes locally in node-red, the npm install <folder> command can be used. This allows you to develop the node in a local directory and have it linked into a local node-red install during development.

In your node-red user directory, typically ~/.node-red, run:

npm install <path to location of node-red-contrib-zeebe>

This creates the appropriate symbolic link to the directory so that Node-RED will discover the node when it starts. Any changes to the node’s file can be picked up by simply restarting Node-RED.

Tests

Tests are written in Jest, and live in the __tests__ directory. To run the unit tests:

npm test

Integration tests are in the __tests__/integration.js file.

They require a Zeebe broker to run. You can start a dockerised broker:

cd resources/travis/
docker-compose up

And then run them manually:

npm run test:integration

Contributions

Contributions are always welcome! There are some open issues.

Install

npm i @alpine-code/node-red-contrib-zeebe

DownloadsWeekly Downloads

1

Version

1.0.0

License

MIT

Unpacked Size

97 kB

Total Files

43

Last publish

Collaborators

  • avatar