capitulo--1.

md 07/02/2018

1 # odoo essentials
2
3 ## Capítulo 1. Iniciando con desarrollo Odoo
4
5 Antes de sumergirnos en el desarrollo en Odoo, necesitamos armar
nuestro ambiente de desarrollo y aprender las tareas de administraciión
básicas para ello.
6
7 Oddo se construye utilizando el lenguaje de programación Phyton, y
utiliza la base de datos PostgreSQL para almacenamiento de datos; estos
son los dos principales requerimientos de un huesped Odoo. Para correr
Odoo desde la fuente, necesitaremos primero instalar las librerias de
Phyton de as cuales depende. El código de fuente de Odoo puede
posteriormente ser descargado desde GitHub. Mientras podemos descargar
un archivo ZIP o tarball, veremos que es mejor si obtenemos las fuentes
utilizando la versión Git de aplicación de control.; Nos ayudará a
tenerlo instalado en nuestro huesped Odoo también.
8
9 ## Creando un huesped para el servidor Odoo
10
11 Se recomienda para el sistema Debian/Ubuntu para el servidor Odoo. Aún
serás capaz de trabajar desde tu sistema de escritorio favorito, bien
sea Windows, Mac, o Linux.
12
13 Odoo puede correr con gran variedad de sistemas operativos, entonces,
por qué escoger Debian a expensas de otros sistemas operativos?: Porque
Debian es considerado la plataforma de despliegue de referencia por el
equipo Odoo; tiene el mejor soporte. Será más facil hallar ayuda y
recursos adicionales si trabajamos con Debian/Ubuntu.
14
15 También es la plataforma con la que la mayoría de desarrolladores
trabajan y donde se implementan más despliegues. Así que
inevitablemente, se espera que los desarrolladores de Odoo se sientan
cómodos con la plataforma Debian/Ubuntu. Incluso si tienes un pasado
Windows, será importante que tengas algún conocimiento acerca de esto.
16
17 En este capítulo, aprenderás cómo armar y trabajar con Odoo hospedado
en un sistema Debian, usando sólo la linea de comando. Para aquellos en
casa con un sistema Windows, cubriremos cómo configurar una máquina
virtual para hospedar el servidor Odoo. Como ventaja, las técnicas que
aprenderás aquí también te permitirán administrar Odoo en servidores en
la nube, donde tu único acceso será a través de Secure Shel ( SSH).
18
19 ### Nota
20
21 Manten en mente que estas instrucciones están destinadas a organizar un
nuevo sistemas para desarrollo. Si deseas probar algunos de ellos en un
sistema existente, siempre toma una copia de seguridad antes de tiempo
para poder restaurarlo en caso de que algo salga mal.
22
23 ## Provisión para un huesped Debian
24
25 Como se explicó antes, necesitaremos un huesped basado en Debian para
nuestro servidor Odoo. Si estos son tus primeros pasos con Linux, puede
gustarte notar que Ubuntu es una distribución Linux basada en Debian,
así que son muy similares.
26
27 Está garantizado que Odoo trabaje con la versión actual estable de
Debian o Ubuntu. Al tiempo de escribir, estos son Debian 8 "Jessie" y
Ubuntu 16.04.1 LTS (Xenial Xerus). Ambos, vienen con Python 2.7, el
cual es necesario para correr Odoo. Es importante señalar que Odoo no
Page 1
capitulo--1.md 07/02/2018

soporta Python 3 aún, así que Python 2 es requerido.

