Skip to content

OpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub

[#65532] reworked wording in documentation for onedrive

Eric Schuberta3302ecd9449
diff --git a/docs/enterprise-guide/README.md b/docs/enterprise-guide/README.md
index f7274e1dddb..bddb6864777 100644
--- a/docs/enterprise-guide/README.md
+++ b/docs/enterprise-guide/README.md
@@ -34,11 +34,9 @@ However, new add-ons that will be released with 16.0.0 and afterwards in higher
The following changes to our Enterprise plans will become effective on 2025-05-21 and **apply for new customers**:
-| Community | Basic | Professional | Premium | Corporate |
-| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
-| **All [Community features](https://www.openproject.org/pricing/#features)** | **All Community features +**<br />**Basic Enterprise add-ons**:<br />- Baseline comparisons<br />- Status boards (Kanban)<br/>- Assignee boards<br/>- Version boards<br/>- Subproject boards<br/>- Parent-child boards (Work Breakdown Structure)<br/>- Attribute highlighting<br/>- Intelligent workflows with custom action buttons<br/>- Custom fields of type hierarchy<br/>- Date alerts<br/>- Custom theme and logo<br/>- Configure work package forms<br/>- Gantt charts PDF export<br/>- Graphs on project overview page<br/>- Placeholder users<br/>- Read-only mode for work packages<br/>- Team planner<br/>- Display relations in the work package table | **All from Basic +**<br />**Professional Enterprise add-ons**:<br />- Single sign-on (OIDC & SAML)<br />- OneDrive/SharePoint integration<br/>- Share work packages with external users<br/>- Automatic work package subject generation <br />- Internal work package comments | **All from Professional +**<br />**Premium Enterprise add-ons**:<br />- Share project lists (project portfolio)<br />- LDAP users and group sync<br / \- Customize project life cycle (coming with 16.1.0) | **All from Premium +**<br />**Corporate Enterprise add-ons**:<br/>- Storage single sign-on for Nextcloud<br />- Nextcloud Hub integration<br/>- openDesk integration<br/>- SCIM API integration<br/>- Antivirus scanning |
-
-
+| Community | Basic | Professional | Premium | Corporate |
+|-----------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **All [Community features](https://www.openproject.org/pricing/#features)** | **All Community features +**<br />**Basic Enterprise add-ons**:<br />- Baseline comparisons<br />- Status boards (Kanban)<br/>- Assignee boards<br/>- Version boards<br/>- Subproject boards<br/>- Parent-child boards (Work Breakdown Structure)<br/>- Attribute highlighting<br/>- Intelligent workflows with custom action buttons<br/>- Custom fields of type hierarchy<br/>- Date alerts<br/>- Custom theme and logo<br/>- Configure work package forms<br/>- Gantt charts PDF export<br/>- Graphs on project overview page<br/>- Placeholder users<br/>- Read-only mode for work packages<br/>- Team planner<br/>- Display relations in the work package table | **All from Basic +**<br />**Professional Enterprise add-ons**:<br />- Single sign-on (OIDC & SAML)<br />- OneDrive integration<br/>- Share work packages with external users<br/>- Automatic work package subject generation <br />- Internal work package comments | **All from Professional +**<br />**Premium Enterprise add-ons**:<br />- Share project lists (project portfolio)<br />- LDAP users and group sync<br / \- Customize project life cycle (coming with 16.1.0) | **All from Premium +**<br />**Corporate Enterprise add-ons**:<br/>- Storage single sign-on for Nextcloud<br />- Nextcloud Hub integration<br/>- openDesk integration<br/>- SCIM API integration<br/>- Antivirus scanning |
### Testing the new Enterprise add-ons
diff --git a/docs/glossary/README.md b/docs/glossary/README.md
index 8e17beb2bd3..492c74291bb 100644
--- a/docs/glossary/README.md
+++ b/docs/glossary/README.md
@@ -108,7 +108,10 @@ Community edition is defined as the main and free-of-charge edition of OpenProje
### Connection validation
-The connection validation in OpenProject is available for the storage integrations with [Nextcloud](#nextcloud-integration) and [OneDrive/SharePoint](#onedrivesharepoint-integration). It is a manually triggered test to check the connection between OpenProject and the respective storage. [Read more about health status checks for OpenProject's external file storages](../system-admin-guide/files/external-file-storages/health-status/).
+The connection validation in OpenProject is available for the storage integrations
+with [Nextcloud](#nextcloud-integration) and [OneDrive](#onedrive-integration). It is a manually
+triggered test to check the connection between OpenProject and the respective
+storage. [Read more about health status checks for OpenProject's external file storages](../system-admin-guide/files/external-file-storages/health-status/).
### Custom action
@@ -275,9 +278,13 @@ In OpenProject, you get in-app notifications about important changes that are re
OAuth is an open authorization standard. It allows you to access certain information or resources on behalf of a user without accessing their username and password on each individual service. OpenProject acts as an OAuth provider, allowing you to optionally grant permissions to access your data to authorized third-party applications or services. [Read more about OAuth applications in OpenProject](../system-admin-guide/authentication/oauth-applications/).
-### OneDrive/SharePoint integration
+### OneDrive integration
-OpenProject offers a OneDrive/SharePoint [integration](#integration) as an [Enterprise add-on](#enterprise-add-on). It must be setup by an administrator before members can use it. With this integration, users can link files and folders that are stored in OneDrive/SharePoint with work packages in OpenProject. They can also view, open and download files and folders linked to a work package. [Read more about OpenProject's OneDrive/SharePoint integration](../user-guide/file-management/one-drive-integration/).
+OpenProject offers a OneDrive [integration](#integration) as an [Enterprise add-on](#enterprise-add-on). It must be
+setup by an administrator before members can use it. With this integration, users can link files and folders that are
+stored in OneDrive with work packages in OpenProject. They can also view, open and download files and folders
+linked to a work
+package. [Read more about OpenProject's OneDrive integration](../user-guide/file-management/one-drive-integration/).
### On-premises
@@ -337,7 +344,9 @@ A project attribute in OpenProject is a [custom field](#custom-field) that appli
### Project folder
-Project folders help collaborating in the most efficient way. They can be used with OpenProject's [Nextcloud integration](#nextcloud-integration) or with OpenProject's [OneDrive/SharePoint integration](#onedrivesharepoint-integration). [Read more about project folders in OpenProject](../user-guide/projects/project-settings/files/#project-folders).
+Project folders help collaborating in the most efficient way. They can be used with
+OpenProject's [Nextcloud integration](#nextcloud-integration) or with
+OpenProject's [OneDrive integration](#onedrive-integration). [Read more about project folders in OpenProject](../user-guide/projects/project-settings/files/#project-folders).
### Project identifier
diff --git a/docs/security-and-privacy/processing-of-personal-data/README.md b/docs/security-and-privacy/processing-of-personal-data/README.md
index b43398b4f92..4b6b6a7641d 100644
--- a/docs/security-and-privacy/processing-of-personal-data/README.md
+++ b/docs/security-and-privacy/processing-of-personal-data/README.md
@@ -242,7 +242,7 @@ flowchart TD
direction TB
idp["Identity provider (idp)"]
nex["Nextcloud (nex)"]
- osh["OneDrive/SharePoint (osh)"]
+ osh["OneDrive (osh)"]
gih["GitHub (gih)"]
gil["GitLab (gil)"]
cal["Calendar (cal)"]
@@ -279,7 +279,12 @@ As a web application, the primary data flow is between the user's web browser (o
The external web server acts as a proxy/reverse-proxy for the OpenProject Puma app server, relaying requests for it to handle and respond. In the course of the request, access to external services such as the PostgreSQL database, a caching server, or attached storages might be performed. In case of S3-compatible object storage set ups, OpenProject performs calls to the object storage to put or request files from it. Likewise, for network-attached storages linked into the application, underlying network requests are performed. These are out of scope for this evaluation, as they are provided and maintained by the operator of the system.
-In the course of using the application, background tasks are enqueued in the database such as outgoing emails, cleanup tasks, or notification processing. These tasks are performed in a separate process, the background worker queue. This process accesses the same services as the application server process to access or modify data. It might connect to external integrations such as a [Nextcloud](../../user-guide/file-management/nextcloud-integration/) or [OneDrive/SharePoint](../../user-guide/file-management/one-drive-integration/) instance to set up file sharings depending on actions performed by the users.
+In the course of using the application, background tasks are enqueued in the database such as outgoing emails, cleanup
+tasks, or notification processing. These tasks are performed in a separate process, the background worker queue. This
+process accesses the same services as the application server process to access or modify data. It might connect to
+external integrations such as a [Nextcloud](../../user-guide/file-management/nextcloud-integration/)
+or [OneDrive](../../user-guide/file-management/one-drive-integration/) instance to set up file sharings
+depending on actions performed by the users.
**Exemplary request flow**
@@ -506,7 +511,7 @@ subgraph openproject[OpenProject]
* `nex-03` TLS
* `nex-04` TLS
-### F: OneDrive/SharePoint (osh)
+### F: OneDrive (osh)
#### Overview
@@ -525,11 +530,11 @@ flowchart LR
subgraph openproject[OpenProject]
- oponedrivetegration[OneDrive/SharePoint integration]
+ oponedrivetegration[OneDrive integration]
openprojectapi[API]
end
- subgraph onedrive[OneDrive/SharePoint]
+ subgraph onedrive[OneDrive]
appopenprojectintegration[OpenProject integration app]
onedriveapi[API]
end
@@ -537,7 +542,7 @@ subgraph openproject[OpenProject]
#### Purpose
-* Users can link files stored in OneDrive/SharePoint with work packages in OpenProject.
+* Users can link files stored in OneDrive with work packages in OpenProject.
#### Processed data
diff --git a/docs/system-admin-guide/files/README.md b/docs/system-admin-guide/files/README.md
index 93d1eccbacd..d12bca9e378 100644
--- a/docs/system-admin-guide/files/README.md
+++ b/docs/system-admin-guide/files/README.md
@@ -3,16 +3,17 @@ sidebar_navigation:
title: Files
priority: 830
description: File storages in OpenProject.
-keywords: files, file storages, Nextcloud integration, OneDrive setup, Sharepoint setup, OneDrive, Sharepoint, attachments
+keywords: files, file storages, Nextcloud integration, OneDrive setup, OneDrive, Sharepoint, attachments
---
# Files
-Under *Administration -> Files* you can add external file storages, such as Nextcloud or OneDrive/SharePoint and manage settings for attachments to work packages.
+Under *Administration -> Files* you can add external file storages, such as Nextcloud or OneDrive and manage settings
+for attachments to work packages.
## External file storages
-Under [external file storages](./external-file-storages) you can add Nextcloud or OneDrive/SharePoint integration to OpenProject.
+Under [external file storages](./external-file-storages) you can add Nextcloud or OneDrive integration to OpenProject.
## Attachments
diff --git a/docs/system-admin-guide/files/external-file-storages/README.md b/docs/system-admin-guide/files/external-file-storages/README.md
index 71c8074ef0a..4b8c7f1c1f2 100644
--- a/docs/system-admin-guide/files/external-file-storages/README.md
+++ b/docs/system-admin-guide/files/external-file-storages/README.md
@@ -3,14 +3,15 @@ sidebar_navigation:
title: File storages
priority: 990
description: File storages in OpenProject.
-keywords: file storages, Nextcloud setup, Nextcloud integration, OneDrive setup, Sharepoint setup, OneDrive, Sharepoint
+keywords: file storages, Nextcloud setup, Nextcloud integration, OneDrive setup, OneDrive, Sharepoint
---
# External file storages
-You can connect your OpenProject installation to Nextcloud or OneDrive/SharePoint. To do that navigate to **Administration** -> **Files** -> **External file storages** and select the respective option.
+You can connect your OpenProject installation to Nextcloud or OneDrive. To do that navigate to **Administration** -> *
+*Files** -> **External file storages** and select the respective option.
-You need to have administrator rights to be able to setup the integration.
+You need to have administrator rights to be able to set up the integration.
![Files storages in OpenProject administration](openproject_admin_guide_file_storages.png)
@@ -20,14 +21,18 @@ For detailed guide on the initial setup, please consult [Nextcloud integration s
For instructions on using the integration after the setup has been complete please refer to [Nextcloud integration user guide](../../../user-guide/file-management/nextcloud-integration/).
-## OneDrive/SharePoint integration (Enterprise add-on) setup guide
+## OneDrive integration (Enterprise add-on) setup guide
-> [!NOTE]
-> OneDrive/SharePoint integration is an Enterprise add-on and can only be used with [Enterprise cloud](../../../enterprise-guide/enterprise-cloud-guide/) or [Enterprise on-premises](../../../enterprise-guide/enterprise-on-premises-guide/). An upgrade from the free Community edition is easy and helps support OpenProject.
+> [!NOTE]
+> OneDrive integration is an Enterprise add-on and can only be used
+> with [Enterprise cloud](../../../enterprise-guide/enterprise-cloud-guide/)
+> or [Enterprise on-premises](../../../enterprise-guide/enterprise-on-premises-guide/). An upgrade from the free Community
+> edition is easy and helps support OpenProject.
-For detailed guide on the initial setup, please consult [OneDrive/SharePoint integration setup guide](../../integrations/one-drive/).
+For detailed guide on the initial setup, please consult [OneDrive integration setup guide](../../integrations/one-drive/).
-For instructions on using the integration after the setup has been complete please refer to [SharePoint/OneDrive integration user guide](../../../user-guide/file-management/one-drive-integration/).
+For instructions on using the integration after the setup has been complete please refer
+to [OneDrive integration user guide](../../../user-guide/file-management/one-drive-integration/).
## Health status
diff --git a/docs/system-admin-guide/files/external-file-storages/health-status/README.md b/docs/system-admin-guide/files/external-file-storages/health-status/README.md
index 236f7b0df3f..d6b29bb9591 100644
--- a/docs/system-admin-guide/files/external-file-storages/health-status/README.md
+++ b/docs/system-admin-guide/files/external-file-storages/health-status/README.md
@@ -53,9 +53,9 @@ that can happen on all files storages.
| ERR_NOT_CONFIGURED | The file storage is not fully configured. | Important data is missing, so that the file storage is labelled incomplete. | Check the input fields and fill in the missing data. |
| ERR_UNKNOWN_ERROR | An unknown error occurred. | There can be multiple reasons and the error source was not foreseen. | Errors of this kind are logged to the server logs. Look for a log entry starting with `Connection validation failed with unknown error:` |
-### Error codes specific for OneDrive/SharePoint
+### Error codes specific for OneDrive
-The following table lists the error codes of failures specific to OneDrive/SharePoint, with a description of the
+The following table lists the error codes of failures specific to OneDrive, with a description of the
possible reasons and suggested solutions.
| Error code | Error description | Possible reasons | Next steps and solutions |
@@ -126,18 +126,18 @@ error message.
Please consult the following table for possible reasons behind the errors and suggested solutions.
-| Error name | Error description | Possible reasons | Next steps and solutions |
-|--------------|-----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Error | No group specified | The name may not be specified for the storage.<br/>A glitch during setup or manual changes to the DB could cause this problem. The group name is saved in the database in the Storages Table in the providers field (JSON). | Setup the entire storage again. |
-| Error | Group does not exist | The app was activated on Nextcloud and the OpenProject group was removed afterwards.<br/>Changes on Nextcloud: OpenProject group was removed. | Manually add the group in the Nextcloud setup and call it OpenProject. Add the user OpenProject to the group OpenProject. |
-| Error | User does not exist | After the app was activated on Nextcloud and the user was removed afterwards.<br> Changes on Nextcloud: OpenProject user was removed. | Manually add the user in the Nextcloud setup and call that user OpenProject. Add the user OpenProject to the group OpenProject. <br>Alternatively reinstall the OpenProject integration app on Nextcloud. You will also need to reconfigure the Nextcloud storage. |
-| Error | Insufficient privileges | OpenProject can not change the user permissions for folders or add folders to the OpenProject folder, because the OpenProject user no longer has access to the folder. | Reinstall the OpenProject integration app on Nextcloud. You will need to reconfigure the Nextcloud storage. Make sure the OpenProject user is the admin of the OpenProject group and also the admin of the OpenProject folder. |
-| Error | Failed to remove or add user from group | A user does not exist in the file storage.<br>A user can not be removed from the OpenProject group due to admin rights. <br>This may occur when running the sync job and further information can be found in the server logs. | Ensure that the user exists in the file storage platform. <br>Remove admin rights for that user on the OpenProject group. <br>If the user is also an admin in the files storage group, he/she/they need to be removed by a file storage platform admin. |
-| Not allowed | Outbound request method not allowed | OpenProject sent wrong requests to the storage.<br>This error can occur both in Nextcloud and OneDrive/Sharepoint integration. | Report this to [OpenProject community](https://community.openproject.org/projects/openproject/forums) or [support team](https://www.openproject.org/contact/). |
-| Not found | Outbound request destination not found | OpenProject can not reach file storage platform.<br>This could be due to Storage provider being down:<br>- DNS problems <br>- Network problems (flaky network) <br>- Local networks (Nextcloud specific setting that needs to enabled) | See if you can access the file storage platform from your browser. <br>For Nextcloud, see if Nextcloud settings are active if in local network. |
-| Unauthorized | Outbound request not authorized | - Authentication is failing<br>- Application password was changed and not updated in OpenProject (Nextcloud OAuth settings are wrong or OneDrive/SharePoint client secret or ID is wrong).<br>- User has no access, can not login, no token can be negotiated.<br> Server to server: the client secret might be wrong <br> OpenProject User credentials might be wrong | Check the storages setup.<br>Check if the client secret (OneDrive/SharePoint) or the OAuth setup is correct (Nextcloud).<br>Check if the application password is correct. |
-| Conflict | *error_text_from_response* | A folder or a file was created, which already exists on the storage platform, e.g. a folder with the same name exists. <br> Can happen if for example a user manually created something on the storage platform. | Check in the storage platform if the folder already exists. |
-| Error | Outbound request failed | An unexpected 500 error, e.g. TOS (Terms of Service) app was activated and OpenProject can not access storage anymore. <br> Password configuration plugin may have caused problems. | See if file storage is working correctly. If it does, collect as much information as possible and contact [OpenProject community](https://community.openproject.org/projects/openproject/forums) or [support team](https://www.openproject.org/contact/). |
+| Error name | Error description | Possible reasons | Next steps and solutions |
+|--------------|-----------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Error | No group specified | The name may not be specified for the storage.<br/>A glitch during setup or manual changes to the DB could cause this problem. The group name is saved in the database in the Storages Table in the providers field (JSON). | Setup the entire storage again. |
+| Error | Group does not exist | The app was activated on Nextcloud and the OpenProject group was removed afterwards.<br/>Changes on Nextcloud: OpenProject group was removed. | Manually add the group in the Nextcloud setup and call it OpenProject. Add the user OpenProject to the group OpenProject. |
+| Error | User does not exist | After the app was activated on Nextcloud and the user was removed afterwards.<br> Changes on Nextcloud: OpenProject user was removed. | Manually add the user in the Nextcloud setup and call that user OpenProject. Add the user OpenProject to the group OpenProject. <br>Alternatively reinstall the OpenProject integration app on Nextcloud. You will also need to reconfigure the Nextcloud storage. |
+| Error | Insufficient privileges | OpenProject can not change the user permissions for folders or add folders to the OpenProject folder, because the OpenProject user no longer has access to the folder. | Reinstall the OpenProject integration app on Nextcloud. You will need to reconfigure the Nextcloud storage. Make sure the OpenProject user is the admin of the OpenProject group and also the admin of the OpenProject folder. |
+| Error | Failed to remove or add user from group | A user does not exist in the file storage.<br>A user can not be removed from the OpenProject group due to admin rights. <br>This may occur when running the sync job and further information can be found in the server logs. | Ensure that the user exists in the file storage platform. <br>Remove admin rights for that user on the OpenProject group. <br>If the user is also an admin in the files storage group, he/she/they need to be removed by a file storage platform admin. |
+| Not allowed | Outbound request method not allowed | OpenProject sent wrong requests to the storage.<br>This error can occur both in Nextcloud and OneDrive integration. | Report this to [OpenProject community](https://community.openproject.org/projects/openproject/forums) or [support team](https://www.openproject.org/contact/). |
+| Not found | Outbound request destination not found | OpenProject can not reach file storage platform.<br>This could be due to Storage provider being down:<br>- DNS problems <br>- Network problems (flaky network) <br>- Local networks (Nextcloud specific setting that needs to enabled) | See if you can access the file storage platform from your browser. <br>For Nextcloud, see if Nextcloud settings are active if in local network. |
+| Unauthorized | Outbound request not authorized | - Authentication is failing<br>- Application password was changed and not updated in OpenProject (Nextcloud OAuth settings are wrong or OneDrive client secret or ID is wrong).<br>- User has no access, can not login, no token can be negotiated.<br> Server to server: the client secret might be wrong <br> OpenProject User credentials might be wrong | Check the storages setup.<br>Check if the client secret (OneDrive) or the OAuth setup is correct (Nextcloud).<br>Check if the application password is correct. |
+| Conflict | *error_text_from_response* | A folder or a file was created, which already exists on the storage platform, e.g. a folder with the same name exists. <br> Can happen if for example a user manually created something on the storage platform. | Check in the storage platform if the folder already exists. |
+| Error | Outbound request failed | An unexpected 500 error, e.g. TOS (Terms of Service) app was activated and OpenProject can not access storage anymore. <br> Password configuration plugin may have caused problems. | See if file storage is working correctly. If it does, collect as much information as possible and contact [OpenProject community](https://community.openproject.org/projects/openproject/forums) or [support team](https://www.openproject.org/contact/). |
If the suggested troubleshooting solutions did not resolve your issue, please reach out to
the [OpenProject community](https://community.openproject.org/projects/openproject/forums)
diff --git a/docs/system-admin-guide/integrations/README.md b/docs/system-admin-guide/integrations/README.md
index 5e1f40a4451..beca3ca97ac 100644
--- a/docs/system-admin-guide/integrations/README.md
+++ b/docs/system-admin-guide/integrations/README.md
@@ -27,12 +27,17 @@ OpenProject offers a GitLab integration, based on the [GitLab plugin contributed
OpenProject offers integration with Nextcloud for file storage and collaboration. You can find more information about [setting up the integration with Nextcloud](./nextcloud) and [using the integration](../../user-guide/file-management/nextcloud-integration/).
-### OneDrive/SharePoint (Enterprise add-on)
+### OneDrive (Enterprise add-on)
-OpenProject offers an integration with OneDrive/Sharepoint for file storage and collaboration. You can find more information about [setting up the integration with OneDrive/SharePoint](./one-drive) and [using the integration](../../user-guide/file-management/one-drive-integration/).
+OpenProject offers an integration with OneDrive for file storage and collaboration. You can find more information
+about [setting up the integration with OneDrive](./one-drive)
+and [using the integration](../../user-guide/file-management/one-drive-integration/).
> [!NOTE]
-> OneDrive/SharePoint integration is an Enterprise add-on and can only be used with [Enterprise cloud](../../enterprise-guide/enterprise-cloud-guide/) or [Enterprise on-premises](../../enterprise-guide/enterprise-on-premises-guide/). An upgrade from the free Community edition is easy and helps support OpenProject.
+> OneDrive integration is an Enterprise add-on and can only be used
+> with [Enterprise cloud](../../enterprise-guide/enterprise-cloud-guide/)
+> or [Enterprise on-premises](../../enterprise-guide/enterprise-on-premises-guide/). An upgrade from the free Community
+> edition is easy and helps support OpenProject.
## Community plugins
diff --git a/docs/system-admin-guide/integrations/one-drive/README.md b/docs/system-admin-guide/integrations/one-drive/README.md
index 23d44c49b3d..69200772276 100644
--- a/docs/system-admin-guide/integrations/one-drive/README.md
+++ b/docs/system-admin-guide/integrations/one-drive/README.md
@@ -1,31 +1,31 @@
---
sidebar_navigation:
- title: OneDrive/SharePoint integration setup
+ title: OneDrive integration setup
priority: 601
description: Set up One Drive as a file storage in your OpenProject instance
-keywords: One Drive, SharePoint, file storage, integration
+keywords: OneDrive, SharePoint, file storage, integration
---
-# OneDrive/SharePoint (Enterprise add-on) integration setup
+# OneDrive (Enterprise add-on) integration setup
-| Topic | Description |
-|-----------------------------------------------------------------------------------------|:--------------------------------------------------------------------------|
-| [Minimum requirements](#minimum-requirements) | Minimum version requirements to enable the integration |
-| [Set up the integration](#set-up-the-integration) | Connect OpenProject and OneDrive/SharePoint instances as an administrator |
-| [Drive guide](./drive-guide) | How to configure a drive and obtain the drive id |
-| [Using the integration](#using-the-integration) | How to use the OneDrive/SharePoint integration |
-| [Edit a OneDrive/SharePoint file storage](#edit-a-onedrivesharepoint-file-storage) | Edit a OneDrive/SharePoint file storage |
-| [Delete an OneDrive/SharePoint file storage](#delete-a-onedrivesharepoint-file-storage) | Delete a OneDrive/SharePoint file storage |
+| Topic | Description |
+|--------------------------------------------------------------------|:----------------------------------------------------------------------|
+| [Minimum requirements](#minimum-requirements) | Minimum version requirements to enable the integration |
+| [Set up the integration](#set-up-the-integration) | Connect OpenProject and OneDrive instances as an administrator |
+| [Drive guide](./drive-guide) | How to configure a drive and obtain the drive id |
+| [Using the integration](#using-the-integration) | How to use the OneDrive integration |
+| [Edit a OneDrive file storage](#edit-a-onedrive-file-storage) | Edit a OneDrive file storage |
+| [Delete an OneDrive file storage](#delete-a-onedrive-file-storage) | Delete a OneDrive file storage |
> [!NOTE]
-> OneDrive/SharePoint integration is an Enterprise add-on and can only be used
+> OneDrive integration is an Enterprise add-on and can only be used
> with [Enterprise cloud](../../../enterprise-guide/enterprise-cloud-guide/)
> or [Enterprise on-premises](../../../enterprise-guide/enterprise-on-premises-guide/). An upgrade from the free
> Community edition is easy and helps support OpenProject.
-OpenProject offers an integration with OneDrive/SharePoint to allow users to:
+OpenProject offers an integration with OneDrive to allow users to:
-- Link files and folders stored in OneDrive/SharePoint with OpenProject work packages
+- Link files and folders stored in OneDrive with OpenProject work packages
- View, open and download files and folder linked to a work package via the Files tab
The goal here is to provide a *Document Library*, embedded in a SharePoint site, as a file storage system for
@@ -37,17 +37,17 @@ documentation.
> [!NOTE]
> This guide only covers the integration setup. Please go to
-> our [OneDrive/SharePoint integration user guide](../../../user-guide/file-management/nextcloud-integration/) to learn
-> more about how to work with the OneDrive/SharePoint integration.
+> our [OneDrive integration user guide](../../../user-guide/file-management/nextcloud-integration/) to learn
+> more about how to work with the OneDrive integration.
## Minimum requirements
Please note these minimum version requirements for the integration to work with a minimal feature set:
- OpenProject version 13.1 (or above)
-- Access to OneDrive/SharePoint
+- Access to OneDrive or SharePoint
-We recommend using the latest versions of both OneDrive/SharePoint and OpenProject to be able to use the latest
+We recommend using the latest versions of both OneDrive and OpenProject to be able to use the latest
features.
## Set up the integration
@@ -66,103 +66,118 @@ features.
Navigate to **System administration -> File storages**. You will see the list of all storages that have already been set
up. If no files storages have been set up yet, a banner will tell you that there are no storages yet set up.
-Click the green **+Storage** button and select the OneDrive/SharePoint option.
+Click the green **+Storage** button and select the OneDrive option.
-![Add a new OneDrive/SharePoint storage to OpenProject](openproject_system_guide_new_onedrive_storage.png)
+![Add a new OneDrive storage to OpenProject](openproject_system_guide_new_onedrive_storage.png)
-A screen will open, in which you will first need to add the **Name**, **Drive ID** and the **Directory (tenant) ID** details for your new OneDrive/SharePoint storage. Please consult your Azure administrator and the [Drive guide](./drive-guide) to obtain respective information. Be aware, that the last step includes copying generated information to the Azure portal. Enter your data and click the green *Save and continue* button.
+A screen will open, in which you will first need to add the **Name**, **Drive ID** and the **Directory (tenant) ID**
+details for your new OneDrive storage. Please consult your Azure administrator and
+the [Drive guide](./drive-guide) to obtain respective information. Be aware, that the last step includes copying
+generated information to the Azure portal. Enter your data and click the green *Save and continue* button.
-![Setting up a new OneDrive/SharePoint](openproject_system_guide_new_onedrive_storage_details_new.png)
+![Setting up a new OneDrive](openproject_system_guide_new_onedrive_storage_details_new.png)
The *Access and project folders* section of the setup will open next, where you can choose between automatically or manually managed access and folders. Choose your preferred option and click the green *Save and continue* button to proceed.
-![Access and project folders details in OneDrive/SharePoint file storages setup in OpenProject](openproject_system_guide_new_onedrive_storage_access_and_project_folders.png)
+![Access and project folders details in OneDrive file storages setup in OpenProject](openproject_system_guide_new_onedrive_storage_access_and_project_folders.png)
Continue by filling out the information for the *Azure OAuth* and once again click the green *Save and continue* button.
-![OAuth applications details in OneDrive/SharePoint file storages setup in OpenProject](openproject_system_guide_new_onedrive_storage_OAuth.png)
+![OAuth applications details in OneDrive file storages setup in OpenProject](openproject_system_guide_new_onedrive_storage_OAuth.png)
Finally, copy the *Redirect URl* and click the green *Done, complete setup* button.
-![Redirect URI details in OneDrive/SharePoint file storage setup in OpenProject](openproject_system_guide_new_onedrive_storage_redirect_URL.png)
+![Redirect URI details in OneDrive file storage setup in OpenProject](openproject_system_guide_new_onedrive_storage_redirect_URL.png)
You will see the following message confirming the successful setup on top of the page.
-![System message on successful OneDrive/SharePoint file storages setup in OpenProject](openproject_system_guide_new_onedrive_message_successful_setup.png)
+![System message on successful OneDrive file storages setup in OpenProject](openproject_system_guide_new_onedrive_message_successful_setup.png)
> [!IMPORTANT]
-> In Sharepoint you can add (custom) columns in addition to the ones shown by default (*Modified* and *Modified by*). Please keep in mind if these custom columns are added, OpenProject integration can no longer copy the automatically managed project folders. The columns will have to be de-activated, or ideally not be created in the first place.
+> In Sharepoint you can add (custom) columns in addition to the ones shown by default (*Modified* and *Modified by*).
+> Please keep in mind if these custom columns are added, OpenProject integration can no longer copy the automatically
+> managed project folders. The columns will have to be de-activated, or ideally not be created in the first place.
-## Enable OneDrive/SharePoint file storage in projects
+## Enable OneDrive file storage in projects
-Now that the integration is set up, the next step is to make the OneDrive/SharePoint file storage you just created available to individual projects. This can be either done by you directly in the system administration under **Enabled in projects** tab of a specific file storage, or on a project level under **Project settings**.
+Now that the integration is set up, the next step is to make the OneDrive file storage you just created available to
+individual projects. This can be either done by you directly in the system administration under **Enabled in projects**
+tab of a specific file storage, or on a project level under **Project settings**.
-To add a OneDrive/SharePoint to a specific project on a project level, navigate to any existing project in your OpenProject instance and click on **Project settings** -> **Files** and follow the instructions in the [Project settings user guide](../../../user-guide/projects/project-settings/files/).
+To add a OneDrive to a specific project on a project level, navigate to any existing project in your OpenProject
+instance and click on **Project settings** -> **Files** and follow the instructions in
+the [Project settings user guide](../../../user-guide/projects/project-settings/files/).
-To add a OneDrive/SharePoint storage to one or multiple projects on an instance level, click on a file storage under *Administration -> Files -> External file storages* and select **Enabled in projects** tab. You will see the list of all projects, for which the file storage was already activated. Click the **+Add projects** button.
+To add a OneDrive storage to one or multiple projects on an instance level, click on a file storage under
+*Administration -> Files -> External file storages* and select **Enabled in projects** tab. You will see the list of all
+projects, for which the file storage was already activated. Click the **+Add projects** button.
-![Add OneDrive/SharePoint file storage to projects in OpenProject administration](openproject_system_guide_file_storages_add_projects_button_onedrive.png)
+![Add OneDrive file storage to projects in OpenProject administration](openproject_system_guide_file_storages_add_projects_button_onedrive.png)
-You can you use the search bar to select either one or multiple projects and have an option of including sub-projects. Select the type of project folders for file uploads and click **Add**.
+You can you use the search bar to select either one or multiple projects and have an option of including subprojects.
+Select the type of project folders for file uploads and click **Add**.
![Select projects to activate Nextcloud storage in in OpenProject administration](openproject_system_guide_onedrive_storage_add_multiple_projects.png)
-You can always remove file storage from projects by selecting the respective option.
-
-![Remove OneDrive/SharePoint file storage from a project in OpenProject administration](openproject_system_guide_onedrive_storage_remove_projects.png)
+You can always remove file storages from projects by selecting the respective option.
+![Remove OneDrive file storage from a project in OpenProject administration](openproject_system_guide_onedrive_storage_remove_projects.png)
## Using the integration
-Once the [file storage is added and enabled for projects](../../../user-guide/projects/project-settings/files/), your users are able to take full advantage of the integration between OneDrive/SharePoint and OpenProject. For more information on how to link SharePoint files to work packages in OpenProject, please refer to
-the [OneDrive/SharePoint integration user guide](../../../user-guide/file-management/one-drive-integration).
+Once the [file storage is added and enabled for projects](../../../user-guide/projects/project-settings/files/), your
+users are able to take full advantage of the integration between OneDrive and OpenProject. For more information on how
+to link OneDrive files to work packages in OpenProject, please refer to
+the [OneDrive integration user guide](../../../user-guide/file-management/one-drive-integration).
-## Edit a OneDrive/SharePoint file storage
+## Edit a OneDrive file storage
-To edit an existing OneDrive/SharePoint file storage hover over the name of the storage you want to edit and click it.
+To edit an existing OneDrive file storage hover over the name of the storage you want to edit and click it.
-![Select OneDrive/SharePoint file storage in OpenProject system administration](openproject_system_guide_select_onedrive_storage.png)
+![Select OneDrive file storage in OpenProject system administration](openproject_system_guide_select_onedrive_storage.png)
To update the general storage information, select the **Details** tab, click the **Edit** icon next to the storage provider. To replace the Azure authentication information, click on the **Sync** icon next to the OAuth application. With changing the authentication information the redirect URI will get generated again and thus needs to be copied again. The redirect URI can be copied
by clicking on the **Copy-to-Clipboard** element next to the information text, or by entering the form by clicking the
**View** icon.
> [!TIP]
-> If you have selected automatically managed access and folders you will also see the *Health status* message on the right side. If the file storage set-up is incomplete or faulty, an error message will be displayed in that section. Read more about errors and troubleshooting [here](../../files/external-file-storages/health-status/).
+> If you have selected automatically managed access and folders you will also see the *Health status* message on the
+> right side. If the file storage set-up is incomplete or faulty, an error message will be displayed in that section. Read
+> more about errors and troubleshooting [here](../../files/external-file-storages/health-status/).
-![Edit OneDrive/SharePoint in OpenProject](openproject_system_guide_edit_icon_onedrive_storage.png)
+![Edit OneDrive in OpenProject](openproject_system_guide_edit_icon_onedrive_storage.png)
-Here you will be able to edit all of the information you have specified when creating the OneDrive/SharePoint connection
+Here you will be able to edit all the information you have specified when creating the OneDrive connection
initially.
-## Delete a OneDrive/SharePoint file storage
+## Delete a OneDrive file storage
-You can delete a OneDrive/SharePoint file storage either at a project level or at an instance-level.
+You can delete a OneDrive file storage either at a project level or at an instance-level.
Deleting a file storage at a project level simply makes it unavailable to that particular project, without affecting the
integration for other projects. Project admins can do so by navigating to **Project settings -> Files** and
clicking the **Delete** icon next to the file storage you would like to remove.
-![Delete a OneDrive/SharePoint storage from an OpenProject project](openproject_system_guide_delete_onedrive_storage_in_a_project.png)
+![Delete a OneDrive storage from an OpenProject project](openproject_system_guide_delete_onedrive_storage_in_a_project.png)
-Deleting a file storage at an instance level deletes the OneDrive/SharePoint integration completely, making it
+Deleting a file storage at an instance level deletes the OneDrive integration completely, making it
inaccessible to all projects in that instance. Should an instance administrator nevertheless want to do so, they can
navigate to **Administration -> File storages**, hover over the name of the file storage they want to remove and click
it to enter the next page. Then they need to click the **Delete** button in the top right corner.
-![Delete icon for SharePoint integration in OpenProject system settings](openproject_system_guide_delete_icon_onedrive_storage.png)
+![Delete icon for OneDrive integration in OpenProject system settings](openproject_system_guide_delete_icon_onedrive_storage.png)
You will be asked to confirm the exact file storage name.
-![Delete a SharePoint integration from OpenProject system settings](openproject_system_guide_delete_onedrive_storage.png)
+![Delete a OneDrive integration from OpenProject system settings](openproject_system_guide_delete_onedrive_storage.png)
> [!IMPORTANT]
> Deleting a file storage as an instance administrator will also delete all settings and links between
-> work packages and OneDrive/SharePoint files/folders. This means that should you want to reconnect your
-> OneDrive/SharePoint instance with OpenProject, you will need complete the entire setup process once again.
+> work packages and OneDrive files/folders. This means that should you want to reconnect your
+> OneDrive instance with OpenProject, you will need complete the entire setup process once again.
## Getting support
-If you run into any issues or you cannot setup your integration yourself please use
+If you run into any issues, or you cannot set up your integration yourself, please use
our [Support Installation & Updates forum](https://community.openproject.org/projects/openproject/forums/9) or if you
have an Enterprise subscription, please contact us at Enterprise Support.
diff --git a/docs/system-admin-guide/integrations/one-drive/drive-guide/README.md b/docs/system-admin-guide/integrations/one-drive/drive-guide/README.md
index 95338acc95c..f94a4edace8 100644
--- a/docs/system-admin-guide/integrations/one-drive/drive-guide/README.md
+++ b/docs/system-admin-guide/integrations/one-drive/drive-guide/README.md
@@ -2,17 +2,17 @@
sidebar_navigation:
title: Drive Guide
priority: 600
-description: Drive guide for OneDrive/SharePoint integration setup in OpenProject
-keywords: OneDrive/SharePoint file storage integration, OneDrive, SharePoint, DriveID, Azure, Drive ID
+description: Drive guide for OneDrive integration setup in OpenProject
+keywords: OneDrive file storage integration, OneDrive, SharePoint, DriveID, Azure, Drive ID
---
# Drive Guide
## Configure drive for automatic management
-If you need a OneDrive/SharePoint drive configured for using the "Automatically managed project folders" file storage
-option, there are some preliminary steps to take. Otherwise, if the drive will to be used in a file storage with the
-permission management still based within OneDrive/SharePoint, you should skip these steps and continue
+If you need a OneDrive drive inside a SharePoint site configured for using the "Automatically managed project folders"
+file storage option, there are some preliminary steps to take. Otherwise, if the drive will to be used in a file storage
+with the permission management still based within OneDrive, you should skip these steps and continue
with [obtaining the drive id](./#how-to-obtain-a-drive-id).
> [!IMPORTANT]
@@ -51,7 +51,7 @@ Once this is done, there should be no permissions left assigned to the document
## How to obtain a drive ID
-To configure a OneDrive/SharePoint storage you will need the drive ID of the drive you want to connect to OpenProject.
+To configure a OneDrive file storage you will need the drive ID of the drive you want to connect to OpenProject.
Usually this will be a drive within a SharePoint site or a group.
The easiest way to get this ID is by using the Microsoft GRAPH API.
@@ -81,12 +81,13 @@ GET https://graph.microsoft.com/v1.0/sites/<SITE_ID>/drives
```
This will result in a list of drives. You can select the correct drive by its `name` and take the value of the `ID`.
-With this value you can fully configure the OneDrive/SharePoint integration in OpenProject.
+With this value you can fully configure the OneDrive integration in OpenProject.
## Step-by-step guide with examples
In this section we provide a few examples, in which we demonstrate how to go through the steps mentioned above with a
specific toolset.
+
> [!NOTE]
> Following examples are explicitly written for this toolset and other mentioned preconditions, hence deviating
> from the preconditions will cause the example to deviate.
@@ -210,7 +211,7 @@ There is a way to get all necessary information by executing the web requests fr
> **IMPORTANT, please read**: Setting the API permission `Sites.Read.All` to the `Application` level imposes an
> undeniable security risk.
-If the client credentials would get leaked, any client can read sites and their content by just using those credentials.
+If the client credentials get leaked, any client can read sites and their content by just using those credentials.
It is highly recommended to remove that API permission after using this method to get the drive ID.
#### How to
@@ -228,7 +229,7 @@ curl -H "Content-Type: application/x-www-form-urlencoded" \
'https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token' | jq .access_token
```
-- The result is a valid access that is needed in the following requests.
+- The result is a valid access token that is needed in the following requests.
- Fetch the hostname of the tenant (e.g. `example.sharepoint.com`).
- Go to the SharePoint website, where the drive you want to connect can be found.
- Fetch the relative path from the browser's URL field (e.g. `/sites/mysharepointsite`).
diff --git a/docs/system-admin-guide/users-permissions/roles-permissions/README.md b/docs/system-admin-guide/users-permissions/roles-permissions/README.md
index 8bbb2dea49a..e2ece289fa4 100644
--- a/docs/system-admin-guide/users-permissions/roles-permissions/README.md
+++ b/docs/system-admin-guide/users-permissions/roles-permissions/README.md
@@ -181,9 +181,9 @@ Following are the permissions for file storages within OpenProject:
Following user permissions are set on files and folder in **External Storages**:
-- **Automatically managed folders: Read files (Nextcloud, OneDrive/SharePoint)**
+- **Automatically managed folders: Read files (Nextcloud, OneDrive)**
-- **Automatically managed folders: Write files (Nextcloud, OneDrive/SharePoint)**
+- **Automatically managed folders: Write files (Nextcloud, OneDrive)**
- **Automatically managed folders: Create files (Nextcloud)**
diff --git a/docs/user-guide/README.md b/docs/user-guide/README.md
index b11dc3c345a..e66122762ec 100644
--- a/docs/user-guide/README.md
+++ b/docs/user-guide/README.md
@@ -29,29 +29,29 @@ Within a project Modules can be activated and deactivated under "Modules" in the
Please choose the module or feature you want to learn more about.
-| Topic | Content |
-| ------------------------------------------------------------ | :----------------------------------------------------------- |
-| [Activity](activity) | How to find out about the latest activities in a project. |
-| [Backlogs (Scrum)](backlogs-scrum) | How to manage a Scrum team in OpenProject with a product backlog and taskboard. |
-| [Baseline comparison](work-packages/baseline-comparison) | View and compare changes in a work package table within a given period of time. |
-| [Boards](agile-boards) | How to work with Agile boards for agile project management, e.g. Kanban. |
-| [Budgets](budgets) | How to create and manage a project budget. |
-| [Calendar](calendar) | How to display your work in a calendar in OpenProject. |
-| [Documents](documents) | How to upload and share documents in OpenProject. |
-| [Forums](forums) | How to manage forums to discuss and comment on topics. |
-| [Gantt chart](gantt-chart) | How to create and manage a project plan in a Gantt chart. |
-| [GitHub](../system-admin-guide/integrations/github-integration/) | How to manage the GitHub integration. |
-| [GitLab](../system-admin-guide/integrations/gitlab-integration/) | How to manage the GitLab integration. |
-| [Meetings](meetings) | How to manage meetings to create and share meeting agenda and meeting outcomes. |
-| [Members](members) | How to manage Members in a project. |
-| [My time tracking](./time-and-costs/my-time-tracking) | How to manage personal time entries in list and calendar views. |
-| [News](news) | How to create and manage News for your projects. |
-| [Nextcloud integration](./file-management/nextcloud-integration) | How to link and use Nextcloud files and folders in OpenProject. |
-| [OneDrive/SharePoint integration](./file-management/one-drive-integration) | How to link and use SharePoint files and folders in OpenProject. |
-| [Projects](projects) | Edit, create, copy, delete projects and change project settings. |
-| [Project overview page](project-overview) | How to create a project overview dashboard with important project information. |
-| [Roadmap](roadmap) | How to create a product roadmap with OpenProject. |
-| [Team planner](team-planner) | How to use the team planner module. |
-| [Time and costs](time-and-costs) | How to track time and costs in OpenProject and report spent time and costs. |
-| [Wiki](wiki) | How to create and manage a wiki to collaboratively document and share information. |
-| [Work packages](work-packages) | How to manage your work in a project. |
+| Topic | Content |
+|---------------------------------------------------------------------|:-----------------------------------------------------------------------------------|
+| [Activity](activity) | How to find out about the latest activities in a project. |
+| [Backlogs (Scrum)](backlogs-scrum) | How to manage a Scrum team in OpenProject with a product backlog and taskboard. |
+| [Baseline comparison](work-packages/baseline-comparison) | View and compare changes in a work package table within a given period of time. |
+| [Boards](agile-boards) | How to work with Agile boards for agile project management, e.g. Kanban. |
+| [Budgets](budgets) | How to create and manage a project budget. |
+| [Calendar](calendar) | How to display your work in a calendar in OpenProject. |
+| [Documents](documents) | How to upload and share documents in OpenProject. |
+| [Forums](forums) | How to manage forums to discuss and comment on topics. |
+| [Gantt chart](gantt-chart) | How to create and manage a project plan in a Gantt chart. |
+| [GitHub](../system-admin-guide/integrations/github-integration/) | How to manage the GitHub integration. |
+| [GitLab](../system-admin-guide/integrations/gitlab-integration/) | How to manage the GitLab integration. |
+| [Meetings](meetings) | How to manage meetings to create and share meeting agenda and meeting outcomes. |
+| [Members](members) | How to manage Members in a project. |
+| [My time tracking](./time-and-costs/my-time-tracking) | How to manage personal time entries in list and calendar views. |
+| [News](news) | How to create and manage News for your projects. |
+| [Nextcloud integration](./file-management/nextcloud-integration) | How to link and use Nextcloud files and folders in OpenProject. |
+| [OneDrive integration](./file-management/one-drive-integration) | How to link and use OneDrive files and folders in OpenProject. |
+| [Projects](projects) | Edit, create, copy, delete projects and change project settings. |
+| [Project overview page](project-overview) | How to create a project overview dashboard with important project information. |
+| [Roadmap](roadmap) | How to create a product roadmap with OpenProject. |
+| [Team planner](team-planner) | How to use the team planner module. |
+| [Time and costs](time-and-costs) | How to track time and costs in OpenProject and report spent time and costs. |
+| [Wiki](wiki) | How to create and manage a wiki to collaboratively document and share information. |
+| [Work packages](work-packages) | How to manage your work in a project. |
diff --git a/docs/user-guide/file-management/README.md b/docs/user-guide/file-management/README.md
index bd89df0609b..c0ad7820978 100644
--- a/docs/user-guide/file-management/README.md
+++ b/docs/user-guide/file-management/README.md
@@ -8,12 +8,12 @@ keywords: files, attachment, Nextcloud, OneDrive, SharePoint
# File Management
-| Topic | Content |
-|--------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| [Manual upload](#manual-upload) | How to manually upload files to work packages in OpenProject. |
-| [Nextcloud integration](#nextcloud-integration) | How to manage files using Nextcloud integration in OpenProject. |
-| [OneDrive/SharePoint integration](#onedrivesharepoint-integration-enterprise-add-on) | How to manage files using OneDrive/Sharepoint integration in OpenProject. |
-| [File management FAQs](./file-management-faq) | Frequently asked questions on file management in OpenProject. |
+| Topic | Content |
+|-----------------------------------------------------------------|---------------------------------------------------------------------------|
+| [Manual upload](#manual-upload) | How to manually upload files to work packages in OpenProject. |
+| [Nextcloud integration](#nextcloud-integration) | How to manage files using Nextcloud integration in OpenProject. |
+| [OneDrive integration](#onedrive-integration-enterprise-add-on) | How to manage files using OneDrive integration in OpenProject. |
+| [File management FAQs](./file-management-faq) | Frequently asked questions on file management in OpenProject. |
There are several ways of adding or linking files to work packages in OpenProject. You can manually attach files directly to work packages or use one of the integrations with file management systems.
@@ -29,13 +29,16 @@ Please refer to [Nextcloud integration user guide](./nextcloud-integration) for
For the initial setup please refer to the [Nextcloud integration setup guide](../../system-admin-guide/integrations/nextcloud/).
-## OneDrive/SharePoint integration (Enterprise add-on)
+## OneDrive integration (Enterprise add-on)
-You can also use OneDrive/SharePoint integration to link OpenProject work packages directly to the files stored in your OneDrive/SharePoint repository.
+You can also use OneDrive integration to link OpenProject work packages directly to the files stored in your OneDrive repository.
> [!NOTE]
-> OneDrive/SharePoint integration is an Enterprise add-on and can only be used with [Enterprise cloud](../../enterprise-guide/enterprise-cloud-guide/) or [Enterprise on-premises](../../enterprise-guide/enterprise-on-premises-guide/). An upgrade from the free community edition is easy and helps support OpenProject.
+> OneDrive integration is an Enterprise add-on and can only be used
+> with [Enterprise cloud](../../enterprise-guide/enterprise-cloud-guide/)
+> or [Enterprise on-premises](../../enterprise-guide/enterprise-on-premises-guide/). An upgrade from the free community
+> edition is easy and helps support OpenProject.
-Please refer to [OneDrive/SharePoint integration user guide](./one-drive-integration) for further instructions on using the integration.
+Please refer to [OneDrive integration user guide](./one-drive-integration) for further instructions on using the integration.
-For the initial setup please refer to the [OneDrive/SharePoint integration setup guide](../../system-admin-guide/integrations/one-drive/).
+For the initial setup please refer to the [OneDrive integration setup guide](../../system-admin-guide/integrations/one-drive/).
diff --git a/docs/user-guide/file-management/file-management-faq/README.md b/docs/user-guide/file-management/file-management-faq/README.md
index 7302bbe58a9..b85ed431839 100644
--- a/docs/user-guide/file-management/file-management-faq/README.md
+++ b/docs/user-guide/file-management/file-management-faq/README.md
@@ -8,15 +8,16 @@ keywords: files, attachment, Nextcloud, OneDrive, SharePoint, FAQ
# File Management FAQs
-## Why am I not allowed to see/read a certain file in OneDrive/SharePoint or Nextcloud?
+## Why am I not allowed to see/read a certain file in OneDrive or Nextcloud?
It is possible that you lack the necessary permissions to view a certain file. In this case please contact your administrator.
-Another explanation may be that you have been removed from a project in OpenProject, which will also mean that you lost your viewing or reading privileges in OneDrive/SharePoint or Nextcloud project folders.
+Another explanation may be that you have been removed from a project in OpenProject, which will also mean that you lost
+your viewing or reading privileges in OneDrive or Nextcloud project folders.
It can also be that case, that a project admin revoked your permission to view files on file storages within a project in OpenProject.
-## Can I rename a project with an established file storage (Nextcloud or OneDrive/SharePoint) connection?
+## Can I rename a project with an established file storage (Nextcloud or OneDrive) connection?
Yes, that is possible. If you work with automatically managed folders, the corresponding project folder will also be renamed automatically after a few minutes.
@@ -25,8 +26,10 @@ Yes, that is possible. If you work with automatically managed folders, the corre
Yes, you can. If the file storage in your project had the automatically managed folders selected during the set-up, the folder with all files will be copied. If the file storage was added with manual managed folders, the new copy of the project will have the same file storage setup and reference the original folder without copying it. Read more about copying projects [here](../../projects/project-settings/project-information/#copy-a-project).
> [!IMPORTANT]
-> In Sharepoint you can add (custom) columns in addition to the ones shown by default (*Modified* and *Modified by*). Please keep in mind if these custom columns are added, OpenProject integration can no longer copy the automatically managed project folders. The columns will have to be de-activated, or ideally not be created in the first place.
-
+> In Sharepoint you can add (custom) columns in addition to the ones shown by default (*Modified* and *Modified by*).
+> Please keep in mind if these custom columns are added, the OpenProject OneDrive integration can no longer copy the
+> automatically managed project folders. The columns will have to be de-activated, or ideally not be created in the
+> first place.
## Is there a virus scanner for the files attachments in OpenProject?
diff --git a/docs/user-guide/projects/project-settings/files/README.md b/docs/user-guide/projects/project-settings/files/README.md
index 98f15c1a750..786b366c76e 100644
--- a/docs/user-guide/projects/project-settings/files/README.md
+++ b/docs/user-guide/projects/project-settings/files/README.md
@@ -8,21 +8,21 @@ keywords: file storages, project folder, storages
# File storages
> [!NOTE]
-> Before a storage service can be added to a project, an administrator must first set up [Nextcloud integration](../../../../system-admin-guide/integrations/nextcloud/) or [OneDrive/SharePoint integration](../../../../system-admin-guide/integrations/one-drive/) with OpenProject.
+> Before a storage service can be added to a project, an administrator must first set up [Nextcloud integration](../../../../system-admin-guide/integrations/nextcloud/) or [OneDrive integration](../../../../system-admin-guide/integrations/one-drive/) with OpenProject.
-| Topic | Description |
-| ------------------------------------------------------------ | :---------------------------------------------------------- |
-| [Files module overview](#files-module-overview) | Files module explained |
-| [Add Nextcloud storage](#add-a-nextcloud-storage-to-a-project) | Add your Nextcloud storage to a project |
-| [Nextcloud and project folders](#project-folders) | How to manage Nextcloud project folders |
-| [Edit and delete Nextcloud storage](#edit-an-existing-nextcloud-storage) | Edit and delete an existing Nextcloud storage |
-| [Add OneDrive/SharePoint storage to a project](#add-a-onedrivesharepoint-storage-to-a-project-enterprise-add-on) | Add your OneDrive/SharePoint storage to a project |
-| [Show attachments in work packages](#show-attachments-in-the-work-packages-files-tab) | Allow showing attachments under the work packages Files tab |
+| Topic | Description |
+|---------------------------------------------------------------------------------------------|:------------------------------------------------------------|
+| [Files module overview](#files-module-overview) | Files module explained |
+| [Add Nextcloud storage](#add-a-nextcloud-storage-to-a-project) | Add your Nextcloud storage to a project |
+| [Nextcloud and project folders](#project-folders) | How to manage Nextcloud project folders |
+| [Edit and delete Nextcloud storage](#edit-an-existing-nextcloud-storage) | Edit and delete an existing Nextcloud storage |
+| [Add OneDrive storage to a project](#add-a-onedrive-storage-to-a-project-enterprise-add-on) | Add your OneDrive storage to a project |
+| [Show attachments in work packages](#show-attachments-in-the-work-packages-files-tab) | Allow showing attachments under the work packages Files tab |
## Files module overview
-Under the **Files** module you will be able to manage external file storages, such as Nextcloud or OneDrive/SharePoint and manage attachments upload under *Files* tab in work packages. Navigate to **Project settings -> Files** to get here.
-
+Under the **Files** module you will be able to manage external file storages, such as Nextcloud or OneDrive and manage
+attachments upload under *Files* tab in work packages. Navigate to **Project settings -> Files** to get here.
## Add a new storage to a project
@@ -32,31 +32,50 @@ Click on **+ Storage** or the **+** icon below the table.
![List of file storages available in a project under project settings in OpenProject](file-storages-available-in-project.png)
-In the page that follows, you will be able to select one of the file storages set up by your administrator. You can select Nextcloud or OneDrive/SharePoint storages from the drop-down menu. If you only have one file storage set up (which is the most likely scenario), it should already be selected by default. Once the storage is selected click on the **Continue** button to proceed.
+In the page that follows, you will be able to select one of the file storages set up by your administrator. You can
+select Nextcloud or OneDrive file storages from the drop-down menu. If you only have one file storage set up (
+which is the most likely scenario), it should already be selected by default. Once the storage is selected click on the
+**Continue** button to proceed.
![Add a file storage to a project under project settings in OpenProject](storage-add-new.png)
-## Add a OneDrive/SharePoint storage to a project (Enterprise add-on)
+## Add a OneDrive storage to a project (Enterprise add-on)
> [!NOTE]
-> OneDrive/SharePoint integration is an Enterprise add-on and can only be used with [Enterprise cloud](../../../../enterprise-guide/enterprise-cloud-guide/) or [Enterprise on-premises](../../../../enterprise-guide/enterprise-on-premises-guide/). An upgrade from the free Community edition is easy and helps support OpenProject.
+> OneDrive integration is an Enterprise add-on and can only be used
+> with [Enterprise cloud](../../../../enterprise-guide/enterprise-cloud-guide/)
+> or [Enterprise on-premises](../../../../enterprise-guide/enterprise-on-premises-guide/). An upgrade from the free
+> Community edition is easy and helps support OpenProject.
-If you have selected the OneDrive/SharePoint option in the previous step of storage selection, you will now see the **Project folder** options.
+If you have selected the OneDrive option in the previous step of storage selection, you will now see the **Project
+folder** options.
-Here you can choose which kind of OneDrive/SharePoint project folder will be the default folder for file uploads for this project when using SharePoint integration.
+Here you can choose which kind of OneDrive project folder will be the default folder for file uploads for this project
+when using OneDrive integration.
-![Select OneDrive/SharePoint folder type in OpenProject](onedrive-storage-add-folders-new.png)
+![Select OneDrive folder type in OpenProject](onedrive-storage-add-folders-new.png)
-1. **No specific folder**: By default, each user will start at the drive root when they upload a file or select files for linking.
-2. **New folder with automatically managed permissions**: This will automatically create a folder for this project and manage the access permissions for each project member. Each project member will automatically have access to this folder according to the user permissions defined in [File storages permissions](../../../../system-admin-guide/users-permissions/roles-permissions/#permissions). This option will only be available if the system administrator has [set up the storage with automatically managed folders](../../../../system-admin-guide/integrations/one-drive/).
-3. **Existing folder with manually managed permissions**: Once you selected this option, you can designate an existing folder as the project folder for this project using the button **Select folder**. The permissions are however not automatically managed, **instead the folder and its content inherits the permissions as configured in the SharePoint site or drive**. The administrator needs to manually ensure relevant users have access. The selected folder can be used by multiple projects.
+1. **No specific folder**: By default, each user will start at the drive root when they upload a file or select files
+ for linking.
+2. **New folder with automatically managed permissions**: This will automatically create a folder for this project and
+ manage the access permissions for each project member. Each project member will automatically have access to this
+ folder according to the user permissions defined
+ in [File storages permissions](../../../../system-admin-guide/users-permissions/roles-permissions/#permissions). This
+ option will only be available if the system administrator
+ has [set up the storage with automatically managed folders](../../../../system-admin-guide/integrations/one-drive/).
+3. **Existing folder with manually managed permissions**: Once you selected this option, you can designate an existing
+ folder as the project folder for this project using the button **Select folder**. The permissions are however not
+ automatically managed, **instead the folder and its content inherits the permissions as configured in the drive or
+ the containing SharePoint site**. The administrator needs to manually ensure relevant users have access. The selected
+ folder can be used by multiple projects.
-Click on **Add** to add your new OneDrive/SharePoint file storage to this project.
+Click on **Add** to add your new OneDrive file storage to this project.
-The SharePoint file storage is now available to all work packages in this project.
+The OneDrive file storage is now available to all work packages in this project.
> [!TIP]
-> Please refer to the [OneDrive/SharePoint user guide](../../../file-management/one-drive-integration) for further instructions on using the integration at a user level.
+> Please refer to the [OneDrive user guide](../../../file-management/one-drive-integration) for further instructions on
+> using the integration at a user level.
## Add a Nextcloud storage to a project