Metadata-Version: 2.1
Name: odoo-addon-dms_field
Version: 18.0.1.1.3
Requires-Python: >=3.10
Requires-Dist: odoo-addon-dms==18.0.*
Requires-Dist: odoo==18.0.*
Summary: Create DMS View and allow to use them inside a record
Home-page: https://github.com/OCA/dms
License: LGPL-3
Author: Creu Blanca,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)
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

=========
DMS Field
=========

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

.. |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%2Fdms-lightgray.png?logo=github
    :target: https://github.com/OCA/dms/tree/18.0/dms_field
    :alt: OCA/dms
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/dms-18-0/dms-18-0-dms_field
    :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/dms&target_branch=18.0
    :alt: Try me on Runboat

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

This addon creates a new kind of view and allows to define a folder
related to a record.

**Table of contents**

.. contents::
   :local:

Configuration
=============

To use the embedded view in any module, the module must inherit from the
mixin dms.field.mixin (You have an example with res.partner in this
module).

Once this is done, in the form view of the model we will have to add the
following:

.. code:: xml

   <field name="dms_directory_ids" mode="dms_list" />

In addition, it will be necessary to create an Embedded DMS template for
this model.

1. *Go to Documents > Configuration > Embedded DMS templates* and create
   a new record.
2. Set a storage, a model (res.partner for example) and the access
   groups you want.
3. You can also use expressions in "Directory format name", for example:
   {{object.name}}
4. Click on the "Documents" tab icon and a folder hierarchy will be
   created.
5. You can set here the hierarchy of directories, subdirectories and
   files you need, this hierarchy will be used as a base when creating a
   new record (res.partner for example).

Usage
=====

1. Go to the form view of an existing partner and click on the "DMS" tab
   icon, a hierarchy of folders and files linked to that record will be
   created.
2. Create a new partner. A hierarchy of folders and files linked to that
   record will be created.

Known issues / Roadmap
======================

- Add drag & drop compatibility to the dms_tree mode
- Multiple selection support (e.g. cut several files and paste to
  another folder).

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/dms/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/dms/issues/new?body=module:%20dms_field%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
-------

* Creu Blanca

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

- Enric Tobella <etobella@creublanca.es>

- Jaime Arroyo <jaime.arroyo@creublanca.es>

- `Tecnativa <https://www.tecnativa.com>`__:

  - Víctor Martínez
  - Carlos Roca

- `PyTech <https://www.pytech.it>`__:

  - Simone Rubino simone.rubino@pytech.it

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-CarlosRoca13| image:: https://github.com/CarlosRoca13.png?size=40px
    :target: https://github.com/CarlosRoca13
    :alt: CarlosRoca13

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

|maintainer-CarlosRoca13| 

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

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