nsaspy/node-red-contrib-cloudantplus
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Enhanced Cloudant node for Node-RED
38 commits 1 branch 0 tags 145 KiB
  • JavaScript 54.6%
  • HTML 44.3%
  • Nix 1.1%
Find a file
Exact
nsaspy d2f7b878c2 update deps
2024-05-16 05:46:25 -04:00
.github/workflows First submission for 0.4, update to IBM SDK 2021-06-20 04:38:42 +08:00
icons Created Cloudantplus 2017-10-07 18:16:41 +01:00
modules Various fixes 2022-06-10 09:36:40 +01:00
resources First submission for 0.4, update to IBM SDK 2021-06-20 04:38:42 +08:00
test Mocha test for utils.js, back to commonjs 2021-06-21 03:35:59 +08:00
.envrc add flakes, so i can easily update on my nixos machine and others 2024-05-16 05:34:42 -04:00
.gitignore First submission for 0.4, update to IBM SDK 2021-06-20 04:38:42 +08:00
.npmrc Mocha test for utils.js, back to commonjs 2021-06-21 03:35:59 +08:00
flake.nix add flakes, so i can easily update on my nixos machine and others 2024-05-16 05:34:42 -04:00
package.json update deps 2024-05-16 05:46:25 -04:00
README.md Update README.md 2022-05-07 12:33:16 +01:00
wallaby.js Mocha test for utils.js, back to commonjs 2021-06-21 03:35:59 +08:00

README.md

node-red-node-cf-cloudant

A set of Node-RED nodes to work with documents in a Cloudant database that is integrated with IBM Cloud or an on-premises CouchDB. This version is a superset of the functionality in the original Cloudant node and replicates the functionality of the node-red-contrib-cloudantplus node and will eventually replace it.

Installation

Ideally, install from the package manager inside Node-RED.

Alternatively, install from npm

npm install node-red-node-cf-cloudant

Usage

Allows access to a Cloudant or CouchDB database to insert, update, delete and search for documents. Also bulk operations are supported.

An additional node allows to retrieve information about server and databases

To insert a new document into the database you have the option to store the entire msg object or just the msg.payload. If the input value is not in JSON format, it will be transformed before being stored. If msg or msg.payload is an array, all elements will be processed using the bulk operations API.

For update and delete, you must pass the _id and the _revas part of the input msg.payload object. Bulk operations are also supported when putting documents as an array in the input msg.payload object.

To search for a document you have five options:

  • get a document directly by its _id
  • use query
  • use an existing search index from the database
  • use an existing view
  • retrieve all documents

Take note

  • When getting documents by id, the payload will be the desired _id value.
  • For query, the payload will be the set to an object with a declarative JSON query syntax.
  • For search indexes, the query should follow the format indexName:value.
  • For views and all docs, payload should be set be set to an object containing key/value pairs as defined in the Query string section in the Cloudant documentation

Dependencies

Authors

Based on the node written and enhanced by: