Adding a monetary field to a Model
by Daniel Reis, Alexandre Fayolle, Holger Brunn
Odoo Development Cookbook
- Odoo Development Cookbook
- Table of Contents
- Odoo Development Cookbook
- Credits
- About the Authors
- About the Reviewers
- www.PacktPub.com
- Preface
- 1. Installing the Odoo Development Environment
- 2. Managing Odoo Server Instances
- 3. Creating Odoo Modules
- 4. Application Models
- Introduction
- Defining the Model representation and order
- Adding data fields to a model
- Using a float field with configurable precision
- Adding a monetary field to a Model
- Adding relational fields to a Model
- Adding a hierarchy to a Model
- Adding constraint validations to a Model
- Adding computed fields to a Model
- Exposing Related fields stored in other models
- Adding dynamic relations using Reference fields
- Adding features to a Model using inheritance
- Using Abstract Models for reusable Model features
- Using Delegation inheritance to copy features to another Model
- 5. Basic Server Side Development
- Introduction
- Defining model methods and use the API decorators
- Reporting errors to the user
- Obtaining an empty recordset for a different model
- Creating new records
- Updating values of recordset records
- Searching for records
- Combining recordsets
- Filtering recordsets
- Traversing recordset relations
- Extending the business logic defined in a Model
- Extending write() and create()
- Customizing how records are searched
- 6. Advanced Server Side Development Techniques
- 7. Debugging and Automated Testing
- Introduction
- Producing server logs to help debug methods
- Using the Odoo shell to interactively call methods
- Using the Python debugger to trace method execution
- Writing tests for your module using YAML
- Writing tests for your module using Python unit tests
- Running server tests
- Using the Odoo Community Association maintainer quality tools
- 8. Backend Views
- Introduction
- Adding a menu item and window action
- Having an action open a specific view
- Adding content and widgets to a form view
- Adding buttons to forms
- Passing parameters to forms and actions: Context
- Defining filters on record lists: Domain
- List views
- Search views
- Changing existing views: View inheritance
- Document-style forms
- Dynamic form elements using attrs
- Embedded views
- Kanban views
- Show kanban cards in columns according to their state
- Calendar views
- Graph and pivot views
- QWeb reports
- 9. Module Data
- 10. Access Security
- 11. Internationalization
- 12. Automation and Workflows
- 13. Web Server Development
- 14. CMS Website Development
- 15. Web Client Development
- 16. Server Deployment
- Index
Odoo has special support for monetary values related to a currency. Let's see how to use it in a Model.
We will reuse the my_module addon module from Chapter 3, Creating Odoo Modules.
The monetary field needs a complementary currency field to store the currency for the amounts.
The my_module already has a models/library_book.py defining a basic Model. We will edit this to add the needed fields:
- Add the field to store the currency that is to be used:
class LibraryBook(models.Model): # ... currency_id = fields.Many2one( 'res.currency', string='Currency') - Add the monetary field to store our amount:
class LibraryBook(models.Model): # ... retail_price = fields.Monetary( 'Retail Price', # optional: currency_field='currency_id', )
Now, upgrade the addon module, and the new fields should be available in the Model. They won't be visible in views until they are added to them, but we can confirm their addition by inspecting the Model fields in Settings | Technical | Database Structure | Models.
Monetary fields are similar to Float fields, but Odoo is able to represent them correctly in the user interface since it knows what their currency is through a second field for that purpose.
This currency field is expected to be named currency_id, but we can use whatever field name we like as long as it is indicated using the currency_field optional parameter. You might like to know that the decimal precision for the amount is taken from the currency definition (the decimal_precision field of the res.currency model).
-
No Comment