PDF de programación - BachacoVE

BachacoVE

Tabla de contenido

1. Introducción
2. Prefacio
3. ¿Qué abarca este libro?
4. ¿Qué se necesita para este libro?
5. ¿A quien va dirigido este libro?
6. Convenciones
7. Capítulo I: Comenzando con Odoo
8. Capítulo II: Primera aplicación con Odoo
9. Capítulo III: Herencia
10. Capítulo IV: Serialización de Datos y Datos del Módulo
11. Capítulo V: Modelos
12. Capítulo VI: Vistas
13. Capítulo VII: Lógica de la Aplicación
14. Capítulo VIII: QWeb
15. Capítulo IX: API Externa
16. Capítulo X: Lista de Verificación para Despliegue

2

BachacoVE

Introducción

Esta es una iniciativa de un grupo de desarrolladoras y desarrolladores, entusiastas del Software Libre para hacer más
accesibles los conocimientos sobre odoo.

Introducción

3

BachacoVE

Prefacio

Odoo es una plataforma poderosa de codigo abierto para aplicaciones de negocio. Sobre esta se encuentra una suite de
aplicaciones estrechamente integradas, que cubren todas las áreas de negocio desde CRM y Ventas hasta Contabilidad y
Suministros. Odoo tiene una comunidad dinámica y en constante crecimiento, constantemente se agregan características,
conectores, y aplicaciones de negocio adicionales.

Lo Esencial del Desarrollo con Odoo provee una guia paso a paso para el desarrollo con Odoo, para escalar rapidamente
la curva de aprendizaje y emprender productivamente en la plataforma Odoo.

Los primeros tres capítulos tiene como finalidad hacer que la persona que lee se sienta comoda con Odoo, las tecnicas
básicas para configurar un entorno de desarrollo, el desarrollo de módulos y flujos de trabajo. Los cinco capítulos
siguientes explican en detalle varias áreas de desarrollo usadas en los módulos: archivos de datos, modelos, vistas, lógica
de negocio, y QWeb.

Los dos capítulos finales son una guía a través de la integración de aplicaciones Odoo con aplicaciones externas y la
discusión sobre las consideraciones a tener en cuenta al implementar instancias de Odoo para su uso en producción.

Prefacio

4

BachacoVE

Qué abarca este libro

Capítulo 1, Comenzar con el Desarrollo de Odoo, abarca la configuración del entorno de desarrollo, instalación de Odoo
desde el código fuente, y aprender como se gestionan las instacias del servidor Odoo.

Capítulo 2, Desarrollar una Primera Aplicación con Odoo, es una guía a través de la creación de un primer módulo de
Odoo, cubre todas las capas involucradas: modelos, vistas y lógica de negocio.

Capítulo 3, Herencia - Ampliar las Aplicaciones Existentes, explica los mecanismos de herencia y sus usos para crear
módulos de extensión que agregan o modifican características en otros módulos existentes.

Capítulo 4, Serialización de Datos y Datos de Módulo, abarca los formatos de archivo de datos más usados en Odoo, XML
y CSV, identificadores exernos, y como usar archivos de datos en los módulos y en la importación y exportación de datos.

Capítulo 5, Modelos – Estrauturar los Datos de la Aplicación, describre en detalle la capa de Modelo con los tipos de
modelos y campos disponibles, incluyendo los campos relacionales y computados.

Capítulo 6, Vistas – Diseñar la Interfaz de Usuario, abarca la capa de Vista, explicando en detalle los tipos de vistas y
todos los elementos que pueden ser usados para crear interfaces dinámicas e intuitivas.

Capítulo 7, Lógica de Aplicación ORM – Apoyar la Lógica de Negocio, introduce a la programación de la lógica de negocio
del lado del servidor, explorando los conceptos de ORM y sus características, también explica como usar wizards para una
interacción más compleja con las usuarias y los usuarios.

Capítulo 8, QWeb – Crear Vistas y Reportes Kanban, recorre las plantillas QWeb de Odoo, usandolas para crear
sofisticadas kanban boards y reportes basados en HTML.

Capítulo 9, API Externa – Integración con Otros Sistemas, explica como usar la lógica del servidor Odoo desde
aplicaciones externas, e introduce una popular librería de programación que puede también ser usada como cliente de
línea de comando.

Capítulo 10, Lista de Verificación de Implementación – En Vivo, muestra como preparar un servidor para ser usado en
producción, explica cuales configuraciones deben ser tomadas en cuenta y como configurar un proxy inverso Nginx para
mejorar la seguridad y escalabilidad.

¿Qué abarca este libro?

5

BachacoVE

Que se necesita para este libro

Se realiza la instalación de Odoo en un servidor con sistema Ubuntu o Debian, pero puede usar las herramientas de
programación y el sistema operativo de su preferencia, sea Windows, Macintosh, o cualquier otro.

Aquí se proporciona una guía general para la configuración de na máquina virtual con Ubuntu Server. Puede elegir el
software de virtualización que desee, como VirtualBox o VMware Player, ambos disponibles de forma gratuita. Si usa una
estación de trabajo Ubuntu o Debian, no es necesaria una máquina virtual.

