Technisch overzicht, voor Zebra DataWedge op Elo Android I-Series 5. Compatibiliteit, functieondersteuning en configuratie (Fase 1)
Snelkoppelingen
Versies
| Component | Versie |
|---|---|
| Component | Versie |
| DataWedge | 20.0.36.139 |
| Scanner Framework | 43.63.56.0 |
| Minimale Elo OS | Elo Android 14 MR-9, 7.000.009.0046+gen5p |
1. Overzicht
Met de release van het Android 14 MR-9 OS worden Elo I-Series 5-apparaten geleverd met Zebra DataWedge, dezelfde zero-code gegevensverwerkingsservice die wordt gebruikt op Zebra's enterprise Android-apparaten.
DataWedge haalt gegevens van een aangesloten barcode-scanner of camera en levert deze aan de app die op de voorgrond actief is - of als toetsaanslagen, alsof ze op een toetsenbord zijn getypt, of als een Android-intentie die de app programmatief ontvangt. Apps hoeven geen scannerspecifieke code of een Elo-specifieke SDK op te nemen om scangegevens te ontvangen.
Dit is de eerste softwareplatformintegratie die gezamenlijk door Elo en Zebra wordt geleverd. DataWedge is gebouwd door Zebra en geïntegreerd door Elo in het Elo Android OS-afbeelding, zodat het standaard aanwezig is na de MR-9-update - er is geen afzonderlijke download of sideload vereist.
Waarom het belangrijk is
- Herbruik bestaande app-logica. Toepassingen die al zijn geschreven volgens DataWedge-profielen en -intenties op Zebra-apparaten zijn ontworpen om op Elo I-Series 5 te draaien zonder hun scanintegratie opnieuw te schrijven.
- Geen scanner SDK vereist. Scangegevens arriveert als toetsaanslagen of intenties, zodat nieuwe apps scanning kunnen ondersteunen zonder een apparaat-specifieke SDK te integreren.
- Per-app gedrag, automatisch. Profielen zijn gekoppeld aan apps; DataWedge schakelt profielen als apps naar de voorgrond komen, zonder dat gebruikersacties nodig zijn.
- Herhaalbare vlootconfiguratie. Een configuratie die op één apparaat is gebouwd, kan worden geëxporteerd en geïmporteerd op andere apparaten.
2. Hardware en platformcompatibiliteit
Ondersteunde apparaten en OS
| Apparaat | Chipset | OS |
|---|---|---|
| Elo I-Series 5 10", 15" en 22" | Qualcomm QCS6490 | Android 14 |
Minimale OS: Elo Android 14 MR-9, versie 7.000.009.0046+gen5p of later.
Beschikbaarheid: dropdown OTA op het EloView-portaal op 28 oktober 2026; standaard OTA op EloView en OEMConfig vanaf 4 november 2026.
Ondersteunde invoerbronnen
| Invoerbron | Aansluiting | Opmerkingen |
|---|---|---|
| Elo Edge Connect barcode scanners | USB | Zebra scan-engine scanners worden native door DataWedge aangestuurd. |
| Geïntegreerde frontcamera | Ingebouwd | Genoemd in DataWedge als Front Camera. Selecteer het in het menu voor Barcode Input Scanner om een nieuwe scanner toe te voegen. Beschikbaar op I-Series 5 10", 15" en 22". |
Zebra TechDocs referentie:
Barcode Invoer: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Kenmerken
Fase 1 levert de kernfunctionaliteit van DataWedge voor barcodecaptatie, profielbeheer, gegevenslevering en configuratie. De beschrijvingen van de functies volgen de documentatie van Zebra's DataWedge; zie Zebra TechDocs (https://techdocs.zebra.com/datawedge/latest/guide/about/) voor de volledige parameterreferentie.
3.1 Gegevenscaptatie
| Kenmerk | Beschrijving |
|---|---|
| Barcode Invoer | Verkrijg barcodegegevens van aangesloten USB-scanners of een camera. |
| Camera-scanning | Scan barcodes met een camera via de DataWedge-zoeker. |
| Scanner Invoer plug-in | Beheer de scannerhardware, decoderparameters en lezerparameters. |
| Scanner selectie | Automatisch standaard. Om een specifieke externe scanner of de frontcamera te gebruiken, open het Barcode Input Scanner selectiemenu, open het menu en selecteer Voeg nieuwe scanner toe; Gebruik auto keert terug naar automatische selectie. |
| Decoder (symbologie) configuratie | Schakel afzonderlijke symbologieën in of uit en stel decoderparameters per profiel in. |
| Data Captatie Plus (on-screen scan trigger) | Benoem een deel van het scherm als een virtuele scan-trigger: het indrukken en vasthouden ervan start een scan met de geselecteerde scanner of camera van het profiel, precies zoals een hardware-trigger zou doen. Weergegeven als een zwevende knop in apps waarvan het profiel deze inschakelt: het is standaard ingeschakeld in nieuwe profielen, en voor apps zonder een profiel verschijnt het zodra Profile0 is ingeschakeld (Aan de slag, Stap 2). |
Zebra TechDocs referentie:
Barcode Invoer: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
Data Captatie Plus: https://techdocs.zebra.com/datawedge/latest/guide/input/dcp/
3.2 Gegevenslevering en formattering
| Kenmerk | Beschrijving |
|---|---|
| Toetsaanslag-uitvoer | Lever scangegevens als toetsgebeurtenissen in het gefocuste veld van de voorgrondapp, inclusief actie-toetskarakters, tussen-karaktervertraging en toets-gebeurtenisvertraging. |
| Intent-uitvoer | Lever scangegevens aan een app als een Android-intentie (broadcast, start activiteit of start service) met configureerbare actie en categorie. Gegevens komen aan in standaard DataWedge extras zoals com.symbol.datawedge.data_string en com.symbol.datawedge.label_type. |
| Basis Gegevensformatterings (BDF) | Voeg een prefix, suffix of Enter/Tab-toets toe aan scangegevens. |
| Geavanceerde Gegevensformatterings (ADF) | Regel-gebaseerde formattering op basis van symbologie, lengte of inhoud. |
| GS1 / GS1 Digitale Link parsing | Parse en orden GS1 Toepassingsidentificatoren in de uitvoer. |
Zebra TechDocs referentie:
Toetsaanslag-uitvoer: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Intent-uitvoer: 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 Profielbeheer
| Kenmerk | Beschrijving |
|---|---|
| Meerdere profielen | Maak en beheer afzonderlijke configuraties voor verschillende apps of use cases. |
| Standaardprofiel (Profile0) | Basisprofiel dat wordt toegepast op elke app zonder zijn eigen profiel. |
| App- en activiteitassociatie | Koppel een profiel aan een of meer apps (en activiteiten) zodat het wordt geactiveerd wanneer die app op de voorgrond is. |
| Automatische profielwisseling | DataWedge schakelt over naar het bijbehorende profiel wanneer een app naar de voorgrond komt. |
| Maak / bewerk / verwijder profiel | Beheer profielen in de DataWedge-configuratie-app. |
| Deactiveer profiel | Schakel een profiel uit zonder het te verwijderen. |
| Kloon profiel | Dupliceer een profiel (zonder zijn app-associatie). |
Zebra TechDocs referentie:
DataWedge Profielen: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
3.4 DataWedge-instellingen en implementatie
| Kenmerk | Beschrijving |
|---|---|
| Inschakelen / uitschakelen DataWedge | Zet de DataWedge-service aan of uit. |
| Uitgeschakelde app-lijst | Schort DataWedge op voor geselecteerde apps of activiteiten terwijl deze op de voorgrond zijn. |
| Exporteren / importeren profielen | Exporteer een enkel profiel naar een bestand en importeer het op een ander apparaat. |
| Exporteren / importeren volledige configuratie | Exporteer de volledige DataWedge-configuratie en importeer deze op andere apparaten. |
| Herstel standaardinstellingen | Breng DataWedge terug naar de standaardconfiguratie. |
| Auto-import | DataWedge past automatisch configuratiebestanden toe die in zijn auto-importmap zijn geplaatst (zie sectie 4). |
| Configuratiepersistentie | Configuratie blijft behouden bij herstarts. |
| Configuratiegebruikersinterface | DataWedge-app op het apparaat voor handmatige configuratie. |
Zebra TechDocs referentie:
DataWedge Instellingen: https://techdocs.zebra.com/datawedge/latest/guide/settings/
3.5 Programmatore controle en tools
| Kenmerk | Beschrijving |
|---|---|
| DataWedge Intent API | Beheer DataWedge vanuit een app met Android-intenties - bijvoorbeeld schakel profielen, triggere een zachte scan, stel de lijst met uitgeschakelde apps in, vraag de scannerstatus op en maak of werk configuratie bij. |
| DWDemo-app | Testen van scanning en gegevensuitvoer. |
Zebra TechDocs referentie:
DataWedge API's: https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo: https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/
4. Aan de slag
Stap 1 - Update het OS
- Update het apparaat naar Elo Android 14 MR-9 (7.000.009.0046+gen5p) of later vanaf het EloView-portaal of het EloView-configuratiescherm op het apparaat. Andere MDM-gebruikers kunnen de Auto- en Handmatige Update-functies van Elo OEMConfig gebruiken.
- Als je een Edge Connect barcode-scanner gebruikt, verbind deze dan met het apparaat.
- Open de DataWedge-app vanuit de app-launcher.
Stap 2 - Schakel Profile0 in en verifieer
- Profile0 is het fallback-profiel dat van toepassing is op elke app zonder zijn eigen profiel. In de releasebuild is het standaard uit, dus apps zonder hun eigen profiel krijgen geen zwevende scan-knop en DataWedge houdt de camera niet vast totdat je hem inschakelt.
- Om het in te schakelen, open je Android-instellingen Elo-instellingen en zet DataWedge-scanning (Profile0) aan. Open vervolgens DWDemo, scan een barcode met de aangesloten scanner (of druk langdurig op de gele scan-knop op het scherm: met Scanner selectie op Auto gebruikt hij de aangesloten USB-scanner, en zonder aangesloten USB-scanner scant hij met de frontcamera), en bevestig dat de gegevens verschijnen.
- Terwijl de Elo-instellingen op gebruik staan, is de Profile0-invoer binnen de DataWedge-app grijs gemaakt ("uitgeschakeld door admin"); wijzig Profile0 vanuit de Elo-instellingen.
- Om scannen in te schakelen zonder elk apparaat aan te raken, geef je app zijn eigen profiel in plaats van afhankelijk te zijn van Profile0. Een profiel is van toepassing wanneer zijn app vooraan staat, ongeacht de instelling van Profile0. Maak het op een referentie-apparaat en push het naar de vloot met Auto Import (Stap 5), of laat de app het creëren bij de eerste lancering met de DataWedge SET_CONFIG Intent API (zie Voor ontwikkelaars).
Stap 3 - Maak een profiel voor je app
- In DataWedge open je het menu en selecteer je Nieuw profiel; voer een naam in.
- Open Geassocieerde apps en voeg het pakket van je app toe (en, indien gewenst, specifieke activiteiten).
- Onder Barcode Invoer, zorg ervoor dat de invoer is ingeschakeld en kies het apparaat onder Scanner selectie (Auto standaard; om een specifieke externe scanner of de frontcamera te selecteren, open het menu en selecteer Behouden nieuwe scanner). Opmerking: de scanner die onder Barcode Input Scanner selectie is gekozen, is degene die het profiel gebruikt; Configureer Scanner-instellingen stelt alleen die scannerparameters in.
- Onder Decoders, schakel alleen de symbologieën in die je workflow nodig heeft.
- Kies een uitvoer: Toetsaanslag-uitvoer voor apps die tekstvelden lezen, of Intent-uitvoer voor apps die scangegevens programmatief ontvangen (stel de intent-acties, categorie en leveringsmethode in om overeen te komen met de ontvanger van je app). De uitvoer die je niet gebruikt, moet je uitschakelen.
- Voeg indien gewenst prefixes, suffixes of regels toe onder Basis of Geavanceerde Gegevensformatterings.
- Breng je app naar de voorgrond - DataWedge schakelt automatisch over naar het nieuwe profiel.
Stap 4 - Beheer Profile0 en de scan-knop op het scherm
- Profile0 is standaard uitgeschakeld, dus apps zonder hun eigen profiel tonen geen zwevende scan-knop. Zet het aan of uit via Android-instellingen > Elo-instellingen > DataWedge-scanning (Profile0).
- Data Captatie Plus is standaard ingeschakeld in elk nieuw profiel, zodat de zwevende scan-knop ook verschijnt in apps die hun eigen profiel hebben. Om deze voor een app te verbergen, open je dat app-profiel en wis je Data Captatie Plus > Ingeschakeld.
- Apps die de camera niet mogen delen of scangegevens ontvangen - bijvoorbeeld tap-to-pay / SoftPOS-betaling apps die gebruik van de camera detecteren - moeten worden toegevoegd aan Instellingen > Uitgeschakelde app-lijst in DataWedge, of Profile0 moet uitgeschakeld blijven.
Stap 5 - Implementeer de configuratie naar je vloot
- Op een geconfigureerd referentie-apparaat open je DataWedge Instellingen Exporteren en exporteer de volledige configuratie (datawedge.db) of een enkel profiel (dwprofile\_<naam>.db).
- Gebruik je MDM om het bestand naar de DataWedge auto-importmap op doelapparaten te pushen:
/storage/emulated/0/Android/data/com.symbol.datawedge/files/autoimport
- DataWedge importeert het bestand automatisch en past het toe zonder een herstart. Hernaam of bewerk geen geëxporteerde .db-bestanden.
Voor ontwikkelaars
- Gebruik de DataWedge Intent API om profielen te wijzigen, scans te triggeren en profielen te maken of bij te werken vanuit je app: https://techdocs.zebra.com/datawedge/latest/guide/api/
- Profiel- en plug-inreferentie: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
- Apps die al zijn geïntegreerd met DataWedge op Zebra Android-apparaten zijn ontworpen om geen wijzigingen aan de scan-code nodig te hebben voor de Fase 1 functie set.
5. Bronnen en ondersteuning
- Zebra DataWedge-documentatie: https://techdocs.zebra.com/datawedge/latest/guide/about/
- Elo ondersteuning: https://www.elotouch.com/support
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article