Esqueletos de proyectos OpenERP

Sobre este artículo

Autor(es):Leonardo J. Caballero G. Correo(s):leonardoc@plone.org Compatible con:Probado con Python 2.6 o versiones superiores Fecha:21 de Marzo de 2015

Introducción

OpenERP, es un sistema ERP y CRM. Tiene componentes separados en esquema Cliente-servidor. Dispone de interfaces XML-RPC, y SOAP. Emplea a Postgresql como sistema manejador de bases de datos y ha sido programado con Python, lo cual permite que su adecuación e implantación sea limpia y pueda tener una curva de adopción bastante menor que otras soluciones ERP existentes.

Entonces para su desarrollo existen una serie de colecciones de plantillas esqueletos de módulos y temas basados en Paster, para proyectos que permiten iniciar rápidamente el desarrollo en OpenERP.

Requerimientos previos

Se requiere instalar las siguientes dependencias con el siguiente comando:

# aptitude install bzr bzr-gtk bzrtools bzr-explorer python-dev python-setuptools

Instalación

Dentro de su entorno virtual activado debe instalar el paquete openerp_bootstrap, ejecutando el siguiente comando:

(python) pip install openerp_bootstrap

Nota

No olvidar que estos paquetes han sido instalados con el entorno virtual que previamente usted activo, eso quiere decir que los paquetes previamente instalados con Easy Install o PIP están instalados en el directorio ~/virtualenv/python/lib/python2.x/site-packages/ en ves del directorio de su versión de Python del sistema /usr/lib/python2.x/site-packages/.

Al finalizar la instalación podrá opcionalmente consultar cuales plantillas tiene disponible para usar, ejecutando el siguiente comando:

(python)$ paster create --list-templates
  Available templates:
    basic_package:      A basic setuptools-enabled package
    openerp_newmodule:  Template for creating a basic openerp package skeleton
    openerp_webmodule:  Template for creating a basic openerp theme skeleton
    paste_deploy:       A web application deployed through paste.deploy

Generación modulo OpenERP

Usted puede usar el comando paster para crear paquetes Python.

(python)$ paster create -t openerp_newmodule openerp_mimodulo
  Selected and implied templates:
    openerp-bootstrap#openerp_newmodule  Template for creating a basic openerp package skeleton

  Variables:
    egg:      openerp_mimodulo
    package:  openerp_mimodulo
    project:  openerp_mimodulo
  Enter module_name (Module name (like "Project Issue")) ['My Module']: Mi modulo OpenERP
  Enter description (One-line description of the module) ['']: Mi modulo de OpenERP de pruebas
  Enter version (Version) ['1.0']: 0.1
  Enter author (Author name) ['']: Leonardo J. Caballero G.
  Enter author_email (Author email) ['']: leonardocaballero@gmail.com
  Enter category (Category) ['']: modulos openerp demo pruebas
  Enter website (Website) ['']: http://about.me/macagua
  Enter depends (Dependencies [space-separated module names]) ['']: account
  Enter is_web (Is web addon? [yes/no]) ['no']:
  Creating template openerp_newmodule
  Creating directory ./openerp_mimodulo
    Copying __init__.py to ./openerp_mimodulo/__init__.py
    Copying __openerp__.py_tmpl to ./openerp_mimodulo/__openerp__.py

Luego de responder a estas preguntas el programa paster creará la estructura inicial del paquete del modulo OpenERP llamado openerp_mimodulo en el directorio donde ejecuto el comando anterior.

