Introduction

In this tutorial you are going to learn how to develop custom feature for shopinvader.

Shopinvader architecture is based on a REST API. The main idea is to be able to develop new feature without any frontend template. Traditional developement mix the front and the back but this is a bad practice and make slow the developpment (front dev wait for back dev and back dev wait for front dev)

To be efficient for every feature we develop we will start by writting a test ! So for developping a new feature you do not need to install wagon, locomotive. You just need Odoo, if you absolutly want to develop with wagon you really really go in the wrong way, so I will not help you ;).

Modify sale service (read information)

Imaging that you want to show an extra information on you sale order (like the state of manufacturing, the hour/date for retrieving your package…).

For the exercice we are going to add the field “custom_field” (a char field) on the sale order and add it into the API

STEP 1: First create a module for ODOO

If it’s the first time that you create an Odoo module please take a look here :

• ODOO doc: https://www.odoo.com/documentation/13.0/
• OCA GUIDELINE: https://github.com/OCA/odoo-community.org/blob/master/website/Contribution/CONTRIBUTING.rst

STEP 2: Add a test

Writing test for shopinvader is quit is the same as usual but instead of using the TransactionCase of Odoo we recommend to use the CommonCase from Shopinvader.

CommonCase class

The CommonCase class have some helper to make it simplier to test your service. You can import the class like that:

from odoo.addons.shopinvader.tests.common import CommonCase class CustomSaleServiceTest(CommonCase): def test_read_custom_field(self): pass

work_on_services helper

This helper, will return you the service wanted

Example

with self.work_on_services() as work: sale_service = work.component(usage="sales") sale_service.dispatch('get', sale_id)

If you want to pass the partner logged on the front

partner = self.env.ref("shopinvader.partner_1") with self.work_on_services(partner=partner) as work: sale_service = work.component(usage="sales") sale_service.dispatch('get', sale_id)

Now it’s your turn

Try to build the test, when you think it’s ready you can take a look at

Solution at Modify sale service. STEP 2: Add test

STEP 3: Add the feature

Modify the models

You need to add the field “custom_fields” into the model sale.order

Modify the service

You need to inherit the method _convert_one_sale of the service shopinvader.sale.service

Note: service are base on the Component module: doc code source

Inheriting the SaleService can be done like this

from odoo.addons.component.core import Component class SaleService(Component): _inherit = "shopinvader.sale.service"

Modify addresses webservice (read/write information)

Now you know how to modify a webservice let’s go futher.

We are going to add a new field on the partner and make it editable for the address service

STEP 1: Add a test

And yes again we start with the test. You need to create three test

• one for reading the information throught the webservice
• one for writing the information throught the webservice
• one for creating an address with this information throught the webservice

STEP 2: Add the feature

Now you have a working broken test let’s add the feature

• add the field on the model
• customize the address service

Add a new method on sale service

On the sale order we are going to add a new method that can be call by the web service

This method will be custom_action and will just flag the field custom_action_done on the sale order.

STEP 1: Add the test

The test should use an existing sale order and call the method custom_action by using the dispatch method.

Add an assert to check that the field custom_action_done is flag at True

STEP 2: Add the feature

Now you can edit the sale service and add the custom_action method.

Do not forget to add a validator.