Odoo Upgrade Assistant v4.0

A comprehensive skill for upgrading Odoo modules between versions, with extensive pattern recognition, automated fixes, and deep integration with Odoo's architecture for common migration issues.

Version Compatibility Matrix

Odoo Version	Python	PostgreSQL	Bootstrap	Owl	Status
14.0	3.7-3.10	13+	4.5.0	experimental	Legacy
15.0	3.8-3.11	13+	5.0.2	experimental	Legacy
16.0	3.9-3.12	13+	5.1.3	v1	Stable
17.0	3.10-3.13	13+	5.1.3	v1	Active
18.0	3.10-3.13	13+	5.1.3	v2	Active
19.0	3.10-3.13	13+	5.1.3	v2	Latest

When to Use This Skill

Activate this skill when:

• User requests upgrading Odoo modules between versions (14→19)
• Fixing Odoo version compatibility errors
• Migrating themes or custom modules to newer versions
• Resolving RPC service errors in frontend components
• Converting XML views for newer Odoo versions (tree→list, search groups)
• Updating SCSS variables for Odoo 18/19 themes
• Fixing portal view XPath inheritance errors
• Updating mail template helper functions
• Migrating JavaScript from Owl v1 to v2

Upgrade Workflow

1. Initial Analysis

# Analyze source module structure
- Check __manifest__.py version
- Identify module dependencies
- List all file types (XML, Python, JS, SCSS)
- Create backup before changes

2. Manifest Updates

Standard Manifest Fields (Odoo 19 TaqaTechno Standard)

{
    'name': 'Module Display Name',
    'version': '19.0.1.0.0',          # Format: ODOO_VERSION.MAJOR.MINOR.PATCH
    'summary': 'Brief description',
    'category': 'Category Name',
    'author': 'TaqaTechno',            # REQUIRED for Odoo 19
    'website': 'https://www.taqatechno.com/',  # REQUIRED
    'support': 'support@example.com',  # REQUIRED
    'license': 'LGPL-3',               # REQUIRED
    'contributors': [                   # Names only, NO emails
        'Developer Name',
    ],
    'depends': ['base', 'other_module'],
    'data': [
        'security/group_*.xml',        # User groups first
        'security/ir.model.access.csv', # Model access
        'security/rules_*.xml',        # Record rules
        'views/*.xml',                 # UI views
        'data/*.xml',                  # Default data
    ],
    'assets': {
        'web.assets_frontend': [
            'module_name/static/src/js/*.js',
            'module_name/static/src/scss/*.scss',
        ],
        'web._assets_primary_variables': [
            'module_name/static/src/scss/primary_variables.scss',
        ],
        'web._assets_frontend_helpers': [
            'module_name/static/src/scss/bootstrap_overridden.scss',
        ],
    },
    'installable': True,
    'auto_install': False,
    'application': False,
}

Version String Migration

# Odoo 14: '14.0.1.0.0'
# Odoo 15: '15.0.1.0.0'
# Odoo 16: '16.0.1.0.0'
# Odoo 17: '17.0.1.0.0'
# Odoo 18: '18.0.1.0.0'
# Odoo 19: '19.0.1.0.0'

3. XML/View Transformations

Search Views (Odoo 19)

<!-- BEFORE (Invalid in Odoo 19) -->
<search>
    <group expand="0" string="Group By">
        <filter name="type" string="Type"/>
    </group>
</search>

<!-- AFTER (Valid in Odoo 19) -->
<search>
    <filter name="type" string="Type"/>
</search>

Tree to List Views (Comprehensive)

<!-- 1. View Template Tags -->
<!-- BEFORE -->
<tree string="Title" edit="1" editable="top">
    <field name="name"/>
</tree>

<!-- AFTER -->
<list string="Title" editable="top">
    <field name="name"/>
</list>

<!-- 2. Action Window view_mode -->
<!-- BEFORE -->
<record id="action_my_model" model="ir.actions.act_window">
    <field name="view_mode">tree,form,kanban</field>
</record>

<!-- AFTER -->
<record id="action_my_model" model="ir.actions.act_window">
    <field name="view_mode">list,form,kanban</field>
</record>

<!-- 3. XPath Expressions (CRITICAL for Odoo 18/19) -->
<!-- BEFORE -->
<xpath expr="//tree" position="inside">
    <field name="new_field"/>
