OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

This node operation updates a non-working day in a work schedule. It is useful for managing and customizing work calendars by marking specific dates as non-working days, such as holidays or company-specific off days. This helps automate scheduling, resource planning, and time tracking by ensuring that these days are recognized as exceptions in workflows.

Practical examples include:

  • Updating a holiday date with a descriptive name to reflect a new public holiday.
  • Marking a company-wide off day for maintenance or special events.
  • Adjusting non-working days dynamically based on project requirements or regional differences.

Properties

Name Meaning
Date The ISO 8601 formatted date of the non-working day to update.
Type The type of entry; here it only supports "Non Working Day".
Date The date of the non-working day (same as above, used in request body).
Name A descriptive name for the non-working day, e.g., "Christmas Holiday".
Links JSON object defining API endpoint and method for the update request (usually fixed).

Note: The property "Date" appears twice because one is likely for selecting the target date and the other for sending in the request body.

Output

The node outputs JSON data representing the updated non-working day record as returned by the API. This typically includes fields like the date, name, type, and possibly metadata about the update operation.

If binary data were involved (not indicated here), it would represent file attachments or similar content related to the work schedule, but this node focuses solely on JSON data.

Dependencies

  • Requires an API key credential for authenticating with the OpenProject API.
  • Needs the base URL of the OpenProject instance configured in credentials.
  • Depends on the OpenProject REST API being accessible and supporting the update of non-working days via the specified endpoint.

Troubleshooting

  • Common issues:

    • Incorrect date format: Ensure the date is in ISO 8601 format (e.g., "2022-05-06").
    • Missing required fields: Both date and name must be provided.
    • Authentication errors: Verify that the API key and base URL are correctly set.
    • API endpoint changes: If the OpenProject API changes, the node may fail to update non-working days.
  • Error messages:

    • Unauthorized or 401 errors indicate invalid or missing API credentials.
    • 400 Bad Request errors often mean required properties are missing or malformed.
    • 404 Not Found could mean the specified non-working day does not exist or the endpoint URL is incorrect.

Resolving these usually involves checking input values, credentials, and API availability.

Links and References

Discussion