OpenERP Custom Sample Module Development – OpenERP Quick Start Guide
Introduction
This article will explain the basic steps involved in developing custom OpenERP modules. It is a “Hello World” kind of guideline, therefore you won’t be able to find out all the theories behind OpenObject platform here. Instead you will get all the necessary information to get started with.
Sample module given here is fully functional and tested on OpenERP version 6.0-RC2 (with Web Client on Chrome browser). You will be able to download the complete source code at the end of this article.
Module Description
The sample module we are going to develop is a simple Notebook application. It helps to take down notes and contains just three fields namely “Title”, “Note” and “Date” in its data model.
Module Structure
An OpenERP module consists of some basic elements as explained below. Note that what is explained here is only the basic files required and structure will be more complex in real world applications.
- module_name.py – contains the application logic and database table structure definition.
- __init__.py – init script will load the application’s main python-module and related in application initialization.
- view_name.xml – contains the application interface definition and menu structure.
- __openerp__.py – is the module descriptor file. In previous versions of OpenERP this was known as “__terp__.py”
File Contents
[ notebook.py ]
[python]
from osv import fields, osv
import time
class notebook(osv.osv):
_name = "notebook"
_description = "Simple Notebook"
_columns = {
‘title’ : fields.char(‘Title’, size=30, required=True),
‘note’ : fields.text(‘Note’),
‘note_date’ : fields.date(‘Date’),
}
notebook()
[/python]
Next we import the python module we created in application initialization script.
[ __init__.py ]
[python]
import notebook
[/python]
After that we define the view and menu structure of our module.
[ notebook_view.xml ]
[xml]
<?xml version="1.0" encoding="utf-8"?>
<openerp>
<data>
<record model="ir.ui.view" id="notebook_tree_view">
<field name="name">notebook.tree</field>
<field name="model">notebook</field>
<field name="type">tree</field>
<field name="arch" type="xml">
<tree string="Notebook">
<field name="title"/>
<field name="note"/>
<field name="note_date"/>
</tree>
</field>
</record>
<record model="ir.ui.view" id="notebook_form_view">
<field name="name">notebook.form</field>
<field name="model">notebook</field>
<field name="type">form</field>
<field name="arch" type="xml">
<form string="Notebook">
<field name="title"/>
<field name="note"/>
<field name="note_date"/>
</form>
</field>
</record>
<record model="ir.actions.act_window" id="action_notebook_form">
<field name="name">notebook</field>
<field name="res_model">notebook</field>
</record>
<menuitem name="Notebook" icon="terp-project" id="notebook_menu"/>
<menuitem name="Notes" parent="notebook_menu" id="notebook_menu_mainform" action="action_notebook_form"/>
</data>
</openerp>
[/xml]
Finally create the application descriptor as follows.
[ __openerp__.py ]
[python]
{
"name" : "notebook",
"version" : "0.1",
"author" : "Keerthi Bandara @ iBCScorp",
"website" : "http://www.ibcscorp.com/",
"category" : "Generic Modules/Others",
"depends" : ["base"],
"description" : "Simple demo module",
"init_xml" : ["notebook_view.xml"],
"demo_xml" : [],
"update_xml" : [],
"active": False,
"installable": True
}
[/python]
Packaging and Installing New Module
To prepare your module for installation, you may simply compress the module directory into a zip archive (e.g. notebook.zip).
Once your module archive is ready, you can continue the installation by following the given path below.
1. Login to OpenERP admin view and open “Import Module” screen under “Modules” section in “Administration” area. Select newly created module archive and click “Import Module” button.
Note: Sometimes on OpenERP V6 (RC2), the message ”Loading..” will be continuously displayed, even though your module is successfully imported. In that case simply close the message window and continue to next step.
2. After importing new module, it will appear under OpenERP “Modules” list. It can be easily located by Searching for the module name. Once you found the module, mark it for installation, then select the check box in front of the module and click “Apply Scheduled Upgrades” link.
Click on “Start update” to continue the installation.
Accessing Your Module