</xpath>
<xpath expr="//tree/field[@name='name']" position="after">
    <field name="other_field"/>
</xpath>

<!-- AFTER -->
<xpath expr="//list" position="inside">
    <field name="new_field"/>
</xpath>
<xpath expr="//list/field[@name='name']" position="after">
    <field name="other_field"/>
</xpath>

<!-- 4. Search View Group expand Attribute (Deprecated) -->
<!-- BEFORE -->
<group expand="0" string="Group By">
    <filter name="group_status" context="{'group_by': 'state'}"/>
</group>

<!-- AFTER -->
<group string="Group By">
    <filter name="group_status" context="{'group_by': 'state'}"/>
</group>

Python view_mode Dictionary (Odoo 18/19)

# BEFORE
def action_view_records(self):
    return {
        'type': 'ir.actions.act_window',
        'res_model': 'my.model',
        'view_mode': 'tree,form',
        'view_type': 'tree',  # Deprecated parameter
    }

# AFTER
def action_view_records(self):
    return {
        'type': 'ir.actions.act_window',
        'res_model': 'my.model',
        'view_mode': 'list,form',
        # view_type parameter removed
    }

Kanban Templates (Odoo 19)

<!-- BEFORE -->
<t t-name="kanban-box">

<!-- AFTER -->
<t t-name="card">

Form View Context (Odoo 19)

<!-- BEFORE -->
context="{'search_default_type_id': active_id}"

<!-- AFTER -->
context="{'search_default_type_id': id}"

Cron Jobs (Odoo 19)

Remove numbercall field - no longer supported:

<!-- Remove this line -->
<field name="numbercall">-1</field>

4. Python API Migrations

Slug Function (Odoo 18+)

# Add compatibility wrapper
from odoo.http import request

def slug(value):
    """Compatibility wrapper for slug function"""
    return request.env['ir.http']._slug(value)

def unslug(value):
    """Compatibility wrapper for unslug function"""
    return request.env['ir.http']._unslug(value)

URL For Function (Odoo 19)

# BEFORE
from odoo.addons.http_routing.models.ir_http import url_for
url = url_for('/path')

# AFTER
url = self.env['ir.http']._url_for('/path')

5. JavaScript/OWL Frontend Migrations

RPC Service Replacement (Odoo 19)

The RPC service is NOT available in Odoo 19 frontend/public components.

/** @odoo-module **/

// BEFORE (Odoo 17)
import {useService} from "@web/core/utils/hooks";

export class MyComponent extends Component {
    setup() {
        this.rpc = useService("rpc");
    }

    async fetchData() {
        const data = await this.rpc("/api/endpoint", params);
    }
}

// AFTER (Odoo 19)
export class MyComponent extends Component {
    setup() {
        // RPC service removed - using fetch instead
    }

    async _jsonRpc(endpoint, params = {}) {
        try {
            const response = await fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json',
                    'X-Csrf-Token': document.querySelector('meta[name="csrf-token"]')?.content || '',
                },
                body: JSON.stringify({
                    jsonrpc: "2.0",
                    method: "call",
                    params: params,
                    id: Math.floor(Math.random() * 1000000)
                })
            });

            if (!response.ok) {
                throw new Error(`HTTP error! status: ${response.status}`);
            }

            const data = await response.json();
            if (data.error) {
                throw new Error(data.error.message || 'RPC call failed');
            }
            return data.result;
        } catch (error) {
            console.error('JSON-RPC call failed:', error);
            throw error;
        }
    }

    async fetchData() {
        const data = await this._jsonRpc("/api/endpoint", params);
    }
}

OWL 1.x → OWL 2.0 Lifecycle Hook Migration (Odoo 18+)

OWL 2.0 (used in Odoo 18+) renames all lifecycle hooks and changes the constructor signature. This is a breaking change — old method names simply won't be called.

Lifecycle Hook Rename Table:

OWL 1.x (Odoo 14-17)	OWL 2.0 (Odoo 18-19)	Notes
constructor(parent, props)	setup()	No super() needed
willStart()	onWillStart(callback)	Now uses onWillStart hook function
mounted()	onMounted(callback)	Now uses onMounted hook function
willUpdateProps(nextProps)	onWillUpdateProps(callback)	Callback receives nextProps
patched()	onPatched(callback)	Now uses onPatched hook function
willUnmount()	onWillUnmount(callback)	Now uses onWillUnmount hook function
willPatch()	onWillPatch(callback)	Now uses onWillPatch hook function
destroyed()	onDestroyed(callback)	Now uses onDestroyed hook function

