Difference between revisions of "FAQ Desarrolladores"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
m
Tag: 2017 source edit
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
<!-- BEGIN interlang links -->
 +
<!-- Do NOT edit this section
 +
    Links below are automatically managed by PolyglotBot
 +
    You can edit links on the English source page : Developer_FAQ -->
 +
[[en:Developer_FAQ]]
 +
[[fr:FAQ_Développeur]]
 +
[[de:Entwickler_FAQ]]
 +
[[zh:开发者常见问题解答]]
 +
<!-- END interlang links -->
 +
 
[[Category:FAQ ES]]
 
[[Category:FAQ ES]]
 
{{TemplateDocDesarrollo}}
 
{{TemplateDocDesarrollo}}
Line 5: Line 15:
  
 
= Cómo convertirse en desarrollador oficial =
 
= 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.
+
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 GIT) 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.
+
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 GIT en escritura, antes de un cierto plazo.
  
 
<span id="Soldado">'''* Soldado'''</span>
 
<span id="Soldado">'''* Soldado'''</span>
Line 14: Line 24:
  
 
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.
 
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).
 
 
<span id="Cazador">'''* Cazador'''</span>
 
  
 
El grado siguiente consiste en enviar parches, empezando por los simples, a la Lista de Correo de desarrollo (ver [[FAQ_Desarrolladores#Enviar un parche, mejora o participar en el desarrollo |FAQ Desarrolladores]] para el procedimiento), preferiblemente al foro (Lista de Correo preferida).  
 
El grado siguiente consiste en enviar parches, empezando por los simples, a la Lista de Correo de desarrollo (ver [[FAQ_Desarrolladores#Enviar un parche, mejora o participar en el desarrollo |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
+
Puede encontrar las tareas en espera de parche en el gestor de tareas a realizar: {{TemplateURLTasks}}
  
 
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.  
 
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 soldado no está limitado. Además, cuantos más tengamos, más fuertes seremos.
 +
Los soldados son la principal fuerza de la alianza Dolibarr.
  
El número de cazadores no está limitado. Además, cuantos más tengamos, más fuertes seremos.
+
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 continua evolución y muy larga).
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]]
 
  
 
<span id="Z-6PO">'''* Z-6PO'''</span>
 
<span id="Z-6PO">'''* Z-6PO'''</span>
  
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.
+
Si habla correctamente un idioma que no está presente o está mal traducido en Dolibarr y conoce GIT, use el sistema de push para publicar sus correcciones y ajustes.
 
+
El equipo seguramente le añadirá a la página oficial de traductores ([[:Category:Z-6PO]]) después de varios push
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 [[FAQ_Desarrolladores#Recuperar.2Factualizar_una_versi.C3.B3n_CVS_de_desarrollo|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]]
+
Si no conoce el sistema GIT, envíe sus correcciones sobre la última versión por e-mail a la lista de correo '''dolibarr-dev''' (Inscripción desde la página {{TemplateURLMLDev}}). Sin embargo, es preferible la primera solución basada en los push de GIT.
  
 
<span id="Almirante">'''* Almirante'''</span>
 
<span id="Almirante">'''* Almirante'''</span>
  
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.
+
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 GIT. 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)
+
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 GIT de un '''Almirante''' debe de ser utilizado para confirmar traducciones, correcciones de bugs declarados (BUG Tracker {{TemplateURLBugs}})
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).
+
o en el foro (tanto correcciones personales como parches enviados por un '''Cazador'''). Toda confirmación GIT debe incluir obligatoriamente en la descripción (el campo log de la confirmación), el número de bug de 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 '''Soldado'''.
 
 
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)
+
la obtención del grado de Almirante es rara porque está limitada. La calidad de Dolibarr solamente 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]]
 
Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página [[:Category:Admiral]]
Line 61: Line 60:
 
Ese título no se pide, se obtiene de otro Jedi o de un Yoda.
 
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)
+
Este privilegio, sin embargo, es excepcional. La calidad de Dolibarr solamente 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]]
 
Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página [[:Category:Jedi]]
Line 83: Line 82:
 
También puede consular los siguientes FAQ.
 
También puede consular los siguientes FAQ.
  