openerp_mimodulo/
|-- __init__.py
`-- __openerp__.py

Hasta este punto tiene creado la estructura del su modulo y puede consultar el archivo descriptor de Modulo OpenERP, el cual ofrece la información del manifiesto de su modulo en el archivo en la ruta openerp_mimodulo/__openerp__.py que contiene la siguiente información:

# -*- coding: utf-8 -*-

{
    'name': 'Mi modulo OpenERP',
    'version': '0.1',
    'category': 'modulos openerp demo pruebas',
    'description': """Mi modulo de OpenERP de pruebas""",
    'author': 'Leonardo J. Caballero G. (leonardocaballero@gmail.com)',
    'website': 'http://about.me/macagua',
    'license': 'AGPL-3',
    'depends': ['account'],
    'init_xml': [],
    'update_xml': [],
    'demo_xml': [],
    'active': False,
    'installable': True,
}

Generación Tema OpenERP

Ahora proceda a crear un nuevo tema, con el siguiente comando:

(python)$ paster create -t openerp_webmodule openerp_mitema
  Selected and implied templates:
    openerp-bootstrap#openerp_webmodule  Template for creating a basic openerp theme skeleton

  Variables:
    egg:      openerp_mitema
    package:  openerp_mitema
    project:  openerp_mitema
  Enter module_name (Module name (like "My Web module")) ['My Web module']: Mi tema OpenERP
  Enter description (One-line description of the module) ['']: Mi tema OpenERP de pruebas
  Enter version (Version) ['1.0']: 0.1
  Enter author (Author name) ['']: Leonardo J. Caballero G.
  Enter author_email (Author email) ['']: leonardocaballero@gmail.com
  Enter category (Category) ['']: tema openerp demo pruebas
  Enter website (Website) ['']: http://about.me/macagua
  Enter depends (Dependencies [space-separated module names]) ['']: project
  Enter has_css (Needs CSS? [yes/no]) ['yes']:
  Enter has_js (Needs Javascript? [yes/no]) ['yes']:
  Enter has_xml (Needs QWeb XML? [yes/no]) ['no']:
  Creating template openerp_webmodule
  Creating directory ./openerp_mitema
    Copying __init__.py to ./openerp_mitema/__init__.py
    Copying __openerp__.py_tmpl to ./openerp_mitema/__openerp__.py
    Recursing into static
      Creating ./openerp_mitema/static/
      Recursing into css
        Creating ./openerp_mitema/static/css/
        Copying +normalized_name+.css_tmpl to ./openerp_mitema/static/css/openerp_mitema.css
      Recursing into js
        Creating ./openerp_mitema/static/js/
        Copying +normalized_name+.js_tmpl to ./openerp_mitema/static/js/openerp_mitema.js
      Recursing into xml
        Creating ./openerp_mitema/static/xml/
        Copying +normalized_name+.xml_tmpl to ./openerp_mitema/static/xml/openerp_mitema.xml
  xml not required, removed dir ./openerp_mitema/static/xml

Luego de responder a estas preguntas el programa paster creará la estructura inicial de un modulo Web con todos los archivos estáticos que usted ya tiene listo para personalizar, con el nombre de openerp_mitema en el directorio donde ejecuto el comando anterior.

openerp_mitema/
|-- __init__.py
|-- __openerp__.py
`-- static
    |-- css
    |   `-- openerp_mitema.css
    `-- js
        `-- openerp_mitema.js

En este modulo esta archivo descriptor de Modulo OpenERP en la ruta openerp_mitema/__openerp__.py que contiene la siguiente información:

# -*- coding: utf-8 -*-

{
    'name': 'Mi tema OpenERP',
    'version': '0.1',
    'category': 'tema openerp demo pruebas',
    'description': """Mi tema OpenERP de pruebas""",
    'author': 'Leonardo J. Caballero G. (leonardocaballero@gmail.com)',
    'website': 'http://about.me/macagua',
    'license': 'AGPL-3',
    'depends': ['project', 'web'],
    'init_xml': [],
    'update_xml': [],
    'demo_xml': [],
    'active': False,
    'installable': True,
    'web':True,
    'css': [
        'static/css/openerp_mitema.css',
    ],
    'js': [
        'static/js/openerp_mitema.js',
    ],
}

Descarga código fuente

Para descargar el código fuente de este ejemplo ejecute el siguiente comando:

$ bzr branch lp:~macagua/macagua-stuff/openerp_mimodulo
$ bzr branch lp:~macagua/macagua-stuff/openerp_mitema

Recomendaciones

Si desea trabajar con algún proyecto de desarrollo basado en esqueletos o plantillas paster y Buildout simplemente seleccione cual esqueleto va a utilizar para su desarrollo y proceso a instalarlo con easy_install o PIP (como se explico anteriormente) y siga sus respectivas instrucciones para lograr con éxito la tarea deseada.

Ver también

Artículos sobre:

• Esqueletos de proyectos Python.

Referencias

• How to create an OpenERP module.
• http://planet.domsense.com/en/2011/12/quickly-get-and-run-openerp-6-1-trunk/
• http://planet.domsense.com/en/2012/04/how-to-create-an-openerp-module-the-easy-way/trackback/

los comentarios son proporcionados por Disqus