[18.0][ADD] fs_folder: An new addon to link a folder accessed through the fsspecs library to an odoo record. #480

lmignon · 2025-06-03T11:07:39Z

If you need to link some specific models to a specific folder into an external filesystem and be able to manage the content of this folder from the model form view, the fs_folder addon is for you.

With the contribution of @etobella

…laces

* Sort char and text using locale and in a case and accent incensitive way * When soring on name, keep directory first into the list * Allows to define a comparison method into the field definition used if specified into the sort method

etobella · 2025-06-04T06:33:11Z

@lmignon on the rename, all commit history will be lost on next version. There are options to rename the history or you can just squash all commits together and add coauthors in order to simplify everything (second option is probably the easier one)

lmignon · 2025-06-04T07:25:28Z

@lmignon on the rename, all commit history will be lost on next version. There are options to rename the history or you can just squash all commits together and add coauthors in order to simplify everything (second option is probably the easier one)

No need to do it 😏; the path into the history is also renamed...

When creating a storage used to store fs folder content, disbale possible existing one created by others addons

…must return a new instance

…value

…fied This action is usefull when an action from within odoo update the content and the widget need to be refreshed

Uses the TransactionCase class in place of BaseCommon as base class for tests to avoid error when tests are run on an database where the account module is installed but not loaded into the registry. The account addon adds a required column on the res.partner model with a default value but if the module is not loaded into the registry when a res.partner record is created, the creation fails with an integrity error

The hyphen is a valid character in the name of a directory or file.

youring · 2025-08-28T09:38:33Z

Thank you for creating this very useful module! It seems very similar to Alfodoo project. Will version control be added in the future?

Tested on runboat, found two points:
If create a folder for the first time,
ValueError: No default storage found for the content of the external filesystem fields for model res.partner and field fs_folder_field. Please set a default storage in the filesystem storage configuration.
Go to FS Storage, set Odoo Filesystem Backend as Default For Fs Contents, now it's fixed.
Should this be automatically set by demo module?

It seems preview is handled by the standalone SimpleDialog method, image is not centered, with white frame, and it can't be closed with the ESC key.

And it's unable to navigate multiple files in current folder using the left and right arrow keys like Odoo core's preview.
A dumb question: for consistency, can we leverage Odoo core's preview component for attachment preview to replace SimpleDialog here?

lmignon · 2025-08-28T12:48:56Z

Thank you for creating this very useful module! It seems very similar to Alfodoo project.

Same company, same authors ...

Will version control be added in the future?

The “fs_folder” module allows you to manage content stored in file systems external to Odoo from within Odoo. In its basic version, it focuses solely on cross-functional features for all file systems supported by the Python fsspecs library, which we use as an abstraction layer for the various file systems. Document versioning is not one of these standard features and is therefore not offered. However, the module has been designed to be easily extensible. An initial specialisation offered concerns more specific support for Microsoft Drive ( and SharePoint) directories. In the latter case, the target file system offers document version management features. These could be exposed in this specific context, even if it is not currently a requirement expressed by our customers. But do we really need it into Odoo? Indeed, It's very easy for users to jump from Odoo to a specific file or directory in the Microsoft application that manages these items and benefit from these advanced features without having to complicate the implementation in Odoo.

Tested on runboat, found two points: If create a folder for the first time, ValueError: No default storage found for the content of the external filesystem fields for model res.partner and field fs_folder_field. Please set a default storage in the filesystem storage configuration. Go to FS Storage, set Odoo Filesystem Backend as Default For Fs Contents, now it's fixed. Should this be automatically set by demo module?

It could

It seems preview is handled by the standalone SimpleDialog method, image is not centered, with white frame, and it can't be closed with the ESC key. And it's unable to navigate multiple files in current folder using the left and right arrow keys like Odoo core's preview. A dumb question: for consistency, can we leverage Odoo core's preview component for attachment preview to replace SimpleDialog here?

We have not found a simple way to use the native Odoo component. The preview could be improved, and all contributions are welcome. At this stage, we are not using the basic version of the fs_folder addon; we are using the fs_folder_ms_drive addon. Nevertheless, we have taken care to design this new document management approach to make it as modular as possible. As mentioned above, fs_folder is the basic component, and although it already offers many features, some of them, such as the preview, are offered in this first draft in a simple form because they are not used in our projects (in the specialization for ms_drive, we use the preview system provided by Microsoft).

lmignon · 2025-09-14T07:28:35Z

/ocabot merge nobump

OCA-git-bot · 2025-09-14T07:28:43Z

Hey, thanks for contributing! Proceeding to merge this for you.
Prepared branch 18.0-ocabot-merge-pr-480-by-lmignon-bump-nobump, awaiting test results.

Signed-off-by lmignon

OCA-git-bot · 2025-09-14T07:34:28Z

It looks like something changed on 18.0 in the meantime.
Let me try again (no action is required from you).
Prepared branch 18.0-ocabot-merge-pr-480-by-lmignon-bump-nobump, awaiting test results.

OCA-git-bot · 2025-09-14T07:40:06Z

Congratulations, your PR was merged at 0269cb2. Thanks a lot for contributing to OCA. ❤️

lmignon and others added 30 commits March 21, 2025 17:53

[ADD] fs_field: Provides fields for filesystem contents

b199f45

[IMP] fs_field: Add api to be used by the FsFolder widget

e719215

[IMP] fs_field: Add documentation

55b1f63

[IMP] fs_field: Add cleanup method in case of rollback

1f60c60

[IMP] fs_field: Add a way to sanitize the path used to create a folder

13677c9

[FIX] fs_field: makes tests consistent from one environment to another

374c516

