Description des paramètres
Configurations
Tableau de configurations. Une configuration est un ensemble de paramètres correspondant à un environnement Reflex (par exemple : test, production).
Libellé | Paramètre (**) | Présent dans | Obligatoire ? | Signification et valeurs possibles | ||||||||||||||
Titre | name (string) | Non | Oui | Nom du groupe de paramètres, valeur possible : "Test" | ||||||||||||||
Icone | icon (string) | Non | Fichier d'icône du raccourci, valeur recommandée : "favicon.ico" | |||||||||||||||
Paramètres de connexion | ||||||||||||||||||
URL de l'application | url (string) | Possible | Oui | Base de l'URL du serveur Reflex Valeur possible " http://10.209.5.46:8080/reflex " /reflex est obligatoire en suffixe. | ||||||||||||||
Nom de l'environnement | environment (string) | Non | Oui | Nom de l'environnement Reflex, valeur possible :"Test" | ||||||||||||||
Application | application_profile (string) | Non | Oui | Si vous êtes en configuration assistée, il vous suffit de choisir le libellé dans la liste déroulante. Sinon, il faut affecter la valeur correspondante souhaitée au paramètre url_parameters.
| ||||||||||||||
Paramètres de l'URL | url_parameters (string) | Oui | Paramètres supplémentaires à ajouter à l'URL. Valeur libre. | |||||||||||||||
Desktop | Desktop (string) | Oui | Valeur recommandée "android" | |||||||||||||||
Maintien de la connexion | Keep_alive (integer) | Oui | Durée en secondes (entre 5 et 60) d'envoi d'un ping pour éviter que le réseau se coupe. Valeur recommandée=30 | |||||||||||||||
| Paramètres de sécurité | ||||||||||||||||||
Utiliser le navigateur du système pour l'authentification de l'utilisateur | Use_external_browser_auth (boolean) | Oui | Si cette option est cochée, l'authentification de l'utilisateur (JEE, OpenID) sera faite en utilisant le navigateur du système. Valeur recommandée : true | |||||||||||||||
Ne pas vérifier le nom du serveur | Ssl_allow_all_hosts (boolean) | Oui | Si cette option est sélectionnée, le nom du serveur ne sera pas vérifié lors de la connexion SSL. | |||||||||||||||
Certificat SSL privé | Private_ssl_certificate (string) | Non | Certificat de l'environnement au format cer ou pem en base 64 sur une seule ligne. Uniquement dans le fichier au format json. | |||||||||||||||
Paramètres d'affichage | ||||||||||||||||||
Orientation | Display_orientation (integer) | Oui | Oui | Valeur recommandée : 1 Valeurs possibles : 1 : Selon l'écran du terminal 2 : Suit la rotation de l'écran 3 : Portrait 4 : Paysage 5 : Portrait inversé 6 : Paysage inversé | ||||||||||||||
Résolution d'écran émulée | Resolution (string) | Oui | Oui | Valeurs possibles : -1 -1 : Selon l'écran du terminal 320 240 : Emulation 320 X 240 (QVGA) 640 480 : Emulation 640 X 480 (VGA) 800 600 : Emulation 800 X 600 (SVGA) | ||||||||||||||
Plein écran | Full_screen (boolean) | Oui | Exécution en mode plein écran. L'application passe par-dessus la barre Android Valeur recommandée : false | |||||||||||||||
Masquer la barre d'outils | Hide_action_bar (boolean) | Oui | Permet de cacher la barre de Reflex, qui redevient visible avec un glissement vers le bas. Valeur recommandée : true | |||||||||||||||
Police des messages | Message_font (integer) | Oui | Taille de la police de caractères des messages d'erreur. Valeur recommandée=8 | |||||||||||||||
Empêcher la mise en veille | Keep_screen_on (integer) | Oui | Valeur recommandée=0 0 : Désactivé, la mise en veille est pilotée par les paramètres système. <0 : Ne se met jamais en veille. >0 : Fixe, en secondes, la durée d'inactivité après laquelle le terminal se met en veille. | |||||||||||||||
Paramètres divers | ||||||||||||||||||
Active la notification d'entrée d'Intents | Enable_Notification | Oui | Valeur true/false. | |||||||||||||||
Désactiver le clavier sur le focus | Disable_keyboard_focus (boolean) | Oui | Si cette option est sélectionnée, le clavier Android ne s'affichera pas automatiquement lors de l'activation d'un champ. Valeur recommandée=false | |||||||||||||||
Activer le focus automatique | Enable_auto_focus (boolean) | Oui | Active la gestion automatique du focus lors de la validation d'un champ de saisie. Valeur recommandée=false | |||||||||||||||
Secouer pour rafraîchir | Shake_to_reload (integer) | Oui | Sensibilité du détecteur de secousse 0 : désactivé 3 : Très sensible 10: Normal 25: Peu sensible Valeur recommandée :0 | |||||||||||||||
Nombre de secousses | Num_of_shakes (integer) | Oui | Valeur recommandée : 0 | |||||||||||||||
Afficher le détail des erreurs | Error_detail (boolean) | Oui | Valeur recommandée : true | |||||||||||||||
Activation du support NFC | Enable_nfc (boolean) | Oui | ||||||||||||||||
Activation du support Zxing | Enable_zxing (boolean) | Oui | Active la caméra pour scanner des codes à barres. Valeur recommandée : false | |||||||||||||||
Désactivation des mises à jour | Disable_auto_update (boolean) | Oui | Si ce paramètre est à "false", Reflex Apk, lors de son premier démarrage quotidien, contrôle automatiquement :
Ce paramètre n'est pas disponible en configuration gérée. Une demande de mise à jour peut être faite manuellement via le menu Mettre à jour de l'Apk.
Les paramètres sont modifiables par l'utilisateur dans le menu Paramètre de l'Apk et sont immédiatement pris en compte. Ils seront écrasés par les paramètres du fichier lors de la prochaine lecture s'ils sont renseignés dans le fichier. | |||||||||||||||
Paramètres de logging | ||||||||||||||||||
Activer le log | Enable_logging (boolean) | Oui | Active le logging Valeur recommandée : false | |||||||||||||||
Niveau de détail | Log_level (string) | Oui | Niveau de log Valeurs possibles : ERROR, WARN, INFO, DEBUG, VERBOSE Valeur recommandée : ERROR | |||||||||||||||
Protocole de transfert | Log_upload_protocol (string) | Oui | Valeurs possibles : FTP, AWS | |||||||||||||||
URL du serveur | Log_upload_server (string) | Oui | URL du serveur Exemple : ftp://xxx ou http :xxx | |||||||||||||||
Profil | Log_upload_login (string) | Oui | ||||||||||||||||
Mot de passe | Log_upload_password (string) | Oui | ||||||||||||||||
Répertoire de sauvegarde | Log_upload_directory (string) | Oui | Répertoire sur le serveur où les fichiers journaux seront sauvegardés. Répertoire FTP bucket AWS | |||||||||||||||
| Paramètres de droits sur les menus | ||||||||||||||||||
Environnements | enable_environment_menu (boolean) | Oui | Rend visible le menu des environnements Valeur recommandée : true | |||||||||||||||
Certificats | enable_certificates_menu (boolean) | Oui | Rend visible le menu des certificats Valeur recommandée : true | |||||||||||||||
Private_ssl_certificate
Libellé | Clé json (type) | Obligatoire ? | Signification et valeurs possibles |
Certificat SSL privé | Private_ssl_certificate (string) | Certificat au format cer ou pem en base 64 sur une seule ligne. Vous pouvez le configurer ici, une seule fois au niveau global, pour l'utiliser dans chaque configuration. Uniquement dans le fichier au format json. |
(**) Ajouter le préfixe Pref_ au nom du paramètre dans les configurations gérées et leur fichier json correspondant.
Option Multi-Scanning Scandit
Fonctionnalités
|
|
Le Multi-Scanning Scandit permet via la caméra du terminal :
Ces fonctionnalités sont optionnelles et nécessitent l'acquisition d'une licence payante Scandit. Elles ne sont pour l'instant pas proposées dans des procédures embarquées standards de Reflex et doivent être intégrées dans des écrans ou des procédures spécifiques. |
Prérequis
Attention, il est nécessaire de valider les caractéristiques des terminaux selon les usages attendus.
Les terminaux suivants sont validés : Zebra TC52/57, TC72/77, TC53/58, TC73/78. Cette liste n'est pas exhaustive, contactez votre responsable Hardis Group pour plus d'informations.
Installation
Le principe est d'isoler un sous-ensemble de terminaux utilisés pour le Multi-Scanning car ils auront une installation, configuration et une maintenance particulière.
En effet, nous avons construit une variante de l'application Android Reflex Web dédiée qui intègre le Multi-Scanning Scandit.
Elle s'installe et se configure exactement comme Reflex Web, les différences à prendre en compte sont les suivantes :
1 - L'application à télécharger se trouve exclusivement ici :
Elle n'est donc pas disponible sur Google Play Store ou sur l'auto-updater de Reflex.
La seule méthode de déploiement possible est par l'installation du fichier téléchargé.
2 - Il faut obligatoirement configurer :
- le paramètre scandit_licence pour indiquer la licence à utiliser.
- activer le paramètre disable_auto_update en le positionnant à true pour ne pas écraser Reflex Scandit par Reflex Legacy.
Configurations avec certificats
Spécification Https - Certificat auto-signé ou certificat d'entreprise
Il est possible d'automatiser le processus d'importation du certificat auto-signé dans Reflex sur les terminaux Android. Les certificats payants ne sont pas concernés car ils intègrent déjà ce procédé.
Création du Keystore
La création du Keystore se fait uniquement sur un des serveurs Reflex portant le rôle web (nécessite Java).
Créer le "keystore" via la commande suivante (cmd ou linux) :
keytool -importcert -v -trustcacerts –file nomcertificat -alias aliascertificat -keystore storename -provider
org.bouncycastle.jce.provider.BouncyCastleProvider -providerpath bcprovjar -storetype BKS -storepass storepass -noprompt
nomcertificat : Nom du fichier du certificat (avec le chemin si besoin)
aliascertificat : Alias qu'on veut donner à ce certificat.
storename : Nom du fichier keystore à générer/modifier
bcprovjar : Chemin vers le fichier jar "bcprov" (fichier livré dans Reflex pour les rôles web et processing, qu'on trouve dans le dossier $REFLEX_HOME/product/java/reflexcloud/WEB-INF/lib/, et dont le nom commence par "bcprov-jdk".
Par exemple : /hardis/reflex/product/java/reflexcloud/WEB-INF/lib/bcprov-jdk15on-1.60.jar)
storepass : Mot de passe du keystore
Modification du fichier reflexWeb.properties
Dans le fichier reflexWeb.properties , il est nécessaire d'ajouter les lignes suivantes :
# created truststore
ssl_trust_store=MYSRVTRUSTSTORE.BKS
# Password to access to local truststore (default changeit)
ssl_trust_store_password=STOREPASS_NAME
ssl_trust_store correspond au nom du "keystore" que vous avez créé, ou que vous allez créer dans la suite de cette procédure.
ssl_trust_store_password correspond au mot de passe "storepass" que vous avez créé, ou que vous allez créer dans la suite de cette procédure.
Copiez ensuite le fichier reflexWeb.properties et le keystore dans le dossier du terminal : /Hardis/Reflex/Conf/
Ajouter également les trois lignes suivantes en début de fichier :
ssl_private_store=true
ssl_allow_all_hosts=true
disable_auto_update=false
ssl_private_store : Si cette option est cochée, les connexions sécurisées (SSL) utiliseront les certificats de l'application au lieu de ceux du système (True : Auto-signé ; False : Payant).
ssl_allow_all_hosts : Si cette option est sélectionnée, le nom du serveur ne sera pas vérifié lors de connexion SSL (True : Auto-signé ; False : Payant).
disable_auto_update : Désactive la mise à jour et la configuration automatique.
A positionner à "False" dans le cas où vous souhaitez que la mise à jour se fasse par Reflex.