{"id":47759288,"url":"https://github.com/oracle-samples/node-red-nodes","last_synced_at":"2026-04-03T05:05:57.259Z","repository":{"id":335171144,"uuid":"1139797309","full_name":"oracle-samples/node-red-nodes","owner":"oracle-samples","description":"Custom Node-RED nodes that integrate the Oracle Database, Advanced Queues (AQ), Oracle Fusion Cloud SCM, OCI services, and the OCI IoT Platform.","archived":false,"fork":false,"pushed_at":"2026-03-23T22:25:48.000Z","size":196,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-24T21:17:52.509Z","etag":null,"topics":["iot-platform","mqtt","node-red","oci","oci-notifications","oracle","oracle-aq","oracle-db","oracle-fusion","oracle-iot"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"upl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle-samples.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-22T12:34:23.000Z","updated_at":"2026-03-23T22:25:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/oracle-samples/node-red-nodes","commit_stats":null,"previous_names":["oracle-samples/node-red-nodes"],"tags_count":3,"template":false,"template_full_name":"oracle/template-repo","purl":"pkg:github/oracle-samples/node-red-nodes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Fnode-red-nodes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Fnode-red-nodes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Fnode-red-nodes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Fnode-red-nodes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle-samples","download_url":"https://codeload.github.com/oracle-samples/node-red-nodes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Fnode-red-nodes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31335237,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T04:42:29.251Z","status":"ssl_error","status_checked_at":"2026-04-03T04:42:12.667Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["iot-platform","mqtt","node-red","oci","oci-notifications","oracle","oracle-aq","oracle-db","oracle-fusion","oracle-iot"],"created_at":"2026-04-03T05:05:56.591Z","updated_at":"2026-04-03T05:05:57.248Z","avatar_url":"https://github.com/oracle-samples.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Node-RED Oracle Cloud Nodes\n\nThis project provides a set of custom Node-RED nodes that integrate the Oracle Database, Advanced Queues (AQ), Oracle Fusion Cloud SCM, OCI services, and the OCI IoT Platform.\n\n## What's Included\n\n- **db-nodes**\n  - Database connection (with Test Connection)\n  - SQL execution (Editor or msg.sql)\n  - AQ enqueue / dequeue (configurable dequeue mode)\n  - Transactional processing (begin / end transaction with commit or rollback)\n\n- **fusion-scm-nodes**\n  - General transaction node (fusion-request)\n  - General lookup node (scm-lookup)\n  - SMO Transformer\n  - Create Asset, Create Meter Reading\n  - Inventory transactions (misc, subinventory transfer)\n  - Delete transaction\n  - Lookup nodes (asset, meter reading, organization)\n\n- **oci-nodes**\n  - OCI authentication config (Config File, Instance Principal, Resource Principal, API Key)\n  - OCI Notifications (email, Slack, PagerDuty, webhook, SMS, OCI Functions)\n  - OCI Object Storage (upload and download objects)\n  - OCI Logging (putLogs to OCI Custom Logs)\n  - OCI Log Analytics (upload log events to Log Analytics)\n  - IoT Device config (MQTT connection to OCI IoT Platform)\n  - IoT Telemetry (publish device telemetry)\n  - IoT Command (receive commands from IoT Platform)\n  - IoT Send Command (send commands to devices via OCI REST API)\n\n\u003e Detailed node-level documentation is available in [Node Reference](./docs/node-reference.md).\n\n## Quick Start\n\n| Description | Resource |\n|-------------|:--------:|\n| Detailed installation | [Guide](./docs/installation.md) |\n| Setup Oracle AQ (queue + subscriber using SQL) | [Guide](./docs/setup-sql.md) |\n| Import examples into Node-RED | [Guide](./docs/import-examples.md) |\n| Best practices | [Guide](./docs/best-practice.md) |\n| Node reference | [Guide](./docs/node-reference.md) |\n\n## Installation\n\n### 1. Clone the Repository\n\nNavigate to your Node-RED user directory (`~/.node-red`) and clone using one of the following methods:\n\n#### HTTPS\n```bash\ngit clone https://github.com/oracle-samples/node-red-nodes.git\n```\n\n#### SSH\n```bash\ngit clone git@github.com:oracle-samples/node-red-nodes.git\n```\n\n#### GitHub CLI\n```bash\ngh repo clone oracle-samples/node-red-nodes\n```\n\n### 2. Install Dependencies\n\n#### Prerequisites\n\n- Node-RED v3.0+\n- Node.js v18+\n- npm\n- Oracle Instant Client 23c (required only when DB `Driver Mode` is `Thick`)\n\n#### Required Node-RED Dependencies\n\nThese libraries must be installed inside your Node-RED user directory (`~/.node-red`):\n\n```bash\ncd ~/.node-red\nnpm install oracledb          # DB nodes\nnpm install axios             # SCM nodes\nnpm install https-proxy-agent # SCM nodes (proxy support)\nnpm install oci-sdk           # OCI nodes (Notifications, Logging, Log Analytics, IoT Send Command)\nnpm install mqtt              # IoT nodes (Telemetry, Command)\n```\n\n#### Install Oracle Instant Client (23c)\n\n```bash\nsudo dnf install oracle-instantclient-release-el8\nsudo dnf install oracle-instantclient-basic\nsudo dnf install oracle-instantclient-sqlplus\n```\n\n\u003e **NOTE:** Oracle Linux typically installs Instant Client into `/usr/lib/oracle/23/client64/lib` by default.\n\u003e\n\u003e If your DB flows use `Driver Mode = Thin`, Oracle Instant Client is not required.\n\n### Local Install Note (Palette Manager Upload)\n\nFor local/offline installs via the Node-RED editor, you must generate an npm-packed tarball yourself with `npm pack`.\nGitHub source/release tarballs are not directly uploadable in Palette Manager because they do not use the expected npm archive layout (`package/package.json`).\n\nSee [Detailed installation: Install from Local `.tgz` in Palette Manager](./docs/installation.md#13-install-from-local-tgz-in-palette-manager).\n\n## Documentation\n\nYou can find the online documentation for the Oracle Internet of Things Platform at [docs.cloud.oracle.com](https://docs.oracle.com/en-us/iaas/Content/internet-of-things).\n\n## Examples\n\nExample Node-RED flows are provided in the documentation showcasing different use cases:\n\n- Subscriber exists? → If Not, Create New Subscriber → If It Exists, Enqueue → Dequeue Example\n- Enqueue → Dequeue → Create Meter Reading → If Not Found, Create Asset\n- Transactional dequeue with rollback protection\n- IoT telemetry publishing and command-response\n- Threshold monitoring with OCI Notifications\n\nExamples can be imported directly into the Node-RED editor.\nSee [Import Examples Guide](./docs/import-examples.md).\n\n## Contributing\n\nThis project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md).\n\n## Security\n\nPlease consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process.\n\n## License\n\nSee [LICENSE](./LICENSE.txt).\n\n## Disclaimer\n\nOracle and its affiliates do not provide any warranty whatsoever, express or implied, for any software, material or content of any kind contained or produced within this repository, and in particular specifically disclaim any and all implied warranties of title, non-infringement, merchantability, and fitness for a particular purpose. Furthermore, Oracle and its affiliates do not represent that any customary security review has been performed with respect to any software, material or content contained or produced within this repository. In addition, and without limiting the foregoing, third parties may have posted software, material or content to this repository without any review. Use at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-samples%2Fnode-red-nodes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle-samples%2Fnode-red-nodes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-samples%2Fnode-red-nodes/lists"}