**As a** Nextcloud user Begin of the insertion
End of the insertion Begin of the deletion

End of the deletion **I want to** see Begin of the insertionallEnd of the insertion Begin of the deletion the relatedEnd of the deletion work packages Begin of the insertionon OpenProject that are linked toEnd of the insertion Begin of the deletion forEnd of the deletion a file Begin of the insertion
End of the insertion Begin of the deletion

End of the deletion **so that** I Begin of the deletion know:End of the deletion

* Begin of the insertioncan knowEnd of the insertion the status of the file in Begin of the deletion aEnd of the deletion workflows (work package Begin of the insertionstatus, (needs clarification))End of the insertion Begin of the deletion status)End of the deletion
* Begin of the insertionknow which work packages refer toEnd of the insertion Begin of the deletion whereEnd of the deletion the Begin of the insertionfile, so I know where/how itEnd of the insertion Begin of the deletion fileEnd of the deletion is used
* Begin of the insertioncanEnd of the insertion easier Begin of the insertionlocate andEnd of the insertion navigate to connected information in OpenProject

Begin of the insertion## Example use casesEnd of the insertion Begin of the deletion Examples:End of the deletion

* I have a Begin of the insertionlabourEnd of the insertion Begin of the deletion laborEnd of the deletion contract in a Begin of the insertionwritingEnd of the insertion Begin of the deletion writerEnd of the deletion app Begin of the insertionthat stores the file in NextcloudEnd of the insertion and I want to know if the manager has approved the conditions.
* There is a Begin of the insertionnewEnd of the insertion security guideline that is relevant Begin of the insertiontoEnd of the insertion Begin of the deletion forEnd of the deletion the specification of a new feature and I want to know where this guideline is used so that I can estimate the impact on the project.
* I Begin of the insertionhave updated a file andEnd of the insertion want to update the status of the related work package to communicate the current Begin of the insertionprogress; theEnd of the insertion Begin of the deletion progress. TheEnd of the deletion link helps me Begin of the insertioneasily and confidentlyEnd of the insertion Begin of the deletion toEnd of the deletion find the correct work Begin of the insertionpackage quickly.End of the insertion Begin of the deletion package.End of the deletion

Begin of the insertion## Implementation considerationsEnd of the insertion Begin of the deletion **Implementation considerations**End of the deletion

* Begin of the insertionThe implementation on the OpenProject end is described in epic #40228 ("In OpenProject: A Nextcloud split-screen tab that shows files related to a work package").End of the insertion Begin of the deletion ##40228End of the deletion
* Begin of the insertionOn the Nextcloud end, the details split-screen will have a new "OpenProject" tab that shows linked work packages and allows the user to search for new work packages to link

## TheEnd of the insertion OpenProject tab Begin of the insertion

The OpenProject tab is added systematically toEnd of the insertion Begin of the deletion showingEnd of the deletion the Begin of the insertionright-side details pane, after "Versions".

By default, when no links have been established withEnd of the insertion Begin of the deletion linkedEnd of the deletion work Begin of the insertionpackages, this pane contains just a search bar and an empty-state message, "No OpenProject links yet. To add a link, use the search bar above to find the desired work package."

**Adding a link to a work package**
To link the current file to a work package in OpenProject, the user has to first simply locate the correct work package via the search bar.

A drop-down displays a list of workEnd of the insertion packages Begin of the insertioncorresponding to the search term. Each search result item will contain:

* Project nameEnd of the insertion
* Begin of the insertionWork package type
* Status
* Author
* Title/subject

**Open question**: would displaying the work package #ID be important to add to the list of attributes displayed in the search result?

Clicking onEnd of the insertion Begin of the deletion AddingEnd of the deletion a work package Begin of the insertiondismissesEnd of the insertion Begin of the deletion fromEnd of the deletion the Begin of the insertiondrop-down and adds that work package to the work package list (where the empty-state message was). A user may add links to additional work packages in the same manner.

**Actions on existing links**

The user may interact with existing links to work packages in a limited manner. They may:

* Click on the work package to open it in a newEnd of the insertion Begin of the deletion OpenProjectEnd of the deletion tab Begin of the insertion
* Right click on it and, in the context menu that appears:
* _Open in OpenProject_ (which does the same thing as clicking on the work package)
* _Delete link_, which simply removes the link with the selected work package

## Link symmetry

Adding a linkEnd of the insertion to Begin of the insertiona work package on NextCloud automatically also adds one on the OpenProject end. Doing the same on OpenProject will also automaticallyEnd of the insertion add a link Begin of the insertionhere. This symmtery is always maintained.End of the insertion

Begin of the insertionFor details on how a link should appear on OpenProject, refer to epic #40228.

## OutEnd of the insertion Begin of the deletion **OutEnd of the deletion of Begin of the insertionscopeEnd of the insertion Begin of the deletion scope**End of the deletion

* Creation of Begin of the insertionOpenProjectEnd of the insertion work packages Begin of the insertionfromEnd of the insertion inside Nextcloud
* Automatically manage permissions by actions in OpenProject. All permissions in Nextcloud are set manually.

Begin of the insertion## VisualsEnd of the insertion Begin of the deletion **Visuals**End of the deletion

Begin of the insertion_An "empty" OpenProject tab in Nextcloud_End of the insertion Begin of the deletion https://www.figma.com/file/gtLQfPe09X7XugAH8L7dTy/NextCloud-Base?node-id=24%3A3374End of the deletion

<figure class="image op-uc-figure"><div class="op-uc-figure--content"><img class="op-uc-image" Begin of the insertionsrc="/api/v3/attachments/24009/content"></div></figure>



_Searching for a work package to link to_

<figure class="image op-uc-figure"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/24010/content"></div></figure>



_Displaying work packages linked to the selected file_

<figure class="image op-uc-figure"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/24011/content"></div></figure>

## Figma prototype

[https://www.figma.com/file/gtLQfPe09X7XugAH8L7dTy/?node-id=24%3A3374](https://www.figma.com/file/gtLQfPe09X7XugAH8L7dTy/?node-id=24%3A3374)End of the insertion Begin of the deletion src="/api/v3/attachments/23951/content"></div></figure>End of the deletion