Before (OWL 1.x — Odoo 14-17):

/** @odoo-module **/
import { Component } from "@odoo/owl";

export class MyWidget extends Component {
    constructor(parent, props) {
        super(...arguments);
        this.state = { count: 0 };
    }

    async willStart() {
        this.data = await this._loadData();
    }

    mounted() {
        this._setupListeners();
    }

    patched() {
        this._updateDOM();
    }

    willUnmount() {
        this._cleanupListeners();
    }
}

After (OWL 2.0 — Odoo 18-19):

/** @odoo-module **/
import { Component, onMounted, onPatched, onWillStart, onWillUnmount, useState } from "@odoo/owl";

export class MyWidget extends Component {
    setup() {
        // useState replaces this.state = {}
        this.state = useState({ count: 0 });

        onWillStart(async () => {
            this.data = await this._loadData();
        });

        onMounted(() => {
            this._setupListeners();
        });

        onPatched(() => {
            this._updateDOM();
        });

        onWillUnmount(() => {
            this._cleanupListeners();
        });
    }
}

Key OWL 2.0 Import Changes:

// OLD — OWL 1.x
import { Component } from "@odoo/owl";

// NEW — OWL 2.0 (import hooks explicitly)
import {
    Component,
    useState,
    useRef,
    useEnv,
    onMounted,
    onPatched,
    onWillStart,
    onWillUpdateProps,
    onWillPatch,
    onWillUnmount,
    onDestroyed,
} from "@odoo/owl";

Auto-fix command:

python scripts/auto_fix_library.py --fix owl_lifecycle <project_path>

Detection command:

python scripts/odoo19_precheck.py <project_path>
# Look for: [HIGH] OWL 1.x lifecycle methods found

6. Theme SCSS Variables (Odoo 19)

Proper Structure

// ===================================================================
// Theme Name - Primary Variables
// ===================================================================

// Typography Hierarchy
$o-theme-h1-font-size-multiplier: (64 / 16);
$o-theme-headings-font-weight: 700;  // NOT $headings-font-weight

// Website Values Palette
$o-website-values-palettes: (
    (
        'color-palettes-name': 'my_theme',
        'font': 'Inter',
        'headings-font': 'Inter',
        'btn-padding-y': 1rem,  // Use rem not px
        'btn-padding-x': 2rem,
    ),
);

// Color Palette with menu/footer assignments
$o-color-palettes: map-merge($o-color-palettes, (
    'my_theme': (
        'o-color-1': #124F81,
        'o-color-2': #B1025D,
        'o-color-3': #f8fafc,
        'o-color-4': #ffffff,
        'o-color-5': #1e293b,
        'menu': 1,        // IMPORTANT: Specify which color for menu
        'footer': 4,      // IMPORTANT: Specify which color for footer
        'copyright': 5,   // IMPORTANT: Specify which color for copyright
    ),
));

// Font Configuration (use map-merge!)
$o-theme-font-configs: map-merge($o-theme-font-configs, (
    'Inter': (
        'family': ('Inter', sans-serif),
        'url': 'Inter:300,400,500,600,700&display=swap',
        'properties': (  // IMPORTANT: Add properties section
            'base': (
                'font-size-base': 1rem,
                'line-height-base': 1.6,
            ),
        )
    ),
));

7. Theme Snippet System (Odoo 19)

Remove incompatible website.snippet_options inheritance:

<!-- REMOVE this template - not compatible with Odoo 19 -->
<template id="custom_footer_op" inherit_id="website.snippet_options">
    <!-- Snippet options content -->
</template>

Common Errors and Solutions

Error: "Service rpc is not available"

• Cause: Using useService("rpc") in frontend components
• Solution: Replace with _jsonRpc helper method using fetch API

Error: "Invalid field 'numbercall' in 'ir.cron'"

• Cause: Field removed in Odoo 19
• Solution: Remove <field name="numbercall"> from cron definitions

Error: "Invalid view definition" (search views)

• Cause: <group> tags not allowed in search views (Odoo 19)
• Solution: Remove <group> tags, keep filters at root level

Error: "Missing 'card' template"

• Cause: Kanban template name changed in Odoo 19
• Solution: Change t-name="kanban-box" to t-name="card"

