Panoramica tecnica, per Zebra DataWedge su Elo Android I-Series 5. Compatibilità, supporto delle funzionalità e configurazione (Fase 1)
Link Rapidi
Versioni
| Componente | Versione |
|---|---|
| Componente | Versione |
| DataWedge | 20.0.36.139 |
| Scanner Framework | 43.63.56.0 |
| Minimum Elo OS | Elo Android 14 MR-9, 7.000.009.0046+gen5p |
1. Panoramica
A partire dal rilascio del sistema operativo Android 14 MR-9, i dispositivi Elo I-Series 5 vengono forniti con Zebra DataWedge, lo stesso servizio di acquisizione dati senza codice utilizzato su tutti i dispositivi aziendali Android di Zebra.
DataWedge acquisisce dati da uno scanner di codici a barre o da una camera connessa e li consegna all'app che è in primo piano - sia come sequenze di tasti, come se fossero digitati su una tastiera, sia come un'intenzione Android che l'app riceve programmaticamente. Le app non hanno bisogno di includere codice specifico per scanner o un SDK specifico di Elo per ricevere dati di scansione.
Questa è la prima integrazione della piattaforma software fornita congiuntamente da Elo e Zebra. DataWedge è costruito da Zebra e integrato da Elo nell'immagine del sistema operativo Android Elo, quindi è presente già dopo l'aggiornamento MR-9 - non è necessario alcun download o sideload separato.
Perché è importante
- Riutilizzo della logica dell'app esistente. Le applicazioni già scritte contro profili e intenzioni di DataWedge sui dispositivi Zebra sono progettate per funzionare su Elo I-Series 5 senza riscrivere la loro integrazione di scansione.
- Nessun SDK per scanner richiesto. I dati di scansione arrivano come sequenze di tasti o intenzioni, quindi le nuove app possono supportare la scansione senza integrare un SDK specifico per il dispositivo.
- Comportamento per app, automaticamente. I profili sono legati alle app; DataWedge cambia profili man mano che le app vengono portate in primo piano, senza alcuna azione da parte dell'utente.
- Impostazione della flotta ripetibile. Una configurazione costruita su un dispositivo può essere esportata e importata su altri.
2. Compatibilità Hardware e Piattaforma
Dispositivi e OS supportati
| Dispositivo | Chipset | OS |
|---|---|---|
| Elo I-Series 5 10", 15" e 22" | Qualcomm QCS6490 | Android 14 |
Minimum OS: Elo Android 14 MR-9, versione 7.000.009.0046+gen5p o successiva.
Disponibilità: rilascio OTA drop-down sul portale EloView il 28 ottobre 2026; OTA predefinito su EloView e OEMConfig dal 4 novembre 2026.
Fonti di input supportate
| Fonte di input | Connessione | Note |
|---|---|---|
| Scanner di codici a barre Elo Edge Connect | USB | Gli scanner Zebra scan-engine sono pilotati nativamente da DataWedge. |
| Camera frontale integrata | Integrata | Elencata in DataWedge come Camera frontale. Selezionalo nel menu di selezione scanner di input codice a barre Aggiungi nuovo scanner. Disponibile su I-Series 5 10", 15" e 22". |
Riferimento Zebra TechDocs:
Input codice a barre: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Funzionalità
La Fase 1 fornisce il set di funzionalità core di DataWedge per l'acquisizione di codici a barre, gestione dei profili, consegna dei dati e configurazione. Le descrizioni delle funzionalità seguono la documentazione di DataWedge di Zebra; vedere Zebra TechDocs (https://techdocs.zebra.com/datawedge/latest/guide/about/) per un riferimento completo ai parametri.
3.1 Acquisizione dati
| Funzionalità | Descrizione |
|---|---|
| Input codice a barre | Acquisire dati di codice a barre da scanner USB o da una camera connessa. |
| Scansione con camera | Scansionare codici a barre con una camera tramite il mirino di DataWedge. |
| Plug-in di input scanner | Controlla l'hardware dello scanner, i parametri del decoder e i parametri del lettore. |
| Selezione scanner | Auto per impostazione predefinita. Per utilizzare uno scanner esterno specifico o la camera anteriore, aprire Selezione scanner di input codice a barre, aprire il menu e selezionare Aggiungi nuovo scanner; Usa auto riporta alla selezione automatica. |
| Configurazione del decoder (simboli) | Abilita o disabilita singole simbologie e imposta i parametri del decoder per ogni profilo. |
| Data Capture Plus (grilletto di scansione su schermo) | Designa parte dello schermo come un grilletto di scansione virtuale: premere e tenere premuto avvia una scansione con lo scanner o la camera selezionati dal profilo, proprio come un grilletto hardware. Mostrato come un pulsante galleggiante nelle app il cui profilo ha abilitato questa funzione: è attivo per impostazione predefinita nei nuovi profili e per le app senza un profilo appare una volta che Profile0 è abilitato (Iniziare, Passo 2). |
Riferimento Zebra TechDocs:
Input codice a barre: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
Data Capture Plus: https://techdocs.zebra.com/datawedge/latest/guide/input/dcp/
3.2 Consegna e formattazione dei dati
| Funzionalità | Descrizione |
|---|---|
| Output sequenze di tasti | Consegna i dati di scansione come eventi chiave nel campo focalizzato dell'app in primo piano, inclusi caratteri chiave di azione, ritardo tra i caratteri e ritardo negli eventi chiave. |
| Output intenzioni | Consegna i dati di scansione a un'app come un'intenzione Android (broadcast, avvia attività o avvia servizio) con azioni e categorie configurabili. I dati arrivano in standard DataWedge extras come com.symbol.datawedge.data_string e com.symbol.datawedge.label_type. |
| Formattazione base dei dati (BDF) | Aggiungi un prefisso, un suffisso o un tasto Invio/Tab ai dati di scansione. |
| Formattazione avanzata dei dati (ADF) | Formattazione basata su regole condizionata da simbologia, lunghezza o contenuto. |
| Parsing GS1 / GS1 Digital Link | Analizza e ordina gli Identificatori di Applicazione GS1 nell'output. |
Riferimento Zebra TechDocs:
Output sequenze di tasti: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Output 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 Gestione dei profili
| Funzionalità | Descrizione |
|---|---|
| Più profili | Crea e gestisci configurazioni separate per diverse app o casi d'uso. |
| Profilo predefinito (Profile0) | Profilo base applicato a qualsiasi app senza il proprio profilo. |
| Associazione app e attività | Collega un profilo a una o più app (e attività) affinché si attivi quando quell'app è in primo piano. |
| Cambio automatico del profilo | DataWedge passa al profilo associato quando un'app viene portata in primo piano. |
| Crea / modifica / elimina profilo | Gestisci i profili nell'app di configurazione DataWedge. |
| Disabilita profilo | Disattiva un profilo senza eliminarlo. |
| Clona profilo | Duplica un profilo (senza la sua associazione ad app). |
Riferimento Zebra TechDocs:
Profili DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
3.4 Impostazioni e distribuzione di DataWedge
| Funzionalità | Descrizione |
|---|---|
| Abilita / disabilita DataWedge | Attiva o disattiva il servizio DataWedge. |
| Elenco app disabilitate | Sospendi DataWedge per app o attività selezionate mentre sono in primo piano. |
| Esporta / importa profili | Esporta un profilo singolo in un file e importalo su un altro dispositivo. |
| Esporta / importa configurazione completa | Esporta la configurazione completa di DataWedge e importala su altri dispositivi. |
| Ripristina impostazioni predefinite | Riporta DataWedge alla configurazione predefinita. |
| Importazione automatica | DataWedge applica automaticamente i file di configurazione posizionati nella sua cartella di importazione automatica (vedere sezione 4). |
| Persistenza della configurazione | La configurazione è mantenuta attraverso i riavvii. |
| Interfaccia utente di configurazione | App DataWedge sul dispositivo per la configurazione manuale. |
Riferimento Zebra TechDocs:
Impostazioni DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/settings/
3.5 Controllo programmatico e strumenti
| Funzionalità | Descrizione |
|---|---|
| API Intent di DataWedge | Controlla DataWedge da un'app con intenzioni Android - ad esempio cambia profili, attiva una scansione soft, imposta l'elenco app disabilitate, interroga lo stato dello scanner e crea o aggiorna la configurazione. |
| App DWDemo | Testa la scansione e l'output dei dati. |
Riferimento Zebra TechDocs:
API di DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo: https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/
4. Iniziare
Passo 1 - Aggiorna l'OS
- Aggiorna il dispositivo a Elo Android 14 MR-9 (7.000.009.0046+gen5p) o successivo tramite il portale EloView o il Pannello di Controllo EloView sul dispositivo. Altri utenti MDM possono utilizzare le funzionalità di Aggiornamento Automatico e Manuale di Elo OEMConfig.
- Se utilizzi uno scanner di codici a barre Edge Connect, collegalo al dispositivo.
- Apri l'app DataWedge dal launcher delle app.
Passo 2 - Abilita Profile0 e verifica
- Profile0 è il profilo di fallback che si applica a ogni app senza il proprio profilo. Nella versione di rilascio è disattivato per impostazione predefinita, quindi le app senza il proprio profilo non mostrano alcun pulsante di scansione flottante e DataWedge non tiene la camera fino a quando non lo attivi.
- Per abilitarlo, apri Impostazioni Android Impostazioni Elo e attiva Scansione DataWedge (Profile0). Poi apri DWDemo, scansiona un codice a barre con lo scanner connesso (o premi e tieni premuto il pulsante di scansione giallo sullo schermo: con Selezione scanner su Auto utilizza lo scanner USB connesso, e senza scanner USB collegato scansiona con la camera frontale), e conferma che i dati appaiano.
- Mentre il controllo delle Impostazioni Elo è in uso, l'entrata di Profile0 all'interno dell'app DataWedge è disabilitata ("disabilitato dall'amministratore"); cambia Profile0 dalle Impostazioni Elo.
- Per abilitare la scansione senza toccare ogni dispositivo, dai alla tua app il proprio profilo invece di fare affidamento su Profile0. Un profilo si applica ogni volta che la sua app è in primo piano, indipendentemente dall'impostazione di Profile0. Crealo su un dispositivo di riferimento e invialo alla flotta con Importazione Automatica (Passo 5), oppure fai in modo che l'app lo crei al primo avvio con l'API Intent SET_CONFIG di DataWedge (vedi Per sviluppatori).
Passo 3 - Crea un profilo per la tua app
- In DataWedge, apri il menu e seleziona Nuovo profilo; inserisci un nome.
- Apri App associate e aggiungi il pacchetto della tua app (e, facoltativamente, attività specifiche).
- Sotto Input codice a barre, assicurati che l'input sia abilitato e scegli il dispositivo sotto Selezione scanner (Auto per impostazione predefinita; per scegliere uno scanner esterno specifico o la camera frontale, apri il menu e seleziona Mantieni nuovo scanner). Nota: lo scanner scelto sotto Selezione scanner di input codice a barre è quello utilizzato dal profilo; Configura impostazioni scanner imposta solo i parametri di quello scanner.
- Sotto Decodificatori, abilita solo le simbologie di cui il tuo flusso di lavoro ha bisogno.
- Scegli un output: Output sequenze di tasti per app che leggono campi di testo, o Output intenzioni per app che ricevono dati di scansione programmaticamente (imposta l'azione dell'intenzione, la categoria e il metodo di consegna per corrispondere al ricevitore della tua app). Disabilita l'output che non stai utilizzando.
- Facoltativamente aggiungi prefissi, suffissi o regole sotto Formattazione base o Formattazione avanzata dei dati.
- Porta la tua app in primo piano - DataWedge passa automaticamente al nuovo profilo.
Passo 4 - Controlla Profile0 e il pulsante di scansione sullo schermo
- Profile0 è disattivato per impostazione predefinita, quindi le app senza il proprio profilo non mostrano alcun pulsante di scansione flottante. Attivalo o disattivalo da Impostazioni Android > Impostazioni Elo > Scansione DataWedge (Profile0).
- Data Capture Plus è attivato di default in ogni nuovo profilo, quindi il pulsante di scansione flottante appare anche nelle app che hanno il proprio profilo. Per nasconderlo per un'app, apri il profilo di quell'app e deseleziona Data Capture Plus > Abilitato.
- Le app che non devono condividere la camera o ricevere dati di scansione - ad esempio tap-to-pay / app di pagamento SoftPOS che rilevano l'uso della camera - dovrebbero essere aggiunte a Impostazioni > Elenco app disabilitate in DataWedge, oppure Profile0 dovrebbe essere disattivato.
Passo 5 - Distribuisci la configurazione alla tua flotta
- Su un dispositivo di riferimento configurato, apri Esporta impostazioni DataWedge ed esporta la configurazione completa (datawedge.db) o un singolo profilo (dwprofile\_<nome>.db).
- Utilizza il tuo MDM per inviare il file alla cartella di importazione automatica di DataWedge sui dispositivi target:
/storage/emulated/0/Android/data/com.symbol.datawedge/files/autoimport
- DataWedge importa automaticamente il file e lo applica senza riavvio. Non rinominare o modificare i file .db esportati.
Per sviluppatori
- Utilizza l'API Intent di DataWedge per cambiare profili, attivare scansioni e creare o aggiornare profili dalla tua app: https://techdocs.zebra.com/datawedge/latest/guide/api/
- Riferimento profilo e plug-in: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
- Le app già integrate con DataWedge su dispositivi Android Zebra sono progettate per non necessitare di modifiche al codice di scansione per il set di funzionalità della Fase 1.
5. Risorse e Supporto
- Documentazione Zebra DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/about/
- Supporto 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