README.md

<title>Field Renaming — OpenUpgrade 15.0 documentation</title> <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script> <script src="../_static/jquery.js"></script> <script src="../_static/underscore.js"></script> <script src="../_static/_sphinx_javascript_frameworks_compat.js"></script> <script src="../_static/doctools.js"></script> <script src="../_static/sphinx_highlight.js"></script>

<div class="document">
  <div class="documentwrapper">
    <div class="bodywrapper">
      

      <div class="body" role="main">

Field Renaming¶

From version 14.0 to version 15.0, in the module mail, in the model mail.activity.type the html field default_description has been renamed into default_note.

Analysis¶

...
---Fields in module 'mail'---
...
mail         / mail.activity.type       / default_description (html)    : DEL
...
mail         / mail.activity.type       / default_note (html)           : NEW

See Full V15 Analysis File.

Source Code Differences¶

Version 14.0¶

class MailActivityType(models.Model):
<span class="n">_name</span> <span class="o">=</span> <span class="s1">&#39;mail.activity.type&#39;</span>

<span class="n">default_description</span> <span class="o">=</span> <span class="n">fields</span><span class="o">.</span><span class="n">Html</span><span class="p">(</span>
    <span class="n">string</span><span class="o">=</span><span class="s2">&quot;Default Description&quot;</span><span class="p">,</span>
    <span class="n">translate</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
<span class="p">)</span>

See Full V14 Code Source.

Version 15.0¶

class MailActivityType(models.Model):
<span class="n">_name</span> <span class="o">=</span> <span class="s1">&#39;mail.activity.type&#39;</span>

<span class="n">default_note</span> <span class="o">=</span> <span class="n">fields</span><span class="o">.</span><span class="n">Html</span><span class="p">(</span>
    <span class="n">string</span><span class="o">=</span><span class="s2">&quot;Default Description&quot;</span><span class="p">,</span>
    <span class="n">translate</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
<span class="p">)</span>

See Full V15 Code Source.

Result without migration script / Expected Result¶

V14 table mail_activity_type¶

id	name	default_description
1	Email	<p>A description</p>
2	Call
3	Meeting	<p>Another description</p>

V15 table mail_activity_type (Without migration script)¶

id	name	default_note
1	Email
2	Call
3	Meeting

Problem : the data is lost during them migration process, and the new column is empty.

V15 table mail_activity_type (With migration script)¶

id	name	default_note
1	Email	<p>A description</p>
2	Call
3	Meeting	<p>Another description</p>

Contribution to OpenUpgrade¶

Update upgrade_analysis_work.txt file¶

• Place side by side the two lines that correspond to the change

• Mention the operation performed, starting with # DONE:

---Fields in module 'mail'---
mail         / mail.activity.type       / default_note (html)           : NEW
mail         / mail.activity.type       / default_description (html)    : DEL
# DONE: pre-migration, rename fields default_description -> default_note

See Full V15 Work Analysis File.

Write migration Script¶

in the pre-migration.py script add:

from openupgradelib import openupgrade
def _rename_fields(env):
openupgrade.rename_fields(
env,
[
(
"mail.activity.type",
"mail_activity_type",
"default_description",
"default_note",
),
]
)
@openupgrade.migrate()
def migrate(env, version):
_rename_fields(env)

See Full pre migration Script.

      </div>
      
    </div>
  </div>
  <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
    <div class="sphinxsidebarwrapper">

OpenUpgrade

Navigation

• Introduction
• Migrating your database
• Community involvement
• Module coverage
• Database analysis
• Migration script development
  • Overview
  • Learn from typical Use cases
    • Field Renaming
  • Learn from existing migration scrips
  • Learn from code review of open PRs
  • The Trial and error process for the development of your scripts
  • Learning resources
• OpenUpgrade API

Related Topics

• Documentation overview
  • Migration script development
    • Previous: Migration script development
    • Next: The Odoo Migration Manager

Quick search

<script>document.getElementById('searchbox').style.display = "block"</script>

    </div>
  </div>
  <div class="clearer"></div>
</div>
<div class="footer">
  &copy;2012-2021, Odoo Community Association (OCA) / The OpenUpgrade developers.
  
  |
  Powered by <a href="http://sphinx-doc.org/">Sphinx 5.2.3</a>
  &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
  
  |
  <a href="../_sources/use_cases/field_renaming.rst.txt"
      rel="nofollow">Page source</a>
</div>