Skip to content

Releases: sus-tech-gmbh/n8n-nodes-matrix42

v0.3.0

Choose a tag to compare

@SK4P3 SK4P3 released this 31 Aug 17:44

0.3.0

  • New: Matrix42 Trigger node — a polling trigger that starts workflows on Matrix42 changes. Events: Ticket Created (default preset — new Service Desk tickets, with a ticket-type filter), Object Created (any data definition, watched through a configurable creation-date attribute) and Object Created or Updated (the universal TimeStamp rowversion; works on every class, exactly-once). Server-side type/ASQL filtering, optional full-object fetch, and watermark semantics built on live-verified API behavior (tick-exact date comparisons, boundary dedup, baseline-on-activation so historic records never fire).
  • Fixed: Webservice Token auth no longer fails after the access token expires (reported as "auth invalidates itself after one day"). Matrix42 rejects an expired token with HTTP 406 — which n8n's built-in credential refresh (401-only) never picks up — so the node now performs the API-token → access-token exchange itself: once per execution, cached for the run, refreshed shortly before expiry and retried once on 401/406 (also covers server-side token revocation). Other failures are never retried.
  • Add Journal Entry reworked: Parameters is now a Name/Value/Format collection instead of a raw JSON field (the legacy JSON field of saved workflows is still read and validated); Creator is optional and, when empty, the entry is attributed to the API user; Type ID is validated as a GUID before sending. Documented that template parameters only render on system-generated entry types, not on plain comments.
  • Matrix42 validation rejections (400 with empty messages) now name the rejected fields in the error description instead of a bare "Bad request".
  • Repo: CI workflow (lint, tests, build on Node 20/22), contributing/security/code-of-conduct docs, README badges.
  • Last tested with n8n 2.36.9 against Matrix42 26.1.

v0.2.1

Choose a tag to compare

@SK4P3 SK4P3 released this 13 Jul 09:48

Addresses the n8n verified-node review feedback:

  • Runtime execution errors are now wrapped in NodeApiError, so HTTP status codes and response context surface properly in the n8n UI.
  • The codex nodeVersion is set to 1.0 (a schema value, independent of the node's runtime version).

No functional/API changes otherwise.

v0.2.0

Choose a tag to compare

@SK4P3 SK4P3 released this 12 Jul 17:28

Breaking change (node v2). The ASQL resource was split into Data Fragment and Data Object, and operations were renamed to the standard CRUD set (Get Many, Create, Update, Delete, Get, Transform, Close, Add Journal Entry, Upload, Execute). Existing workflows must reselect the resource/operation on Matrix42 nodes.

Added

  • Data Query resource with Get Data — paged (zero-based) with a Return All option. Uses GET by default and switches to POST when a structured User Filters (QueryFilterGroup) is supplied in Additional Fields.
  • Ticket Create: a selectable State field (loaded from the instance's activity states; defaults to New / 200) and an Extra Properties name/value collection for setting arbitrary/custom ticket attributes.
  • Response Language credential field, sent as the Explicit-Language header on every request.
  • Ignore SSL Issues (Insecure) toggle on both credentials.
  • Return All / Limit paging on Data Fragment Get Many.

Fixed

  • Token auth now performs the documented API-token → access-token exchange (previously the raw token was sent directly, which the current API rejects).
  • Ticket Create no longer crashes when the priority mapping is empty; numeric fields are validated.
  • Responsible Role / Recipient Role dropdowns now load without requiring a category first.
  • JSON parameters are parsed, A-SQL values escaped, URL path segments encoded, file IDs use crypto.randomUUID, and the journal IsFromEditDialog field name was corrected.

Compatibility

  • Rebuilt against current n8n-workflow (uses NodeConnectionTypes); requires n8n 1.85+ and Node.js 22+. Last tested with n8n 2.2.3 and Matrix42 26.1.0.1390.