FAQ Desarrolladores

Volver al índice
Documentación desarrolladores

Esta página contiene algunas preguntas-respuestas en relación al desarrollo de Dolibarr. Para preguntas-respuestas sobre su uso, consulte la página FAQ Usuarios.

Cómo convertirse en desarrollador oficial

En la galaxia del proyecto Dolibarr, hay varias partes interesadas distribuidas en diferentes niveles o grados. El número de desarrolladores y las contribuciones son importantes y, cualquier proyecto que desee tener cierto nivel de calidad, debe de estar bajo una gestión controlada y de unas modificaciones validadas para su evolución, tanto en las necesidades funcionales como en su código. Por esta razón, el acceso en escritura a los fuentes (Servidor CVS) está limitado y regido por una organización que se describe en las líneas siguientes. Cada desarrollador tiene un grado que depende de su antigüedad y de sus contribuciones. El nivel de autorización de una persona en el proyecto aumenta con las etapas de promoción de grado.

El curso de un desarrollador Dolibarr pasa a través de estas etapas, que hemos clasificado como un título familiar para los adeptos a la ciencia ficción. Estas son las etapas. Es importante comprender que esta organización tiene el único propósito de mejorar la calidad de Dolibarr y que es necesario que se respete estrictamente a fin de lograrlo. Así que no se ofenda si, como desarrollador, no dispone de un acceso CVS en escritura, antes de un cierto plazo.

* Soldado

La primera cosa que una persona dispuesta a ayudar debe realizar es familiarizase con las reglas y normas de desarrollo.

Leyendo toda la Documentación Desarrolladores, demostrará tener voluntad suficiente para convertirse automáticamente en Soldado de la alianza Dolibarr (Su grado será un nivel de Soldado). La mayoría de los desarrolladores interesados en el desarrollo de Dolibarr se clasifican en esta categoría.

Este grado se obtiene sin validación superior. Es un grado de inicio.

Dada la naturaleza de este grado, no es posible establecer una lista de todos los interesados en el proyecto Dolibarr con este grado (lista en contínua evolución y muy larga).

* Cazador

El grado siguiente consiste en enviar parches, empezando por los simples, a la Lista de Correo de desarrollo (ver FAQ Desarrolladores para el procedimiento), preferiblemente al foro (Lista de Correo preferida).

Puede encontrar las tareas en espera de parche en el gestor de tareas a realizar: http://savannah.nongnu.org/task/?group=dolibarr

Las tareas disponibles son las tareas que tienen la propiedad "Task opened to external developers" a "si". Si el valor es "no", olvídela, ya que será tratada por un desarrollador de grado Jedi.

En su primer envío aceptado (incluido en el CVS por un almirante, Jedi o Yoda), automáticamente entrará en la familia de Cazadores de la alizanda Dolibarr.

El número de cazadores no está limitado. Además, cuantos más tengamos, más fuertes seremos. Los cazadores son la principal fuerza de la alianza Dolibarr.

Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página Category:Chasseur

* Z-6PO

Si habla correctamente un idioma que no está presente o está mal traducido en Dolibarr, un Jedi o Yoda le dará a su login de Savannah los derechos de escritura en los fuentes CVS del proyecto.

Dirígase al sitio http://savannah.nongnu.org para crear una cuenta y pedir la inclusión al proyecto como Z-6PO para su idioma.

Vea Recuperar/actualizar una versión CVS de desarrollo para saber como usar el servidor CVS que contiene los fuentes de los archivos de idiomas a actualizar. Este derecho de escritura en los fuentes solamente puede ser usado con la condición de limitarse únicamente al objetivo de realizar traducciones. Este grado puede obtenerse con rapidez.

Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página Category:Z-6PO

* Almirante

Sólamente después de un tiempo variable (que puede ser muy largo) en la categoría de Cazador, y si la calidad de los parches envíados son satisfactorios, un Yoda le ofrecerá acceso directo a CVS. Se habrá convertido en un Almirante de la alianza Dolibarr.

