DifficultyMoeilijkheidsgraad: expert
Inhoud
Table of Contents | ||||
---|---|---|---|---|
|
Learning Objectives
After reading this article, you’ll be able to:
Troubleshoot issues on Kiosk App
FAQ
Leerdoelen
Na het lezen van dit artikel zul je in staat zijn om:
Problemen met de Kiosk-app oplossen
FAQ
Netwerk gerelateerde vragen
Expand | ||||
---|---|---|---|---|
|
| |||
Workplace API en alle apps/touchpoints communiceren via https, d.w.z. 443 zou goed genoeg moeten zijn.
Specifiek voor Qbic-apparaten -> Het apparaatbedieningsplatform (1e tabblad Apparaatbediening, specifiek voor Qbic) communiceert met de Qbic-apparaten voor hardwarebediening via http (poort 80). Dit is hoe Qbic de API beschikbaar stelt, dus dat kunnen we niet veranderen. Als poort 80 niet beschikbaar is, zal Qbic remote hardwarebeheer niet werken. Dit is ook de reden waarom Qbic hardwarebeheer alleen beschikbaar is voor PC's binnen hetzelfde netwerk. Het is een extra beveiligingsvoorwaarde Zodat externe apparaten geen toegang hebben tot de Qbic API via http. Om configuratie naar QBIC-apparaten te pushen vanuit Device Control: poorten 80 + 443 moeten open staan. Als je Device Control niet wilt gebruiken om configuratie te pushen (geen Qbic maar staande kiosk; of je wilt geen Qbic-apparaten scannen in Device Control): vanuit een puur Workplace-perspectief is alleen poort 443 nodig. Over het algemeen hebben PC's/apparaten echter allemaal poort 80 openstaan voor webcommunicatie vanuit andere apps/services, dus we weten niet zeker wat voor invloed het sluiten hiervan zou kunnen hebben. Klein voorbeeld: als je momenteel http://go.cobundu.com/ on your op uw browser, you are automatically redirected to wordt u automatisch doorgestuurd naar httpS://go.cobundu.com/ -> you asked for an insecure URL, but either the application or the browser automatically redirected you to the secure one. On the other hand, if port 80 was disabled, your http request might just show an error "connection refused" on the browser - and not redirect anymore, because port 80 could not capture your request | ||||
Expand | ||||
| ||||
Kiosk app reaches out toje hebt om een onveilige URL gevraagd, maar de applicatie of de browser heeft je automatisch omgeleid naar de veilige URL. Aan de andere kant, als poort 80 was uitgeschakeld, zou je http-verzoek een foutmelding "connection refused" (verbinding geweigerd) kunnen tonen op de browser - en niet meer doorsturen, omdat poort 80 je verzoek niet kon afvangen. |
Expand | ||
---|---|---|
| ||
Kiosk-app bereikt |
Expand | ||||
---|---|---|---|---|
| On
| |||
|
Hardware related questions
Expand | ||
---|---|---|
| ||
Yes, you can install the app on any other tablet device, as long as it runs the latest OS versions of iOS, Android or Windows. Other Operating systems like Tizen are not supported.
|
Vragen over hardware
Expand | ||
---|---|---|
| ||
Ja, je kunt de app installeren op elk ander tabletapparaat, zolang het de nieuwste OS-versies van iOS, Android of Windows draait. Andere besturingssystemen zoals Tizen worden niet ondersteund.
Het oplossen van problemen met firmware en hardware wordt niet aangeboden door Spacewell. |
Expand | ||
---|---|---|
| ||
The Het QBIC TD1070 model comes is er in 2 flavorssmaken:
Controleer de specificaties van de tag/kaart om meer te weten te komen over het protocol dat ze gebruiken en vergelijk met onderstaande NFC-compatibiliteitslijst. Of below NFC compatibility list: the entire table is supported by the TD1070H Van onderstaande NFC-compatibiliteitslijst:
|
Expand | ||||||
---|---|---|---|---|---|---|
|
Info |
---|
Be sure to check question “Which NFC Protocolls are supported?” |
Spacewell does not provide help on questions like
"How do we upload the Spacewell Workplace ID of our many employees on ourHoe kan ik de NFC-functionaliteit gebruiken? |
Het TD1070 model heeft een ingebouwde NFC-chip. De individuele Spacewell Workplace ID van de gebruiker moet op de werknemersbadge worden geschreven.
Controleer bij uw IT-/beveiligingsafdeling of uw badges NFC ondersteunen en of ze (opnieuw) geformatteerd moeten worden. Er moeten duidelijke gegevens (directe toegang) op de tag staan (NDEF-bericht).
Info |
---|
Controleer zeker de vraag "Welke NFC-protocollen worden ondersteund?". |
Spacewell biedt geen hulp bij vragen als
"Hoe uploaden we de Spacewell Workplace ID van onze vele werknemers op onze badges in batch-upload? "
"We don't know if this badge is formatted/how to get the info as plain dataweten niet of deze badge geformatteerd is/hoe krijgen we de info als gewone gegevens?"
"Because of security protocols, we cannot touch the Vanwege beveiligingsprotocollen kunnen we de badge (contentsinhoud) niet aanraken, how do we make this work?”
|
QBIC Besturingssysteem
Expand | ||
---|---|---|
Expand | ||
| ||
| ||
The Qbic devices receive regular OS upgrades every few years to remain compatible with the latest IT security requirements. Spacewell collaborates with Qbic, however we can’t promise to always offer the latest Android version. Note only a very small number of Android devices around the world get security patches (mostly consumer devices like Samsung); it’s not a common practice for Digital Signages to get the same frequency of OS & security upgrades to ensure stability and “long term stable builds”. The releases do not happen very often, but they are tested very thoroughly both in terms of stability as in terms of security. The embedded Android version is stripped from all unnecessary items (e.g. there’s no PlayStore available) to guarantee better stability and security. Also, the device is completely shielded: it runs a single app and physical users have no way of breaking out of the devices launch screen. In combination with a strong firewall, one can really mitigate the risk to near-zero. You can add an extra layer of security by creating a separate network for the devices , limiting the risk of external attacks to real-zero. Most firmware upgrades can be pushed (as part of the Device Configuration Push, see Device Control for Kiosk App )), but it’s not a fully bullet proof rule. There are situations in which Qbic releases an update which cannot be pushed over-the-air and hence requires a manual update. This doesn’t happen much and is only applicable in case of big OS upgrades on the device. | ||
| ||
De Qbic-apparaten krijgen om de paar jaar regelmatige OS-upgrades om compatibel te blijven met de nieuwste IT-beveiligingsvereisten. Spacewell werkt samen met Qbic, maar we niet kunnen beloven altijd de nieuwste Android-versie aan te bieden. Merk op dat slechts een zeer klein aantal Android-apparaten over de hele wereld beveiligingspatches krijgen (meestal consumentenapparaten zoals Samsung); het is niet gebruikelijk voor Digital Signages om dezelfde frequentie van OS & beveiligingsupgrades te krijgen om stabiliteit en "langdurige stabiele builds" te garanderen. De releases komen niet vaak voor, maar ze worden zeer grondig getest, zowel op stabiliteit als op veiligheid. De ingesloten Android-versie is ontdaan van alle onnodige zaken (er is bijvoorbeeld geen PlayStore beschikbaar) om een betere stabiliteit en veiligheid te garanderen. Bovendien is het apparaat volledig afgeschermd: er draait maar één app op en fysieke gebruikers hebben geen mogelijkheid om uit het startscherm van het apparaat te komen. In combinatie met een sterke firewall kan het risico echt tot bijna nul worden teruggebracht. Je kunt een extra beveiligingslaag toevoegen door een apart netwerk te maken voor de apparaten, waardoor het risico op aanvallen van buitenaf tot nul wordt beperkt. De meeste firmware-upgrades kunnen worden gepusht (als onderdeel van de Device Configuration Push, zie Device Control for Kiosk App )), maar het is geen volledig waterdichte regel. Er zijn situaties waarin Qbic een update uitbrengt die niet over-the-air kan worden gepushed en dus een handmatige update vereist. Dit gebeurt niet vaak en is alleen van toepassing bij grote OS-upgrades op het apparaat. |
Expand | ||
---|---|---|
| ||
Momenteel wordt de upgrade naar Android 12 alleen aanbevolen voor TD-1070 toestellen
|
Logo/Video Best Practices
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Device Control use
Expand | ||
---|---|---|
| ||
Yes, using device control you can see snapshots of the configured devices. Connected devices automatically upload a screenshot every hour
You can view the latest snapshot per device: Or you can view an overview of all snapshots side by side: |
Expand | ||
---|---|---|
| ||
|
Kiosk app
title | How do I log out of the Kiosk app? |
---|
To log out of the Kiosk app, you’ll need the kiosk user login details.
Info |
---|
If Device Account Management is enabled, the password might have been reset by Workplace to a random, auto-generated device account password. |
Tap multiple times on the Logo (top left on Kiosks; Meeting Room Displays either bottom left or top right depending on the used profile view)
You will be prompted to provide the Kiosk user login details
Return to Home: return to the Kiosk App-in-use screen
Re-Configure Device: re-start configuration (for example when you change the profile or theme)
Force Reload Configuration (for example when you changed a location name or picture in IWMS, or if you want to push custom content)
Exit: Exit the app
Expand | ||
---|---|---|
| ||
Kiosk App is only available in landscape / horizontal mode. |
Troubleshooting
The Device Control Platform is a good place to start troubleshooting. When the device is not able to connect to the Platform (device is “offline”): troubleshooting on site seems to be the only possible option.
Info |
---|
When troubleshooting, it’s advisable to take note of the app version, profiles and themes. We recommend to take a screenshot of all the error screens you encounter in case our support team is helping |
The most common error is related to devices going offline
A Room Display can go offline due to multiple reasons. The below table lists the most common scenarios, how the app reacts to each, and whether a manual intervention is needed to bring it back online.
Offline scenario
Point of failure
Recovery mechanism
Requires manual intervention?
Internet/network connection lost
Network/hardware/ISP
Kiosk re-checks for connectivity iteratively until a successful connection is established.
No
Scheduled off/on times on Qbic
Device
Kiosk re-connects automatically when device switches on
No
Workplace API not reachable/Workplace down
Workplace back-end
Depending on the kind of error received, the Kiosk re-checks for service availability iteratively until a successful connection is established
No
Device account disabled
Device account
A device account can get disabled in the below cases:
Manually disabled in Studio by an administrator (for example in case of a security breach). As this is a manual intervention, this is not a concern.
Device tries to login with invalid credentials multiple times. This should be properly handled in the app.
Automatic recovery not possible. An admin needs to enable the device account in Studio. The app navigates back to the Wizard screen and does not recover.
Yes; An administrator can login into studio and re-enable the account. The app will reconnect automatically at the next attempt.
Device account – password changed/ needs to be changed because it has expired
Device account
A device account password can expire or change in the following ways:
An administrator changed it explicitly by logging in to Go or Studio with the same account.
The “must change password” or “Force all users to change password” option was triggered in Studio.
The “maximum password age” has elapsed.
Automatic recovery not possible. An admin needs to change the password and push new credentials. The app navigates back to the Wizard screen and does not recover.
If "Allow Kiosk to manage it’s own device account" has been enabled in the past, then the issue should not occur.
Yes, although “Allow Kiosk to manage its own device account” is available under Device Control > Settings.
Captcha input requested by server
3rd party service (ReCAPTCHA)
Captcha input is mandated when there have been too many attempts to login with invalid credentials within a short duration. This, in a way, relates back to the previous scenario.
As Captcha input is needed at an IP address level, it needs to be performed on the Device only.
Yes
Device account deleted
Workplace back-end
Cannot be recovered automatically. A new account should be created, and the app should be configured again.
Yes
Other common errors and solutions are shown in the table below
Error
Troubleshooting
The QBIC lights are no longer working
Expand | ||
---|---|---|
| ||
1. did the customer try to push new colors through Device Control > Themes? 2. when leaving the app, is it possible to steer the LEDs from within the QBIC settings? |
Error in the last configuration download (e.g. room pictures failed to download and the live device is showing the fallback background option)
Expand | ||
---|---|---|
| ||
Select the device(s) in device control and click on “ force reload configuration” in the bottom bar Note: The force re-load configuration does NOT force an immediate configuration push from device control to the app. |
I changed the name/image of a room and I don't see it being reflected in the Room display
Expand | ||
---|---|---|
| ||
Select the device(s) in device control and click on “ force reload configuration” in the bottom bar Note: The force re-load configuration does NOT force an immediate configuration push from device control to the app. |
The text is too small on the app: How do I make it larger?
title | expand |
---|
We suggest to make use of the Android functionalities on the device:
For QBIC TD-1050
Exit the app > Go to Settings> Display > Font Size > Large
For QBIC TD-1070 and TD-1060
Exit the app > Go to Settings:
- Display > Font Size > Large
- Display > Font Size > DPI, set to the lowest value (160)
- Display > Display Size
|
Logo/video best practices
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Apparaatcontrole gebruiken
Expand | ||
---|---|---|
| ||
Ja, met apparaatbeheer kun je snapshots zien van de geconfigureerde apparaten. Aangesloten apparaten uploaden elk uur automatisch een schermafbeelding
Je kunt de laatste momentopname per apparaat bekijken: Of je kunt een overzicht bekijken van alle snapshots naast elkaar: |
Expand | ||
---|---|---|
| ||
|
Kiosk-app
Expand | ||
---|---|---|
| ||
Om uit te loggen uit de Kiosk-app heb je de inloggegevens van de kioskgebruiker nodig.
Tik meerdere keren op het Logo (linksboven op Kiosken; Meeting Room Displays linksonder of rechtsboven, afhankelijk van de gebruikte profielweergave) U wordt gevraagd om de inloggegevens van de Kiosk-gebruiker op te geven
|
Expand | ||
---|---|---|
| ||
Kiosk App is alleen beschikbaar in liggende/horizontale modus. |
Problemen oplossen
Het Device Control Platform is een goede plek om te beginnen met het oplossen van problemen. Als het apparaat geen verbinding kan maken met het Platform (apparaat is "offline"): is probleemoplossing ter plaatse de enige mogelijke optie.
Info |
---|
Bij het oplossen van problemen is het raadzaam om de app-versie, profielen en thema's te noteren. We raden aan om een schermafdruk te maken van alle foutschermen die je tegenkomt, voor het geval ons ondersteuningsteam je helpt. |
De meest voorkomende fout is gerelateerd aan apparaten die offline gaan
Een Kamerdisplay kan om verschillende redenen offline gaan. In de onderstaande tabel staan de meest voorkomende scenario's, hoe de app op elk van deze scenario's reageert en of er een handmatige ingreep nodig is om het scherm weer online te krijgen.
Offline scenario | Faalpunt | Herstelmechanisme | Handmatige tussenkomst vereist? |
---|---|---|---|
Internet-/netwerkverbinding verbroken | Netwerk/hardware/ISP | De Kiosk controleert herhaaldelijk op connectiviteit totdat er een succesvolle verbinding tot stand is gebracht. | Geen |
Geplande uit/aan tijden op Qbic | Apparaat | Kiosk maakt automatisch opnieuw verbinding als apparaat wordt ingeschakeld | Geen |
Workplace API niet bereikbaar/Workplace down | Workplace back-end | Afhankelijk van het soort ontvangen fout controleert de Kiosk de beschikbaarheid van de service herhaaldelijk totdat een succesvolle verbinding tot stand is gebracht. | Geen |
Apparaataccount uitgeschakeld | Apparaat account Een apparaataccount kan in de volgende gevallen worden uitgeschakeld:
| Automatisch herstel niet mogelijk. Een beheerder moet het apparaataccount inschakelen in Studio. De app navigeert terug naar het scherm Wizard en herstelt niet. | Ja; Een beheerder kan inloggen in studio en de account opnieuw inschakelen. De app zal bij de volgende poging automatisch opnieuw verbinding maken. |
Apparaat account - wachtwoord gewijzigd/ moet worden gewijzigd omdat het verlopen | Apparaat account Het wachtwoord van een apparaataccount kan op de volgende manieren verlopen of veranderen:
| Automatisch herstel niet mogelijk. Een beheerder moet het wachtwoord wijzigen en nieuwe gegevens invoeren. De app navigeert terug naar het scherm Wizard en herstelt niet. Als "Allow Kiosk to manage it's own device account" in het verleden is ingeschakeld, dan zou het probleem niet moeten optreden. | Ja, hoewel "Kiosk toestaan zijn eigen apparaataccount te beheren" beschikbaar is onder Apparaatbeheer > Instellingen. |
Captcha invoer gevraagd door server | 3rd partijservice (ReCAPTCHA) | Captcha-invoer wordt verplicht wanneer er binnen een korte tijd te veel pogingen zijn geweest om in te loggen met ongeldige gegevens. Dit heeft in zekere zin te maken met het vorige scenario. Aangezien Captcha-invoer nodig is op IP-adresniveau, moet het alleen op het Apparaat worden uitgevoerd. | Ja |
Apparaataccount verwijderd | Workplace back-end | Kan niet automatisch worden hersteld. Er moet een nieuwe account worden aangemaakt en de app moet opnieuw worden geconfigureerd. | Ja |
Andere veelvoorkomende fouten en oplossingen staan in de onderstaande tabel
Fout | Problemen oplossen | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
De QBIC-lampjes werken niet meer |
| |||||||||||
Fout bij het downloaden van de laatste configuratie (bijv. kamerfoto's zijn niet gedownload en het live-apparaat toont de fallback-achtergrondoptie) |
| |||||||||||
Ik heb de naam/afbeelding van een kamer gewijzigd en zie dit niet terug in de weergave Ruimte |
| |||||||||||
De tekst is te klein op de app: Hoe maak ik hem groter? |
| |||||||||||
De tijd/klok in de app is niet correct voor de locatie |
| |||||||||||
"Scherm ontgrendelen: typ je wachtwoord" |
| |||||||||||
"niet in staat om boekingen te krijgen" |
| |||||||||||
"Help ons alsjeblieft met identificeren, ben je een robot?" |
| |||||||||||
" account is uitgeschakeld". |
| |||||||||||
Code “XML not installed correctly”"XML niet correct geïnstalleerd". |
| |||||||||||
"Niet afspelen, ongeldige URL" |
| |||||||||||
“This device is already registered with another account”"Dit apparaat is al geregistreerd bij een andere account". |
| |||||||||||
" Configuratie niet gevonden. Configureer het apparaat". |
| |||||||||||
Het apparaat gaat offline |
| |||||||||||
Het apparaat is geroot | Kiosk app is not able to run on rooted devices. If this message appears on a QBIC device, contact Spacewell Support. | “Network is unreachable“ | Make sure Private DNS is turned off in Android Network Settings depending on the chosen network settings Go back to the QBIC start screen (with the 4 tiles), check if a network connection is indicated -app kan niet draaien op gerootte apparaten. Neem contact op met Spacewell Support als dit bericht wordt weergegeven op een QBIC-apparaat. | |||||||||
"Netwerk is onbereikbaar". |
| |||||||||||
Het apparaat gaat offline | “This device has not been setup” | After resetting an ELO kiosk to factory settings, instead of showing the option to select eloview kiosk mode versus the android home page, the device might state it’s not been setup. We found following these steps helped to solve the issue
| The device is rooted |
| ||||||||
Het apparaat is geroot | Kiosk-app kan niet draaien op gerootte apparaten. Neem contact op met Spacewell Support als dit bericht wordt weergegeven op een QBIC-apparaat. | |||||||||||
"Dit apparaat is niet ingesteld". | Na het resetten van een ELO kiosk naar fabrieksinstellingen, in plaats van de optie te tonen om eloview kiosk modus te selecteren op de android startpagina, kan het apparaat aangeven dat het niet is ingesteld. We ontdekten dat deze stappen hielpen om het probleem op te lossen: https://getbite.zendesk.com/hc/en-us/articles/360060235371-Switching-EloView-between-Kiosk-and-Android-Mode#:~:text=Switching%20EloView%20between%20Kiosk%20and%20Android%20Mode%201,automatically%20reboot%20and%20display%20the%20Android%20Home%20screen. | |||||||||||
Android Home screenStartscherm |
|
Couldn’t find your error in the table above? Then try to empty the cache of the device:
Go to the device and close the Kiosk app. Go to settings > advanced settings
|
Kunt u uw fout niet vinden in de bovenstaande tabel? Probeer dan de cache van het apparaat te legen:
Ga naar het apparaat en sluit de Kiosk-app. Ga naar instellingen > geavanceerde instellingen > apps > kiosk > "clear Cache wissen" and en "Clear dataGegevens wissen"
Go back to the home screen on the display and launch the Kiosk app (if needed reboot the device)
Once the Kiosk app is launched, on Device Control Platform, scan for the device on "Qbic devices" tab.
Reconfigure the device with location, profile and theme.
Nothing worked? Then try a tabula rasa and clean install
On the Device Control Platform, unlink the device
Reboot (on device or through Device Control)
Go to the device and close the Kiosk app. Go to settings > advanced settings .
Ga terug naar het beginscherm op het scherm en start de Kiosk-app (indien nodig start het apparaat opnieuw op).
Zodra de Kiosk-app is gestart, scant u op het Device Control Platform naar het apparaat op het tabblad "Qbic-apparaten".
Herconfigureer het apparaat met locatie, profiel en thema.
Heeft niets gewerkt? Probeer dan een tabula rasa en schone installatie
Ontkoppel het apparaat op het Device Control Platform
Opnieuw opstarten (op apparaat of via Apparaatbeheer)
Ga naar het apparaat en sluit de Kiosk-app. Ga naar instellingen > geavanceerde instellingen > apps > kiosk > "clear Cache wissen" and en "Clear dataGegevens wissen".
Factory reset the Qbic display
In display settings: Check date/time toggle to “take from server” (Time server set to time.google; Time zone set to relevant time zoneFabrieksreset van het Qbic-scherm
In weergave-instellingen: Vink datum/tijd aan bij "take from server" (Tijdserver ingesteld op time.google; Tijdzone ingesteld op relevante tijdzone)
In Studio: disablegebruiker uitschakelen + enable user + reset password
Device Control Tab Qbic Devices > IP scan: install latest version of the app (through “remote upgrade XML”) + config push
Device Control Tab Devices: link devices
inschakelen + wachtwoord opnieuw instellen
Tabblad Apparaatbediening Qbic-apparaten > IP-scan: nieuwste versie van de app installeren (via "upgrade XML op afstand") + push-configuratie
Tabblad Apparaatbediening Apparaten: apparaten koppelen
Zoek op
Live Search |
---|