[IMP] fs_field: Add missing api methods

3b3b331

[FIX] fs_field: doc

3c96103

[DOC] fs_field: fix doc typos

53ce193

[FIX] fs_content: Make preview work

d5018c8

[ADD] fs_field_demo

6dad2d4

[IMP] fs_field: Add JS

59138ec

[IMP] fs_field: Pass logic to a service in order to use it in other p…

4ed72f0

…laces

[IMP] fs_field: Allow to initialize from the widget directly

6ee50d5

[FIX] fs_field_demo: Hide button

9162110

[IMP] fs_field: Improve views. Add headers

3a314d5

[FIX] fs_field: Fix upload of files

bccea60

[IMP] fs_field: Remove double components. improve buttons

1b8031d

[IMP] fs_field: Allow to rename folders & files

ccc326d

[IMP] fs_field: Improve management of icons

e467833

[IMP] fs_field: Improve table management

eb65df1

[FIX] fs_field: Make button work

9ebb372

[IMP] fs_field: Allow sort of files

ad6ebf7

[IMP] fs_field: Allow to hide columns

93fbeb8

[FIX] fs_field: Use proper names

bd0b710

[IMP] fs_field: Improve view

249c2cb

[FIX] fs_field: use onWillRender

8808b57

[IMP] fs_field: Add names. Fix directory icon

649c705

[IMP] fs_field: Use effect. initialize some states

b90e559

[IMP] fs_field: Improves sorting

2090291

* Sort char and text using locale and in a case and accent incensitive way * When soring on name, keep directory first into the list * Allows to define a comparison method into the field definition used if specified into the sort method

lmignon force-pushed the 18.0-add-fs-folder branch from 8220e6b to 2fc0260 Compare June 3, 2025 11:34

lmignon mentioned this pull request Jun 3, 2025

[18.0][ADD] fs_folder_msgraph #481

Merged

1 task

etobella approved these changes Jun 4, 2025

View reviewed changes

[IMP] fs_folder: Proper tests isolation

90de015

When creating a storage used to store fs folder content, disbale possible existing one created by others addons

lmignon force-pushed the 18.0-add-fs-folder branch from 28ec119 to 90de015 Compare June 8, 2025 09:30

lmignon added 3 commits June 10, 2025 14:23

[FIX] fs_folder: call to method initialize on FsFolderValue instance …

79bb44b

…must return a new instance

[IMP] fs_folder: Get access to the fs_storage instance from FsFolder …

78fb546

…value

[IMP] fs_folder: Allows to notify the widged when the content is modi…

72f23b5

…fied This action is usefull when an action from within odoo update the content and the widget need to be refreshed

lmignon force-pushed the 18.0-add-fs-folder branch from 69b3527 to 72f23b5 Compare June 11, 2025 10:00

lmignon mentioned this pull request Jun 11, 2025

[18.0][ADD] fs_folder_report: Store generated report in record's FsFolder field #484

Open

1 task

lmignon force-pushed the 18.0-add-fs-folder branch from 36c8f7c to c715e12 Compare June 11, 2025 15:22

lmignon force-pushed the 18.0-add-fs-folder branch from 422c0b9 to ef5d65c Compare August 27, 2025 06:43

[FIX] fs_folder: fix sanitize method

256da4b

The hyphen is a valid character in the name of a directory or file.

lmignon force-pushed the 18.0-add-fs-folder branch from ef5d65c to 256da4b Compare August 27, 2025 06:49

[IMP] fs_folder: Improve breadcrumb display

63eac44

OCA-git-bot added a commit that referenced this pull request Sep 14, 2025

Merge PR #480 into 18.0

5ecbe2e

Signed-off-by lmignon

OCA-git-bot added the bot is merging ⏳ label Sep 14, 2025

OCA-git-bot merged commit bc04134 into OCA:18.0 Sep 14, 2025
6 of 7 checks passed

OCA-git-bot added merged 🎉 and removed bot is merging ⏳ labels Sep 14, 2025

lmignon deleted the 18.0-add-fs-folder branch September 14, 2025 08:01

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

[18.0][ADD] fs_folder: An new addon to link a folder accessed through the fsspecs library to an odoo record. #480

[18.0][ADD] fs_folder: An new addon to link a folder accessed through the fsspecs library to an odoo record. #480

Uh oh!

lmignon commented Jun 3, 2025 •

edited

Loading

Uh oh!

etobella commented Jun 4, 2025

Uh oh!

lmignon commented Jun 4, 2025

Uh oh!

youring commented Aug 28, 2025

Uh oh!

lmignon commented Aug 28, 2025

Uh oh!

lmignon commented Sep 14, 2025

Uh oh!

OCA-git-bot commented Sep 14, 2025

Uh oh!

OCA-git-bot commented Sep 14, 2025

Uh oh!

Uh oh!

OCA-git-bot commented Sep 14, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

[18.0][ADD] fs_folder: An new addon to link a folder accessed through the fsspecs library to an odoo record. #480

[18.0][ADD] fs_folder: An new addon to link a folder accessed through the fsspecs library to an odoo record. #480

Uh oh!

Conversation

lmignon commented Jun 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

etobella commented Jun 4, 2025

Uh oh!

lmignon commented Jun 4, 2025

Uh oh!

youring commented Aug 28, 2025

Uh oh!

lmignon commented Aug 28, 2025

Uh oh!

lmignon commented Sep 14, 2025

Uh oh!

OCA-git-bot commented Sep 14, 2025

Uh oh!

OCA-git-bot commented Sep 14, 2025

Uh oh!

Uh oh!

OCA-git-bot commented Sep 14, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

lmignon commented Jun 3, 2025 •

edited

Loading