28
29 Si ya estás ejecutando Ubuntu o alguna otra distribución con basada en
Debian, ¡estas listo!; Esto también puede ser utilizado como un huesped
para Odoo.
30
31 Para los sitemas operativos Windows y Mac, instala Python, PostgreSQL,
y todas las dependencias ; luego, ejecuta Odoo desde la fuente nativa.
Sin embargo, esto puede ser un reto, así que nuestro consejo es que
uses una máquina virtual que ejecute un servidor Debian o Ubuntu. Eres
bienvenido a utilizar tu software de virtualización preferido para
obtener un sistema de trabajo Debian en una máquina virtual.
32
33 En caso de que necesites alguna guía, aquí hay unos consejos con
respecto al software de visualización. Existen varias opciones, tales
como Microsoft Hyper-V (disponíble en algunas versiones de Windows
recientes), Oracle VirtualBox y VMWare Workstation Player (VMWare
Fusion para MAC). La VMWare Workstation Player es probablemente más
fácil de utilizar y descargas fáciles de usar pueden ser halladas en
https://my.vmware.com/wev/vmware/downloads.
34
35 Con respecto a la imagen de Linux a utilizar, será más amigable para el
usuario instalar Ubuntu Server que Debian. Si estás empezando con
Linux, te recomiendo que pruebes una imagen lista para usar. TurnKey
Linux proporciona imágenes preinstaladas fáciles de usar en varios
formatos, incluyendo ISO. El formato ISO funcionará con cualquier
programa de visualización que elijas, incluso en una máquina de metal
desnudo que puedas tener. Una buena opción podría ser la imagen LAPP,
que incluye Python y PostgreSQL, y se puede encontrar en
http://www.turnkeylinux.org/lapp.
36
37 Una vez instalada y arrancada, deberías ser capaz de iniciar sesión en
una línea de comando shell.
38
39
40 ## Creando una cuenta de usuario para Oddo
41
42 Si has iniciado sesión usando la cuenta de super usuario `root`, tu
primera tarea debe ser crear una cuenta de usuario normal para tu
trabajo, ya que se considera una mala práctica trabajar como `root`. En
particular, el operador de Odoo se rehusará a correr si lo inicias como
`root`.
43
44 Si has inicaido sesión usando Ubuntu, probablemente no necesitaras
esto, ya que el proceso de instalación debe haberte guiado para la
creación de un usuario.
45
46 Primero, asegurate de que `sudo` esté instalado. Nuestro usuario de
trabajo lo necesitará. Si se inició sesión como `root`, ejecuta los
siguientes comandos:
47
48 ```
49 # apt-get update && apt-get upgrade # Install system updates
50 # apt-get install sudo # Make sure 'sudo' is installed
51
52 ```
53
54
55 El siguiente set de comandos creará un usuario `odoo`:
56
57 ```
Page 2
capitulo--1.md 07/02/2018

58 # useradd -m -g sudo -s /bin/bash odoo # Create an 'odoo' user with

sudo powers
59
60 # passwd odoo # Ask and set a password for the new user
61
62 ```
63 Puedes cambiar el nombre de usuario `odoo` al que tu quieras. La
opción `-m`asegura que su directorio de inicio sea creado. La opción
`-g sudo`
64
65
66 Ahora podemos iniciar sesión como el nuevo usuario y organizar Odoo.
67
68
69 ## Instalando Odoo desde la fuente
70
71 Los paquetes de instalación rápida de Odoo, pueden hallarse en
nigthly.odoo.com, disponíble como Windows `(.exe)`, Debian (`.deb`),
CentOS (`.rpm`), y código fuente en formato tarballs (`. tar .gz`).
72
73 Como desarrolladores, preferiremos instalarlos directamente del
repositorio GitHub. Esto terminará dándonos más control sobre versiones
y actualizaciones.
74
75 Para mantener las cosas ordenadas, vamos a trabajar en un directorio
`/odoo-dev` dentro de nuestro directorio `home`.
76
77 ### Nota
78
79 A lo largo del libro, asumiremos que `/odoo-dev` es el directorio donde
tu servidor de Odoo está instalado.
80
81 Primero, asegúrate de haber iniciado sesión como el usuario creado
ahora o durante el proceso de instalación, no como el usuario `root`.
Asumiendo que tu usuario es `odoo`, confírmalo con el siguiente comando:
82
83 ```
84 odoo
85
86 $ echo $HOME
87
88 /home/odoo
89 $ whoami
90
91 odoo
92
93 $ echo $HOME
94
95 /home/odoo
96 ```
97
98 Ahora podemos utilizar este script. Nos muestra cómo instalar Odoo
desde la fuente a un sistema Debian/Ubuntu.
99
100 Primero, intala las dependencias básicas para comenzar:
101
102 ```
103 $ sudo apt-get update && sudo apt-get upgrade #Install system updates
104
105 $ sudo apt-get install git # Install Git
106
Page 3
capitulo--1.md 07/02/2018

107 $ sudo apt-get install npm # Install NodeJs and its package manager
108
109 $ sudo ln -s /usr/bin/nodejs /usr/bin/node # call node runs nodejs
110
111 $ sudo npm install -g less less-plugin-clean-css #Install less compiler
112
113 ```
114
115 Partiendo de la versión 9.0, el cliente web de Odoo requiere que el
preprocesador `less` CSS esté instalado en el sistema para que las
páginas web puedan ser renderizadas correctamente. Para instalar esto,
necesitamos Node.js y npm.
116
117 Luego, necesitamos obtener el código fuente Odoo e instalar sus
dependencias. El código fuente Odoo incluye un script de utilidades,
dentro del directorio `odoo/setup/`, para ayudarnos a instalar las
dependencias requeridas en un sistema Debian/Ubuntu:
118
119 ```
120 $ mkdir ~/odoo-dev # Create a directory to work in
121
122 $ cd ~/odoo-dev # Go into our work directory
123
124 $ git clone https://github.com/odoo/odoo.git -b 10.0 --depth=1 # Get
Odoo source code
125
126 $ ./odoo/setup/setup_dev.py setup_deps # Installs Odoo system
dependencies
127
128 $ ./odoo/setup/setup_dev.py setup_pg # Installs PostgreSQL & db
superuser for unix user
129 ```
130
131 Al final, Odoo debería estar listo para utilizarse. El símbolo ~ es n
atajo para nuestro directorio `home` (por ejemplo, `/home/odoo`).
132 La opción `git -b 10.0` indíca a Git que descargue específicamente la
rama 10.0 de Odoo. Al tiempo de la escritura, esto es redundante ya que
10.0 es la rama por defecto; sin embargo, esto puede cambiar, entonces,
puede hacer el script a prueba del futuro. La opción `--depth=1` indica
a Git que descargue sólo la última revisión, en vez del último
historial de cambio completo, haciendo la descarga más pequeña y más
veloz.
133
134 Para iniciar un servidor Odoo, solo ejecuta:
135
136 ```
137 $ ~/odoo-dev/odoo/odoo-bin
138 ```
139
140 ### Tip
141
142 En Odoo 10, el script `odoo.py`, utilizado en versiones previas para
iniciar el servidor, fue reemplazado con `odoo-bin`.
143
144 De forma predeterminada, las instancias Odoo escuchan en el puerto
8069, por lo que si apuntamos un navegador a `http: //
<dirección-servidor>: 8069`, llegaremos a estas instancias. Cuando lo
accedemos por primera vez, nos muestra un asistente para crear una
nueva base de datos, como se muestra en la siguiente captura de pantalla:
145
146 
Page 4
capitulo--1.md 07/02/2018

