Description

@eccenca/n8n-nodes-corporate-memory

An n8n community node for
eccenca Corporate Memory (CMEM).

Provides a Corporate Memory credential (OAuth2 client-credentials grant, via
n8n’s built-in OAuth2) and a Corporate Memory node with three resources:
Workflow (execute DataIntegration workflows), SPARQL (SELECT/ASK queries),
and Query Catalog (list and run saved, parameterized queries). See
tasks/spec.md and tasks/backlog.md.

Installation · Credentials ·
Operations · Development

Installation

In a self-hosted n8n: Settings → Community Nodes → Install and enter
@eccenca/n8n-nodes-corporate-memory. See the n8n docs on
installing community nodes.

Credentials

Create an eccenca Corporate Memory OAuth2 API credential. It extends n8n’s
built-in OAuth2 and uses the client-credentials grant, so n8n obtains, caches
and refreshes the access token for you (no interactive sign-in).

| Field | Notes |
| —– | —– |
| Client ID | OAuth2 client (e.g. the cmemc service-account client) |
| Client Secret | client secret of the (confidential) service-account client |
| Base URL | e.g. https://cmem.example.com (trailing slash optional) |
| OAuth Token URL | optional; leave empty to derive {Base URL}/auth/realms/cmem/protocol/openid-connect/token; set it for a non-default Keycloak realm or host |
| DataIntegration / DataPlatform Base URL | optional overrides; default to {Base URL}/dataintegration and {Base URL}/dataplatform |

> Field order follows n8n’s OAuth2 credential layout: the inherited fields (Client ID,
> Client Secret, plus Send Additional Body Properties and Allowed HTTP Request Domains)
> render first, then the CMEM-specific fields.

Use Test in the credential dialog to verify the token can be obtained and the
DataPlatform API is reachable.

> The resource-owner password grant is not offered: n8n’s built-in OAuth2
> supports only the authorizationCode, clientCredentials and pkce grants, and
> the client-credentials service-account flow covers the automation use case.

Operations

Resource: Workflow

Project and Workflow are searchable dropdowns populated from your instance.

• Execute — run a workflow synchronously (POST /api/workflow/result/…),

optionally with a payload. Pick the Payload content type (None / JSON / XML /
CSV) and the Result Format (JSON / XML / CSV / N-Triples) independently — they
need not match. A workflow with no variable output returns
{ executed: true, hasResult: false }; a JSON array result can be split into one
item per element.

• Execute (Async) — start a workflow execution

(POST /api/workflow/executeAsync?output:type=…); returns { activityId, instanceId }.

Resource: SPARQL

• Select Query — run a SPARQL SELECT/ASK (GET /proxy/default/sparql) and get

one item per result row. Simplify returns just each variable’s value; off
returns the full binding object (type, value, datatype, language). Optional
default/named graph URIs.

Resource: Query Catalog

Queries live in one or more catalog graphs; a Catalog Graph dropdown (default
All Catalogs) scopes the picker, mirroring CMEM’s own catalog selector.

• List Queries — list saved queries across the selected catalog(s); each item

carries its source catalogGraph.

• Run Report — execute a saved query by IRI with parameter substitutions

({{placeholder}} → value) and get the CSV result parsed into items
(GET /api/queries/reports/perform); toggle off to return the raw CSV string.

Development

Requires Node.js v22+. Tooling is provided by
@n8n/node-cli; a
Taskfile.yml (go-task) wraps the
lifecycle.

task deps     # install dependencies
task dev      # run a local n8n with the node hot-reloaded (http://localhost:5678)
task test     # jest unit tests
task lint     # n8n-node lint (verification-grade)
task build    # compile + copy icons into dist/
task check    # lint + test + build (the CI gates)

The equivalent npm scripts (npm run dev|test|lint|build) work too. Without
go-task, run the npm scripts directly.

Manual end-to-end check: task dev, add the Corporate Memory credential, run its
Test, then add a Corporate Memory node and execute a known workflow.

CI & publishing

.gitlab-ci.yml runs lint + test + build on merge requests and
branches, and publishes to npm (with provenance) on v* tags. Publishing needs an
NPM_TOKEN CI/CD variable; npm provenance becomes mandatory for community nodes
from 2026-05-01.

License

MIT.