n8n-nodes-matrix42 0.1.3 → 0.2.0

package/README.md

@@ -1,137 +1,159 @@
-# n8n-nodes-matrix42
-
-This is an n8n community node that integrates with the Matrix42 ESMP Web Services API. It allows you to retrieve and work with Data Fragments from Matrix42 Data Definitions directly in your n8n workflows.
-
-Matrix42’s ESMP API exposes CRUD‑style endpoints for data fragments, supporting OData‑like filtering, column selection, paging, sorting, and more.
-
-[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
-
-[Installation](#installation)  
-[Operations](#operations)  
-[Credentials](#credentials)
-[Compatibility](#compatibility)  
-[Resources](#resources)  
-[Version history](#version-history)  
-
-## Installation
-
-Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
-
-## Operations
-
-This node supports multiple operations across different resources:
-
-### Data Fragments (asql)
-
--   **Get Fragments** (`getFragments`): Retrieve data fragments from a specified Data Definition.
-
--   **Add Fragment** (`addFragment`): Create a new data fragment in the specified Data Definition.
-
--   **Update Fragment** (`updateFragment`): Update an existing data fragment by its ID.
-
--   **Delete Fragment** (`deleteFragment`): Remove a data fragment by its ID.
-
-
-### Data Objects (asql)
-
--   **Add Object** (`addObject`): Create a new Data Object under a given fragment.
-
--   **Get Object** (`getObject`): Retrieve a Data Object by its ID.
-
--   **Update Object** (`updateObject`): Update an existing Data Object by its ID.
-
--   **Delete Object** (`deleteObject`): Delete a Data Object by its ID.
-
-
-### Tickets
-
--   **Create Ticket** (`createTicket`): Open a new ticket in the Service Desk.
-
--   **Close Ticket** (`closeTicket`): Close an existing ticket by ID.
-
--   **Transform Ticket** (`transformTicket`): Apply a transformation to a ticket.
-
-
-### Import
-
--   **Execute Import Definition** (`executeImportDefinition`): Run a predefined import definition to ingest data.
-
-## Credentials
-
-> **Prerequisite:** You must have access to a running Matrix42 instance with appropriate API permissions.
-
-This node supports two authentication methods. Configure these under **Workflow → Credentials**.
-
-### Matrix42 Token Auth
-
-1.  **API Token** — Your long‑lived Matrix42 API Token.
-
-2.  **Base URL** — Your Matrix42 server URL (e.g. `https://api.mycompany.com`).
-
-
-On execution, the node:
-
--   Exchanges the API Token for a short‑lived Bearer (JWT) token via `GenerateAccessTokenFromApiToken`.
-
--   Uses the Bearer token in the `Authorization` header for all subsequent calls.
-
-
-> **Self‑signed certificates**: If your Matrix42 server uses a self‑signed SSL certificate, you must add its CA certificate to n8n’s trusted certificate store. For details, see the n8n docs on adding self‑signed certificates: https://docs.n8n.io/hosting/configuration/configuration-examples/custom-certificate-authority/
-
-### Matrix42 Basic Auth
-
-1.  **Username** and **Password** — Your Matrix42 user credentials.
-
-2.  **Base URL** — As above.
-
-## Compatibility
-
--   **n8n**: Tested with v1.100.1 and later.
-
--   **Node.js**: v22.17.0 or higher.
-
--   **Matrix42 ESMP API**: Tested with Matrix42 12.1.2.5325.
-
-## Resources
-
-* [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
-* [Matrix42 Web Services](https://help.matrix42.com/030_ESMP/030_INT/Business_Processes_and_API_Integrations/Matrix42_Web_Services_API#Public_API)
-
-## Version History
-
-**0.1.3:**
-- Added Operations:
-	-   Tickets: `addJournalEntry`
-
-**0.1.2:**
-- Added Operations:
-	-   Storage Operations: `uploadFile`
-
-**0.1.1:**
-- Bug Fixes
-
-**0.1.0:**
-  - Initial release supporting operations across multiple resources:
-    -   Data Fragments: `getFragments`, `addFragment`, `updateFragment`, `deleteFragment`
-    -   Data Objects: `addObject`, `getObject`, `updateObject`, `deleteObject`
-    -   Tickets: `createTicket`, `closeTicket`, `transformTicket`
-    -   Import: `executeImportDefinition`
-
-  - Authentication methods:
-    -   Matrix42 Token API (API Token ↔︎ Bearer JWT exchange)
-    -   Matrix42 Basic API (HTTP Basic Authentication)
-   
-
-## Legal & Disclaimer
-
-This project is an **unofficial, community-maintained integration** for the Matrix42 ESMP **Public API**.  
-It uses only documented, publicly available endpoints as described in the official
-[Matrix42 Web Services API documentation](https://help.matrix42.com/030_ESMP/030_INT/Business_Processes_and_API_Integrations/Matrix42_Web_Services_API).
-
-Matrix42 **explicitly provides** a Public API and token-based authentication mechanism to support
-third-party integrations. This node simply wraps those endpoints for easier use within n8n.
-There is **no violation** of Matrix42’s licensing or terms of service in doing so.
-
-> **No Affiliation:**  
-> This project is **not affiliated with, endorsed, or sponsored by Matrix42 GmbH**.  
-> *MATRIX42* and related marks are trademarks of Matrix42 GmbH, used here for identification purposes only.
+# n8n-nodes-matrix42
+
+This is an n8n community node that integrates with the Matrix42 ESMP Web Services API. It allows you to retrieve and work with Data Fragments from Matrix42 Data Definitions directly in your n8n workflows.
+
+Matrix42’s ESMP API exposes CRUD‑style endpoints for data fragments, supporting OData‑like filtering, column selection, paging, sorting, and more.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+[Installation](#installation)  
+[Operations](#operations)  
+[Credentials](#credentials)
+[Compatibility](#compatibility)  
+[Resources](#resources)  
+[Version history](#version-history)  
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+## Operations
+
+This node supports multiple operations across different resources:
+
+### Data Fragment
+
+-   **Get Many** (`getAll`): Retrieve data fragments matching a search expression, with Return All / Limit paging.
+
+-   **Create** (`create`): Create a new data fragment in the specified Data Definition.
+
+-   **Update** (`update`): Update an existing data fragment.
+
+-   **Delete** (`delete`): Delete a data fragment by its ID.
+
+
+### Data Object
+
+-   **Create** (`create`): Create a new object for a Configuration Item.
+
+-   **Get** (`get`): Retrieve a single object by its ID.
+
+-   **Update** (`update`): Update an existing object.
+
+-   **Delete** (`delete`): Delete an object by its ID.
+
+
+### Data Query
+
+-   **Get Data** (`getData`): Read the list items of a data query, with Return All / paging (zero-based pages). Uses the `POST` variant so a structured **User Filters** group (`QueryFilterGroup`) can be passed in the body for ad-hoc filtering.
+
+### Ticket
+
+-   **Create** (`create`): Open a new ticket in the Service Desk (with a selectable initial **State**).
+
+-   **Close** (`close`): Close an Incident or Service Request.
+
+-   **Transform** (`transform`): Transform a ticket into another type.
+
+-   **Add Journal Entry** (`addJournalEntry`): Add a journal entry to a ticket.
+
+### Storage
+
+-   **Upload** (`upload`): Upload a file and attach it to a Configuration Item.
+
+### Import
+
+-   **Execute** (`execute`): Run a predefined import definition to ingest data.
+
+## Credentials
+
+> **Prerequisite:** You must have access to a running Matrix42 instance with appropriate API permissions.
+
+This node supports two authentication methods. Configure these under **Workflow → Credentials**.
+
+### Matrix42 Webservice Token Auth
+
+1.  **Server URL** — Your Matrix42 server URL (e.g. `https://matrix42.example.com`).
+
+2.  **Webservice Token** — Your Matrix42 API Token.
+
+3.  **Ignore SSL Issues (Insecure)** — Enable when the server uses a self‑signed certificate.
+
+
+On execution, the node:
+
+-   Exchanges the API Token for a short‑lived Bearer (JWT) access token via `GenerateAccessTokenFromApiToken` (handled automatically in the credential's pre‑authentication step; the access token is cached and refreshed on expiry).
+
+-   Uses the access token in the `Authorization` header for all subsequent calls.
+
+
+> **Self‑signed certificates**: enable **Ignore SSL Issues (Insecure)** on the credential, or add the server's CA certificate to n8n's trusted store (see https://docs.n8n.io/hosting/configuration/configuration-examples/custom-certificate-authority/).
+
+### Matrix42 Basic Auth
+
+1.  **Server URL** — As above.
+
+2.  **User** and **Password** — Your Matrix42 user credentials.
+
+3.  **Ignore SSL Issues (Insecure)** — As above.
+
+## Compatibility
+
+-   **n8n**: Node API version 1; built and tested against `n8n-workflow` 2.x. Requires n8n 1.85 or later (uses `NodeConnectionTypes`). Last tested with n8n 2.2.3.
+
+-   **Node.js**: v22 or higher.
+
+-   **Matrix42 ESMP API**: Last tested against Matrix42 26.1.0.1390.
+
+## Resources
+
+* [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
+* [Matrix42 Web Services](https://help.matrix42.com/030_ESMP/030_INT/Business_Processes_and_API_Integrations/Matrix42_Web_Services_API#Public_API)
+
+## Version History
+
+**0.2.0:**
+- **Breaking (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 using the node must reselect the resource/operation.
+- Token auth now performs the documented API‑token → access‑token exchange
+- Added an **Ignore SSL Issues (Insecure)** toggle to both credentials.
+- Added a **Data Query** resource with **Get Data** (POST-based, paged, with Return All and a structured **User Filters** body).
+- Ticket **Create** gained a selectable **State** field (loaded from the instance's activity states; defaults to New/200) and an **Extra Properties** collection for setting arbitrary/custom ticket attributes as name/value pairs.
+- Added an optional **Response Language** credential field, sent as the `Explicit-Language` header on every request.
+- `Get Many` (fragments) gained **Return All / Limit** paging.
+
+**0.1.3:**
+- Added Operations:
+	-   Tickets: `addJournalEntry`
+
+**0.1.2:**
+- Added Operations:
+	-   Storage Operations: `uploadFile`
+
+**0.1.1:**
+- Bug Fixes
+
+**0.1.0:**
+  - Initial release supporting operations across multiple resources:
+    -   Data Fragments: `getFragments`, `addFragment`, `updateFragment`, `deleteFragment`
+    -   Data Objects: `addObject`, `getObject`, `updateObject`, `deleteObject`
+    -   Tickets: `createTicket`, `closeTicket`, `transformTicket`
+    -   Import: `executeImportDefinition`
+
+  - Authentication methods:
+    -   Matrix42 Token API (API Token ↔︎ Bearer JWT exchange)
+    -   Matrix42 Basic API (HTTP Basic Authentication)
+   
+
+## Legal & Disclaimer
+
+This project is an **unofficial, community-maintained integration** for the Matrix42 ESMP **Public API**.  
+It uses only documented, publicly available endpoints as described in the official
+[Matrix42 Web Services API documentation](https://help.matrix42.com/030_ESMP/030_INT/Business_Processes_and_API_Integrations/Matrix42_Web_Services_API).
+
+Matrix42 **explicitly provides** a Public API and token-based authentication mechanism to support
+third-party integrations. This node simply wraps those endpoints for easier use within n8n.
+There is **no violation** of Matrix42’s licensing or terms of service in doing so.
+
+> **No Affiliation:**  
+> This project is **not affiliated with, endorsed, or sponsored by Matrix42 GmbH**.  
+> *MATRIX42* and related marks are trademarks of Matrix42 GmbH, used here for identification purposes only.

package/dist/credentials/Matrix42BasicApi.credentials.d.ts

@@ -1,9 +1,10 @@
-import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
 export declare class Matrix42BasicApi implements ICredentialType {
     name: string;
     extends: string[];
     displayName: string;
     documentationUrl: string;
+    icon: "file:matrix42.svg";
     properties: INodeProperties[];
     authenticate: IAuthenticateGeneric;
     test: ICredentialTestRequest;

package/dist/credentials/Matrix42BasicApi.credentials.js

@@ -6,14 +6,16 @@ class Matrix42BasicApi {
         this.name = 'matrix42BasicApi';
         this.extends = ['httpBasicAuth'];
         this.displayName = 'Matrix42 Basic Auth API';
-        this.documentationUrl = 'https://help.matrix42.com/030_ESMP/030_INT/Business_Processes_and_API_Integrations/Web_Services%3A_Authentication_types';
+        this.documentationUrl = 'https://docs.matrix42.com/1074558_web-services/3463380_web-services-authentication-types';
+        this.icon = 'file:matrix42.svg';
         this.properties = [
             {
                 displayName: 'Server URL',
                 name: 'serverUrl',
                 type: 'string',
                 default: '',
-                hint: 'The URL of the Matrix42 server. (https://www.example-matrix42.com)',
+                placeholder: 'e.g. https://matrix42.example.com',
+                hint: 'The base URL of the Matrix42 server',
                 required: true,
             },
             {
@@ -33,6 +35,21 @@ class Matrix42BasicApi {
                 },
                 default: '',
             },
+            {
+                displayName: 'Ignore SSL Issues (Insecure)',
+                name: 'allowUnauthorizedCerts',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to connect even if SSL certificate validation is not possible, e.g. when the Matrix42 server uses a self-signed certificate',
+            },
+            {
+                displayName: 'Response Language',
+                name: 'explicitLanguage',
+                type: 'string',
+                default: '',
+                placeholder: 'e.g. de-DE',
+                hint: 'Optional. Sent as the "Explicit-Language" header on every request to control the language of the response. Leave empty to use the server default.',
+            },
         ];
         this.authenticate = {
             type: 'generic',
@@ -45,9 +62,12 @@ class Matrix42BasicApi {
         };
         this.test = {
             request: {
-                baseURL: '={{$credentials?.serverUrl}}',
+                baseURL: '={{$credentials.serverUrl.replace(/\\/+$/, "")}}',
                 url: '/m42Services/api/data/fragments/SPSGlobalConfigurationClassBase',
-                skipSslCertificateValidation: false,
+                qs: {
+                    pagesize: 1,
+                },
+                skipSslCertificateValidation: '={{$credentials.allowUnauthorizedCerts}}',
             },
         };
     }

package/dist/credentials/Matrix42BasicApi.credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"Matrix42BasicApi.credentials.js","sourceRoot":"","sources":["../../credentials/Matrix42BasicApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,gBAAgB;IAA7B;QACC,SAAI,GAAG,kBAAkB,CAAC;QAE1B,YAAO,GAAG,CAAC,eAAe,CAAC,CAAC;QAE5B,gBAAW,GAAG,yBAAyB,CAAC;QAExC,qBAAgB,GAAG,yHAAyH,CAAC;QAE7I,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,IAAI,EAAE,oEAAoE;gBAC1E,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE;aACX;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;aACX;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,IAAI,EAAE;oBACL,QAAQ,EAAE,wBAAwB;oBAClC,QAAQ,EAAE,4BAA4B;iBACtC;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,8BAA8B;gBACvC,GAAG,EAAE,iEAAiE;gBACtE,4BAA4B,EAAE,KAAK;aACnC;SACD,CAAC;IACH,CAAC;CAAA;AAtDD,4CAsDC"}
+{"version":3,"file":"Matrix42BasicApi.credentials.js","sourceRoot":"","sources":["../../credentials/Matrix42BasicApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,gBAAgB;IAA7B;QACC,SAAI,GAAG,kBAAkB,CAAC;QAE1B,YAAO,GAAG,CAAC,eAAe,CAAC,CAAC;QAE5B,gBAAW,GAAG,yBAAyB,CAAC;QAExC,qBAAgB,GACf,0FAA0F,CAAC;QAE5F,SAAI,GAAG,mBAA4B,CAAC;QAEpC,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,mCAAmC;gBAChD,IAAI,EAAE,qCAAqC;gBAC3C,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE;aACX;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;aACX;YACD;gBACC,WAAW,EAAE,8BAA8B;gBAC3C,IAAI,EAAE,wBAAwB;gBAC9B,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACV,qIAAqI;aACtI;YACD;gBACC,WAAW,EAAE,mBAAmB;gBAChC,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,mJAAmJ;aACzJ;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,IAAI,EAAE;oBACL,QAAQ,EAAE,wBAAwB;oBAClC,QAAQ,EAAE,4BAA4B;iBACtC;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,kDAAkD;gBAC3D,GAAG,EAAE,iEAAiE;gBACtE,EAAE,EAAE;oBACH,QAAQ,EAAE,CAAC;iBACX;gBACD,4BAA4B,EAAE,0CAA0C;aACxE;SACD,CAAC;IACH,CAAC;CAAA;AA7ED,4CA6EC"}

package/dist/credentials/Matrix42TokenApi.credentials.d.ts

@@ -1,9 +1,13 @@
-import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+import type { IAuthenticateGeneric, ICredentialDataDecryptedObject, ICredentialTestRequest, ICredentialType, IHttpRequestHelper, INodeProperties } from 'n8n-workflow';
 export declare class Matrix42TokenApi implements ICredentialType {
     name: string;
     displayName: string;
     documentationUrl: string;
+    icon: "file:matrix42.svg";
     properties: INodeProperties[];
+    preAuthentication(this: IHttpRequestHelper, credentials: ICredentialDataDecryptedObject): Promise<{
+        accessToken: string;
+    }>;
     authenticate: IAuthenticateGeneric;
     test: ICredentialTestRequest;
 }

package/dist/credentials/Matrix42TokenApi.credentials.js

@@ -5,14 +5,16 @@ class Matrix42TokenApi {
     constructor() {
         this.name = 'matrix42TokenApi';
         this.displayName = 'Matrix42 Webservice Token Auth API';
-        this.documentationUrl = 'https://help.matrix42.com/030_ESMP/030_INT/Business_Processes_and_API_Integrations/Web_Services%3A_Authentication_types';
+        this.documentationUrl = 'https://docs.matrix42.com/1074558_web-services/3463380_web-services-authentication-types';
+        this.icon = 'file:matrix42.svg';
         this.properties = [
             {
                 displayName: 'Server URL',
                 name: 'serverUrl',
                 type: 'string',
                 default: '',
-                hint: 'The URL of the Matrix42 server. (https://www.example-matrix42.com)',
+                placeholder: 'e.g. https://matrix42.example.com',
+                hint: 'The base URL of the Matrix42 server',
                 required: true,
             },
             {
@@ -20,29 +22,71 @@ class Matrix42TokenApi {
                 name: 'webserviceToken',
                 type: 'string',
                 typeOptions: {
-                    password: true
+                    password: true,
                 },
                 default: '',
-                hint: 'The Webservice token of the Matrix42 server.',
+                hint: 'The API Token generated in Matrix42. It is exchanged for a short-lived access token on each run',
                 required: true,
             },
+            {
+                displayName: 'Ignore SSL Issues (Insecure)',
+                name: 'allowUnauthorizedCerts',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to connect even if SSL certificate validation is not possible, e.g. when the Matrix42 server uses a self-signed certificate',
+            },
+            {
+                displayName: 'Response Language',
+                name: 'explicitLanguage',
+                type: 'string',
+                default: '',
+                placeholder: 'e.g. de-DE',
+                hint: 'Optional. Sent as the "Explicit-Language" header on every request to control the language of the response. Leave empty to use the server default.',
+            },
+            {
+                displayName: 'Access Token',
+                name: 'accessToken',
+                type: 'hidden',
+                typeOptions: {
+                    expirable: true,
+                },
+                default: '',
+            },
         ];
         this.authenticate = {
             type: 'generic',
             properties: {
                 headers: {
-                    Authorization: '=Bearer {{$credentials.webserviceToken}}',
+                    Authorization: '=Bearer {{$credentials.accessToken}}',
                 },
             },
         };
         this.test = {
             request: {
-                baseURL: '={{$credentials?.serverUrl}}',
+                baseURL: '={{$credentials.serverUrl.replace(/\\/+$/, "")}}',
                 url: '/m42Services/api/data/fragments/SPSGlobalConfigurationClassBase',
-                skipSslCertificateValidation: false,
+                qs: {
+                    pagesize: 1,
+                },
+                skipSslCertificateValidation: '={{$credentials.allowUnauthorizedCerts}}',
             },
         };
     }
+    async preAuthentication(credentials) {
+        const serverUrl = credentials.serverUrl.replace(/\/+$/, '');
+        const { RawToken } = (await this.helpers.httpRequest({
+            method: 'POST',
+            url: `${serverUrl}/m42Services/api/ApiToken/GenerateAccessTokenFromApiToken`,
+            skipSslCertificateValidation: credentials.allowUnauthorizedCerts === true,
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${credentials.webserviceToken}`,
+            },
+            body: {},
+            json: true,
+        }));
+        return { accessToken: RawToken };
+    }
 }
 exports.Matrix42TokenApi = Matrix42TokenApi;
 //# sourceMappingURL=Matrix42TokenApi.credentials.js.map

package/dist/credentials/Matrix42TokenApi.credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"Matrix42TokenApi.credentials.js","sourceRoot":"","sources":["../../credentials/Matrix42TokenApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,gBAAgB;IAA7B;QACC,SAAI,GAAG,kBAAkB,CAAC;QAE1B,gBAAW,GAAG,oCAAoC,CAAC;QAEnD,qBAAgB,GAAG,yHAAyH,CAAC;QAE7I,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,IAAI,EAAE,oEAAoE;gBAC1E,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,IAAI,EAAE,8CAA8C;gBACpD,QAAQ,EAAE,IAAI;aACd;SAUD,CAAC;QAeF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,0CAA0C;iBACzD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,8BAA8B;gBACvC,GAAG,EAAE,iEAAiE;gBACtE,4BAA4B,EAAE,KAAK;aACnC;SACD,CAAC;IACH,CAAC;CAAA;AAnED,4CAmEC"}
+{"version":3,"file":"Matrix42TokenApi.credentials.js","sourceRoot":"","sources":["../../credentials/Matrix42TokenApi.credentials.ts"],"names":[],"mappings":";;;AASA,MAAa,gBAAgB;IAA7B;QACC,SAAI,GAAG,kBAAkB,CAAC;QAE1B,gBAAW,GAAG,oCAAoC,CAAC;QAEnD,qBAAgB,GACf,0FAA0F,CAAC;QAE5F,SAAI,GAAG,mBAA4B,CAAC;QAEpC,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,mCAAmC;gBAChD,IAAI,EAAE,qCAAqC;gBAC3C,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,IAAI,EAAE,iGAAiG;gBACvG,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,8BAA8B;gBAC3C,IAAI,EAAE,wBAAwB;gBAC9B,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACV,qIAAqI;aACtI;YACD;gBACC,WAAW,EAAE,mBAAmB;gBAChC,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,mJAAmJ;aACzJ;YACD;gBACC,WAAW,EAAE,cAAc;gBAC3B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,SAAS,EAAE,IAAI;iBACf;gBACD,OAAO,EAAE,EAAE;aACX;SACD,CAAC;QAoBF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,sCAAsC;iBACrD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,kDAAkD;gBAC3D,GAAG,EAAE,iEAAiE;gBACtE,EAAE,EAAE;oBACH,QAAQ,EAAE,CAAC;iBACX;gBACD,4BAA4B,EAAE,0CAA0C;aACxE;SACD,CAAC;IACH,CAAC;IArCA,KAAK,CAAC,iBAAiB,CAA2B,WAA2C;QAC5F,MAAM,SAAS,GAAI,WAAW,CAAC,SAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAExE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YACpD,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,GAAG,SAAS,2DAA2D;YAC5E,4BAA4B,EAAE,WAAW,CAAC,sBAAsB,KAAK,IAAI;YACzE,OAAO,EAAE;gBACR,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,WAAW,CAAC,eAAe,EAAE;aACtD;YACD,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,IAAI;SACV,CAAC,CAAyB,CAAC;QAE5B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAClC,CAAC;CAqBD;AA/FD,4CA+FC"}

package/dist/credentials/matrix42.svg

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" width="400" height="150" viewBox="0 0 400 150">
+  <path d="M197.5,0h-72.5l-27.5,72.5L72.5,0H0v150h55V60l32.5,90h20l35-90v90h55l-52.5-75L197.5,0Z" fill="#202326"/>
+  <path d="M232.5,85v-30l-20,30h20Z" fill="#f86200"/>
+  <path d="M210,0l-50,75,52.5,75h187.5V0h-190ZM282.5,120h-15v20h-35v-20h-25l-32.5-45,45-60h50v70h15v35h-2.5ZM385,140h-95v-30c47.5-37.5,55-45,55-52.5,0-5-5-7.5-10-7.5-10,0-17.5,2.5-25,12.5l-2.5,2.5-22.5-25v-2.5c12.5-12.5,30-20,47.5-20,30,0,50,17.5,50,42.5,0,17.5-10,30-35,50h35v30h2.5Z" fill="#f86200"/>
+</svg>

package/dist/nodes/Matrix42/GenericFunctions.d.ts

@@ -1,3 +1,4 @@
-import { IDataObject, IExecuteFunctions, IHookFunctions, IHttpRequestMethods, ILoadOptionsFunctions } from 'n8n-workflow';
+import type { IDataObject, IExecuteFunctions, IHookFunctions, IHttpRequestMethods, ILoadOptionsFunctions } from 'n8n-workflow';
+export declare function normalizeServerUrl(serverUrl: string): string;
+export declare function escapeAsqlString(value: string): string;
 export declare function matrix42ApiRequest(this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, endpoint: `/${string}`, body: object, query?: IDataObject, uri?: string, contentType?: string): Promise<any>;
-export declare function uuidv4(): string;

package/dist/nodes/Matrix42/GenericFunctions.js

@@ -1,33 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeServerUrl = normalizeServerUrl;
+exports.escapeAsqlString = escapeAsqlString;
 exports.matrix42ApiRequest = matrix42ApiRequest;
-exports.uuidv4 = uuidv4;
+function normalizeServerUrl(serverUrl) {
+    return serverUrl.replace(/\/+$/, '');
+}
+function escapeAsqlString(value) {
+    return String(value !== null && value !== void 0 ? value : '').replace(/'/g, "''");
+}
 async function matrix42ApiRequest(method, endpoint, body, query, uri, contentType = 'application/json') {
     const authenticationMethod = this.getNodeParameter('authentication', 0);
     const credentialType = authenticationMethod === 'basic' ? 'matrix42BasicApi' : 'matrix42TokenApi';
-    const { serverUrl } = await this.getCredentials(credentialType);
+    const { serverUrl, allowUnauthorizedCerts, explicitLanguage } = await this.getCredentials(credentialType);
     const isJson = contentType === null || contentType === void 0 ? void 0 : contentType.toLowerCase().includes('application/json');
+    const hasBody = method !== 'GET' && method !== 'HEAD' && body != null && Object.keys(body).length > 0;
+    const headers = {
+        'Content-Type': contentType,
+    };
+    if (explicitLanguage) {
+        headers['Explicit-Language'] = explicitLanguage;
+    }
     const options = {
-        headers: {
-            'Content-Type': contentType,
-        },
+        headers,
         method,
-        body: method === 'GET' || method === 'HEAD' || method === 'DELETE' ? null : body,
+        body: hasBody ? body : undefined,
         qs: query,
-        url: uri || `${serverUrl}/m42Services/api${endpoint}`,
+        url: uri || `${normalizeServerUrl(serverUrl)}/m42Services/api${endpoint}`,
         json: isJson,
-        skipSslCertificateValidation: false
+        skipSslCertificateValidation: allowUnauthorizedCerts === true,
     };
-    if (options.body === null) {
+    if (options.body === undefined) {
         delete options.body;
     }
     return await this.helpers.httpRequestWithAuthentication.call(this, credentialType, options);
 }
-function uuidv4() {
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
-        const r = (Math.random() * 16) | 0;
-        const v = c === 'x' ? r : (r & 0x3) | 0x8;
-        return v.toString(16);
-    });
-}
 //# sourceMappingURL=GenericFunctions.js.map

package/dist/nodes/Matrix42/GenericFunctions.js.map

@@ -1 +1 @@
-{"version":3,"file":"GenericFunctions.js","sourceRoot":"","sources":["../../../nodes/Matrix42/GenericFunctions.ts"],"names":[],"mappings":";;AAOA,gDAiCC;AAED,wBAMC;AAzCM,KAAK,UAAU,kBAAkB,CAEvC,MAA2B,EAC3B,QAAsB,EACtB,IAAY,EACZ,KAAmB,EACnB,GAAY,EACZ,cAAsB,kBAAkB;IAGxC,MAAM,oBAAoB,GAAG,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC,CAAW,CAAC;IAClF,MAAM,cAAc,GAAG,oBAAoB,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAClG,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAwB,cAAc,CAAC,CAAC;IAEvF,MAAM,MAAM,GAAG,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,WAAW,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAEvE,MAAM,OAAO,GAAwB;QACpC,OAAO,EAAE;YACR,cAAc,EAAE,WAAW;SAC3B;QACD,MAAM;QACN,IAAI,EAAE,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAChF,EAAE,EAAE,KAAK;QACT,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,mBAAmB,QAAQ,EAAE;QACrD,IAAI,EAAE,MAAM;QACZ,4BAA4B,EAAE,KAAK;KACnC,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC;AAED,SAAgB,MAAM;IACrB,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE;QAClE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"GenericFunctions.js","sourceRoot":"","sources":["../../../nodes/Matrix42/GenericFunctions.ts"],"names":[],"mappings":";;AAgBA,gDAEC;AAMD,4CAEC;AAED,gDAyCC;AArDD,SAAgB,kBAAkB,CAAC,SAAiB;IACnD,OAAO,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAMD,SAAgB,gBAAgB,CAAC,KAAa;IAC7C,OAAO,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAChD,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAEvC,MAA2B,EAC3B,QAAsB,EACtB,IAAY,EACZ,KAAmB,EACnB,GAAY,EACZ,cAAsB,kBAAkB;IAExC,MAAM,oBAAoB,GAAG,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC,CAAW,CAAC;IAClF,MAAM,cAAc,GAAG,oBAAoB,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAClG,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,GAC5D,MAAM,IAAI,CAAC,cAAc,CAAsB,cAAc,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,WAAW,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACvE,MAAM,OAAO,GACZ,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAEvF,MAAM,OAAO,GAAgB;QAC5B,cAAc,EAAE,WAAW;KAC3B,CAAC;IAEF,IAAI,gBAAgB,EAAE,CAAC;QACtB,OAAO,CAAC,mBAAmB,CAAC,GAAG,gBAAgB,CAAC;IACjD,CAAC;IAED,MAAM,OAAO,GAAwB;QACpC,OAAO;QACP,MAAM;QACN,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAChC,EAAE,EAAE,KAAK;QACT,GAAG,EAAE,GAAG,IAAI,GAAG,kBAAkB,CAAC,SAAS,CAAC,mBAAmB,QAAQ,EAAE;QACzE,IAAI,EAAE,MAAM;QACZ,4BAA4B,EAAE,sBAAsB,KAAK,IAAI;KAC7D,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC"}

package/dist/nodes/Matrix42/Matrix42.node.d.ts

@@ -1,4 +1,4 @@
-import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import type { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
 export declare class Matrix42 implements INodeType {
     description: INodeTypeDescription;
     methods: {
@@ -10,8 +10,10 @@ export declare class Matrix42 implements INodeType {
             getTicketRoles(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getTicketSlas(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getTicketOlas(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getActivityStates(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getTicketCloseReasons(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getTicketCloseErrorTypes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getDataQueries(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getImportDefinitions(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getStorageProviders(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getJournalEntryTypes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;