Error: "cannot import name 'slug'"

• Cause: Import location changed in Odoo 18+
• Solution: Add compatibility wrapper function

Error: "External ID not found: website.snippet_options"

• Cause: Snippet system changed in Odoo 19
• Solution: Remove the incompatible template

Error: "field 'active_id' does not exist"

• Cause: active_id not available in form view contexts (Odoo 19)
• Solution: Replace active_id with id

Testing Checklist

After upgrade, test:

• Module installation without errors
• All views load correctly
• JavaScript components function
• Theme displays properly
• API endpoints respond
• Cron jobs execute
• Search/filter functionality
• Form submissions work
• Reports generate correctly

Helper Commands

# Install upgraded module
python -m odoo -d [DB] -i [MODULE] --addons-path=odoo/addons,projects/[PROJECT] --stop-after-init

# Update module after changes
python -m odoo -d [DB] -u [MODULE] --stop-after-init

# Run with development mode for debugging
python -m odoo -d [DB] --dev=xml,css,js

# Install Python dependencies
pip install geopy spacy hachoir

Migration Report Template

Generate comprehensive reports documenting:

• Files modified count
• Lines changed
• Patterns applied
• Manual fixes needed
• External dependencies added
• Testing status
• Known issues
• Rollback instructions

Advanced Patterns

Multi-Module Projects

When upgrading projects with multiple interdependent modules:

1. Analyze dependency tree
2. Upgrade in dependency order
3. Test each module individually
4. Test integrated functionality

Theme Migrations

Special considerations for themes:

1. SCSS variable structure changes
2. Bootstrap version compatibility
3. Snippet system updates
4. Asset bundling changes

Performance Optimization

After upgrade:

1. Regenerate assets
2. Clear caches
3. Recompile Python files
4. Optimize database indexes

Version-Specific Notes

Odoo 14 → 15

• Bootstrap 4.x → 5.x (major CSS class changes)
• QWeb syntax: t-use-call removed, use t-call
• Payment Provider API changes
• Left/Right classes → Start/End for RTL support

Odoo 15 → 16

• Bootstrap 5.1.3 standardization
• Web framework module reorganization
• Website page template changes
• Payment flow updates
• Owl v1 adoption begins

Odoo 16 → 17

• OWL framework v1 fully adopted
• Widget system changes
• Asset pipeline updates
• publicWidget API stabilization
• Theme color palette improvements

Odoo 17 → 18

• Owl v1 → v2 migration starts
• Minor XML changes
• Python API mostly compatible
• JavaScript minor updates
• Snippet group system introduced

Odoo 18 → 19

• Major frontend architecture changes
• RPC service REMOVED from public components
• Snippet system overhaul (groups required)
• Kanban template: kanban-box → card
• Search view: <group> tags NOT allowed
• <tree> views → <list> views
• XPath expressions: //tree → //list
• Portal view templates completely restructured
• Mail template helpers: remove env parameter
• Cron jobs: numbercall field removed

Security Implementation (Required for All Versions)

1. Model Access (ir.model.access.csv)

id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
access_my_model_user,my.model.user,model_my_model,base.group_user,1,1,1,0
access_my_model_admin,my.model.admin,model_my_model,base.group_erp_manager,1,1,1,1

2. User Groups (security/group_*.xml)

<record id="group_my_manager" model="res.groups">
    <field name="name">My Manager</field>
    <field name="category_id" ref="base.module_category_services"/>
    <field name="implied_ids" eval="[(4, ref('base.group_user'))]"/>
</record>

3. Record Rules (security/rules_*.xml)

<record id="my_model_rule" model="ir.rule">
    <field name="name">My Model: User own records</field>
    <field name="model_id" ref="model_my_model"/>
    <field name="domain_force">[('user_id', '=', user.id)]</field>
    <field name="groups" eval="[(4, ref('base.group_user'))]"/>
    <field name="perm_read" eval="True"/>
    <field name="perm_write" eval="True"/>
    <field name="perm_create" eval="True"/>
    <field name="perm_unlink" eval="False"/>
</record>

Portal View XPath Migration (Odoo 19)

Sale Portal Template Changes

The sale portal templates have been completely restructured in Odoo 19:

Table Header XPaths

<!-- BEFORE (Odoo 17/18) - Positional selectors -->
<xpath expr="//table[@id='sales_order_table']/thead/tr/th[3]" position="attributes">

