OpenProject icon

OpenProject

Interact with OpenProject via API
Join our community

Actions199

Overview

The "Work Schedule - List Days" operation retrieves a list of days from the work schedule, optionally filtered by specific criteria. This node is useful for workflows that need to analyze or process calendar days within a project management context, such as identifying working days, non-working days, or days within a particular date range.

Practical examples include:

  • Generating reports on working vs. non-working days in a given period.
  • Automating task scheduling based on available working days.
  • Filtering days to trigger actions only on weekends or holidays.

Properties

Name Meaning
Filters A JSON string specifying filter conditions to narrow down the days returned. Supported filters include:
• date: An inclusive date interval to scope the days (e.g., between two dates).
• working: Boolean filter to return only working days (true), only non-working days (false), or both if unspecified.
Example: { "date": { "operator": "<>d", "values": ["2022-05-02","2022-05-26"] } }

Output

The output contains a JSON array of day objects matching the specified filters. Each object represents a day in the work schedule and includes details such as the date and whether it is a working day or not.

If the node supports binary data output, it would typically represent attachments or related files, but this node focuses on JSON data representing days.

Dependencies

  • Requires an API key credential for authenticating with the OpenProject API.
  • The node depends on the OpenProject API endpoint for queries related to work schedules.
  • Proper configuration of the base URL and authentication credentials in n8n is necessary.

Troubleshooting

  • Invalid Filter JSON: If the filters property contains malformed JSON, the node will fail to parse it. Ensure the JSON syntax is correct.
  • Unsupported Filter Fields: Using unsupported filter keys may result in empty responses or errors. Use only supported filters like date and working.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key and base URL are correctly configured.
  • Date Format Issues: Dates must be in ISO format (YYYY-MM-DD). Incorrect formats may lead to unexpected results or errors.
  • Empty Results: If no days match the filters, the output will be an empty array. Adjust filters accordingly.

Links and References

Discussion