147
148 Como desarrolladores, necesitaremos trabajar con varias bases de datos,
así que es más convenientes más conveniente crearlos desde la línea de
comandos, así que aprenderemos cómo hacerlo. Ahora presione ***Ctrl +
C*** en el terminal para detener el servidor Odoo y volver al prompt de
comando.
149
150 ## Inicializando una nueva database Odoo
151
152 Para ser capaces de crear una nueva database, tu usuario debe ser un
super usuario PostgreSQL. El sigiente comando crea un superusuario
PostgreSQL para el usuario actual Unix.
153
154 ```
155 $ sudo createuser --superuser $(whoami)
156 ```
157 Para crear una nueva database, usa el comando `createdb`. Creeamos una
database `demo`:
158
159 ```
160 $ createdb demo
161 ```
162
163 Para inicializar esta database con el esquema de datos Odoo, debemos
ejecutar Odoo en la database vacía, usando la opción `-d`:
164
165 ```
166 $ ~/odoo-dev/odoo/odoo-bin -d demo
167 ```
168
169 Esto tomará un par de minutos para inicializar una database `demo`, y
terminará con un mensaje de registro INFO, **Módulos cargados**.
170
171 ### Nota
172 Ten en cuenta que puede no ser el último mensaje de registro, y puede
estar en las últimas tres o cuatro líneas. Con esto, el servidor estará
listo para escuchar las peticiones del cliente.
173
174 De forma predeterminada, esto inicializará la database con datos de
demostración, que a menudo es útil para las databases de desarrollo.
Para inicializar una database sin datos de demostración, agregue la
opción `--without-demo-data = all` al comando.
175
176 Ahora abre `http: // <server-name>: 8069` con tu navegador para que se
presente la pantalla de inicio de sesión. Si no conoces el nombre del
servidor, escribe el comando `hostname` en el terminal para encontrarlo
o el comando `ifconfig` para encontrar la dirección IP.
177
178 Si estás hospedando Odoo en una máquina virtual, es posible que debas
establecer algunas configuraciones de red para poder acceder desde tu
sistema huesped. La solución más simple es cambiar el tipo de red de la
máquina virtual de NAT a Bridged. Con esto, en lugar de compartir la
dirección IP del huesped, la máquina virtual invitada tendrá su propia
dirección IP. También es posible utilizar NAT, pero eso requiere que
configures el reenvío de puertos para que su sistema sepa que algunos
puertos, como `8069`, deben ser manejados por la máquina virtual. En
caso de que tengas problemas, esperamos que estos detalles te ayuden a
encontrar información relevante en la documentación del software de
virtualización elegido.
179
180 La cuenta de administrador predeterminada es `admin` con su contraseña
Page 5
capitulo--1.md 07/02/2018

