Nextcloud Calendar icon

Nextcloud Calendar

Verwalten Sie Ihre Kalender und Termine mit Nextcloud CalDAV
Join our community

Actions9

Overview

This node integrates with Nextcloud Calendar via CalDAV to manage calendars and events. Specifically, the "Nach Terminen Suchen" (Search for Events) operation allows users to search for calendar events within a specified time range using a search term. The search can be refined by options such as searching only in event titles, exact matches, and case sensitivity.

Common scenarios where this node is beneficial include:

  • Finding specific meetings or appointments in a busy calendar.
  • Filtering events by keywords in title, description, or location.
  • Automating workflows that depend on the presence or absence of certain events.

Practical example:

  • A user wants to find all events related to "Project X" scheduled between today and three months from now, optionally restricting the search to event titles only.

Properties

Name Meaning
Kalender Select a calendar from the list or enter its ID where the search will be performed.
Suchbegriff The search term used to find events; searches in title, description, and location fields.
Start Start datetime for the search period.
Ende End datetime for the search period.
Suchoptionen Collection of search options:
- Nur in Titeln Suchen (boolean): Search only in event titles.
- Exakte Übereinstimmung (boolean): Search for exact matches instead of partial matches.
- Groß-/Kleinschreibung Beachten (boolean): Make the search case sensitive.

Output

The output is a JSON array containing objects with the following structure:

  • success: Boolean indicating if the search was successful.
  • operation: The operation name ("search").
  • resource: The resource type ("event").
  • message: A descriptive message about the result.
  • data: An object containing:
    • events: An array of event objects matching the search criteria. Each event is parsed into a structured format representing details like title, start/end times, description, location, attendees, etc.
    • searchTerm: The original search term used.
    • count: Number of events found matching the search.
    • totalCount: Total number of events in the searched time range before filtering.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Nextcloud Calendar API.
  • Depends on Nextcloud CalDAV service being accessible.
  • Uses internal helper functions to parse Nextcloud responses.
  • No additional external services are required beyond Nextcloud itself.

Troubleshooting

  • No events found: If no events match the search term, the node returns success with an empty events array. Verify the search term and date range.
  • Invalid calendar ID: Providing an incorrect calendar identifier may cause errors or empty results. Ensure the calendar exists and the ID is correct.
  • Date range issues: The start date must be before the end date; otherwise, the node throws an error.
  • API connectivity problems: Network issues or invalid credentials will cause failures. Check API key validity and network access.
  • Case sensitivity and exact match options: Misunderstanding these options might lead to unexpected results. For example, enabling exact match requires the search term to exactly match the field content.

Common error messages:

  • "Keine Termine gefunden oder ungültige Antwort vom Server" — No events found or invalid server response.
  • "Endzeit muss nach der Startzeit liegen" — End time must be after start time.
  • Errors related to invalid email addresses do not apply here since this operation does not handle attendees.

Links and References

Discussion