KDEnterpriseBrowser — Manuale utente
Cos’è KDEnterpriseBrowser
KDEnterpriseBrowser è il browser dei terminali Android di magazzino Zebra, Honeywell e altri: apre la web app in modalità kiosk/single app.
Sul terminale si vede solo la pagina di lavoro: niente barra degli indirizzi, niente schede. Una striscia scura in alto mostra il nome del terminale, la rotellina di caricamento e, se abilitato, il pulsante App.
Il manuale ha due parti:
- Per chi usa il terminale: uso quotidiano e menu App.
- Per chi configura il terminale (responsabile o tecnico): configurazione, app del menu, Home e blocco, prove, esportazione.
Uso quotidiano
Si lavora sulla pagina come su qualsiasi web app: si tocca, si scrive, si legge un codice con il pulsante del lettore.
| Situazione | Cosa si vede | Cosa fare |
| Lettura di un codice | Bip e/o vibrazione (se attivi); il codice arriva al campo o alla funzione della pagina | Niente: la pagina lo riceve da sola |
| Lettura mentre la pagina carica | Rotellina in alto | Niente: il codice arriva a caricamento finito (se non passano più di 10 secondi) |
| Pagina in caricamento da capo | Pagina «Caricamento…» | Attendere |
| Rete assente | Pagina «Rete non disponibile» con il conto alla rovescia | Attendere la riprova automatica (10 secondi, se non configurato diversamente) o toccare Riprova ora |
| Tasto indietro | Torna alla pagina precedente del sito | Il tasto indietro non chiude mai l’app |
Mentre è aperta la configurazione, la pagina di errore o il menu App, le letture non vanno alla pagina di lavoro.
Accesso ricordato: se la web app offre «Ricorda l’accesso», l’accesso resta anche dopo lo spegnimento del terminale.
Il menu App
Il pulsante App nella striscia in alto apre, senza password, le app che il responsabile ha permesso (per esempio la fotocamera o il client di posta).
- Toccare App nella striscia scura in alto.
- Toccare l’app da aprire nell’elenco (icona e nome).
- Per tornare al browser premere il tasto Home del terminale (se il browser è impostato come Home) oppure riaprire KDEnterpriseBrowser.
Chiudi o il tasto indietro tornano alla pagina di lavoro senza aprire nulla.
Se il pulsante App non c’è, nessuna app è stata permessa. Un’app disinstallata scompare dal menu da sola.
Primo avvio e accesso alla configurazione
Al primo avvio si apre subito la configurazione, perché manca l’indirizzo della web app: scriverlo e premere Salva.
Se sul terminale c’era la versione 1, la versione 2 installata sopra riprende indirizzo, PIN (che diventa la password) e schermo intero, e mantiene l’accesso ricordato.
Per aprire la configurazione in seguito:
- Toccare cinque volte in tre secondi la striscia scura in alto (non il pulsante App). In alternativa, dalla pagina «Rete non disponibile» toccare il pulsante della configurazione.
- Scrivere la password e confermare.
Senza password la configurazione si apre a chiunque e il titolo mostra «Configurazione (senza password!)».
Nella barra in alto, Salva applica le modifiche e torna alla pagina; Annulla (o il tasto indietro) le scarta.
Le voci della configurazione
La configurazione ha tre gruppi di voci (Pagina, Lettore, Terminale); di solito basta l’indirizzo iniziale, il resto ha valori predefiniti adatti.
| Gruppo | Voce | Cosa fa | Predefinito |
| Pagina | Indirizzo iniziale | La pagina aperta all’avvio; deve cominciare con http:// o https:// (per il palmare: https://…/t) | — |
| Pagina | Indirizzi ammessi | Uno per riga. Fuori da questi la navigazione è bloccata. Una voce con :// vale come inizio dell’indirizzo (https://kd.esempio.it/ ammette tutto il sito); una voce senza :// è un nome di server, sottodomini compresi | Vuoto: solo il sito dell’indirizzo iniziale |
| Pagina | Orientamento | Automatico, Verticale o Orizzontale | Automatico |
| Pagina | Zoom con le dita | Permette di ingrandire la pagina con due dita | Spento |
| Pagina | Dimensione del testo | Percentuale, da 50 a 300 | 100 |
| Pagina | Senza rete: nuovo tentativo dopo | Secondi prima della riprova automatica, da 3 a 600 | 10 |
| Lettore | Lettore | Automatico (dal produttore), Zebra (DataWedge), Honeywell, Urovo, Personalizzato | Automatico |
| Lettore | Action, Extra del codice, Extra del tipo | Gli intent del lettore; si modificano solo se il lettore non è Automatico (vedi docs/INTENT_LETTORI.md) | Quelli del produttore |
| Lettore | Consegna alla pagina | onBarcodeRead(codice, simbologia) per le pagine KD; Tastiera con Invio finale scrive il codice nel campo con il cursore | onBarcodeRead |
| Lettore | Suono / Vibrazione a ogni lettura | Segnale a ogni codice letto | Spenti |
| Lettore | Zebra: profilo DataWedge in automatico | Su Zebra il browser crea e aggiorna da solo il profilo DataWedge | Acceso |
| Terminale | Schermo sempre acceso | Lo schermo non si spegne mentre il browser è aperto | Acceso |
| Terminale | Schermo intero | Nasconde le barre di sistema | Acceso |
| Terminale | Blocca sull’app | Blocco di Android sull’app (kiosk) | Spento |
| Terminale | Nuova password | Vuoto: resta la password attuale | Nessuna password |
| Terminale | App nel menu | Le app che il menu App apre senza password (sezione seguente) | Nessuna |
Le modifiche valgono solo dopo Salva. Se l’indirizzo iniziale non è valido o non è fra gli indirizzi ammessi, il browser lo dice e non salva.
Scegliere le app del menu
Le app del menu si scelgono in configurazione, quindi solo chi conosce la password decide quali app gli operatori possono aprire.
- Aprire la configurazione.
- Toccare App nel menu (n), dove n è il numero di app già scelte.
- Nell’elenco delle app installate (icona e nome, in ordine alfabetico) accendere l’interruttore delle app da permettere e spegnere quello delle altre.
- Toccare Fatto (o il tasto indietro) per tornare alla configurazione.
- Toccare Salva: senza Salva la scelta non vale.
L’elenco mostra le app che hanno un’icona nel launcher del terminale. Con almeno un’app scelta, il pulsante App compare nella striscia in alto.
Browser come Home e blocco sull’app
Impostato come app Home, KDEnterpriseBrowser è la prima cosa che il terminale mostra: riparte da solo dopo un riavvio, un errore o la chiusura, e il tasto Home riporta sempre al browser.
Per impostarlo come Home:
- In configurazione toccare Scegli l’app Home del terminale.
- Nella finestra di Android scegliere KDEnterpriseBrowser e confermare con Sempre.
Per tornare alla Home originale ripetere gli stessi passi scegliendo il launcher del terminale.
Blocca sull’app attiva il blocco di Android: l’operatore non può passare ad altre app. Quando si apre un’app dal menu App il blocco si toglie, e torna quando si rientra nel browser. Su alcuni terminali Android chiede di confermare il blocco a ogni rientro; la conferma non serve se il terminale è gestito come Device Owner dall’MDM.
Prova del lettore e della rete
Le due prove dicono se il problema è nel lettore, nella rete o nella pagina, senza uscire dal browser.
- Prova il lettore (configurazione, gruppo Lettore): prova le impostazioni così come sono scritte, anche prima di Salva. Ogni codice letto compare nel registro con simbologia, action e tutti i dati dell’intent; le letture non vanno alla pagina.
- Prova la rete (configurazione o pagina di prova): chiama l’indirizzo iniziale e scrive il codice di risposta HTTP e il tempo in millisecondi, oppure l’errore.
Nel registro finiscono anche gli indirizzi bloccati perché non ammessi, l’esito della configurazione DataWedge su Zebra e gli errori dell’app. Pulisci svuota il registro, Chiudi torna alla configurazione.
Esportare, importare, uscire
Si configura un terminale una volta sola e si copia la configurazione sugli altri, con un file o con un QR Code.
- Sul terminale configurato toccare Esporta la configurazione: il browser scrive KDEnterpriseBrowser.json nella cartella Download (o nella cartella dell’app) e mostra dove.
- Copiare il file sull’altro terminale, per esempio con il cavo USB.
- Sull’altro terminale toccare Importa una configurazione e scegliere il file.
- Controllare i campi e toccare Salva.
Il file contiene tutte le voci, app del menu comprese, e la password come impronta SHA-256, non in chiaro. Le app del menu valgono sull’altro terminale solo se lì sono installate.
Copiare la configurazione con un QR
Senza file e senza cavo, la configurazione passa da un terminale all’altro con un QR Code letto dallo schermo.
- Sul terminale configurato toccare Mostra la configurazione in un QR. Il QR contiene i campi così come sono scritti, anche quelli non ancora salvati e la nuova password, se è stata scritta.
- Sul terminale da configurare aprire la configurazione e leggere il QR con il lettore, dallo schermo dell’altro terminale. I campi si riempiono e compare «Configurazione letta dal codice».
- Controllare i campi e toccare Salva: fino ad allora non cambia nulla, password compresa.
Nella pagina del QR, Esporta salva il QR come immagine KDEnterpriseBrowser.png nella stessa cartella del file JSON, per stamparlo o mandarlo. Chiudi (o il tasto indietro) torna alla configurazione.
Il QR contiene la password come il file: va trattato come un documento riservato. Se la configurazione è troppo lunga per un QR il browser lo dice: in quel caso usare Esporta la configurazione.
Se la lettura non riempie i campi, nel profilo del lettore deve essere attiva la simbologia QR Code, e Prova il lettore deve mostrare le letture. Il QR si legge solo con la configurazione aperta; altrove viene ignorato.
Uscire
Esci da KDEnterpriseBrowser, in fondo alla configurazione, toglie il blocco sull’app e chiude il browser. Se il browser è la Home, Android lo riapre al prossimo tasto Home.
Problemi comuni
Quasi tutti i problemi si riconoscono con le due prove della sezione precedente.
| Problema | Causa probabile | Soluzione |
| Il lettore suona ma il codice non arriva alla pagina | Consegna sbagliata per quella pagina, o pagina senza onBarcodeRead | Provare l’altra voce di Consegna alla pagina; per le pagine KD usare onBarcodeRead |
| Il lettore non legge nulla nel browser | Intent del lettore diversi da quelli configurati | Prova il lettore; se non compare nulla, impostare il lettore del produttore o controllare docs/INTENT_LETTORI.md |
| «Rete non disponibile» continua | Wi-Fi assente o server irraggiungibile | Prova la rete; controllare il Wi-Fi del terminale |
| Un link della pagina non si apre | Indirizzo non fra gli ammessi | Il registro lo mostra: aggiungerlo agli Indirizzi ammessi |
| Il pulsante App non c’è | Nessuna app scelta, o scelta non salvata | App nel menu, poi Salva |
| L’elenco delle app è vuoto | L’app non vede le app installate su quel terminale | Segnalarlo al fornitore con modello e versione di Android |
| La configurazione non si apre | Tocchi troppo lenti o sul pulsante App | Cinque tocchi rapidi sulla parte scura della striscia, lontano dal pulsante App |
| Password dimenticata | — | Cancellare i dati dell’app dalle impostazioni di Android (si perdono configurazione e accesso ricordato), poi riconfigurare o importare un file esportato |