Aperçu technique pour Zebra DataWedge sur Elo Android I-Series 5. Compatibilité, support des fonctionnalités et configuration (Phase 1)
Liens rapides
Versions
| Composant | Version |
|---|---|
| Composant | Version |
| DataWedge | 20.0.36.139 |
| Framework Scanner | 43.63.56.0 |
| Minimum Elo OS | Elo Android 14 MR-9, 7.000.009.0046+gen5p |
1. Aperçu
À partir de la version Android 14 MR-9, les dispositifs Elo I-Series 5 sont livrés avec Zebra DataWedge, le même service de capture de données sans code utilisé sur les dispositifs Android d'entreprise de Zebra.
DataWedge capture des données à partir d'un scanner de codes-barres ou d'une caméra connectée et les livre à l'application en cours - soit sous forme de frappes, comme si elles étaient saisies au clavier, soit sous forme d'une intention Android que l'application reçoit par programmation. Les applications n'ont pas besoin d'inclure de code spécifique au scanner ou d'un SDK spécifique à Elo pour recevoir les données de scan.
Ceci est la première intégration de plateforme logicielle livrée conjointement par Elo et Zebra. DataWedge est développé par Zebra et intégré par Elo dans l'image du système d'exploitation Elo Android, il est donc présent dès la première utilisation après la mise à jour MR-9 - aucun téléchargement ou sideload séparé n'est requis.
Pourquoi c'est important
- Réutiliser la logique d'application existante. Les applications déjà écrites contre les profils et intentions de DataWedge sur les appareils Zebra sont conçues pour fonctionner sur Elo I-Series 5 sans réécrire leur intégration de scan.
- Pas de SDK de scanner requis. Les données de scan arrivent sous forme de frappes ou d'intentions, permettant aux nouvelles applications de supporter le scan sans intégrer un SDK spécifique à un appareil.
- Comportement par application, automatiquement. Les profils sont liés aux applications ; DataWedge change les profils à mesure que les applications passent au premier plan, sans action de l'utilisateur.
- Configuration de flotte répétable. Une configuration créée sur un appareil peut être exportée et importée sur d'autres.
2. Compatibilité matérielle et de la plateforme
Appareils et OS pris en charge
| Dispositif | Chipset | OS |
|---|---|---|
| Elo I-Series 5 10", 15" et 22" | Qualcomm QCS6490 | Android 14 |
OS minimum : Elo Android 14 MR-9, version 7.000.009.0046+gen5p ou ultérieure.
Disponibilité : mise à jour OTA sur le portail EloView le 28 octobre 2026 ; mise à jour OTA par défaut sur EloView et OEMConfig à partir du 4 novembre 2026.
Sources d'entrée prises en charge
| Source d'entrée | Connexion | Notes |
|---|---|---|
| Scanners de codes-barres Elo Edge Connect | USB | Les scanners avec moteur de scan Zebra sont gérés nativement par DataWedge. |
| Caméra frontale intégrée | Intégré | Répertorié dans DataWedge comme Caméra frontale. Sélectionnez-le dans le menu de sélection du scanner d'entrée des codes-barres pour ajouter un nouveau scanner. Disponible sur I-Series 5 10", 15" et 22". |
Référence Zebra TechDocs :
Scanner de codes-barres : https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Fonctionnalités
La Phase 1 livre le noyau des fonctionnalités de DataWedge pour la capture de codes-barres, la gestion des profils, la livraison de données et la configuration. Les descriptions des fonctionnalités suivent la documentation de DataWedge de Zebra ; consultez Zebra TechDocs (https://techdocs.zebra.com/datawedge/latest/guide/about/) pour une référence complète des paramètres.
3.1 Capture de données
| Fonctionnalité | Description |
|---|---|
| Entrée de codes-barres | Acquérir des données de code-barres à partir de scanners USB connectés ou d'une caméra. |
| Scan avec la caméra | Scanner des codes-barres avec une caméra à travers le viseur DataWedge. |
| Plug-in d'entrée de scanner | Contrôler le matériel du scanner, les paramètres du décodeur et les paramètres du lecteur. |
| Sélection du scanner | Auto par défaut. Pour utiliser un scanner externe spécifique ou la caméra frontale, ouvrez la sélection du scanner d'entrée de code-barres, ouvrez le menu et sélectionnez Ajouter nouveau scanner ; Utiliser auto revient à la sélection automatique. |
| Configuration du décodeur (symbologie) | Activer ou désactiver des symbologies individuelles et définir des paramètres de décodeur par profil. |
| Data Capture Plus (déclencheur de scan à l'écran) | Désigne une partie de l'écran comme un déclencheur de scan virtuel : appuyer et maintenir commence un scan avec le scanner ou la caméra sélectionnée par le profil, tout comme un déclencheur matériel le ferait. Affiché comme un bouton flottant dans les applications dont le profil a cela activé : il est activé par défaut dans les nouveaux profils, et pour les applications sans profil, il apparaît une fois que le Profile0 est activé (Premiers pas, Étape 2). |
Référence Zebra TechDocs :
Entrée de codes-barres : https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
Data Capture Plus : https://techdocs.zebra.com/datawedge/latest/guide/input/dcp/
3.2 Livraison et formatage des données
| Fonctionnalité | Description |
|---|---|
| Sortie de frappes | Livrer des données de scan sous forme d'événements clés dans le champ focalisé de l'application au premier plan, y compris les caractères de touche d'action, le délai entre les caractères et le délai d'événement clé. |
| Sortie d'intention | Livrer des données de scan à une application sous forme d'intention Android (diffusion, démarrer une activité ou démarrer un service) avec action et catégorie configurables. Les données arrivent dans des extras standard de DataWedge tels que com.symbol.datawedge.data_string et com.symbol.datawedge.label_type. |
| Formatage de données de base (BDF) | Ajouter un préfixe, un suffixe ou une touche Entrée/Tab au données de scan. |
| Formatage avancé des données (ADF) | Formatage basé sur des règles conditionnées par la symbologie, la longueur ou le contenu. |
| Analyser des liens GS1 / GS1 Digital Link | Analyser et ordonner les identifiants d'application GS1 dans la sortie. |
Référence Zebra TechDocs :
Sortie de frappes : https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Sortie d'intention : https://techdocs.zebra.com/datawedge/latest/guide/output/intent/
BDF : https://techdocs.zebra.com/datawedge/latest/guide/process/bdf/
ADF : https://techdocs.zebra.com/datawedge/latest/guide/process/adf/
3.3 Gestion des profils
| Fonctionnalité | Description |
|---|---|
| Profils multiples | Créer et gérer des configurations séparées pour différentes applications ou cas d'utilisation. |
| Profil par défaut (Profile0) | Profil de base appliqué à toute application sans profil propre. |
| Association d'application et d'activité | Lier un profil à une ou plusieurs applications (et activités) afin qu'il s'active lorsque cette application est au premier plan. |
| Changement automatique de profil | DataWedge passe au profil associé lorsque une application apparaît au premier plan. |
| Créer / modifier / supprimer un profil | Gérer les profils dans l'application de configuration DataWedge. |
| Désactiver le profil | Désactiver un profil sans le supprimer. |
| Cloner le profil | Dupliquer un profil (sans son association d'application). |
Référence Zebra TechDocs :
Profils de DataWedge : https://techdocs.zebra.com/datawedge/latest/guide/profiles/
3.4 Paramètres et déploiement de DataWedge
| Fonctionnalité | Description |
|---|---|
| Activer / désactiver DataWedge | Activer ou désactiver le service DataWedge. |
| Liste des applications désactivées | Suspendre DataWedge pour des applications ou activités sélectionnées lorsqu'elles sont au premier plan. |
| Exporter / importer des profils | Exporter un profil unique vers un fichier et l'importer sur un autre appareil. |
| Exporter / importer la configuration complète | Exporter la configuration complète de DataWedge et l'importer sur d'autres appareils. |
| Restaurer les paramètres par défaut | Ramener DataWedge à sa configuration par défaut. |
| Importation automatique | DataWedge applique automatiquement les fichiers de configuration placés dans son dossier d'importation automatique (voir section 4). |
| Persistance de la configuration | La configuration est conservée entre les redémarrages. |
| Interface utilisateur de configuration | Application DataWedge sur l'appareil pour la configuration manuelle. |
Référence Zebra TechDocs :
Paramètres de DataWedge : https://techdocs.zebra.com/datawedge/latest/guide/settings/
3.5 Contrôle programmatique et outils
| Fonctionnalité | Description |
|---|---|
| API Intention DataWedge | Contrôler DataWedge depuis une application avec des intentions Android - par exemple passer des profils, déclencher un scan, définir la liste des applications désactivées, interroger le statut du scanner, et créer ou mettre à jour la configuration. |
| Application DWDemo | Tester le scan et la sortie de données. |
Référence Zebra TechDocs :
APIs DataWedge : https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo : https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/
4. Premiers pas
Étape 1 - Mettre à jour le système d'exploitation
- Mettre à jour le dispositif vers Elo Android 14 MR-9 (7.000.009.0046+gen5p) ou ultérieure depuis le portail EloView ou le panneau de contrôle EloView sur l'appareil. D'autres utilisateurs de MDM peuvent utiliser les fonctionnalités de mise à jour automatique et manuelle d'Elo OEMConfig.
- Si vous utilisez un scanner de codes-barres Edge Connect, connectez-le à l'appareil.
- Ouvrez l'application DataWedge depuis le lanceur d'applications.
Étape 2 - Activer Profile0 et vérifier
- Profile0 est le profil de secours qui s'applique à chaque application sans son propre profil. Dans la version de construction, il est désactivé par défaut, donc les applications sans leur propre profil n'obtiennent pas de bouton de scan flottant et DataWedge ne maintient pas la caméra jusqu'à ce que vous ne l'activiez.
- Pour l'activer, ouvrez Paramètres Android > Paramètres Elo et activez Scan DataWedge (Profile0). Ensuite, ouvrez DWDemo, scannez un code-barres avec le scanner connecté (ou appuyez et maintenez le bouton de scan jaune à l'écran : avec Sélection de scanner en Auto, il utilise le scanner USB connecté, et sans scanner USB connecté, il scanne avec la caméra frontale), et confirmez que les données apparaissent.
- Tant que le contrôle des paramètres Elo est en cours d'utilisation, l'entrée Profile0 dans l'application DataWedge est grisée ("désactivée par l'administrateur") ; changez Profile0 depuis les paramètres Elo.
- Pour activer le scan sans toucher chaque appareil, donnez à votre application son propre profil au lieu de vous fier à Profile0. Un profil s'applique chaque fois que son application est au premier plan, quelle que soit la configuration de Profile0. Créez-le sur un appareil de référence et poussez-le à la flotte avec Importation automatique (Étape 5), ou laissez l'application le créer au premier lancement avec l'API SET_CONFIG Intent de DataWedge (voir Pour les développeurs).
Étape 3 - Créer un profil pour votre application
- Dans DataWedge, ouvrez le menu et sélectionnez Nouveau profil ; entrez un nom.
- Ouvrez Applications associées et ajoutez le package de votre application (et, optionnellement, des activités spécifiques).
- Sous Entrée de codes-barres, assurez-vous que l'entrée est activée et choisissez l'appareil sous Sélection de scanner (Auto par défaut ; pour choisir un scanner externe spécifique ou la caméra frontale, ouvrez le menu et sélectionnez Conserver le nouveau scanner). Remarque : le scanner choisi sous la sélection du scanner d'entrée de codes-barres est celui utilisé par le profil ; Paramètres du scanner configurés ne font qu'établir les paramètres de ce scanner.
- Sous Décodeurs, activez uniquement les symbologies dont votre flux de travail a besoin.
- Choisissez une sortie : Sortie de frappes pour les applications qui lisent des champs de texte, ou Sortie d'intention pour les applications qui reçoivent des données de scan par programmation (définissez l'action d'intention, la catégorie et le mode de livraison pour correspondre au récepteur de votre application). Désactivez la sortie que vous n'utilisez pas.
- Ajoutez optionnellement des préfixes, suffixes ou règles sous Formatage de base ou Formatage avancé des données.
- Amenez votre application au premier plan - DataWedge passe automatiquement au nouveau profil.
Étape 4 - Contrôler Profile0 et le bouton de scan à l'écran
- Profile0 est désactivé par défaut, donc les applications sans leur propre profil ne montrent pas de bouton de scan flottant. Activez-le ou désactivez-le depuis Paramètres Android > Paramètres Elo > Scan DataWedge (Profile0).
- Data Capture Plus est activé par défaut dans chaque nouveau profil, donc le bouton de scan flottant apparaît également dans les applications qui ont leur propre profil. Pour le masquer pour une application, ouvrez le profil de cette application et désactivez Data Capture Plus > Activé.
- Les applications qui ne doivent pas partager la caméra ou recevoir des données de scan - par exemple tap-to-pay / applications de paiement SoftPOS qui détectent l'utilisation de la caméra - doivent être ajoutées à Paramètres > Liste des applications désactivées dans DataWedge, ou Profile0 doit être désactivé.
Étape 5 - Déployer la configuration à votre flotte
- Sur un dispositif de référence configuré, ouvrez Exportation des paramètres DataWedge et exportez la configuration complète (datawedge.db) ou un profil unique (dwprofile\_<nom>.db).
- Utilisez votre MDM pour pousser le fichier dans le dossier d'importation automatique de DataWedge sur les appareils cibles :
/storage/emulated/0/Android/data/com.symbol.datawedge/files/autoimport
- DataWedge importe automatiquement le fichier et l'applique sans redémarrage. Ne renommez pas ou ne modifiez pas les fichiers .db exportés.
Pour les développeurs
- Utilisez l'API Intention DataWedge pour changer de profils, déclencher des scans, et créer ou mettre à jour des profils depuis votre application : https://techdocs.zebra.com/datawedge/latest/guide/api/
- Référence de profil et de plug-in : https://techdocs.zebra.com/datawedge/latest/guide/profiles/
- Les applications déjà intégrées avec DataWedge sur les appareils Android Zebra sont conçues pour ne nécessiter aucune modification de code de scan pour le set de fonctionnalités de la Phase 1.
5. Ressources et support
- Documentation Zebra DataWedge : https://techdocs.zebra.com/datawedge/latest/guide/about/
- Support Elo : https://www.elotouch.com/support
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article