= Recuperar/actualizar una versión CVS de desarrollo =
+
= Recuperar/actualizar una versión de desarrollo =
===Recuperación de la última versión de los fuentes con acceso CVS anónimo===
+
Ve la pagina [[Recuperar, actualizar GIT fuentes del proyecto]].
Sin cuenta Savannah o sin autorización de acceso CVS en escritura, puede utilizar un cliente CVS (como pueda ser [http://www.wincvs.org WinCVS] o [http://www.tortoisecvs.org 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:
 
<source lang="bash">
 
CVSROOT=:pserver:anonymous@cvs.savannah.nongnu.org:/cvsroot/dolibarr
 
export CVSROOT
 
cvs -q checkout -r HEAD dolibarr
 
</source>
 
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:
 
<source lang="bash">
 
CVSROOT=:ext:yoursavannahlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr
 
export CVSROOT
 
cvs -q checkout -r HEAD dolibarr
 
</source>
 
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
 
<source lang="bash">
 
CVSROOT=:ext:yoursavannahlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr
 
export CVSROOT
 
cvs -q checkout -r HEAD dolibarrmod
 
</source>
 
 
 
===Usar Eclipse para recuperar la versión CVS CVS===
 
El proceso se detalla en la página
 
[[Herramientas_de_Desarrollo#Configurar_Eclipse_para_recuperar_la_versi.C3.B3n_CVS|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:''
 
<source lang="bash">
 
cvs -q update -P -d
 
</source>
 
''Bajo Windows con Tortoise cvs''
 
<source lang="bash">
 
"C:\Program Files\CVSNT\cvs.exe" -q update -P -d
 
</source>
 
Y para actualizar su copia local anulando las modificaciones realizadas en sus fuentes locales, añadir la opción -C:
 
 
 
''Bajo linux:''
 
<source lang="bash">
 
cvs -q update -P -C -d
 
</source>
 
''Bajo Windows con Tortoise cvs''
 
<source lang="bash">
 
"C:\Program Files\CVSNT\cvs.exe" -q update -P -C -d
 
</source>
 
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 [http://www.dolibarr.org/downloads/cat_view/64-development-version 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 =
 
= Cómo crear un nuevo Tema =
 
Para ello consulte la página [[Temas]]
 
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 =
 
= 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 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]].
+
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]].
 
Para desarrollar un módulo funcional completo (pantallas, tablas), consulte [[Desarrollo de un módulo]].
Line 198: Line 118:
 
Convertirse en desarrollador oficial]]. Si su parche ya está listo y desea distribuirlo, este capítulo es el indicado.
 
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 ==
+
== Con acceso GIT ==
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#Cómo convertirse en desarrollador oficial|FAQ Desarrolladores -
+
A día de hoy, los accesos en escritura a GIT están restringidas (el número de confirmaciones és bastante dinámico). Si usted posee en la actualidad de un acceso en escritura GIT, utilícelo con la condición de que sus confirmaciones corresponden a su grado de desarrollador Dolibarr (Ver [[FAQ_Desarrolladores#Cómo convertirse en desarrollador oficial|FAQ Desarrolladores -
 
Convertirse en desarrollador oficial]] para los diferentes grados).
 
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..
+
Si no dispone de acceso a GIT (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 GIT ==
Sin acceso CVS en escritura (sin cuenta desarrollador savannah), será necesario que envíe su fichero 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:
+
Sin acceso GIT en escritura, será necesario generar y enviar un parche a la Lista de Correo (Mailing List dolibarr-dev {{TemplateURLMLDev}}). A continuación le explicamos como generar un parche:
  
 
''En todos los SO'': [[Image:Logo_windows.png|20px]] [[Image:Logo_ubuntu.png|20px]] [[Image:Logo_apple.png|20px]]
 
''En todos los SO'': [[Image:Logo_windows.png|20px]] [[Image:Logo_ubuntu.png|20px]] [[Image:Logo_apple.png|20px]]
Line 210: Line 130:
 
He aquí el ''método Pro'' de como trabajar para poder generar un fichero patch:
 
He aquí el ''método Pro'' de como trabajar para poder generar un fichero patch:
  
- Tener una carpeta 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 esta carpeta '''viejo_rep'''. Puede recuperar el snapshot de la versión de desarrollo en curso en  [http://www.dolibarr.org/component/option,com_docman/task,cat_view/gid,50/Itemid,36/lang,en/ web ofical de Dolibarr].
+
- Tener un directorio con la versión de referencia Dolibarr (resultante de la actualización desde GIT 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  [https://www.dolibarr.org/downloads/ web ofical de Dolibarr].
  
- Tener otra carpeta que contiene Dolibarr pero en la que realiza o ha realizado sus modificaciones. Llamará a esta carpeta '''nuevo_rep'''.
+
- 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 [http://www.cygwin.org/cygwin cygwin]) de la siguiente manera:
+
para generar el fichero patch, deberá ejecutar el comando '''diff''' (estándard de Linux, en windows [https://www.cygwin.org/cygwin cygwin]) de la siguiente manera:
 
<source lang="bash">
 
<source lang="bash">
diff -BNaur --exclude=CVS --exclude=".#*" --exclude="*~" --exclude='*.rej' --exclude='*.orig'
+
diff -BNaur --exclude=CVS --exclude="*.patch" --exclude=".#*" --exclude="*~" --exclude="*.rej"
--exclude="*.bak" --exclude=conf.php --exclude=documents  ancien_rep  nouveau_rep > fichier.patch
+
    --exclude="*.orig" --exclude="*.bak" --exclude=conf.php --exclude=documents   
 +
    viejo_rep nuevo_rep > mypatch.patch
 
</source>
 
</source>
 +
En el directorio '''build/patch''' se encuentra disponible un script ksh que realiza este comando.
 
Envíe su parche a la Lista de Correo.
 
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).
 
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).
Line 228: Line 150:
 
Finalmente, obtendremos un bonito fichero que contiene todas las modificaciones en el formato correcto.
 
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'''.
''Aplicar un 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
 
 
Si su parche todavía no se ha aplicado, pero usted quiere que la aplicación en su servidor esté actualizada desde el CVS, podrá aplicarlo desde la utilidad patch.
 
 
 
Asumiendo que ha creado el parche desde la carpeta htdocs de su copia local modificada de la versión CVS original, y que ha enviado el parche (mifichero.patch) al servidor, a su carpeta patchs, situado al mismo nivel que su carpeta htdocs, el siguiente comando debería realizar el proceso (ejecutado desde la carpeta patchs):
 
 
<source lang="bash">
 
<source lang="bash">
patch -u -p0 -d ../htdocs < mifichero.patch
+
patch -u -p0 -d . < monfichier.patch
 
</source>
 
</source>
<nowiki>Información: -p0 permite utilizar la ruta completa tal como se indica dentro en el parche (-pn retirando los n primeros niveles del árbol de directorios)
+
<nowiki>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.
 
-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)
 
< 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</nowiki>
 
-u permite precisar que el parche está en modo unificado</nowiki>
 +
 +
''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 {{TemplateURLMLDev}}).
 +
 +
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 =
 
= Cómo empaquetar/liberar un módulo =
 
Para ello consulte la página [[Desarrollo_de_un_módulo#Crear_un_paquete_para_liberar_e_instalar_tu_m.C3.B3dulo|Crear un paquete para liberar e instalar su módulo ]]
 
Para ello consulte la página [[Desarrollo_de_un_módulo#Crear_un_paquete_para_liberar_e_instalar_tu_m.C3.B3dulo|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 ?=
 
=¿ Cómo estar informado de lo que sucede en Dolibarr ?=

Latest revision as of 14:48, 19 January 2025

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 GIT) 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 GIT 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.

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: https://github.com/Dolibarr/dolibarr/issues

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.

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

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 continua evolución y muy larga).

* Z-6PO

Si habla correctamente un idioma que no está presente o está mal traducido en Dolibarr y conoce GIT, use el sistema de push para publicar sus correcciones y ajustes. El equipo seguramente le añadirá a la página oficial de traductores (Category:Z-6PO) después de varios push

Si no conoce el sistema GIT, envíe sus correcciones sobre la última versión por e-mail a la lista de correo dolibarr-dev (Inscripción desde la página https://savannah.nongnu.org/mail/?group=dolibarr). Sin embargo, es preferible la primera solución basada en los push de GIT.

* 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 GIT. 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 GIT de un Almirante debe de ser utilizado para confirmar traducciones, correcciones de bugs declarados (BUG Tracker https://github.com/Dolibarr/dolibarr/issues) o en el foro (tanto correcciones personales como parches enviados por un Cazador). Toda confirmación GIT debe incluir obligatoriamente en la descripción (el campo log de la confirmación), el número de bug de 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 Soldado.

la obtención del grado de Almirante es rara porque está limitada. La calidad de Dolibarr solamente 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 solamente 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 de desarrollo

Ve la pagina Recuperar, actualizar GIT fuentes del proyecto.

Cómo crear un nuevo Tema

Para ello consulte la página Temas

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 GIT

A día de hoy, los accesos en escritura a GIT están restringidas (el número de confirmaciones és bastante dinámico). Si usted posee en la actualidad de un acceso en escritura GIT, 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 GIT (usted está en el grado de miembro o cazador de la alianza Dolibarr), deberá seguir el procedimento que sigue a continuación..

Sin acceso GIT

Sin acceso GIT en escritura, 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: Logo windows.png Logo ubuntu.png Logo apple.png

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 GIT 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: Logo windows.png

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.

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