Actions199
- Collections Actions
- Forms Actions
- Actions Capabilities Actions
- Activities Actions
- Attachments Actions
- Budgets Actions
- Categories Actions
- Custom Actions Actions
- Custom Options Actions
- Documents Actions
- File Links Actions
- View File Link
- Delete File Link
- Open File Link
- Download File Link
- List Project Storages
- Get Project Storage
- Open Project Storage
- Create Storage
- Get Storage
- Update Storage
- Delete Storage
- Get Storage Files
- Prepare Storage File Upload
- Create Storage Folder
- Create Storage Oauth Credentials
- Open Storage
- Create Work Package File Link
- List Work Package File Links
- Grids Actions
- Groups Actions
- Help Texts Actions
- Memberships Actions
- Query Filter Instance Schema Actions
- News Actions
- Notifications Actions
- O Auth 2 Actions
- Posts Actions
- Principals Actions
- Priorities Actions
- Query Columns Actions
- Query Filters Actions
- Query Operators Actions
- Query Sort Bys Actions
- Relations Actions
- Previewing Actions
- Revisions Actions
- Roles Actions
- Time Entries Actions
- Time Entry Activities Actions
- Types Actions
- User Preferences Actions
- Wiki Pages Actions
- Work Schedule Actions
- Meetings Actions
- Values Property Actions
- Projects Actions
- Queries Actions
- Users Actions
- Statuses Actions
- Versions Actions
- Work Packages Actions
- Get Project Work Package Collection
- Create Project Work Package
- List Work Package File Links
- Form Create Work Package In Project
- Project Available Assignees
- List Work Packages
- Create Work Package
- Form Create Work Package
- List Work Package Schemas
- View Work Package Schema
- Delete Work Package
- View Work Package
- Update Work Package
- List Work Package Activities
- Comment Work Package
- Work Package Available Assignees
- Available Projects For Work Package
- List Available Relation Candidates
- Available Watchers
- Create Work Package File Link
- Form Edit Work Package
- Revisions
- Reminders
- List Watchers
- Add Watcher
- Remove Watcher
- Views Actions
Overview
This node operation retrieves a list of file links associated with a specific work package in OpenProject. It is useful when you want to programmatically access or manage files attached to a particular work package, for example, to display them in a dashboard, synchronize files with another system, or automate reporting.
Practical examples:
- Fetching all document links related to a project task to include in a project status report.
- Automatically downloading or backing up files attached to a work package.
- Filtering and listing files based on storage location or other criteria.
Properties
| Name | Meaning |
|---|---|
| Id | The unique identifier of the work package whose file links you want to list. |
| Filters | JSON string specifying filter conditions for the file links. Supports filters like storage. Accepts the same format as OpenProject's queries endpoint. Example: [{"storage":{"operator":"=","values":["42"]}}] |
Output
The output contains a JSON array of file link objects related to the specified work package. Each object typically includes metadata about the file link such as URL, filename, storage details, and possibly other attributes depending on the API response.
If binary data is returned (e.g., actual file content), it would be represented in the binary output field, but this operation primarily lists links rather than file contents.
Dependencies
- Requires an API key credential for authenticating with the OpenProject API.
- Needs the base URL of the OpenProject instance configured in the node credentials.
- The node depends on the OpenProject REST API being accessible and the user having permission to read work package attachments.
Troubleshooting
- Invalid Work Package ID: If the provided work package ID does not exist or is inaccessible, the node will likely return an error indicating "Not Found" or "Unauthorized". Verify the ID and permissions.
- Malformed Filters JSON: Providing invalid JSON in the Filters property can cause request failures. Ensure the JSON syntax is correct and matches the expected query format.
- API Authentication Errors: Missing or incorrect API credentials will result in authentication errors. Confirm that the API key and base URL are correctly set.
- No File Links Returned: If no files are linked to the work package or filters exclude all files, the output will be empty. Double-check the filters and work package contents.