OpenProjectInstall

Overview

This node operation retrieves the list of watchers for a specific work package in OpenProject. Watchers are users who receive notifications about changes or updates to that work package. This functionality is useful for project managers or team members who want to monitor activity on particular tasks or issues without being directly assigned to them.

Practical examples:

• Automatically fetching watchers to notify them via another communication channel.
• Auditing who is monitoring critical work packages.
• Integrating watcher information into dashboards or reports.

Properties

Output

The output contains a JSON array representing the watchers of the specified work package. Each item typically includes details about a watcher such as their user ID, name, and possibly contact information depending on the API response structure.

If the node supports binary data output (not evident from the provided code), it would relate to attachments or files associated with watchers, but this is not indicated here.

Dependencies

• Requires an API key credential for authenticating with the OpenProject API.
• Needs the base URL of the OpenProject instance configured in the credentials.
• Depends on the OpenProject REST API endpoint for work package watchers.

Troubleshooting

• Common issue: Providing an invalid or non-existent work package ID will likely result in an error or empty watcher list.
• Error message: "Work package not found" or similar indicates the ID does not exist; verify the ID input.
• Authentication errors: Ensure the API key and base URL are correctly set in the node credentials.
• Network errors: Check connectivity to the OpenProject server and firewall settings.

Links and References

• OpenProject API Documentation
• OpenProject Work Packages
• n8n Documentation