`admin`. Al iniciar sesión, se le presenta el menú **Apps**, que

muestra las aplicaciones disponibles:
181
182 
183
184 Siempre que desee detener la instancia del servidor Odoo y volver a la
línea de comandos, presione ***Ctrl + C*** en el indicador de bash. Al
presionar la tecla de flecha hacia arriba le llevará el comando de
shell anterior, por lo que es una forma rápida de iniciar Odoo de nuevo
con las mismas opciones. Las teclas ***Ctrl + C*** seguido por la tecla
de flecha hacia arriba y ***Enter*** son una combinación utilizada con
frecuencia para reiniciar el servidor Odoo durante el desarrollo.
185
186 ## Administrar sus bases de datos
187
188 Hemos visto cómo crear e inicializar nuevas bases de datos Odoo desde
la línea de comandos. Hay más comandos que vale la pena saber para
administrar las bases de datos.
189
190 Ya sabemos cómo usar el comando `createdb` para crear bases de datos
vacías, pero también podemos crear una nueva base de datos copiando una
existente, usando la opción `--template`.
191
192 Asegúrate de que tu instancia de Odoo está detenida y no tiene ninguna
otra conexión abierta en la base de datos `demo` que acabamos de crear
y, a continuación, ejecuta esto:
193
194 ```
195 $ Createdb --template = demo demo-test
196 ```
197 De hecho, cada vez que creamos una base de datos, se utiliza una
plantilla. Si no se especifica ninguna, se utiliza una predeterminada
llamada `template1`.
198
199 Para enumerar las bases de datos existentes en su sistema, utiliza la
utilidad `psq`l de PostgreSQL con la opción `-l`:
200
201 ```
202 $ Psql -l
203 ```
204
205 Al ejecutarlo se listarán las dos bases de datos que hemos creado hasta
ahora: `demo` y `demo-test`. La lista también mostrará la codificación
utilizada en cada base de datos. El valor predeterminado es UTF-8, que
es la codificación necesaria para las bases de datos Odoo.
206
207 Para eliminar una base de datos que ya no necesitas (o quieres crear
nuevamente) para utilizar el comando `dropdb`:
208
209 ```
210 $ Dropdb demo-test
211 ```
212
213 Ahora ya sabes lo básico para trabajar con bases de datos. Para obtener
más información sobre PostgreSQL, consulta la documentación oficial en
http://www.postgresql.org/docs/.
214
215 ### Nota
216
217 **ADVERTENCIA:**
218
Page 6
capitulo--1.md 07/02/2018

219 El comando drop de la base de datos destruirá irrevocablemente tus

datos. Ten cuidado al usarlo y manten siempre copias de seguridad de
bases de datos importantes antes de usar este comando.
220
221 ## Una palabra sobre las versiones de productos Odoo
222
223 Al momento de la redacción de este texto, la última versión estable de
Odoo es la versión 10, marcada en GitHub como rama 10.0. Esta es la
versión con la que trabajaremos a lo largo del libro.
224
225 ### Nota
226 Es importante notar que las bases de datos de Odoo son incompatibles
entre las versiones principales de Odoo. Esto significa que si ejecutas
un servidor Odoo 10 contra una base de datos creada para una versión
principal anterior de Odoo, no funcionará.
227
228 El trabajo de migración no trivial es necesario antes de que una base
de datos pueda ser usada con una versión más reciente del producto.
229
230 Lo mismo ocurre con los módulos addon: como regla general, un módulo
addon desarrollado para una versión Odoo major no funcionará con otras
versiones. Cuando descargue un módulo de la comunidad desde la Web,
asegúrese de que esté orientado a la versión Odoo que está utilizando.
231
232 Por otra parte, se espera que las versiones principales (9.0, 10.0)
reciban actualizaciones frecuentes, pero éstas deben ser en su mayoría
correcciones de errores.
233 Se asegura que son "API estable", lo que significa que las estructuras
de datos del modelo y los identificadores de elementos de vista se
mantendrán estables. Esto es importante porque significa que no habrá
ningún riesgo de ruptura de módulos personalizados debido a cambios
incompatibles en los módulos de núcleo ascendentes.
234
235 Tenga en cuenta que la versión en la rama `master` resultará en la
siguiente versión estable principal, pero hasta entonces, no es "API
estable" y no debes utilizarla para crear módulos personalizados.
Hacerlo es como moverse en arena movediza: no puedes estar seguro de
cuándo se introducirán algunos cambios que romperán tu módulo
personalizado.
236
237 ## Más opciones de configuración del servidor
238
239 El servidor Odoo soporta bastantes otras opciones. Podemos comprobar
todas las opciones disponibles con Más opciones de configuración del
servidor
240 El servidor Odoo soporta bastantes otras opciones. Podemos comprobar
todas las opciones disponibles con Más opciones de configuración del
servidor
241 El servidor Odoo soporta bastantes otras opciones. Podemos comprobar
todas las opciones disponibles con `--help`:
242
243 ```
244 $ ./odoo-bin --help
245 ```
246
247 Revisaremos algunas de las opciones más importantes en las siguientes
secciones. Comencemos por ver cómo se pueden guardar las opciones
actualmente activas en un archivo de configuración.
248
249 ### Archivos de configuración del servidor Odoo
250
Page 7
capitulo--1.md 07/02/2018

