Agregar campos a formularios de OPENERP 7 mediante modulos, usando su framework OPENOBJECT – Parte I

Hola amigos en esta oportunidad quiero compartir con ustedes la forma mas correcta de agregar un campo a un formulario de OPENERP usando su propio FRAMEWORK OPENOBJECT.

Cuando nos referimos a módulos se refiere a cualquier modificación o cambio que se quiera agregar a un formulario o en general a cualquier funcionalidad de OPENERP.

Suponemos que tiene instalado OPENERP 7 en Ubuntu Server o alguna otra distribución de GNU/Linux.

• Si vemos el formulario actual de PRODUCTO vemos los campos tal como muestra en la imagen siguiente:

• Lo que haremos es agregar el campo Color en la pestaña Información debajo del campo Precio de venta, por medio de un módulo que llamaremos product_color. para ello ingresamos a nuestro servidor y mediante la terminal ingresamos a la carpeta addons de openerp.

#: significa que hemos iniciado sesión como superusuario o root.

 #cd /opt/openerp/server/openerp/addons/

• Creamos una nueva carpeta llamada product_color

#mkdir product_color

•  Ingresamos a la carpeta

#cd product_color

• Crear los archivos __init__.py, __openerp__.py,  product_color.py y product_color_view.xml

#touch __init__.py 
#touch __openerp__.py 
#touch product_color.py
#touch product_color_view.xml

__init__.py: Aqui importaremos todos los archivos y directorios que contienen codigo python, éste archivo hace que OPENERP reconosca al directorio o capeta product_color como un módulo.

__openerp__.py: Contiene un diccionario en Python para agregar las descripciones del módulo, como autor, versión, etc.

product_color.py: Aquí escribiremos el código Python que permitirá agregar o modificar las funcionalidades de OPENERP, este archivo será importado en __init__.py, como veremos mas abajo.

product_color_view.xml: Aquí vamos agregar los codigos XML que permitirá la vista del Módulo en OPENERP, en nombre debe de terminar en _view.xml por convencion.

• Con tu editor favorito editamos el archivo __init__.py, para este ejemplo usaré el editor vim.

#vim __init__.py

• Agregamos lo siguiente y guardamos los cambios.

# -*- coding: utf-8 -*-
import product_color

 La primera linea se recomienda agregar, permite reconocer que python trabaje en utf-8

• Editamos el archivo __openerp__.py

#vim __openerp__.py

• Agregamos lo siguiente y gurdamos:

# -*- encoding: utf-8 -*-

{
    "name": "Product Color",
    "version": "1.0",
    "description": """
        Permite agregar al formulario producto el campo color
    """,
    "author": "Ing. Javier Salazar Carlos",
    "website": "http://salazarcarlos.com",
    "category": "Tools",
    "depends": [
            "product",
            "base",#Este modulo para instalarse debe tener el modulo base y product instalado
                ],
    "data":[
            "product_color_view.xml", #todos los archivos xml que posea nuestro modulo se debe de agregarse aqui
                ],
    "demo_xml": [
                        ],
    "update_xml": [
                        ],
    "active": False,
    "installable": True,
    "certificate" : "",
}

• Editamos el archivo product_color.py y agregamos el siguiente código:

# -*- encoding: utf-8 -*-

#importamos la clase osv del modulo osv y fields
from osv import osv, fields

#Creamos una clase llamada product_product que hereda de la clase product_product padre que esta en /opt/openerp/server/openerp/addons/product
#En openobject hay varios tipos de herencia averiguar mas del tema
#Aqui las clases tienen un atributo _name que es el nombre de la tabla que existe o se creara cuando instalamos el modulo en postgresql

class product_product(osv.osv):
    _name = 'product.product' # Aqui va el mismo nombre de la clase que se hereda
    _inherit = 'product.product' # Permite la herencia propiamente dicho del modulo product 

    #Agregamos el campo color al formulario producto o a la tabla product_product
    _columns = {
                'colores': fields.char('Color',size=40),
        }
product_product()

• Editamos el archivo product_color_view.xml que permitirá mostrar el campo color en formulario producto.

#vim product_color_view.xml

• En OPENERP existe varios tipos de vista: Vista lista(tree), Vista formulario(form), etc. para nuestro caso usaremos una vista formulario, ya que es a este tipo de vista a donde agregaremos el campo color.

La etiqueta <record> tiene los atributos:

model: vista heredada del modelo ir.ui.view

id: Nombre único para cada vista etiqueta <record>

La etiqueta <field> tiene varios atributos los mas importantes son.

name: Indica el nombre de acction a realizar

model: Indica el nombre de la clase a la que se asocia esta vista.

inherit_id: Herencia de vista, para nuestro caso hereda de la vista del modulo product  que esta en /opt/openerp/server/openerp/addons/product/product_view.xml

type: Este es una vista tipo formulario

Agregamos el siguiente código:

<?xml version="1.0" encoding="UTF-8"?>

<!-- Siempre las lineas xml van a ir delimitados por la etiqueta openerp-->
<openerp>
        <!-- Las etiquetas data tambien delimitan a las record siempre -->
        <data>
                <!-- La etiqueta record son la que permitiran mostrar el campo color en el formulario producto-->
                <record model='ir.ui.view' id='product_color_form_view'>
                        <field name='name'>product.form.color</field>
                        <field name='model'>product.product</field>
                        <field name='inherit_id' ref='product.product_normal_form_view'/>
                        <field name='type'>form</field>
                        <field name='arch' type='xml'>
                                <field name="list_price" position="after"> <!-- after: despues del campo list_price -->
                                        <field name="colores"/> <!-- llamamos al campo coleres con el atributo name de field -->
                                </field>
                        </field>

                </record>
        </data>
</openerp>

• Ingresamos a nuestro OPENERP por medio de un navegador web: http://ip_mi_server:8060 iniciamos sesión con usuario administrador y ademas debemos de tener activado Características técnicas para el usuario administrador y nos dirigimos a la pestaña Configuración/Actualizar lista de modulos y damos actualizar.

• Nos dirigimos a Configuración/modulos instalados y en la parte derecha en el área de búsqueda colocamos el nombre del modulo product_color y presionamos enter:

• Hacemos clic en instalar y si todo hemos hecho correctamente no nos debería mostrar ningún error y al ir al formulario de producto deberíamos el nuevo campo creado:

Esto todo amigos espero que les sea de ayuda.