¿Qué se necesita para este libro?

6

BachacoVE

A quién va dirigido este libro

Este libro esta dirigido a desarrolladoras y desarrolladores con experiencia en la creación de aplicaciones de negocio con
la disposición de convertirse en personas productivas con Odoo.

Se espera que cuente con conocimientos en el diseño de aplicaciones MVC y programación con lenguaje Python.

¿A quien va dirigido este libro?

7

BachacoVE

Convenciones

En este libro, encontrará diferentes estilos de texto para distinguir entre distintos tipos de información. Los siguientes son
algunos ejemplos de estos estilos, y una explicación de su significado.

El manejo de palabras de código en texto, nombres de tablas de base de datos, nombres de carpetas, nombres de
archivos, extensiones de archivos, nombres de ruta, URLs falsas, entrada de usuario, y Twitter se muestran como sigue:
“Necesita poder ser importado por Python, por lo tanto tendrá también que ser un archivo init.py”

Un bloque de código es asentado de la siguiente manera:

{
'name': 'To-Do Application',
'description': 'Manage your personal Tasks with this module.',
'author': 'Daniel Reis',
'depends': ['mail'],
'application': True,
}

Cualquier entrada de línea de comand es escrito como sigue:

$ mkdir ~/odoo-dev/custom-addons

Termino nuevos y palabras importantes son mostradas en negrita. Las palabras que se muestran en la pantalla, en los
menús o ventanas de dialogo por ejemplo, apararecen en texto como este: “Seleccione la opción Actualizar Listas de
Módulos.”

Nota

Las advertencias o notas importantes aparecen en una caja como esta.

Tip

Los tips y notas aparecen así.

Convenciones

8

BachacoVE

Capítulo 1. Comenzando con Odoo

Antes de sumergirse en el desarrollo de Odoo, es necesario configurar el entorno de desarrollo, y para esto se debe
aprender las tareas básicas de administración.

En este capítulo, se aprenderá como configurar el entorno de desarrollo, donde luego se desarrollarán las aplicaciones
Odoo.

Se aprenderá a configurar sistemas Debian o Ubuntu para alojar las instancias del servidor de desarrollo, y como instalar
Odoo desde el código fuente en GitHub. Luego aprenderá a configurar archivos compartidos con Samba, permitiendo
trabajar con archivos de Odoo desde una estación de trabajo con cualquier sistema operativo.

Odoo está desarrollado usando el lenguaje de programación Python y usa PostgreSQL como base de datos para
almacenar datos, estos son los requisitos principales para trabajar con Odoo. Para ejecutar Odoo desde el código fuente,
es necesario instalar las librerías Python de las cuales depende. Luego el código fuente de Odoo debe descargarse desde
GitHub y ejecutado desde el código fuente. Aunque es posible descargar un zip o tarball, es mejor obtener el código fuente
usando GitHub, así además tendremos Odoo instalado en nuestro equipo.

Configurar un equipo como servidor Odoo

Preferimos usar sistemas Debian/Ubuntu para el servidor Odoo, aunque puede trabajar desde el sistema operativo de su
preferencia, sea Windows, Macintosh, o Linux.

Odoo puede ser ejecutado en una gran variedad de sistemas operativos, entonces ¿por qué elegir Debian por encima de
otros sistemas operativos? Debido a que Odoo es desarrollado principalmente para sistemas Debian/Ubuntu, el soporte
para Odoo es mejor. Por lo tanto será más fácil encontrar ayuda y recursos adicionales si se trabaja con Debian/Ubuntu.

También son las plataformas más usadas por las personas que desarrollan aplicaciones, y donde se dan a conocer más
implementaciones. Por esta razón, inevitablemente, se espera que las desarrolladoras y los desarrolladores de Odoo se
sientan a gusto con esta plataforma. Incluso quienes tiene una historial de trabajo con Windows, es importante que tengan
algún conocimiento sobre estas plataformas.

En este capítulo, se aprenderá a configurar y trabajar con Odoo sobre un sistema Debian, usando únicamente la línea de
comandos. Para quienes están acostumbrados a sistemas Windows, se describirá como configurar una máquina virtual
para alojar un servidor Odoo. Adicionalmente, las técnicas aprendidas servirán para gestionar servidores Odoo en la nube
donde el único acceso será a través de una Shell Segura (SSH).

Nota

Tenga en cuenta que estas instrucciones tienen como objetivo configurar un nuevo sistema para desarrollo. Si
desea probarlas en un sistema existente, haga un respaldo a tiempo que le permita recuperar el sistema en caso de
algún problema.

Disposiciones para un equipo Debian

Como se explicó antes, será necesario un equipo con Debian para alojar nuestro servidor Odoo versión 8.0. Si estos son
sus primeros pasos con Linux, le gustará saber que Ubuntu es una distribución Linux basada en Debian, por lo tanto son
muy similares.

Nota

Odoo asegura su funcionamiento con la versión estable de Debian o Ubuntu. Al momento de elegir este libro, las

Capítulo I: Comenzando con Odoo

9

BachacoVE

versión estable para Debian es la versión 7 "Wheezy" y para Ubuntu la versión 14.04 "Trusty T