251 La mayoría de las opciones se pueden guardar en un archivo de

configuración. De forma predeterminada, Odoo utilizará el archivo
`.odoorc` en su directorio personal. En sistemas Linux su ubicación
predeterminada está en el directorio de inicio (`$ HOME`) y en la
distribución de Windows está en el mismo directorio que el ejecutable
utilizado para iniciar Odoo.
252
253 ## Nota
254
255 En versiones anteriores de Odoo / OpenERP, el nombre del archivo de
configuración predeterminado era `.openerp-serverrc`. Para
compatibilidad con versiones anteriores, Odoo 10 seguirá utilizando
esto si está presente y no se encuentra ningún archivo `.odoorc`.
256
257 En una instalación limpia, el archivo de configuración `.odoorc` no se
crea automáticamente. Debemos usar la opción `--save` para crear el
archivo de configuración predeterminado, si aún no existe, y almacenar
la configuración actual de la instancia en el:
258
259 ```
260 $ ~ / Odoo-dev / odoo / odoo-bin --save --stop-after-init #servir
configuración al archivo
261 ```
262
263 Aquí, también usamos la opción `--stop-after-init` para detener el
servidor después de que termine sus acciones. Esta opción se utiliza
con frecuencia cuando se ejecutan pruebas o se solicita ejecutar una
actualización de módulo para comprobar si está instalada correctamente.
264
265 Ahora podemos inspeccionar lo que se guardó en este archivo de
configuración predeterminado:
266
267 ```
268 $ More ~ / .odoorc # show the configuration file
269 ```
270
271 Esto mostrará todas las opciones de configuración disponibles con sus
valores predeterminados. Su edición será efectiva la próxima vez que
inicie una instancia de Odoo. Escriba `q` para salir y volver al prompt.
272
273 También podemos optar por usar un archivo de configuración específico,
usando la opción `--conf = <filepath>`. Los archivos de configuración
no necesitan tener todas las opciones que acabas de ver. Sólo los que
realmente cambian un valor por defecto deben estar allí.
274
275 ## Cambiando el puerto de escucha
276
277 La opción de comando `--xmlrpc-port = <port>` nos permite cambiar el
puerto de escucha de una instancia de servidor desde el predeterminado
8069. Esto se puede usar para ejecutar más de una instancia al mismo
tiempo, en la misma máquina.
278
279 Vamos a probar esto. Abre dos ventanas de terminal. En el primero,
ejecuta esto:
280
281 ```
282 $ ~ / Odoo-dev / odoo / odoo-bin --xmlrpc-port = 8070
283 ```
284
285 Ejecuta el siguiente comando en el segundo terminal:
286
Page 8
capitulo--1.md 07/02/2018

