Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/release/14.0' into release/14.1
Browse files Browse the repository at this point in the history
  • Loading branch information
oliverguenther committed May 21, 2024
2 parents 9326f9b + dcc6acd commit 2873824
Show file tree
Hide file tree
Showing 9 changed files with 13 additions and 3 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 11 additions & 1 deletion docs/system-admin-guide/integrations/nextcloud/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,9 @@ In the configuration page that appears, you'll see a blank text field titled **O

Click on the **Save** button.

> **Note:** If the OpenProject host cannot be added, you may check the [Troubleshooting](#troubleshooting) section at the bottom of this page
> **Note:** If the OpenProject host cannot be added, you may check the [Troubleshooting](#troubleshooting) section at the bottom of this page.
Please note, when you use the **Terms of Service** app on the Nextcloud side, all terms also need to be accepted for the OpenProject user that gets created during the setup. This is set to happen automatically during the initial set-up. If you see an error message indicating otherwise or the integration does not behave as expected, please refer to the [Troubleshooting](#troubleshooting) section at the bottom of this page.

The next part of the setup will require you to enter OpenProject OAuth values here, but before we do that, you will need to generate them in OpenProject. To do so, navigate to your OpenProject instance in a new browser tab.

Expand Down Expand Up @@ -216,6 +218,14 @@ Some administrators setup OpenProject using a self signed TLS/SSL certificate wi

Attention: Please do not confuse the CA for the Nextcloud server's certificate with the CA of the OpenProject server's certificate which you might have provided in the OpenProject installation wizard. They do not necessarily need to be the same.

#### Error message "Sign terms of services"

**Terms of services** is an app on the Nextcloud side of integration that makes it mandatory for users to accept terms of services before Nextcloud can be used. In order for the integration to work properly the OpenProject user also needs to accept all terms that are set up. It should be accepted automatically during the set up process. However, it is possible that in certain situations it does not happen automatically.


To fix this please log into Nextcloud, proceed to Administration and select OpenProject. This will trigger an automatic background check and suggest that *Terms of services* be signed.
![Fix a Terms of services error in Nextcloud](openproject_system_guide_tos_fix.png)

#### While setting up Project folders

While setting up the project folders we create a new user, group and group folder named `OpenProject`. At the time of set up the system expects either all of these entities to have been set up with proper permissions or none of them to be present. If one or more of these entities are present without required permissions, an error message will be displayed.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -149,11 +149,11 @@ In the **Details** side panel, click on the **OpenProject** tab. This tab lets y

To link this file to a work package in OpenProject for the first time, use the search bar to find the correct work package (you can search either using a word in the title of the work package, or simply enter the work package ID) and click on it.

![Search work package in Nextcloud](NC_0_01-FileRelationSearch.png)
![Search work package in Nextcloud](NC_0_01-FileRelationSearch_new.png)

This linked file will then appear underneath the search bar. Doing so will also automatically add the file to the Files tab of the corresponding work package(s) in OpenProject.

![Show linked work packages in Nextcloud](NC_1_00-FileWPRelation.png)
![Show linked work packages in Nextcloud](NC_1_00-FileWPRelation_new.png)

#### Link multiple files to a work packages

Expand Down

0 comments on commit 2873824

Please sign in to comment.