OpenProject icon

OpenProject

Interact with OpenProject via API

Actions199

Overview

This node interacts with the "Work Schedule" resource of an external system, specifically to view details about a non-working day. It allows users to retrieve information about a particular date that is marked as a non-working day in the work schedule. This can be useful for automating workflows that depend on business calendars, such as scheduling tasks, managing leave requests, or adjusting project timelines around holidays and other non-working days.

For example, a user might use this node to check if a specific date is a holiday before assigning a task or sending notifications.

Properties

Name Meaning
Date The date of the non-working day to view, provided in ISO 8601 format (e.g., "2022-05-06"). This is a required input property specifying which non-working day's details to retrieve.

Output

The node outputs JSON data containing the details of the specified non-working day. The exact structure depends on the external API's response but typically includes fields such as the date, description or name of the non-working day, and possibly metadata like whether it is a recurring holiday.

If the node supports binary data output, it would generally relate to attachments or documents associated with the non-working day, but based on the provided code and context, no binary output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the external service providing the work schedule data.
  • The node uses a base URL configured via credentials to connect to the external API.
  • The external API must support querying non-working days by date.

Troubleshooting

  • Invalid Date Format: If the date is not in ISO 8601 format, the API may reject the request or return an error. Ensure the date string is correctly formatted (e.g., "YYYY-MM-DD").
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key or token is correctly configured in the node credentials.
  • Date Not Found: If the specified date is not marked as a non-working day, the API might return an empty response or an error indicating no data found. Handle such cases gracefully in your workflow.
  • Network Issues: Connectivity problems or incorrect base URL configuration can lead to request failures. Confirm network access and correct endpoint URLs.

Links and References

  • Refer to the external service's API documentation for detailed information on the "Work Schedule" resource and the "View Non Working Day" operation.
  • ISO 8601 date format specification: https://en.wikipedia.org/wiki/ISO_8601

Discussion