287 ```
288 $ ~ / Odoo-dev / odoo / odoo-bin --xmlrpc-port = 8071
289 ```
290
291 Ahí lo tienes: dos instancias Odoo en el mismo servidor de escucha en
diferentes puertos! Las dos instancias pueden utilizar bases de datos
iguales o diferentes, dependiendo de los parámetros de configuración
utilizados. Y los dos podrían estar ejecutando las mismas o diferentes
versiones de Odoo.
292
293 ### La opción filtro de la base de datos
294
295 Cuando se desarrolla con Odoo, es frecuente trabajar con varias bases
de datos, ya veces incluso con diferentes versiones de Odoo. Detener e
iniciar diferentes instancias de servidor en el mismo puerto y cambiar
entre distintas bases de datos puede provocar que las sesiones de
cliente web se comporten de forma incorrecta.
296
297 El acceso a nuestra instancia utilizando una ventana del navegador que
se ejecuta en modo privado puede ayudar a evitar algunos de estos
problemas.
298
299 Otra buena práctica es habilitar un filtro de base de datos en la
instancia del servidor para asegurarse de que sólo permite las
solicitudes de la base de datos con la que queremos trabajar, ignorando
todos las demás. Esto se hace con la opción `--db-filter`. Acepta una
expresión regular que se utiliza como filtro para los nombres de base
de datos válidos. Para que coincida con un nombre exacto, la expresión
debe comenzar con un `^` y terminar con `$`.
300
301 Por ejemplo, para permitir sólo la base de datos `demo` utilizaríamos
este comando:
302
303 ```
304 $ ~ / Odoo-dev / odoo / odoo-bin --db-filter = ^ demo $
305 ```
306
307 ### Administrar los mensajes de registro del servidor
308
309 La opción `--log-level` nos permite establecer la verbosidad del
registro. Esto puede ser muy útil para entender lo que está sucediendo
en el servidor. Por ejemplo, para habilitar el nivel de registro de
depuración, use la opción `--log-level=debug`.
310
311 Los siguientes niveles de registro pueden ser particularmente
interesantes:
312
313 + `Debug_sql` para inspeccionar consultas SQL generadas por el servidor
314 + `Debug_rp`c para detallar las peticiones recibidas por el servidor
315 + `Debug_rpc_answer` para detallar las respuestas enviadas por el
servidor
316
317 De forma predeterminada, la salida del registro se dirige a la salida
estándar (la pantalla de la consola), pero se puede dirigir a un
archivo de registro con la opción `--logfile=<filepath>`.
318
319 Finalmente, la opción `--dev=all` mostrará el depurador de Python
(`pdb`) cuando se genera una excepción. Es útil hacer un análisis
post-mortem de un error de servidor. Ten en cuenta que no tiene ningún
efecto en la verbosidad del registrador. Puedes encontrar más detalles
sobre los comandos del depurador de Python en
Page 9
capitulo--1.md 07/02/2018

https://docs.python.org/2/library/pdb.html#debugger-commands.
320
321
322 ### Desarrollando desde tu estación de trabajo
323 Puedes estar ejecutando Odoo con un sistema Debian / Ubuntu en una
máquina virtual local o en un servidor a través de la red. Pero puede
que prefieras hacer el trabajo de desarrollo en tu estación de trabajo
personal, utilizando tu editor de texto favorito o IDE. Este suele ser
el caso de los desarrolladores que trabajan desde estaciones de trabajo
Windows. Pero también puede ser el caso de los usuarios de Linux que
necesitan trabajar en un servidor Odoo a través de la red local.
324
325 Una solución para esto es para permitir el uso compartido de archivos
en el huesped Odoo para que los archivos sean fáciles de editar desde
nuestra estación de trabajo. Para las operaciones del servidor Odoo,
como un reinicio del servidor, podemos usar un shell SSH (como PuTTY en
Windows) junto con nuestro editor favorito.
326
327 #### Usando un editor de texto Linux
328 Tarde o temprano, necesitaremos editar archivos desde la línea de
comandos del shell. En muchos sistemas Debian, el editor de texto
predeterminado es vi. Si no te sientes cómodo con él, probablemente
podrías usar una alternativa más amigable. En los sistemas Ubuntu, el
editor de texto predeterminado es nano. Es posible que prefieras este,
ya que es más fácil de usar. En caso de que no esté disponible en tu
servidor, se puede instalar con:
329
330 ```
331 $ sudo apt-get install nano
332 ```
333
334 En las siguientes secciones, asumiremos nano como el editor preferido.
Si prefieres cualquier otro editor, siéntete libre de adaptar los
comandos en consecuencia.
335
336 ## Instalando y configurando Samba
337 El servicio Samba ayuda a que los servicios de compartición de archivos
de Linux sean compatibles con los sistemas Microsoft Windows. Podemos
instalarlo en nuestro servidor Debian / Ubuntu con este comando:
338
339
340 ```
341
342 $ Sudo apt-get instalar samba samba-common-bin
343
344 ```
345
346
347
348 El paquete `samba` instala los servicios de intercambio de archivos y
el paquete `samba-common-bin` es necesario para la herramienta
`smbpasswd`. De forma predeterminada, los usuarios autorizados a
acceder a archivos compartidos deben registrarse con él. Necesitamos
registrar a nuestro usuario, `odoo` por ejemplo, y establecer una
contraseña para su acceso a compartir archivos:
349 ```
350
351
352 $ Sudo smbpasswd -a odoo
353 ```
354
Page 10
capitulo--1.md 07/02/2018

