Updating docs on OneDrive/SharePoint setup (#15324)

* Updating docs on OneDrive/SharePoint setup * link fix in docs
opf · Apr 23, 2024 · 2d36b62 · 2d36b62
1 parent c9e8965
commit 2d36b62
Show file tree

Hide file tree

Showing 10 changed files with 19 additions and 3 deletions.
diff --git a/docs/system-admin-guide/integrations/one-drive/README.md b/docs/system-admin-guide/integrations/one-drive/README.md
@@ -65,12 +65,26 @@ Click the green **+Storage** button and select the OneDrive/SharePoint option.
 
 ![Add a new OneDrive/SharePoint storage to OpenProject](openproject_system_guide_new_onedrive_storage.png)
 
-A screen will open, in which you will need to add the following 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.
+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.
 
 ![Setting up a new OneDrive/SharePoint](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)
+
+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)
+
+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)
+
+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)
+
 ## Using the integration
 
 Once the [file storage is added and enabled for projects](../../../user-guide/projects/project-settings/file-storages),
@@ -90,6 +104,8 @@ information the redirect URI will get generated again and thus needs to be copie
 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 that 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](../../file-storages/file-storage-troubleshooting). 
+
 ![Edit OneDrive/SharePoint 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

diff --git a/...ntegrations/one-drive/openproject_system_guide_delete_icon_onedrive_storage.png b/...ntegrations/one-drive/openproject_system_guide_delete_icon_onedrive_storage.png
diff --git a/...ide/integrations/one-drive/openproject_system_guide_delete_onedrive_storage.png b/...ide/integrations/one-drive/openproject_system_guide_delete_onedrive_storage.png
diff --git a/...ons/one-drive/openproject_system_guide_delete_onedrive_storage_in_a_project.png b/...ons/one-drive/openproject_system_guide_delete_onedrive_storage_in_a_project.png
diff --git a/.../integrations/one-drive/openproject_system_guide_edit_icon_onedrive_storage.png b/.../integrations/one-drive/openproject_system_guide_edit_icon_onedrive_storage.png
diff --git a/...ns/one-drive/openproject_system_guide_new_onedrive_message_successful_setup.png b/...ns/one-drive/openproject_system_guide_new_onedrive_message_successful_setup.png
diff --git a/.../integrations/one-drive/openproject_system_guide_new_onedrive_storage_OAuth.png b/.../integrations/one-drive/openproject_system_guide_new_onedrive_storage_OAuth.png
diff --git a/...ve/openproject_system_guide_new_onedrive_storage_access_and_project_folders.png b/...ve/openproject_system_guide_new_onedrive_storage_access_and_project_folders.png
diff --git a/...rations/one-drive/openproject_system_guide_new_onedrive_storage_details_new.png b/...rations/one-drive/openproject_system_guide_new_onedrive_storage_details_new.png
diff --git a/...ations/one-drive/openproject_system_guide_new_onedrive_storage_redirect_URL.png b/...ations/one-drive/openproject_system_guide_new_onedrive_storage_redirect_URL.png