Este título no se pide, se obtiene por decisión o proposición de un Jedi ó Yoda que ha estimado que ha enviado suficientes parches como para ser un Almirante serio. El acceso a CVS de un Almirante debe de ser utilizado para confirmar traducciones, correcciones de bugs declarados en Savannah (BUG Tracker http://savannah.nongnu.org/bugs/?group=dolibarr) o en el foro (tanto correcciones personales como parches enviados por un Cazador). Toda confirmación CVS debe incluir obligatoriamente en la descripción (el campo log de la confirmación), el número de bug de Savannah corregido o el título del mensaje del foro que indica el problema. Sólo una traducción escapa a esta limitación (no hay restricciones para las traducciones). El incumplimiento de esta limitación, puede dar lugar a la degradación a la categoría de Cazador. Para el envío de nuevas funcionalidades, debe seguir obligatoriamente los principios indicados acerca de los parches enviados a la Lista de Correo (Mailing List).

la obtención del grado de Almirante es rara porque está limitada. La calidad de Dolibarr sólamente puede ser mantenida con un número de Almirantes controlado, ello no implica el tener un número de desarrolladores (Cazadores) importante (gracias al sistema de parches)

Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página Category:Admiral

* Jedi

Después de un tiempo variable (probablemente el más largo de todos) como Almirante, y si la calidad de los parches enviados es satisfactoria, un Yoda le dirá que está autorizado para realizar confirmaciones de funcionalidades sin restricciones, a condición de la aprobación de un maestro Yoda al que explicará la funcionalidad a confirmar. Puede haber una restricción temporal definida por un Yoda debido a una próxima release cercana. Usted se convertirá en un Jedi.

Ese título no se pide, se obtiene de otro Jedi o de un Yoda.

Este privilegio, sin embargo, es excepcional. La calidad de Dolibarr sólamente puede ser mantenida con un número de Jedis controlado, ello no implica el tener un número de desarrolladores (Cazadores) importante (gracias al sistema de parches)

Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página Category:Jedi

* Yoda

En un número de 1 a 5, los Yoda gestionan globalmente el desarrollo del proyecto. Este rango se obtiene por sucesión, a raíz de la salida de un Yoda que se retire por nominación directa o votación de los Yoda existentes

Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página Category:Yoda

* ¿ Y Darth Vader ?

Existe. Siempre habrán parásitos que contaminen el foro o lista de correo con mensajes o críticas no constructivas, que frenan el desarrollo de Dolibarr en lugar de ofrecer una crítica constructiva para ayudar a avanzar. Algunos son con bastante mala intención y mal tono. Son los que llamamos Darth Vader Afortunadamente, estadísticamente sólo hay constancia de la aparición y muerte de uno o dos Darth Vader por año...

El equipo actual

Ver la página Proyecto Dolibarr para obtener una lista actualizada de las personas que trabajan en cada categoría.

Iniciar el desarrollo

Consulte totalmente la Documentación Desarrolladores para asimilar todas las normas y principios exigidos a los desarrolladores. También puede consular los siguientes FAQ.

Recuperar/actualizar una versión CVS de desarrollo

Recuperación de la última versión de los fuentes con acceso CVS anónimo

Sin cuenta Savannah o sin autorización de acceso CVS en escritura, puede utilizar un cliente CVS (como pueda ser WinCVS o TortoiseCVS en windows, el cliente CVS de Eclipse o la línea de comandos CVS en Linux) para recuperar los fuentes del proyecto.

El comando que permite recuperar la totalidad de los archivos de un directorio es:

CVSROOT=:pserver:anonymous@cvs.savannah.nongnu.org:/cvsroot/dolibarr
export CVSROOT
cvs -q checkout -r HEAD dolibarr

HEAD significa que queremos la última versión en curso de desarrollo.

Recuperación de la última versión de los fuentes con acceso CVS completo

Otro método para recuperar la versión CVS es el uso de las utilidades CVS. Debe de tener una cuenta Savannah con acceso CVS en escritura (Tiene que indicar su llave pública en la página https://savannah.gnu.org/my/admin/editsshkeys.php) y un cliente CVS (comandos CVS bajo Linux, WinCVS o TortoiseCVS bajo Windows, o el cliente CVS en Eclipse...).

El comando que permite recuperar la totalidad de los archivos de un directorio es:

CVSROOT=:ext:yoursavannahlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr
export CVSROOT
cvs -q checkout -r HEAD dolibarr

HEAD significa que queremos la última versión en curso de desarrollo.

Recuperar los módulos complementarios

Se encuentra disponible un segundo repositorio CVS para los módulos no oficiales o especiíficos, se encuentra disponible en el módulo CVS dolibarrmod

CVSROOT=:ext:yoursavannahlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr
export CVSROOT
cvs -q checkout -r HEAD dolibarrmod

Usar Eclipse para recuperar la versión CVS CVS

El proceso se detalla en la página Configurar Eclipse para recuerar la versión CVS

Actualizar su repositorio CVS

El comando que permite actualizar localmente una copia de trabajo CVS (repositorio), que ya ha sido tratada por un checkout CVS, es la siguiente:

Bajo linux:

cvs -q update -P -d

Bajo Windows con Tortoise cvs

"C:\Program Files\CVSNT\cvs.exe" -q update -P -d

Y para actualizar su copia local anulando las modificaciones realizadas en sus fuentes locales, añadir la opción -C:

Bajo linux:

cvs -q update -P -C -d

Bajo Windows con Tortoise cvs

"C:\Program Files\CVSNT\cvs.exe" -q update -P -C -d

Si es necesario, cambie los permisoss de propiedad en los directorios, para que el servidor tenga acceso.

Recuperación de otra rama por CVS

Si desea obtener una versión particular (con sus parches), deberá seguir el mismo proceso, reemplazando HEAD por el nombre de la rama. Por ejemplo DOLIBARR_2_2_BRANCH para obtener la rama 2.2 o DOLIBARR_2_4_BRANCH para la rama 2.4.

Recuperación de la última version de los fuentes mediante descarga

Este método le permite recuperar el snapshot diario de la versión CVS del desarrollo principal (llamado HEAD) sin utilizar un software cliente CVS. La operación consiste en descargar la última versión de los archivos de Dolibarr que se montan todas las noches en un zip. Para ello, vaya a la página versión CVS del día.

Los nuevos archivos remplazarán a los antiguros.

El inconveniente de este método consiste en que deberá descargar todo cada vez para actualizarse.

Actualización de la base de datos

Si acaba de realizar una actualización, el próximo paso consiste en migrar la base de datos para coordinarla con los nuevos fuentes. Para ello, simplemente vaya a http://midolibarr/install/ y escoja la opción "Actualizar".

Este proceso de migración/actualización está diseñado para funcionar independientemente del estado de inicio y puede ser realizado varias veces sin riesgo.

Cómo crear un nuevo Tema

Para ello consulte la página Temas

Cómo desarrollar mi própio sistema de menús

Para ello consulte la página Sistema de menús

Cómo desarrollar mi propio módulo

Para desarrollar su propio módulo de numeración, consulte Crear un módulo de numeración.

Para desarrollar su propio modelo de documento, PDF o otro, consulte Crear un modelo de documento PDF o Crear un modelo de documento ODT.

Para desarrollar un módulo funcional completo (pantallas, tablas), consulte Desarrollo de un módulo.

Cómo añadir o completar una traducción

Para ello consulte la página Documentación traductores

Cambiar mi sistema de numeración de las facturas en curso

Si el nuevo sistema de numeración no entra en conflicto con el antiguo, será suficiente con ir al menú Configuración - Módulos - Configuración facturas y escojer un nuevo modelo de la lista. Si el nuevo sistema entra en conflicto, será necesario renumerar las referencias existentes. Esto se puede realizar mediante una consulta SQL. Por ejemplo, para pasar de Jupiter (FYYYYMM99) a Terre (FAYYMM-999), puede ejecutar la siguiente consulta:

update llx_facture set facnumber=concat('FA',substr(facnumber,4,4),'-',substr(facnumber,8))
where facnumber like 'F%' and facnumber not like 'FA%';

Por ejemplo, para pasar de un modelo FAYYMM999 a Terre (FAYYMM-999), puede ejecutar la siguiente consulta:

update llx_facture set facnumber=concat('FA',substr(facnumber,3,4),'-',substr(CONCAT('0000',substr(facnumber,7)),-4))
where facnumber like 'FA%' and facnumber not like '%-%';

Enviar un parche, mejora o participar en el desarrollo

Si busca como comenzar o ayudar en los desarrollos de Dolibarr, lea el capítulo FAQ Desarrolladores - Convertirse en desarrollador oficial. Si su parche ya está listo y desea distribuirlo, este capítulo es el indicado.

Con acceso CVS en modo escritura

A día de hoy, los accesos en escritura a CVS están restringidas (el número de confirmaciones és bastante dinámico). Si usted posee en la actualidad de un acceso en escritura CVS, utilícelo con la condición de que sus confirmaciones corresponden a su grado de desarrollador Dolibarr (Ver FAQ Desarrolladores - Convertirse en desarrollador oficial para los diferentes grados). Si no dispone de acceso a CVS (usted está en el grado de miembro o cazador de la alianza Dolibarr), deberá seguir el procedimento que sigue a continuación..

Sin acceso CVS en escritura

Sin acceso CVS en escritura (sin cuenta desarrollador savannah), será necesario generar y enviar un parche a la Lista de Correo (Mailing List dolibarr-dev https://savannah.nongnu.org/mail/?group=dolibarr). A continuación le explicamos como generar un parche:

En todos los SO:

He aquí el método Pro de como trabajar para poder generar un fichero patch:

- Tener un directorio con la versión de referencia Dolibarr (resultante de la actualización desde CVS o bien el resultante de la descompresión de un snapshot tgz de Dolibarr). Llamaremos a este directorio viejo_rep. Puede recuperar el snapshot de la versión de desarrollo en curso en web ofical de Dolibarr.

- Tener otro directorio que contiene Dolibarr pero en la que realiza o ha realizado sus modificaciones. Llamará a este directorio nuevo_rep.

para generar el fichero patch, deberá ejecutar el comando diff (estándard de Linux, en windows cygwin) de la siguiente manera:

diff -BNaur --exclude=CVS --exclude="*.patch" --exclude=".#*" --exclude="*~" --exclude="*.rej"
     --exclude="*.orig" --exclude="*.bak" --exclude=conf.php --exclude=documents  
     viejo_rep nuevo_rep  > mypatch.patch

En el directorio build/patch se encuentra disponible un script ksh que realiza este comando. Envíe su parche a la Lista de Correo. la integración de su parche no está garantizada, pero si el parche ha sido realizado siguiendo rigurosamente este procedimiento, tiene muchas posibilidades de que sea testeado (de otro modo las posibilidades estarán cercanas a 0).

Bajo Windows:

Si trabaja bajo Windows, un método menos Pro pero que dá el mismo resultado es el siguiente: Instale la excelente utilidad open source de comparación Winmerge, que puede realizar parches en formato diff -Naur. Para ello, compare con Winmerge el fichero de referencia y el modificado y escoja en el menú "Herramientas - Crear correción" (Générer des retouches en la versión francesa). Indicar un nombre de fichero como "resultat.patch", Marcar la casilla "Añadir" y escojer la opción de estilo "Unificado" (Style : unifié en la versión francesa). Haga clic en "Aceptar". Repetir el proceso para cada fichero modificado. Finalmente, obtendremos un bonito fichero que contiene todas las modificaciones en el formato correcto.

En lugar de buscar manualmente los archivos, si ha instalado conjuntamente TortoiseCVS y WinMerge, puede disponer de su versión modificada en el equipo, y la versión CVS en línea. En el explorador de Windows, haga clic derecho en el archivo que debe ser parchado, y seleccione "CVS comparar" (no WinMerge, que se encuentra unas pocas líneas más abajo). Tortoise pondrá en marcha WinMerge. Luego repita el procedimiento descrito anteriormente.

Testear/Aplicar un patch Para aplicar un archivo patch en una versión no modificada, con el fin de integrar las modificaciones contenidas en el archivo patch, puede usar la herramienta patch. Imaginemos que tiene un directorio de fuentes de una versión no modificada de Dolibarr en un servidor. Para aplicar el patch, colóquelo en el direcotrio raíz de Dolibarr y lance el comando

patch -u -p0 -d . < monfichier.patch

Información: -p0 permite utilizar la ruta completa tal como se indica dentro en el parche para encontrar los archivos a modificar (-pn retirando los n primeros niveles del árbol de directorios) -d permite precisar la ruta relativa de la carpeta htdocs a parchear. < permite indicar la ruta hacia el fichero fuente a utilizar (el patch en modo unificado) -u permite precisar que el parche está en modo unificado

Enviar un patch por mail

Una vez el archivo del parche se ha creado y testeado correctamente, debe enviar el archivo a la lista de correo dolibarr-dev (Mire aquí para ello https://savannah.nongnu.org/mail/?group=dolibarr).

Esta lista de correo es leída por la mayoría de los desarrolladores de Dolibarr, sin embargo no podemos decir si el parche será procesado ni si se incluirá. Depende de la calidad del parche y las prioridades del momento.

Cómo empaquetar/liberar un módulo

Para ello consulte la página Crear un paquete para liberar e instalar su módulo El proceso es igualmente válido para generar un fichero para www.dolistore.com.

¿ Cómo estar informado de lo que sucede en Dolibarr ?

Ver la página FAQ Cómo puedo estar informado de lo que sucede en Dolibarr ?

Migrar mi base de datos de MySQL a PostgreSQL

Vea la página FAQ_Migrar_mi_base_de_datos_MySQL_hacia_PostgreSQL