355
356
357
358
359 Después de esto, se nos pedirá una contraseña para usar para acceder al
directorio compartido, y el usuario `odoo` podrá acceder a los archivos
compartidos para su directorio personal, aunque será de sólo lectura.
Queremos tener acceso de escritura, por lo que necesitamos editar el
archivo de configuración de Samba para cambiarlo de la siguiente manera:
360
361 ```
362
363
364 $ Sudo nano /etc/samba/smb.conf
365
366 ```
367
368 En el archivo de configuración, busque la sección `[homes]`. Edita sus
líneas de configuración para que coincidan con la configuración de la
siguiente manera:
369
370 ```
371 [homes]
372 comment = Home Directories
373 browseable = yes
374 read only = no
375 create mask = 0640
376 directory mask = 0750
377 ```
378
379 Para que los cambios de configuración tengan efecto, reinicia el
servicio:
380
381 ```
382 $ sudo /etc/init.d/smbd restart
383 ```
384 #### Tip
385 ##### Descargando el código ejemplo
386
387 Puedes descargar los archivos de códigos de ejemplo para todos los
libros Packt que hayas comprado desde tu cuenta en
http://www.packtpub.com. Si compraste este libro en algun otro sitio,
puedes entrar a http://www.packtpub.com/support y registrate para que
te envien los archivos directamente por correo electrónico.
388
389 Para acceder a los archivos desde Windows, podemos asignar una unidad
de red para la ruta `\\ <my-server-name>\odoo`
390 utilizando el nombre de usuario y la contraseña específicos definidos
con `smbpasswd` Al intentar iniciar sesión con el usuario `odoo`,
podría encontrar problemas con Windows agregando el dominio del equipo
al nombre de usuario (por ejemplo, `MYPC \ odoo`). Para evitar esto,
utilice un dominio vacío añadiendo un caracter`\` al inicio de sesión
(por ejemplo, `\ odoo`):
391
392 
393
394
395 Si ahora abrimos la unidad asignada con el Explorador de Windows,
podremos acceder y editar el contenido del directorio home del usuario
`odoo`:
396
Page 11
capitulo--1.md 07/02/2018

397 
398
399 Odoo incluye un par de herramientas que son muy útiles para los
desarrolladores, y vamos a hacer uso de ellAs a lo largo del libro. Son
características técnicas y el modo de desarrollo. Estos están
desactivados por defecto, por lo que este es un buen momento para
aprender a habilitarlos.
400
401 ### Activación de las herramientas de desarrollo
402 Las herramientas de desarrollo proporcionan una configuración y
funciones avanzadas de servidor. Estos incluyen un menú de depuración
en la barra de menú superior junto con opciones de menú adicionales en
el menú **Settings**, en particular el menú **Technical**.
403
404 Estas herramientas vienen deshabilitadas de forma predeterminada y,
para habilitarlas, debemos iniciar sesión como administrador. En la
barra de menú superior, seleccione el menú **Settings**. En la parte
inferior derecha, debajo de la versión Odoo, encontrará dos opciones
para habilitar el modo de desarrollo; cualquiera de ellas habilitará
los menús **Debug** y **Technical**. La segunda opción, **Activate the
developer mode (whit assest)**, también deshabilita la minificación de
JavaScript y CSS utilizada por el cliente web, facilitando la
depuración del comportamiento del cliente:
405
406 
407
408 Después de eso, la página se vuelve a cargar y debería verse un icono
de error en la barra de menú superior, justo antes del avatar y nombre
de usuario de la sesión que proporciona las opciones de modo de
depuración. Y en la opción **Settings** en el menú superior, deberíamos
ver una nueva sección del menú **Technical** que da acceso a muchos
internos de la instancia de Odoo:
409
410 
411
412 #### Tip
413 La opción **Technical** del menú nos permite inspeccionar y editar
todas las configuraciones Odoo almacenadas en la base de datos, desde
la interfaz de usuario hasta la seguridad y otros parámetros del
sistema. Aprenderás más sobre muchos de estos a lo largo del libro.
414
415 ## Instalación de módulos de terceros
416 Hacer nuevos módulos disponibles en una instancia Odoo para que puedan
instalarse es algo que los recién llegados a Odoo suelen encontrar
confuso. Pero no tiene que ser así, así que vamos a desmitificarlo.
417
418 ## Encontrar módulos comunitarios
419 Hay muchos módulos Odoo disponibles en Internet. La tienda de
aplicaciones de Odoo en apps.odoo.com es un catálogo de módulos que se
pueden descargar e instalar en su sistema. La **Odoo Community
Association (OCA)** coordina las contribuciones de la comunidad y
mantiene bastantes repositorios de módulos en GitHub en
https://github.com/OCA/.
420
421 Para agregar un módulo a una instalación de Odoo, podríamos copiarlo en
el directorio `addons` junto con los módulos oficiales. En nuestro
caso, el directorio `addons` está en `~ / odoo-dev / odoo / addons /`.
Esto podría no ser la mejor opción para nosotros, ya que nuestra
instalación de Odoo se basa en un repositorio de código controlado por
versiones, y queremos mantenerlo sincronizado con el repositorio de
GitHub.
Page 12
capitulo--1.md 07/02/2018

422
423 Afortunadamente, podemos usar ubicaciones adicionales para los módulos
para que podamos mantener nuestros módulos personalizados en un
directorio diferente, sin tenerlos mezclados con los oficiales.
424
425 Como ejemplo, vamos a descargar el código de este libro, disponible en
GitHub, y hacer disponíbles esos módulos addon en nuestra instalación
de Odoo.
426
427 Para obtener el código fuente de GitHub, ejecute los siguientes comandos:
428
429 ```
430 $ cd ~/odoo-dev
431
432 $ git clone https://github.com/dreispt/todo_app.git -b 10.0
433 ```
434 Usamos la opción `-b` para asegurarnos de que estamos escargando los
módulos para la versión 10.0.
435
436 Después de esto, tendremos un directorio nuevo `/ todo_app` junto al
directorio `/ odoo`, que contiene los módulos. Ahora debemos informar a
Odoo sobre este nuevo directorio de módulos.
437
438 ### Configurandola ruta addons
439 El servidor Odoo tiene una opción de configuración llamada
`addons_path` para establecer dónde el servidor debe buscar módulos. De
forma predeterminada, esto apunta al directorio `/ addons`, donde se
ejecuta el servidor Odoo.
440
441 Podemos proporcionar no sólo una, sino una lista de directorios donde
se pueden encontrar módulos. Esto nos permite mantener nuestros módulos
personalizados en un directorio diferente, sin tenerlos mezclados con
los addons oficiales.
442
443 Vamos a iniciar el servidor con una ruta addons que incluye nuestro
nuevo directorio de módulos:
444 ```
445 $ cd ~/odoo-dev/odoo
446
447 $ ./odoo-bin -d demo --addons-path="../todo_app,./addons"
448 ```
449
450 Si miras más de cerca el registro del servidor, notarás una línea que
informa de la ruta de complementos en uso: `INFO? Odoo: addons paths:
[...]`. Confirma que contiene nuestro directorio `todo_app`.
451
452 ### Actualizando la lista de aplicaciones
453 Todavía necesitamos pedirle a Odoo que actualice su lista de módulos
antes de que estos nuevos módulos estén disponibles para la instalación.
454
455 Para ello, necesitamos activar el modo desarrollador, ya que
proporciona la opción de menú **Actualizar Lista de Aplicaciones**. Se
puede encontrar en el menú superior de **Aplicaciones**.
456
457 Después de actualizar la lista de módulos, podemos confirmar que los
nuevos módulos están disponibles para la instalación. Utilice la opción
de menú **Aplicaciones** para ver la lista de módulos locales. Busca
`todo` y deberías ver los nuevos módulos disponibles.
458
459 Ten en cuenta que la segunda opción de menú **App Store** muestra la
lista de módulos del almacén de aplicaciones Odoo en lugar de los
Page 13
capitulo--1.md 07/02/2018

módulos locales:
460
461 
462
463 ## Resumen
464 En este capítulo, aprendimos a configurar un sistema Debian para alojar
Odoo e instalarlo desde el código fuente de GitHub. También aprendimos
a crear bases de datos Odoo y ejecutar instancias de Odoo. Para
permitir a los desarrolladores utilizar sus herramientas favoritas en
su estación de trabajo personal, explicamos cómo configurar el uso
compartido de archivos en el huesped Odoo.
465
466 Ahora deberíamos tener un ambiente Odoo en funcionamiento para trabajar
y estar cómodos con la administración de bases de datos e instancias.
467
468 Con esto en su lugar, estamos listos para ir directamente a la acción.
En el próximo capítulo, crearemos nuestro primer módulo Odoo desde cero
y entenderemos los principales elementos que involucra.
469
470 ¡Entonces empecemos!

Page 14