Mobilid

User Tools

Site Tools

Trace:
androidclientuserguide

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
androidclientuserguide [2021/06/07 18:08] – [Application configuration] rearrange chapter order fappelsandroidclientuserguide [2021/06/09 18:02] (current) – [Application configuration] replace bad screenshot fappels
Line 17: Line 17:
 == Field descriptions == == 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 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.+  * 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. Only if you move your server you can change the provider URL, you can't connect to another server by changing the provider URL.
   * 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.   * 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}}+  * License text field for the add-key required for activation the additional modules. 
 + 
 +{{ :pasted:20210609-180117.png?nolink&320 |Connector Setup}} 
 + 
 +== Toolbar description == 
 +  * With the back button you can confirm your configuration and return to the main screen. 
 +  * Bottom left scan button allows to scan an add-on key QR code into the license text field. If you have barcode reader which can scan QR code, you can also use device or Bluetooth barcode reader. 
 +  * With the bottom connection select field you can switch your server connection to another stored connection. You can have multiple connection to same server (to be able to switch user) or to multiple server (for switch between different Dolibarr). 
 +  * The plus button is used for adding a new connection. 
 +  * Trash button for deleting a connection. 
 ---- ----
-{{ :screenshot_2013-11-08-19-00-28.png?nolink&240|Assignment Confirmation}}+
 On first connect, the server administrator has to assign a system user to your connection request. Tap ‘yes’ when assignment is done, if successful you will get a message with the assigned system user and will go to the Main application screen. On first connect, the server administrator has to assign a system user to your connection request. Tap ‘yes’ when assignment is done, if successful you will get a message with the assigned system user and will go to the Main application screen.
  
-[[connecttutorial|Mobilid Connect Tutorial]]+{{:pasted:20210607-212817.png?nolink&320 |Assignment Confirmation}} {{ :pasted:20210607-212857.png?nolink&320|Assignment Confirmated}}
  
-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.+---- 
 + 
 +[[connecttutorial|Mobilid Connect Tutorial]]
  
 ---- ----
Line 46: Line 58:
 == Field descriptions == == 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 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 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 tested devices and which type to select.
   * The device select field lets you choose your connectable Bluetooth device.   * The device select field lets you choose your connectable Bluetooth device.
-{{ :pasted:20210607-165954.png?nolink&240 |Bluetooth setup}}+{{ :pasted:20210607-165954.png?nolink&320 |Bluetooth setup}}
 ---- ----
  
Line 66: Line 78:
 == Field descriptions == == Field descriptions ==
  
-  * Broadcast name barcode reader text field is for entering de Broastcast 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. +  * 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. 
-  * Broadcast data key text field is a second value that should be provided with the broadcast name.+  * 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]] 
 +  * 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. 
 +  * 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. 
  
-After entering these values you need to restart the Mobilid Application because the barcode reader process is only started at application startup.  +{{ :pasted:20210607-181412.png?nolink&320 |Terminal configuration}}
- +
-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]]+
  
 ---- ----
Line 79: Line 89:
 == Field descriptions == == 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 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.
 +  * With the Quality slider you can modify jpg quality of photo send to server.
 +
 +{{ :pasted:20210607-205926.png?nolink&320 |Search and photo setting fields}}
 +
 +  * Barcode trim prefix and suffix numeric fields allow you to remove a number of characters from beginning and end all barcode readings.
 +  * Version information fields are read only field containing info on application version, connector version, Dolibarr version and Dolibarr timezone.
 +
 +{{ :pasted:20210607-210517.png?nolink&320 |Barcode and version fields}}
 ===== Application usage ===== ===== Application usage =====
  
 ==== Home screen description ==== ==== Home screen description ====
 After app startup, the following screen will always be shown: After app startup, the following screen will always be shown:
----- +{{ :pasted:20210608-105951.png?nolink&320 |main screen}} 
-{{ :home_screen_resize.png?nolink800|Home screen}} +=== Main screen === 
----- +  * Main screen will show a list of your available modules. 
-{{ :main_menu_resize.png?700|Main menu}} +  * To open module you tap on the module. 
-Almost ervery screen has its own menu, this is the main menu:+  * To disable/enable module you tap and hold the module. Once disabled, no more data will be loaded for this module. You can use this to reduce data usage. When a module has a Dolibarr permission error, it will be auto disabled. 
 +  * If you return from a module, there will be an active sign. The module with the active sign will used to search object from scanned barcode. 
 +  * Top toolbar always shows the menu button on the right and the return button on the left. Also the module screens will have this button. The return button will always exit and save changes. The menu button will show a menu, main screen and module screens have there own menu. 
 +  * When you have a Bluetooth device connected to Mobilid, you will have a Bluetooth icon shown. 
 +  * Bottom toolbar always has scan button to open camera scanner. In main screen complete toolbar is scan button and show the connected Dolibarr user and the actual warehouse selected. 
 + 
 +=== Main menu === 
 +{{ :pasted:20210608-110052.png?nolink&320 | main menu}} 
 +  * Settings menu option will open the main settings screen. 
 +  * Location menu option will let you choose your actual warehouse location. If you select a warehouse here, only products located in this warehouse are shown. If you select the 'All' warehouse you see all products. If you use many warehouse for detailed product locations like shelves, you always set to 'All' here. 
 +{{ :pasted:20210608-110139.png?nolink&320 | location list}} 
 +  * Refresh option will reload all module and warehouse list. 
 +  * The dolibarr option will show an in-app window with your dolibarr. 
 +{{ :pasted:20210608-110248.png?nolink&320 | in-app dolibarr}}
 ---- ----
 ===== Modules ===== ===== Modules =====
androidclientuserguide.1623082128.txt.gz · Last modified: 2021/06/07 18:08 by fappels