ecoDMSInstall

Overview

The node provides an integration with ecoDMS, a document management system, enabling advanced search capabilities within the ecoDMS archive. Specifically, the "Suche" (Search) resource with the "Erweiterte Suche" (Advanced Search) operation allows users to perform complex filtered searches for documents based on multiple criteria.

This node is beneficial in scenarios where users need to locate specific documents or sets of documents in ecoDMS by applying detailed filters such as document type, folder location, status, date fields, and other metadata attributes. For example, a user could find all documents of a certain type created after a specific date, or all documents assigned to them that are currently marked with a particular status.

Practical examples:

• Retrieve all documents in a given folder and its subfolders that have a specific remark.
• Find all deleted documents assigned to the current user.
• Search for documents with a certain document type and status, limiting results to 100 entries.

Properties

Details of Suchfilter Attributes

• Attribut options:

  • Bemerkung (Remark)
  • Datum (Date)
  • Dokumentart (Document Type)
  • Ordner (inkl. Unterordner) (Folder including subfolders)
  • Nur in diesem Ordner (Only in this folder)
  • Hauptordner (inkl. Unterordner) (Main folder including subfolders)
  • Nur in diesem Hauptordner (Only in this main folder)
  • Status
  • Bearbeiter (Editor)
  • Wiedervorlage-Datum (Resubmission date)
  • Zeitstempel (Timestamp)

• Operator options (for some attributes):

  • Gleich (=)
  • Nicht gleich (!=)

• Depending on the attribute, the value input changes:

  • Text input for free text attributes.
  • Dropdown selections loaded dynamically for document types, folders, and statuses.

Output

The node outputs an array of JSON objects representing the documents found by the advanced search query. Each object contains metadata about a document matching the specified filters.

If the option to show permissions is enabled, the output includes lists of roles that have read and edit access to each document.

The node does not output binary data; it focuses on returning structured JSON data describing the search results.

Dependencies

• Requires an API key credential configured with the ecoDMS server URL and authentication details.
• The node depends on the ecoDMS REST API being accessible at the configured server URL.
• Dynamic loading of options (folders, document types, statuses) requires proper API connectivity.

Troubleshooting

• Server URL not configured: The node will throw an error if the ecoDMS server URL is missing in the credentials. Ensure the server URL is correctly set.
• Unsupported Resource or Operation: If an unsupported resource or operation is selected, the node throws an error indicating the resource is not supported.
• API Connectivity Issues: Network problems or incorrect credentials may cause failures when fetching dynamic options or executing the search.
• Invalid Filter Configuration: Providing invalid or incomplete filter parameters may result in no results or errors from the API.
• Max Document Count Limits: Setting the maximum document count above 1000 is not allowed and will be rejected.

To resolve these issues:

• Verify credentials and server URL configuration.
• Check network connectivity to the ecoDMS server.
• Review filter settings for correctness.
• Keep max document count within allowed limits.

Links and References

• ecoDMS Official Website
• ecoDMS API Documentation (if publicly available)
• n8n Documentation on Creating Custom Nodes