Metadata-Version: 2.1
Name: odoo-addon-fs_storage_ms_drive
Version: 18.0.2.0.0
Requires-Python: >=3.10
Requires-Dist: fsspec>=2025.0.0
Requires-Dist: msgraphfs
Requires-Dist: odoo-addon-fs_storage==18.0.*
Requires-Dist: odoo-addon-microsoft_drive_account==18.0.*
Requires-Dist: odoo==18.0.*
Summary: Add the microsoft drives (OneDrive, Sharepoint) as a storage backend
Home-page: https://github.com/OCA/storage
License: LGPL-3
Author: ACSONE SA/NV, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Development Status :: 4 - Beta
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

=======================================
Filesystem Storage For Microsoft Drives
=======================================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:df7785300281b10d81235b3a18890ef221f066aa37399355155535b5c82d9575
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-LGPL--3-blue.png
    :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
    :alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fstorage-lightgray.png?logo=github
    :target: https://github.com/OCA/storage/tree/18.0/fs_storage_ms_drive
    :alt: OCA/storage
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/storage-18-0/storage-18-0-fs_storage_ms_drive
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/storage&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This addon extends the functionality of the
`fs_storage <https://github.com/OCA/storage/tree/18.0/fs_storage>`__
module to allow the system to use Microsoft Drives (OneDrive,
Sharepoint) as a storage backend.

All the interactions with Microsoft SharePoint are done through the
Microsoft Graph API, which is a RESTful web API that enables you to
access Microsoft Cloud service resources. To authenticate with Microsoft
Graph, the addon uses the OAuth 2.0 protocol, which is a standard for
authorization that allows third-party applications to access user data
without exposing their credentials. All the calls are done using the
credentials of the odoo user performing the action, which means that the
user must have linked their Microsoft SharePoint account to Odoo in
order to use this addon. See the
`microsoft_drive_account <https://github.com/OCA/storage/tree/18.0/microsoft_drive_account>`__
module documentation for more information on how to link a Microsoft
Drive account to an Odoo user.

When calls are made to the Microsoft Graph API through this addon, the
addon will check if the credentials are still valid. If they are not, it
will refresh them using the refresh token that was obtained during the
initial authentication process. This means that the user does not have
to re-authenticate every time their credentials expire, as long as they
have granted permission for Odoo to refresh their credentials.

**Table of contents**

.. contents::
   :local:

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/storage/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/storage/issues/new?body=module:%20fs_storage_ms_drive%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* ACSONE SA/NV

Contributors
------------

- Laurent Mignon <laurent.mignon@acsone.eu>
- Pierre Halleux <pierre.halleux@acsone.eu>

Other credits
-------------

The development of this module has been financially supported by:

- ACSONE SA/NV

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-lmignon| image:: https://github.com/lmignon.png?size=40px
    :target: https://github.com/lmignon
    :alt: lmignon

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-lmignon| 

This module is part of the `OCA/storage <https://github.com/OCA/storage/tree/18.0/fs_storage_ms_drive>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
