n8n-nodes-drofus

n8n community nodes for the dRofus REST API. Provides a unified DRofus node with operations covering rooms, items, occurrences, room groups, room templates, systems, and the RDL PDF report generation pipeline.

This package is built and maintained by Byggstyrning and used in production for BIM/FM data automation alongside n8n-nodes-streambim and n8n-nodes-ifcpipeline.

Features

• Regional endpoint routing: EU, Nordics, US, Canada, Australia, or custom server.
• Database & project scope bound to credentials so you configure it once.
• Multiple authentication modes:
  • API Key with the official Authorization: Reference <key> scheme (fallback Basic Auth supported).
  • OAuth2 Client Credentials with the dr-std scope.
  • HTTP Basic Auth with username and password.
• OData query helpers: $select, $filter, $top, $skip, $orderby exposed through a typed query builder.
• RFC 5988 Link-header auto-paging when you toggle "Return All" on list operations.
• Automatic application/merge-patch+json header injection on all PATCH operations so dRofus accepts partial updates.
• OPTIONS schema discovery for surfacing project-specific dyn_article_* / occurrence_data_* properties.
• RDL Reports with Wait for Completion: kick off a report job, poll /reports/jobs/{jobId}/status, then auto-download the resulting PDF as binary data on the same item.

Supported resources

| Resource | Operations | | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | Room | Get Many, Get, Get Logs, Get Group, Update Group, Update Equipment List Status, Get Schema (OPTIONS) | | Item | Get Many, Get, Get Files, Create, Update, Get Schema (OPTIONS) | | Occurrence | Get Many, Get, Get System Memberships, Create, Update, Get Schema (OPTIONS) | | Room Group | Get Many, Get Members, Add Members, Get Schema (OPTIONS) | | Room Template | Get Many, Get, Get Logs, Update, Get Schema (OPTIONS) | | Other Resources | Item Groups, Template Occurrences, Systems, System Components, Sub-items, Attribute Configurations (list + OPTIONS where relevant) | | RDL Report | Start Report, Start Report by Template, Get Status, Get Result (PDF), Start Batch, Start Batch by Template (with Wait For Completion) |

Install

In n8n (self-hosted), this is shipped as a custom node package. Either:

1. Use Community Nodes in n8n: Settings → Community Nodes → Install → n8n-nodes-drofus, or
2. Drop the built dist/ directory under <n8n-data>/custom/n8n-nodes-drofus/ and restart n8n.

The included deploy-local.sh script automates option (2) for the ifcpipeline n8n container.

Development

pnpm install
pnpm build
./deploy-local.sh

The repository expects the ifcpipeline/ n8n stack to be on the same machine. Tweak the TARGET_DIR in deploy-local.sh if your layout differs.

Examples

See examples/ for a five-chain test/evaluation workflow that exercises OData filtering, RFC 5988 pagination, merge-patch+json updates, OPTIONS schema discovery, and the RDL "Wait for Completion" PDF flow. Import the workflow into n8n, assign the dRofus credential, and run each chain independently.

License

MIT