Application Android - DoliDroid

From Dolibarr ERP CRM Wiki
Revision as of 16:41, 11 October 2015 by Eldy (talk | contribs) (→‎Informations)
Jump to navigation Jump to search

<keywords content="Android, phone, application, Dolibarr, DoliDroid, apk, smartphone, tablet, samsung, galaxy, remote, native, jmobile, download" />

Informations

Module name Application Android
Editor / Editeur NLTechno - http://www.nltechno.com
Download or buy page / Page achat ou téléchargement External module - https://play.google.com/store/apps/details?id=com.nltechno.dolidroidpro
Status / Statut / Estado Stable
Prerequisites / Prérequis

Dolibarr min version: See on Dolistore   

Last update date / Date mise à jour fiche / Fecha última actualización 2015-10-11
Note / Nota

Features

DoliDroid is the Android front-end client for Dolibarr ERP & CRM web software.

This application is not a standalone program. It is a front end to use on your online hosted Dolibarr ERP & CRM software.

The advantage of DoliDroid are :

  • DoliDroid is not a duplicate code of Dolibarr, but a front-end of a Dolibarr web installation, so all your online existing features are supported by this application. This is also true for external modules features.
  • Upgrading Dolibarr will not break DoliDroid.
  • DoliDroid use embedded image resources to reduce bandwidth.
  • DoliDroid use internal cache for pages that should not change (like menu page)
  • Connections parameters are saved. No need to enter them each time you use DoliDroid.
  • Integration with your phone or other applications (Clicking on PDF open PDF reader, clicking onto email or phone launch your email application or launch Android dialer, ...)


Warning.png WARNING ! 

Due to bugs into Dolibarr 3.4, all features you can use in read mode are guaranteed, however, some create or update features are disabled, like creating/editing invoice/order/proposal/contract. With release of Dolibarr 3.5+, all features should be supported with no restrictions.

This application need Android 2.2+ (3.0+ recommended) and an online hosted Dolibarr ERP & CRM version 3.4+ (for example an online instance provided by one of the SaaS/Cloud hosting provider).


Voir video on Youtube: https://www.youtube.com/watch?v=ult2dmHaP4sSee

DoliDroid Video

Installation

  • Manually: If you get the .apk file (whatever is the source), just open the .apk from the smartphone/tablet web browser or file-system browser. This should launch installation of .apk file on your phone.

Once package installation has been done, a new icon called "DoliDroid" is available into the list of your application.

Setup

There is nothing to do once application is installed onto your smartphone.

Usage

  • Run the application
  • Enter the root URL access to your Dolibarr instance (for next time, it will be saved in drop-down list)
  • Use Dolibarr
  • The "Menu" button will bring up the options (permanent display of the back button, purge cache, ...)
  • The "Quick access" button will open a page with the search form you find on left menu when using a standard desktop browser.

Development

Development of this module is not included inside the standard GIT repository of Dolibarr but inside a repository dedicated to modules not supported by the Dolibarr development team but supported by NLTechno on platform GIT by Framasoft:

Note this is a private repository, so you must apply to be a member from https://git.framasoft.org to be able to clone sources using GIT.

Troubleshooting

JSERR001

If you get this error when loaing a page/feature with DoliDroid (including tha login page), this means your Dolibarr installation on server side serve bugged pages. In a common usage of Dolibarr, this may have no visible effect for user. But when used from a smartphone, this make DoliDroid fails loading pages. This is common things to check to solve the problem:

  • If you have installed external modules, try after disabling them (some external modules introduce bugs).
  • Try also to call login page from a standard PC by adding &dol_use_jmobile=1 as parameter of URL and check you don't have any javascript errors.
  • If you installed Dolibarr with the debian package, check into directory /usr/share/javascript that you find a directory called jquery, jquery-ui and flot. If one of this directory is missing (or if all directory /usr/share/javascript) is missing:

- Install missing packages by launching from command line

sudo apt-get install javascript-common libjs-jquery libjs-jquery-ui libjs-flot
sudo apt-get install -f

- Go into config file /etc/dolibarr/conf.php and check you have the following line uncommented (if line is not found, add it at end of file).

$dolibarr_js_JQUERY_FLOT='/javascript/flot';
  • If you installed Dolibarr with the debian package, check into directory /usr/share/javascript/flot that you find a file called jquery.flot.pie.js. If file does not exists, ...