[18.0][IMP] server_action_mass_edit : improve Readme

server_action_mass_edit/readme/CONFIGURE.md

@@ -1,18 +1,52 @@
-- In developer mode, go to *Settings / Technical / Actions / Server Actions*
-- Create a new server action
-- Name the server action (ie. *Product Template Category Mass Editing*)
-- Choose Type *Mass Edit Records*
-- Select the model
-- Add the security groups allowed to use this action
-- Add the fields you want to be mass edited
+As a user from the access group *Administration / Settings*, in debug mode, go to *Settings / Technical / Actions / Server Actions* and create a new *Server Action.*
+![OCA Mass Editing Menu](../static/description/18-OCA_Mass_Edit_Menu.png)
 
-![Configuration](../static/description/mass_editing_form.png)
+In the field *Type,* choose the new option *Mass Edit Records*. 
+![OCA Mass Editing Type](../static/description/18-OCA_Mass_Edit_Type.png)
 
-- *Add Action*: Click on *Create Contextual Action* to add mass editing
-  in *Action* menu.
+Select the model on which you want to configure this action and give a name to your server action.
 
-**Options**
+TIP\!   
+Name your action “*Mass Edit : Object Functional Name*”   
+E.g. *Mass Edit : Contact (or Partner)*
+![OCA Mass Editing Model](../static/description/18-OCA_Mass_Edit_Model.png)
 
-- You can setup the widget option to be displayed (ie many2many_tags, selection_image...)
-- You can tick Apply Domain allowing you to limit the mass editing action with a domain.
-- You can add an extra message that will be displayed in the wizard.
+Add the fields you want to be able to edit.
+
+You can search and filter all the fields available by clicking on *Search more.*
+![OCA Mass Editing Field](../static/description/18-OCA_Mass_Edit_Field.png)
+![OCA Mass Editing Field Filter](../static/description/18-OCA_Mass_Edit_Field_Filter.png)
+
+Click on *Create Contextual Action* to add the Mass Editing action in the *Action* menu.
+![OCA Mass Editing Create Contextual Action](../static/description/18-OCA_Mass_Edit_Create_Action.png)
+
+## V11 to V13 Access
+
+### Access to the feature in V11 to V13
+
+As a user from the access group *Administration / Settings*, go to *Settings / Mass Operations / Mass Editing.*
+![OCA Mass Editing Access V11 to V13](../static/description/OCA_mass_edit_v11_v13.png)
+
+## Widget Option
+
+This option allows you to choose the widget to be used in the Mass Editing Action Window.
+![OCA Mass Editing Widget](../static/description/18-OCA_Mass_Edit_Widget.png)
+
+## Apply Domain
+
+This option allows you to apply the default Domain related to the selected field.
+![OCA Mass Editing Domain](../static/description/18-OCA_Mass_Edit_Domain.png)
+
+### Adding a Message
+
+You can add a *“Message”* to guide the users when using this action. 
+![OCA Mass Editing Message](../static/description/18-OCA_Mass_Edit_Message.png)
+
+## Adding security access group
+
+Go to the field *Allowed Groups* and add the Access Group(s) who can use this action.
+![OCA Mass Editing Security](../static/description/18-OCA_Mass_Edit_Security.png)
+![OCA Mass Editing Securtiy Groups](../static/description/18-OCA_Mass_Edit_Security_Groups.png)
+![Odoo Mass Editing Security Result](../static/description/18-OCA_Mass_Edit_Security_Result.png)
+
+Now, only users from those groups will be able to see and use this action.

server_action_mass_edit/readme/CONTEXT.md

@@ -0,0 +1,25 @@
+## Context
+
+### Difference in comparison to the Odoo Feature**
+
+Since Odoo V13, a limited *Mass Editing* feature is available in Odoo CE.
+
+In the list view, when selecting multiple records, you can edit a field. Then, the system will ask you if you want to apply those changes on all selected records.
+![Odoo Mass Editing](../static/description/18-Odoo_Mass_Edit.png)
+![Odoo Mass Editing Confirmation](../static/description/18-Odoo_Mass_Edit_Confirmation.png)
+![Odoo Mass Editing Result](../static/description/18-Odoo_Mass_edit_Result.png)
+
+This module provides the following extra features :
+
+* Mass edit *many fields* in a single action  
+* Add an access group to the *Mass Edit Action* to limit the usage of this action to specific users.  
+* Filter the records the user can mass update  
+* Mass edit any fields with any widget. (For example color fields, image fields, etc...)
+
+## Use Case
+
+It can be useful to be able to edit the value of one or more fields on multiple records at the same time easily.
+
+For example, if I want to identify some contacts as *Customers,* I need to change the value of the field `customer_rank` from 0 to 1\. This field is not visible on the form view of a *Contact* so the only way to do it (without this module) would be to export the list and import the edited file.
+
+Another example would be to give access to specific users, using access groups, to mass edit some fields on the invoices.

server_action_mass_edit/readme/DESCRIPTION.md

@@ -1,16 +1 @@
-This module allows to edit several records at the same time in any Odoo model
-
-**Difference in comparison to the Odoo Feature**
-
-Since Odoo V13, a limited "mass Editing feature" is available in Odoo
-CE.
-
-This module provides the following extra features that are not in the
-Core for the time being:
-
-- Possibility to mass edit many fields in a single action
-- Possibility to add a group to limit the usage of this function to
-  given people
-- Possibility to filter the items the user can mass update
-- Possibility to mass edit any fields with any widget. (For exemple
-  color fields, image fields, etc...)
+This module allows to edit several records at the same time in any Odoo model.