diff --git a/docs/system-admin-guide/integrations/nextcloud/3_2_03-NC_Step_2.png b/docs/system-admin-guide/integrations/nextcloud/3_2_03-NC_Step_2.png deleted file mode 100644 index f12c753f44f1..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/3_2_03-NC_Step_2.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/3_2_04-NC_Step_3.png b/docs/system-admin-guide/integrations/nextcloud/3_2_04-NC_Step_3.png deleted file mode 100644 index fb2df29903e0..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/3_2_04-NC_Step_3.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/3_2_06-NC_OP_OAuth_Replace.png b/docs/system-admin-guide/integrations/nextcloud/3_2_06-NC_OP_OAuth_Replace.png deleted file mode 100644 index 59d64c6ec7a8..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/3_2_06-NC_OP_OAuth_Replace.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/3_4_03-OP_Replace_Alert.png b/docs/system-admin-guide/integrations/nextcloud/3_4_03-OP_Replace_Alert.png deleted file mode 100644 index 664f239b2a02..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/3_4_03-OP_Replace_Alert.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/OP-OAuth-values.png b/docs/system-admin-guide/integrations/nextcloud/OP-OAuth-values.png deleted file mode 100644 index e672500471a2..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/OP-OAuth-values.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/README.md b/docs/system-admin-guide/integrations/nextcloud/README.md index 005612b97461..9433fdf227b3 100644 --- a/docs/system-admin-guide/integrations/nextcloud/README.md +++ b/docs/system-admin-guide/integrations/nextcloud/README.md @@ -91,7 +91,7 @@ Navigate to your administration settings page by clicking on *your avatar in the Click on **+ Storage** to add a new file storage. -![File storages in the Administration settings](admin-file-storages.png) +![File storages in the Administration settings](openproject_system_guide_admin-file-storages.png) A new page titled **New storage** will appear, where you will be able to configure your new Nextcloud storage. @@ -134,7 +134,7 @@ Much like in the previous step, you will need to copy these two generated values ![Nextcloud also generates OAuth values that need to be copied to OpenProject](openproject_system_guide_nextcloud_integration_setup_step_5.png) -Navigate back to your OpenProject tab and click on the **Done. Continue** button on the screen you previously left it at. You will now see a screen where you will be able to enter the Nextcloud values. +Navigate back to your OpenProject tab and click on the **Done, continue** button on the screen you previously left it at. You will now see a screen where you will be able to enter the Nextcloud values. ![OpenProject_NC_OAuth_values](openproject_system_guide_nextcloud_integration_setup_step_6.png) @@ -167,7 +167,7 @@ The integration is now complete, and your OpenProject and Nextcloud instances ar Additional settings on this page also allow you, as an administrator, to define default settings for options that are available to each user. These can of course be overridden by a user to their liking: -![Admin settings to configure default settings for all users](NC_admin-defaults-user-options.png) +![Admin settings to configure default settings for all users](openproject-system_guide_admin-defaults-user-options.png) - **Enable navigation link** displays a link to the OpenProject instance in the Nextcloud header - **Enable unified search for tickets** allows users to search for OpenProject work packages via the universal search bar in Nextcloud @@ -178,7 +178,7 @@ Now that the integration is set up, the next step is to make the Nextcloud file To add a Nextcloud 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 Nextcloud storage 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. If the file storage setup was not completed properly, you will see a respective message. +To add a Nextcloud 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. If the file storage setup was not completed properly, you will see a respective message. ![Storage setup incomplete message in OprnProject file storages administration](openproject_system_guide_nextcloud_integration_setup_incomplete_message.png) @@ -192,33 +192,33 @@ You can you use the search bar to select either one or multiple projects and hav You can always edit project folders or remove file storage from projects by selecting the respective option. -![](openproject_system_guide_nextcloud_edit_remove_in_projects.png) +![Remove Nextcloud file storage from a project in OpenProject administration](openproject_system_guide_nextcloud_edit_remove_in_projects.png) > [!NOTE] > For information on how to use the file storage (link Nextcloud user accounts at a user level, link files to a work package, view and download linked files, unlink files), please read our [Nextcloud integration user guide](../../../user-guide/file-management/nextcloud-integration/). ## Reset OAuth values -If you wish to reset OAuth values for any reason, you can do so on either side by clicking on the **Reset OAuth values** button (in Nextcloud settings) or the **Replace OAuth values** button (in OpenProject admin settings). +If you wish to reset OAuth values for any reason, you can do so on either side by clicking on the **Reset OAuth values** button (in Nextcloud settings or in OpenProject admin settings) or the **Replace OAuth values** button (in OpenProject admin settings). > [!IMPORTANT] > When you reset/replace these values, you will need to update the configuration with the new OAuth credentials from the side you are resetting. This will also require all users to re-authorize OpenProject to access their Nextcloud account by logging in again. -![A dialogue asking the user to confirm they want to replace OpenProject OAuth values](3_2_06-NC_OP_OAuth_Replace.png) +![A dialogue asking the user to confirm they want to replace OpenProject OAuth values](openproject_system_guide_nextcloud_reset.png) -![A dialogue asking the user to confirm they want to replace OpenProject OAuth values](3_4_03-OP_Replace_Alert.png) +![A dialogue asking the user to confirm they want to replace OpenProject OAuth values](openproject_system_guide_nextcloud_setup_oaut_replace_alert.png) ## Delete a Nextcloud file storage You can delete a Nextcloud 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 → File storages* and clicking the **delete** icon next to the file storage you would like to remove. +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. -![Click on the delete icon next to the file storage in the project settings to remove it from the project](file-storage-list-project.png) +![Click on the delete icon next to the file storage in the project settings to remove it from the project](openproject_system_guide_nextcloud_setup_delete_storage_icon.png) -Deleting a file storage at an instance level deletes the Nextcloud integration completely and make it unaccessible to all projects in that instance. Should an instance administrator nevertheless want to do so, they navigate to *Administration → File storages* and clicking the **delete** icon next to the file storage they would like to remove. +Deleting a file storage at an instance level deletes the Nextcloud integration completely and makes it inaccessible to all projects in that instance. Should an instance administrator nevertheless want to do so, they should navigate to *Administration → File storages*, select the file storage and click the **delete** button in the upper right corner. -![Click on the delete icon next to the file storage in administration settings to delete it from this instance](file-storage-list-admin.png) +![Click on the delete icon next to the file storage in administration settings to delete it from this instance](openproject_system_guide_nextcloud_setup_delete_storage_button.png) > [!IMPORTANT] > Deleting a file storage as an instance administrator will also delete all settings and links between work packages and Nextcloud files/folders. This means that should you want to reconnect your Nextcloud instance with OpenProject, will need complete the entire setup process once again. diff --git a/docs/system-admin-guide/integrations/nextcloud/file-storage-list-admin.png b/docs/system-admin-guide/integrations/nextcloud/file-storage-list-admin.png deleted file mode 100644 index 9079756092e3..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/file-storage-list-admin.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/file-storage-list-project.png b/docs/system-admin-guide/integrations/nextcloud/file-storage-list-project.png deleted file mode 100644 index e76e1c212de9..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/file-storage-list-project.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/nc-complete_setup.png b/docs/system-admin-guide/integrations/nextcloud/nc-complete_setup.png deleted file mode 100644 index 8c34b9bf65eb..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/nc-complete_setup.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/nc-project_folders-active_default.png b/docs/system-admin-guide/integrations/nextcloud/nc-project_folders-active_default.png deleted file mode 100644 index 13058c161b3f..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/nc-project_folders-active_default.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/nc-project_folders-application_password.png b/docs/system-admin-guide/integrations/nextcloud/nc-project_folders-application_password.png deleted file mode 100644 index 1cd2232cb8c2..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/nc-project_folders-application_password.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/new-storage-admin.png b/docs/system-admin-guide/integrations/nextcloud/new-storage-admin.png deleted file mode 100644 index 249e391dfbb4..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/new-storage-admin.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/nextcloud_not_fully_set_up.png b/docs/system-admin-guide/integrations/nextcloud/nextcloud_not_fully_set_up.png deleted file mode 100644 index 2a1b10224560..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/nextcloud_not_fully_set_up.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/openproject-complete_setup.png b/docs/system-admin-guide/integrations/nextcloud/openproject-complete_setup.png deleted file mode 100644 index 06e06c412144..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/openproject-complete_setup.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/openproject-oauth.png b/docs/system-admin-guide/integrations/nextcloud/openproject-oauth.png deleted file mode 100644 index a7326fc9e5b0..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/openproject-oauth.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/openproject-project_folders-default.png b/docs/system-admin-guide/integrations/nextcloud/openproject-project_folders-default.png deleted file mode 100644 index 60554b2d5b8f..000000000000 Binary files a/docs/system-admin-guide/integrations/nextcloud/openproject-project_folders-default.png and /dev/null differ diff --git a/docs/system-admin-guide/integrations/nextcloud/NC_admin-defaults-user-options.png b/docs/system-admin-guide/integrations/nextcloud/openproject-system_guide_admin-defaults-user-options.png similarity index 100% rename from docs/system-admin-guide/integrations/nextcloud/NC_admin-defaults-user-options.png rename to docs/system-admin-guide/integrations/nextcloud/openproject-system_guide_admin-defaults-user-options.png diff --git a/docs/system-admin-guide/integrations/nextcloud/admin-file-storages.png b/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_admin-file-storages.png similarity index 100% rename from docs/system-admin-guide/integrations/nextcloud/admin-file-storages.png rename to docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_admin-file-storages.png diff --git a/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_reset.png b/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_reset.png new file mode 100644 index 000000000000..9ad36d80fe69 Binary files /dev/null and b/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_reset.png differ diff --git a/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_setup_delete_storage_button.png b/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_setup_delete_storage_button.png new file mode 100644 index 000000000000..c4696a0e86de Binary files /dev/null and b/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_setup_delete_storage_button.png differ diff --git a/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_setup_delete_storage_icon.png b/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_setup_delete_storage_icon.png new file mode 100644 index 000000000000..40c9790ce65c Binary files /dev/null and b/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_setup_delete_storage_icon.png differ diff --git a/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_setup_oaut_replace_alert.png b/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_setup_oaut_replace_alert.png new file mode 100644 index 000000000000..5eb2a571180d Binary files /dev/null and b/docs/system-admin-guide/integrations/nextcloud/openproject_system_guide_nextcloud_setup_oaut_replace_alert.png differ diff --git a/docs/system-admin-guide/integrations/one-drive/README.md b/docs/system-admin-guide/integrations/one-drive/README.md index b326abd5feac..23d44c49b3db 100644 --- a/docs/system-admin-guide/integrations/one-drive/README.md +++ b/docs/system-admin-guide/integrations/one-drive/README.md @@ -93,11 +93,28 @@ You will see the following message confirming the successful setup on top of the > [!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. +## Enable OneDrive/SharePoint 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**. + +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/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. + +![Add OneDrive/SharePoint 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**. + +![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) + + ## 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 +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). ## Edit a OneDrive/SharePoint file storage @@ -106,16 +123,12 @@ To edit an existing OneDrive/SharePoint file storage hover over the name of the ![Select OneDrive/SharePoint file storage in OpenProject system administration](openproject_system_guide_select_onedrive_storage.png) -To update the general storage information, 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 +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. -**Note**: 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/). +> [!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/). ![Edit OneDrive/SharePoint in OpenProject](openproject_system_guide_edit_icon_onedrive_storage.png) @@ -127,7 +140,7 @@ initially. You can delete a OneDrive/SharePoint 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 -> File storages** and +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) diff --git a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_delete_icon_onedrive_storage.png b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_delete_icon_onedrive_storage.png index a1698b22d701..29061fd09ac7 100644 Binary files a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_delete_icon_onedrive_storage.png and b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_delete_icon_onedrive_storage.png differ diff --git a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_delete_onedrive_storage_in_a_project.png b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_delete_onedrive_storage_in_a_project.png index 7f52ba27956d..8db266833914 100644 Binary files a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_delete_onedrive_storage_in_a_project.png and b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_delete_onedrive_storage_in_a_project.png differ diff --git a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_edit_icon_onedrive_storage.png b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_edit_icon_onedrive_storage.png index 50b5a3dc2799..06bcd6792f82 100644 Binary files a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_edit_icon_onedrive_storage.png and b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_edit_icon_onedrive_storage.png differ diff --git a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_file_storages_add_projects_button_onedrive.png b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_file_storages_add_projects_button_onedrive.png new file mode 100644 index 000000000000..c25c721c68a0 Binary files /dev/null and b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_file_storages_add_projects_button_onedrive.png differ diff --git a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_onedrive_storage_add_multiple_projects.png b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_onedrive_storage_add_multiple_projects.png new file mode 100644 index 000000000000..3d7c2b710666 Binary files /dev/null and b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_onedrive_storage_add_multiple_projects.png differ diff --git a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_onedrive_storage_remove_projects.png b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_onedrive_storage_remove_projects.png new file mode 100644 index 000000000000..1cff0c50c505 Binary files /dev/null and b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_onedrive_storage_remove_projects.png differ diff --git a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_select_onedrive_storage.png b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_select_onedrive_storage.png index d1669634105e..0a9d3ff804f9 100644 Binary files a/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_select_onedrive_storage.png and b/docs/system-admin-guide/integrations/one-drive/openproject_system_guide_select_onedrive_storage.png differ