Content
Updated by Eric Schubert over 1 year ago
### Goal
The file storage module will be extended by more file storage types. The start is set with MS SharePoint and OneDrive, which will be selectable beside the currently only available type "Nextcloud". The storage representation on OpenProject site will represent the feature set, we can provide for the selected storage. This is highly dependent on the API each storage type provides.
### Acceptance criteria
* A list of criteria for new file storage integrations is created and publicly available.
* If the admin user creates a new storage, the storage types "SharePoint/OneDrive" must be selectable.
* A user must be able to browse a storage of type "SharePoint/OneDrive" from within OpenProject.
* A user must be able to link files on a storage of type "SharePoint/OneDrive" to work packages from within OpenProject.
### Check list for new storage integrations
We intend to create a check list for new storage integrations. This list should be usable to investigate any file storage and the feasibility of extending the OpenProject "File Storages" module to integrate it. Only basic functionality is part of the check list, as the current state of the Nextcloud integration includes use cases, that are very specific. The check list will contain detailed requirements regarding the following use cases.
* Authentication (one direction, OpenProject needs to authenticate against the file storage)
* File structure discoverability
* Reading file metadata
* unique file identification
* file down- and upload
### What is not included?
* this Epic no longer contains the management of the sharepoint "document workflow"
* the focus is on making sharepoint and onedrive available as file storages as they are, without the nextcloud specific use cases.
* no project folders
### Update 2023-09-18
* discussion about the impact of the upcoming integration on currently available integrations (namely Nextcloud)
* Decision was taken with the following points:
* the storage domain object inside OpenProject should stay as it is
* usage of storage objects (same for file links, project storages, etc.) should be the same regardless of provider type
* to achieve that, a `Sharepoint/OneDrive` storage needs to be created for a specific drive (also know as "Business Drive" or "Document Library")
The file storage module will be extended by more file storage types. The start is set with MS SharePoint and OneDrive, which will be selectable beside the currently only available type "Nextcloud". The storage representation on OpenProject site will represent the feature set, we can provide for the selected storage. This is highly dependent on the API each storage type provides.
### Acceptance criteria
* A list of criteria for new file storage integrations is created and publicly available.
* If the admin user creates a new storage, the storage types "SharePoint/OneDrive" must be selectable.
* A user must be able to browse a storage of type "SharePoint/OneDrive" from within OpenProject.
* A user must be able to link files on a storage of type "SharePoint/OneDrive" to work packages from within OpenProject.
### Check list for new storage integrations
We intend to create a check list for new storage integrations. This list should be usable to investigate any file storage and the feasibility of extending the OpenProject "File Storages" module to integrate it. Only basic functionality is part of the check list, as the current state of the Nextcloud integration includes use cases, that are very specific. The check list will contain detailed requirements regarding the following use cases.
* Authentication (one direction, OpenProject needs to authenticate against the file storage)
* File structure discoverability
* Reading file metadata
* unique file identification
* file down- and upload
### What is not included?
* this Epic no longer contains the management of the sharepoint "document workflow"
* the focus is on making sharepoint and onedrive available as file storages as they are, without the nextcloud specific use cases.
* no project folders
### Update 2023-09-18
* discussion about the impact of the upcoming integration on currently available integrations (namely Nextcloud)
* Decision was taken with the following points:
* the storage domain object inside OpenProject should stay as it is
* usage of storage objects (same for file links, project storages, etc.) should be the same regardless of provider type
* to achieve that, a `Sharepoint/OneDrive` storage needs to be created for a specific drive (also know as "Business Drive" or "Document Library")