Description of parameters
Configurations
Configurations table. A configuration is a set of parameters corresponding to a Reflex environment (e.g.: a test or production environment).
Description | Parameter (**) | Present in the .properties file? | Mandatory? | Purpose and possible values | ||||||||||||||
Title | name (string) | No | Yes | Name of the parameter group, possible value: "Test" | ||||||||||||||
Icon | icon (string) | No | Shortcut icon file, recommended value: "favicon.ico" | |||||||||||||||
Connection parameters | ||||||||||||||||||
Application URL | url (string) | Possible | Yes | Root URL for the Reflex server. Possible value " http://10.209.5.46:8080/reflex " /reflex must be included as the suffix. | ||||||||||||||
Name of the environment | environment (string) | No | Yes | Reflex environment name; possible value: "Test" | ||||||||||||||
Application | application_profile (string) | No | Yes | If you opted for assisted configuration, you will just need to select the designation from the drop-down list. Otherwise, you will need to assign the corresponding value to the url_parameters parameter.
| ||||||||||||||
URL parameters | url_parameters (string) | Yes | Additional parameters to be added to the URL. Freely input value. | |||||||||||||||
Desktop | Desktop (string) | Yes | Recommended value: "android" | |||||||||||||||
Connection time | Keep_alive (integer) | Yes | Time in seconds (between 5 and 60) after which a ping is sent in order to prevent disconnection from the network. Recommended value =30 | |||||||||||||||
| Security parameters | ||||||||||||||||||
Using the system's browser for user authentication | Use_external_browser_auth (boolean) | Yes | If this option is selected, user authentication (JEE, OpenID) will be based on the system's browser. Recommended value: true | |||||||||||||||
The server name is not verified. | Ssl_allow_all_hosts (boolean) | Yes | If this option is selected, the server name will not be verified during the SSL connection. | |||||||||||||||
Private SSL certificate | Private_ssl_certificate (string) | No | Environment certificate in Base64 “cer" or "pem" format over a single line. Only in the file in json format. | |||||||||||||||
Display parameters | ||||||||||||||||||
Orientation | Display_orientation (integer) | Yes | Yes | Recommended value: 1 Possible values: 1: Based on terminal screen 2: Based on screen rotation 3: Portrait 4: Landscape 5: Reverse portrait 6: Reverse landscape | ||||||||||||||
Emulated screen resolution | Resolution (string) | Yes | Yes | Possible values: -1 -1 : Based on terminal screen 320,240: Emulation 320 x 240 (QVGA) 640,480: Emulation 640 x 480 (VGA) 800,600: Emulation 800 x 600 (SVGA) | ||||||||||||||
Full screen | Full_screen (boolean) | Yes | Execution in full screen mode. Expands the application so that it displays on top of the Android tool bar. Recommended value: false | |||||||||||||||
Ide the toolbar | Hide_action_bar (boolean) | Yes | Hides the Reflex tool bar. To display it again, swipe the screen. Recommended value: true | |||||||||||||||
Message fonts | Message_font (integer) | Yes | Font size of characters in error messages. Recommended value =8 | |||||||||||||||
Prevents sleep mode | Keep_screen_on (integer) | Yes | Recommended value =0 0: Deactivated, sleep mode is managed by the system's parameters. < 0: The terminal never goes into sleep mode. >0: Sets the period of inactivity in seconds after which the terminal will switch to sleep mode. | |||||||||||||||
Miscellaneous parameters | ||||||||||||||||||
Enables notification of incoming intents | Enable_Notification | Yes | Value: true/false. | |||||||||||||||
Deactivating keyboard focus | Disable_keyboard_focus (boolean) | Yes | If this option is selected, the Android keyboard will not display automatically when a field is activated. Recommended value =false | |||||||||||||||
Activating automatic focus | Enable_auto_focus (boolean) | Yes | Activates automatic focus management during confirmation of an input field. Recommended value =false | |||||||||||||||
Shaking to refresh | Shake_to_reload (integer) | Yes | Sensitivity level of the shake sensor. 0: deactivated 3: Very sensitive 10: Normal 25: Not very sensitive Recommended value: 0 | |||||||||||||||
Number of shakes | Num_of_shakes (integer) | Yes | Recommended value: 0 | |||||||||||||||
Display error details | Error_detail (boolean) | Yes | Recommended value: true | |||||||||||||||
Activating NFC support | Enable_nfc (boolean) | Yes | ||||||||||||||||
Activating Zxing support | Enable_zxing (boolean) | Yes | Activates the camera for bar code scanning Recommended value: false | |||||||||||||||
Deactivating updates | Disable_auto_update(boolean) | Yes | If this parameter is set to "false", when Reflex Apk starts for the first time each day, it automatically checks:
This parameter is not available as a managed configuration. It is possible to manually request an update using the Update menu in Reflex Apk.
Parameters can be modified by the user from the Reflex Apk Parameters menu and are taken into account immediately. If they are populated in the file, they will be overwritten by the parameter values in the file the next time it is read. | |||||||||||||||
Logging parameters | ||||||||||||||||||
Activating the log | Enable_logging (boolean) | Yes | Activates logging Recommended value: false | |||||||||||||||
Detail level | Log_level (string) | Yes | Log level Possible values: ERROR, WARN, INFO, DEBUG, TRACE. Recommended value: ERROR | |||||||||||||||
Transfer protocol | Log_upload_protocol (string) | Yes | Possible values: FTP, AWS | |||||||||||||||
Server URL | Log_upload_server (string) | Yes | Server URL Example: ftp://xxx or http :xxx | |||||||||||||||
Profile | Log_upload_login (string) | Yes | ||||||||||||||||
Password | Log_upload_password (string) | Yes | ||||||||||||||||
Backup directory | Log_upload_directory (string) | Yes | Directory on the server where the log files will be saved. AWS bucket FTP directory | |||||||||||||||
| Permissions on menus parameters | ||||||||||||||||||
Environments | enable_environment_menu (boolean) | Yes | Makes the environments menu visible Recommended value: true | |||||||||||||||
Certificates | enable_certificates_menu (boolean) | Yes | Makes the certficates menu visible Recommended value: true | |||||||||||||||
Private_ssl_certificate
Description | Json key (type) | Mandatory? | Purpose and possible values |
Private SSL certificate | Private_ssl_certificate (string) | Certificate in Base64 "cer" or "pem" format over a single line. You can configure this value here once, so that it is used globally for all configurations. Only in the file in json format. |
(**) Add the prefix Pref_ to the parameter name in the managed configurations and their corresponding JSON file.
Multi-Scanning Scandit option
Features
|
|
With Multi-Scanning Scandit, you can use the terminal's camera to:
These features are optional and require a paid Scandit licence. They are not currently offered in standard Reflex on-board procedures and must be incorporated in specific screens or procedures if desired. |
Prerequisites
Note: Terminal characteristics need to be validated according to expected usage.
The following terminals have been validated: Zebra TC52/57, TC72/77, TC53/58, TC73/78. This is a non-exhaustive list. Contact your Hardis Group representative for more information.
Installation
The principle behind this is to isolate a subset of terminals used for Multi-Scanning because they will be installed, configured and maintained in a particular way.
We have built a dedicated variant of the Reflex Web Android application that incorporates Multi-Scanning Scandit.
It is installed and configured exactly like Reflex Web, with the following differences to take into account:
1. The application for download can only be found here:
It is therefore not available on Google Play Store or Reflex auto-updater.
The only possible deployment method is via installation of the downloaded file.
2. You must configure:
- The scandit_licence parameter to indicate the licence to use.
- Activate the disable_auto_update parameter by setting it to true to avoid overwriting Reflex Scandit with Reflex Legacy.
Configurations with certificates
Https specification - Auto-signed certificate or company certificate
It is possible to automate the import of auto-signed certificates in the Reflex application on the Android terminal. This does not apply to paid certificates as they already take this process into account.
Creating the keystore
The Keystore can only be created on a Reflex server that has a web role (Java is required).
Create the "keystore" using the following command (cmd or Linux):
keytool -importcert -v -trustcacerts ?file certificatename -alias certificatealias -keystore storename -provider
org.bouncycastle.jce.provider.BouncyCastleProvider -providerpath bcprovjar -storetype BKS -storepass storepass -noprompt
certificatename: Name of the certificate file (with path if needed)
certificatealias: Alias to be assigned to this certificate.
storename: Name of the keystore file to be generated/modified.
bcprovjar: Path to the "bcprov" jar file (provided in Reflex for the web and processing roles. It is located in the $REFLEX_HOME/product/java/reflexcloud/WEB-INF/lib/ folder and its name starts with bcprov-jdk.
For example: /hardis/reflex/product/java/reflexcloud/WEB-INF/lib/bcprov-jdk15on-1.60.jar)
storepass: Keystore password
Modifying the reflexWeb.properties file
The following lines must be added to the reflexWeb.properties file:
# created truststore
ssl_trust_store=MYSRVTRUSTSTORE.BKS
# Password to access to local truststore (default changeit)
ssl_trust_store_password=STOREPASS_NAME
ssl_trust_store corresponds to the name of the "keystore" that you have already created or will create after this step.
ssl_trust_store_password corresponds to the "storepass" password that you have already created or will create after this step.
Then copy the reflexWeb.properties file and the keystore to the following folder on the terminal: /Hardis/Reflex/Conf/
Also add the following three lines to the start of the file:
ssl_private_store=true
ssl_allow_all_hosts=true
disable_auto_update=false
ssl_private_store: If this option is checked, secure (SSL) connections will use the application’s certificates instead of the system's certificates (True: Auto-signed; False: Paid).
ssl_allow_all_hosts: If this option is selected, the server name will not be verified during SSL(True: Auto-signed; False: Paid).
disable_auto_update: Deactivates automatic updates and configuration.
It should be set to "False" if you want Reflex to perform the update