Configuration

To configure this module, you need to:

1. Go to Setting > Field Swaps > Field Swaps.

2. Create a new object and set the following data as an example:

   • Name for identifying it and use it for the action name.

   • Select the source model where the swap will be started.

   • Select the starting field for which the swap will be done.

   • Add several chained fields. They are expressed as a string using dot notation, taking the source model as beginning for looking there the first field, and continuing from there drilling through. Example: picking_ids.partner_id for sale.order model will go to the linked deliveries orders, and change the customer there.

   • Add possible constraints for restricting the chained swap. They are Python expressions that must be one line that is evaluated as boolean. If the evaluation is true, then a message will be thrown and no swap will be allowed. You can use the variable records in your code, that will be referring the selected records for doing the swap. Example: for restricting sales orders that have a delivery order validated:

     any(p.state == ‘done’ for p in records.mapped(‘picking_ids.state’))

     Other variables you can use are env, date and datetime. Each constraint has a name for identifying it, but also for showing that name when displaying the error trying to do the swap.

3. Click on ‘Add action’ smart button to add a new action in the source model.

On demo databases, you can check the example “Language”, that changes the language of a contact, and propagate it to children contacts.

Usage

To use this module, you need to:

1. Go to the source document in list mode.
2. Select one or several records.
3. Click on Action and locate the option “Chained swap: <name of the swap>”.
4. If one of the selected records doesn’t comply with one of the constraints, a message will be shown, and the swap won’t continue.
5. If everything is OK, a popup will arise, and you will see a field for filling the new value.
6. Click on “Change”, and the swap will be done.
7. On the chatter of the source document, an entry will be logged for reflecting the done swap.

Bug Tracker

Bugs are tracked on GitHub 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.

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

Credits

Maintainers

This module is maintained by the OCA.

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.

This module is part of the OCA/server-ux project on GitHub.

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