Differences

This shows you the differences between two versions of the page.

--- androidclientuserguide [2016/12/14 15:31] – [Application configuration] Use SPP and add new scanners fappels
+++ androidclientuserguide [2021/06/07 18:57] – fappels
@@ Line 9: / Line 9: @@
 ==== Application configuration ====
-=== Connector setup ===
+=== Connection configuration ===
 On first installation the application will show the setup screen by default, you can always change these settings.
-To be able to connect to the ERP system server, you will need to set the server url and a name to identify yourself. The default URL will the demo server URL, you can change to your own URL. IMPORTANT, if you are already connected the demo server, do not change the Demo url, but first remove the Demo connection by tapping the 'trash' button.
+To be able to connect to the Dolibarr system server, you will need to set the server type, server url and a name to identify yourself.
-You can’t enter your personal user account of the used system. Instead you need to enter a name (for example your first name) to identify yourself to the server. The server administrator needs to assign a system user account to your identification. Only after this assignment you can access the server data. See [[dolibarrconnectoruserguide|Dolibarr connector documentation]] for instructions. You also need to provide this name when requesting your license key.
+The default URL will the demo server URL, you can change to your own URL before connecting to demo. IMPORTANT, if you are already connected the demo server, do not change the Demo url, but first remove the Demo connection by tapping the 'trash' button.
-You can share your device with multiple users or connect to multiple servers. Each user-server combination has its own application settings. When you change your system user-display language or if the connector is upgraded to a newer version, you will need to synchronize the display language.
+== Field descriptions ==
+  * The connector type select field allows you to choose how you installed the connector, standard custom or the unzip in dolibarr root installation. You also have a normal or slow version, the slow version has extended connection timeout (for example slow 3G connection or some slow background sync process on object updates, like sending email to customer). The slow mode also limits the pre-loaded object lists to 25 items.
+  * The URL text field is your Dolibarr url, the same you enter in your web navigator. Standard Mobilid only allows secure https connection. You can download a less secure APK version [[downloads|here]] for connecting to your http server. You also need to enter explicit http, because Mobilid will default try https.
+  * The identification test field is not your personal user account Dolibarr, instead you need to enter a name (for example your first name) to identify yourself to the server. The server administrator needs to assign a system user account to your identification. Only after this assignment you can access the server data. See [[dolibarrconnectoruserguide|Dolibarr connector documentation]] for instructions. You also need to provide this name when requesting your license key.You can share your device with multiple users or connect to multiple servers. Each user-server combination has its own application settings.
 {{ :pasted:20141018-124836.png?nolink640 |Connector Setup}}
 ----
@@ Line 23: / Line 27: @@
 If you want to connect to multiple servers, you must tap the '+' button. Mobilid will setup a new connection to this server. You can switch between connections using the connection selector at the bottom. Only if you move your server you can change the provider URL, you can't connect to another server by changing the provider URL.
