OpenProject

Interact with OpenProject API

Overview

This node operation updates an existing work package in OpenProject. It allows users to modify various fields of a work package such as subject, description, status, priority, assignee, start date, due date, and estimated time. This operation is useful for project managers or team members who need to keep work package details current as project requirements evolve. For example, updating the status to 'In Progress' or changing the assignee to a different team member.

Use Case Examples

  1. Updating the status of a work package to 'Closed' after completion.
  2. Changing the priority of a work package to 'Critical' to indicate urgency.
  3. Assigning a work package to a new user when responsibilities shift.

Properties

Name Meaning
Work Package ID The unique identifier of the work package to update, required to specify which work package to modify.
Update Fields A collection of fields that can be updated on the work package, including subject, description, status, priority, assignee ID, start date, due date, and estimated time in hours.

Output

JSON

  • json
    • id - The ID of the updated work package.
    • subject - The subject/title of the updated work package.
    • description
      * raw - The raw description text of the updated work package.
    • status - The status of the updated work package.
    • priority - The priority of the updated work package.
    • assignee - The user assigned to the updated work package.
    • startDate - The start date of the updated work package.
    • dueDate - The due date of the updated work package.
    • estimatedTime - The estimated time in hours for the updated work package.

Dependencies

  • OpenProject API

Troubleshooting

  • Ensure the Work Package ID is correct and exists in the OpenProject system; otherwise, the update will fail.
  • Provide at least one field to update; if no fields are specified, the node throws an error 'No fields to update. Please provide at least one field to update.'
  • Check that the API token credential for OpenProject is valid and has sufficient permissions to update work packages.
  • Verify that date fields (startDate, dueDate) are in the correct ISO 8601 format if manually entered.

Links

Discussion