<!-- AFTER (Odoo 19) - Named element selectors -->
<xpath expr="//table[@id='sales_order_table']/thead/tr/th[@id='product_unit_price_header']" position="attributes">

Available Header IDs:

• th[@id='product_qty_header'] - Quantity
• th[@id='product_unit_price_header'] - Unit Price
• th[@id='product_discount_header'] - Discount %
• th[@id='taxes_header'] - Taxes
• th[@id='subtotal_header'] - Amount/Subtotal

Table Body XPaths

<!-- BEFORE (Odoo 17/18) -->
<xpath expr="//table[@id='sales_order_table']/tbody//t[@t-foreach='lines_to_report']//tr/t[@t-if='not line.display_type']/td[3]" position="attributes">

<!-- AFTER (Odoo 19) -->
<xpath expr="//table[@id='sales_order_table']/tbody//tr[@name='tr_product']/td[@name='td_product_priceunit']" position="attributes">

Available Body Element Names:

• tr[@name='tr_product'] - Product row
• tr[@name='tr_section'] - Section row
• tr[@name='tr_note'] - Note row
• td[@name='td_product_name'] - Product name
• td[@name='td_product_quantity'] - Quantity
• td[@name='td_product_priceunit'] - Unit price
• td[@name='td_product_discount'] - Discount %
• td[@name='td_product_taxes'] - Taxes
• td[@name='td_product_subtotal'] - Subtotal

Mail Template Migration (Odoo 19)

Helper Function Changes

<!-- BEFORE (Odoo 17/18) - FAILS in Odoo 19 -->
<t t-out="format_datetime(env, object.date_start, dt_format='long')"/>
<t t-out="format_date(env, object.date_start)"/>
<t t-out="format_amount(env, object.amount, object.currency_id)"/>

<!-- AFTER (Odoo 19) - Remove env parameter -->
<t t-out="format_datetime(object.date_start, dt_format='long')"/>
<t t-out="format_date(object.date_start)"/>
<t t-out="format_amount(object.amount, object.currency_id)"/>

XML Entity Encoding

<!-- BEFORE - HTML entities (FAILS in XML) -->
<p>&copy; 2025 Company Name</p>
<p>Company&nbsp;Name</p>

<!-- AFTER - Numeric character references -->
<p>&#169; 2025 Company Name</p>
<p>Company&#160;Name</p>

Common Character Codes:

• © → © (copyright)
• →   (non-breaking space)
• — → — (em dash)
• ™ → ™ (trademark)
• € → € (euro)

Bootstrap 4 → 5 Class Migration

Bootstrap 4	Bootstrap 5	Description
ml-*	ms-*	Margin Left → Start
mr-*	me-*	Margin Right → End
pl-*	ps-*	Padding Left → Start
pr-*	pe-*	Padding Right → End
text-left	text-start	Text align left
text-right	text-end	Text align right
float-left	float-start	Float left
float-right	float-end	Float right
form-group	mb-3	Form group spacing
custom-select	form-select	Custom select
close	btn-close	Close button
badge-primary	bg-primary	Primary badge
font-weight-bold	fw-bold	Bold text
sr-only	visually-hidden	Screen reader only
no-gutters	g-0	No gutters in grid

Helper Commands

# Pre-check for compatibility issues
python scripts/odoo19_precheck.py <project_path>

# Quick targeted fixes
python scripts/quick_fix_odoo19.py <project_path>

# Full comprehensive upgrade
python scripts/upgrade_to_odoo19.py <project_path>

# Update manifest versions
python scripts/upgrade_manifest.py <project_path> 19.0

# Fix RPC service migrations
python scripts/fix_rpc_service.py <project_path>

# Install upgraded module
python -m odoo -d [DB] -i [MODULE] --addons-path=odoo/addons,projects/[PROJECT] --stop-after-init

# Update module after changes
python -m odoo -d [DB] -u [MODULE] --stop-after-init

# Run with development mode for debugging
python -m odoo -d [DB] --dev=all

Migration Report Template

Generate comprehensive reports documenting:

• Files modified count
• Lines changed
• Patterns applied
• Manual fixes needed
• External dependencies added
• Testing status
• Known issues
• Rollback instructions

References

• Patterns Documentation
• Odoo 18 to 19 Patterns
• JavaScript Fixes
• XML Fixes
• Error Catalog