+----
+A demo connection is available at [[https://dolidemo.zapplica.net/dolibarr]]. Use this URL in the 'provider' field and you can connect to the demo by entering any text in the 'indentification' field.
+If you want to add products or validate orders, you can login into the demo Dolibarr setup with login 'demo' and password 'demo'.
+== For trying inventory barcode scanning, there is a product available with barcode: ==
+{{ :barcode.png?200 |}}
+== For trying customer barcode scanning, there is a customer available with barcode: ==
+{{ :pasted:20141019-234024.png }}
+Scan customer barcode in customer search screen to add a new order for this customer in the order module.
+== For selecting warehouse: ==
+{{ :barcode_warehouse.png |}}
+Scan barcode in warehouse select page.
 ----
 === Bluetooth setup ===
-If your device has bluetooth capability, you can configure an external bluetooth barcode scanner in the setup screen. You need to configure your scanner in SPP mode, in SPP mode you don't need to put focus on a field like HID mode requires.
+If your device has Bluetooth capability, you can configure an external Bluetooth barcode scanner in the setup screen. You need to configure your scanner in SPP mode, in SPP mode you don't need to put focus on a field like HID mode requires.
+----
+== Field descriptions ==
+  * The Bluetooth slider button is for enabling the Bluetooth connectivity. When you enable you will be asked to scan for new to pair devices or to skip and when your device is already known for your Android device. When you do want to scan for new devices, be sure your devices is already in pairing mode. When pairing a new Bluetooth device you will need to enter a PIN code from the pairing device, for the OPN2002 you will need to enter the last 4 characters of the device name. If the characters contain alpha characters you need to enable Alpha-Numeric input mode.
+  * The device type select field defines scanner model, each model has it's own barcode string end (CR, LF, both or none). the 'Opticon' type covers most models. See [[androidclientspecs|Mobilid Android client specifications]] for list of supported devices and which type to select.
+  * The device select field lets you choose your connectable Bluetooth device.
+{{ :pasted:20210607-165954.png?nolink&320 |Bluetooth setup}}
+----
+== Tutorial video ==
 [[pairconnect|Pair bluetooth scanner]]
@@ Line 32: / Line 57: @@
 [[pairedconnect|Connect Paired bluetooth scanner]]
-Following devices are supported:
+If you are not sure your Barcode reader is supported, please send technical info to [[mailto:info@z-application.com?subject=Please%20support%20new%20bluetooth-barcode-scanner|info@z-application.com]]
-  * Microvision ROV
-  * Opticon OPN Data collector series
-  * Generalscan Bluetooth Laser Companion Barcode Scanner
-  * Eyoyo scanner (select Eyoyo or Opticon, depends on HW version)
-  * Inateck BCST-10 (select Generalscan)
-If you want to know if your device can be supported, contact: [[mailto:info@z-application.com?subject=Please%20support%20new%20barcode-scanner|info@z-application.com]]
 ----
-{{ :bluetooth_setp_resize.png?nolink&800|Bluetooth setup}}
-----
+=== Android Terminal barcode readers ===
-{{ :bluetooth_srch_resize.png?nolink&750|Bluetooth search}}
-----
+Mobilid also can read barcodes from Android terminal with build in barcode readers.
-{{ :pasted:20141017-212801.png?nolink&250|Bluetooth pair}}
-When pairing a new bluetooth device you will need to enter a PIN code from the pairing device, for the OPN2002 you will need to enter the last 4 characters of the device name. If the characters contain alpha characters you need to enable Alpha-Numeric input mode. In this example you will need 4BEE (in uppercase !).
+== Field descriptions ==
-----
-A demo connection is available at [[http://dolidemo.cloudapp.net/dolibarr]]. Use this URL in the 'provider' field and you can connect to the demo by entering any text in the 'indentification' field.
+  * The Pda Scan mode select field is only available on the [[https://buy.mobilid.eu/shop/en/android-terminals/2-pda401-1d-barcode-terminal.html|PDA401 device]]. You can select the scan time, timed (stop after 3 seconds), stop after valid code read or read continuous (no need to tap scan button for new read, will use more battery power). Other Terminal can have this setting in a device specific barcode reader configuration app.
-If you want to add products or validate orders, you can login into the demo Dolibarr setup with login 'demo' and password 'demo'.
+  * Broadcast name barcode reader text field is for entering de Broadcast intent name. If your terminal supports reading barcode from a Broadcast indent you can enter the value here. Check your manual or ask your device supplier if the is available on your device. Some Terminal do not have a Broadcast intent, for these devices some specific code is included in Mobilid and the devices are auto-detected at application startup. See [[androidclientspecs|Mobilid Android client specifications]] for list of supported devices and which is auto detected or needs Broadcast name configuration. If your device is not in list or has no broadcast intend please contact: [[mailto:info@z-application.com?subject=Please%20support%20new%20pda-barcode-scanner|info@z-application.com]]
-== For trying inventory barcode scanning, there is a product available with barcode: ==
+  * Broadcast data key text field is a second value that should be provided with the broadcast name. After entering these values you need to restart the Mobilid Application because the barcode reader process is only started at application startup.
-{{ :barcode.png?200 |}}
+  * The Disable Camera scan checkbox will disable the soft scan button which actives the camera scanner, on a terminal you probably do not need the camera scanner and can be annoying when accidental opening camera-scanner.
-== For trying customer barcode scanning, there is a customer available with barcode: ==
-{{ :pasted:20141019-234024.png }}
+{{ :pasted:20210607-181412.png?nolink&320 |Terminal configuration}}
-Scan customer barcode in customer search screen to add a new order for this customer in the order module.
 ----
+=== Other configuration ===
+== Field descriptions ==
+  * The Language sync checkbox is to reload the language localization. When you change your system user-display language or if the connector is upgraded to a newer version, you will need to synchronize the display language.
+  * The auto save checkbox will allow not to show confirmation popups when saving data to the server, be careful because pressing the back button will save you changes without any notification.
+  * The clear search fields checkbox is for clearing the list search fields after each search. Un-checked will remember last search value.
+  * Chars for trigger select field sets number of chars to enter in search field before search will start.
+  * Show Photos checkbox will show product images and company logo in the lists and forms.
+  * Allow editing when adding photos will add some basic photo editing like cropping before upload product photos to the server.
 ===== Application usage =====