KEPLIN Docs

Das Smartphone mit einer App verbinden

Eine App per QR oder von Hand zu KeplinGo hinzufügen, die Verknüpfung auf dem Startbildschirm, mehrere Apps auf demselben Smartphone, und was das Smartphone zu den Bildschirmen hinzufügt.

Direkt nach der Installation weiß KeplinGo weder, mit welcher Installation es sich verbinden soll, noch welche Apps es öffnen soll. Jede App wird einmal hinzugefügt, mit der Adresse der Installation und der Kennung der App, und hat von da an ihre eigene Verknüpfung auf dem Startbildschirm.

Es gibt zwei Wege, eine App hinzuzufügen. Der QR-Code ist der Weg, wenn man Smartphones für andere Personen vorbereitet; die Eingabe von Hand ist für den Fall, dass es keinen QR-Code gibt.

Eine App per QR hinzufügen

Der QR-Code wird auf der Plattform erzeugt und enthält die Adresse der Installation und die gewählte App.

  1. Öffnen Sie Einstellungen in der Seitenleiste.
  2. Gehen Sie hinunter zum Panel Mobile App und finden Sie Verbindung per QR.
  3. Öffnen Sie den Selektor App auswählen… und wählen Sie die App, zum Beispiel Kundenverwaltung.

Der App-Selektor der Verbindung per QR, mit den Apps der Installation
Der App-Selektor der Verbindung per QR, mit den Apps der Installation

  1. Der Code erscheint darunter, mit dem Link daneben und dem Button Link kopieren.

Der für die App Kundenverwaltung erzeugte QR-Code, mit dem Link daneben
Der für die App Kundenverwaltung erzeugte QR-Code, mit dem Link daneben

  1. Richten Sie auf dem Smartphone, mit installiertem KeplinGo, die Kamera auf den Code und öffnen Sie den Link, den sie anzeigt.

KeplinGo öffnet sich auf dem Bildschirm Mit einer App verbinden, bereits ausgefüllt. Der QR-Code erspart das Tippen, fügt die App aber nicht von selbst hinzu: Die Person tippt noch auf Adresse validieren und liest den Namen der App, bevor sie sich anmeldet.

Hinweis

Der QR-Code enthält die erste veröffentlichte Adresse der App, und das Smartphone öffnet die veröffentlichte Version. Im Feld Adresse dient die Option Adresse der Plattform (Arbeitsversion) dazu, noch nicht Veröffentlichtes zu testen.

Tipp

Der QR-Code ist der praktische Weg, ein ganzes Team vorzubereiten: Projizieren Sie ihn in einer Besprechung, oder legen Sie ihn ausgedruckt neben die Smartphones. Jede Person richtet die Kamera darauf und muss sich nur mit ihren eigenen Zugangsdaten anmelden.

Eine App von Hand hinzufügen

  1. Öffnen Sie KeplinGo. Ohne eingerichtete App erscheint der Bildschirm Mit einer App verbinden. Mit eingerichteten Apps erscheint die Liste Ihre Apps: Tippen Sie auf App hinzufügen.
  2. Geben Sie die Serveradresse ein: die Adresse, unter der die Plattform antwortet, zum Beispiel https://ihre-app.beispiel.de. Ohne https:// ergänzt KeplinGo es.
  3. Geben Sie die App ein: die kurze Kennung der Anwendung, zum Beispiel gestao-clientes. Es ist dieselbe, die in ihren Adressen erscheint.
  4. Tippen Sie auf Adresse validieren.

KeplinGo fragt den Server, ob die App existiert, und antwortet auf eine dieser Arten:

Antwort Was zu tun ist
Sie verbinden sich mit «Kundenverwaltung», mit dem Symbol der App Es stimmt: Tippen Sie auf Hinzufügen und öffnen.
„Dieser Server hat diese App nicht.“ Die Adresse stimmt, die Kennung der App nicht.
„Zu dieser Adresse konnte keine Verbindung hergestellt werden.“ Die Adresse ist falsch, oder das Smartphone erreicht den Server nicht.
„Diese Adresse ist keine App dieser Plattform.“ Die Adresse antwortet, ist aber keine Keplin-Installation.
„Geben Sie eine https://-Adresse ein.“ Die Adresse taugt nicht: KeplinGo akzeptiert nur sichere Verbindungen.

Hinweis

Die Validierung gibt es, damit der Name der App gelesen wird, bevor jemand Zugangsdaten herausgibt. Deshalb bleibt sie ein ausdrückliches Tippen, auch wenn der QR-Code schon alles ausgefüllt hat.

In der App anmelden

Hinzufügen und öffnen speichert die App und öffnet sie auf ihrem Anmeldebildschirm: demselben Anmeldebildschirm, den die App im Browser zeigt, mit dem Design, das Sie ihm gegeben haben. Die Zugangsdaten sind die der Anwendung, nicht die der Plattform: die Konten, die in den Einstellungen der App verwaltet werden.

Der Anmeldebildschirm der Kundenverwaltung in der Breite eines Smartphones. Dieser Bildschirm hat kein eigenes Design für das Smartphone bekommen und wird mit dem Web-Design ausgeliefert, deshalb sind die Beschriftungen eng. Das Kapitel zum Bildschirm-Builder zeigt, wie man jedem Gerät sein Design gibt.
Der Anmeldebildschirm der Kundenverwaltung in der Breite eines Smartphones. Dieser Bildschirm hat kein eigenes Design für das Smartphone bekommen und wird mit dem Web-Design ausgeliefert, deshalb sind die Beschriftungen eng. Das Kapitel zum Bildschirm-Builder zeigt, wie man jedem Gerät sein Design gibt.

Die Sitzung bleibt auf dem Smartphone gespeichert und erneuert sich, während man arbeitet; nur lange Inaktivität beendet sie.

Hat die App Authentifizierungsanbieter (siehe Mit Authentifizierungsanbietern anmelden), öffnet die Schaltfläche jedes Anbieters die Seite des Dienstes in einem Chrome-Tab. Wenn die Person die Anmeldung abgeschlossen hat, kommt KeplinGo mit der bereits geöffneten App wieder in den Vordergrund. Active Directory meldet sich über die Felder des Anmeldebildschirms an, wie im Browser.

Die Verknüpfung auf dem Startbildschirm

Wenn KeplinGo eine App zum ersten Mal öffnet, bittet es Android, eine Verknüpfung zu ihr auf den Startbildschirm zu legen. Android zeigt seinen eigenen Bestätigungsdialog, mit dem Namen und dem Symbol der App.

  • Um die Verknüpfung anzulegen, tippen Sie im Dialog auf Zum Startbildschirm hinzufügen.

Die Verknüpfung öffnet die App direkt, ohne den Umweg über die Liste. Sie hat den Namen der App und das Symbol aus Einstellungen der App ▸ Allgemein ▸ Symbol auf dem Smartphone (siehe Apps erstellen und verwalten); ohne Bild hat sie das Symbol der App auf der Hauptfarbe des Designs. Ändern sich der Name oder das Symbol auf der Plattform, aktualisiert sich die Verknüpfung beim nächsten Öffnen der App von selbst.

Hinweis

Android erlaubt einer App nicht, den Namen zu ändern, mit dem sie installiert wurde. In der App-Liste des Smartphones erscheint KeplinGo immer als KeplinGo; Name und Symbol jeder App stehen auf den Verknüpfungen. Der Launcher kann der Verknüpfung ein kleines Abzeichen mit dem KeplinGo-Symbol hinzufügen.

Wenn Sie den Dialog ablehnen, können Sie die Verknüpfung später anfordern: Tippen Sie in der Liste Ihre Apps neben der App auf Weitere Optionen (die drei Punkte) und wählen Sie Zum Startbildschirm hinzufügen.

Unter Android 7 behält die Verknüpfung den Namen und das Symbol, die sie bei der Erstellung hatte: Android erlaubt das Aktualisieren von Verknüpfungen erst ab Android 8.

Mehrere Apps auf demselben Smartphone

KeplinGo behält so viele Apps wie nötig, aus derselben Installation oder aus verschiedenen.

  • Jede App öffnet sich in ihrer eigenen Android-Aufgabe. In den zuletzt verwendeten Apps hat jede ihre eigene Karte, mit ihrem Symbol, und der Wechsel zwischen ihnen verliert nichts von dem, was offen war.
  • Jede App hat ihre eigene Sitzung. Das An- oder Abmelden in einer berührt die anderen nicht.
  • Das KeplinGo-Symbol in der App-Liste öffnet die Liste Ihre Apps. Mit nur einer eingerichteten App öffnet es direkt diese App.
  • Wenn Sie das KeplinGo-Symbol gedrückt halten, erscheinen die eingerichteten Apps und App hinzufügen.

Innerhalb einer App hat das Benutzermenü den Eintrag KeplinGo-Apps, der die Liste öffnet. So fügt man eine weitere App hinzu, ohne die geöffnete zu verlassen.

Was man auf dem Smartphone sieht

KeplinGo zeigt die Bildschirme, die Sie für das Smartphone gestaltet haben, mit der Navigation für das Smartphone (Seitenmenü oder untere Leiste, je nach Konfiguration) und dem Bildschirm, den Sie als Startbildschirm markiert haben.

Der Startbildschirm der App Kundenverwaltung, in der Breite eines Smartphones
Der Startbildschirm der App Kundenverwaltung, in der Breite eines Smartphones

Es ist dieselbe Runtime wie im Browser: Alles, was im Browser funktioniert, funktioniert hier, einschließlich der Custom-Widgets, der Modale, der Berichte und des vollständigen SDK. Es gibt keine zweite Version der Anwendung zu pflegen.

Was das Smartphone hinzufügt:

Element In KeplinGo
Standort keplin.device.location() liest das GPS des Smartphones. Android fragt beim ersten Mal nach der Erlaubnis. keplin.device.platform ist "android".
Kamera Das Widget Datei-Upload mit eingeschalteter Kamera öffnet die Kamera des Smartphones. Custom-Widgets, die die Kamera live nutzen (zum Beispiel ein Codeleser), bekommen sie ebenfalls, mit der Erlaubnis von Android.
Dateien Berichte, Exporte und Anhänge öffnen sich in der App des Smartphones, die diesen Dateityp liest, zum Beispiel im PDF-Viewer; gibt es keine, öffnet sich das Teilen-Menü.
Externe Links Eine Adresse außerhalb der App öffnet sich im Browser des Smartphones; eine Telefonnummer oder eine E-Mail-Adresse öffnet sich in der passenden App.
Zurück-Taste Geht zum vorherigen Bildschirm der App. Auf dem ersten Bildschirm führt sie zum Startbildschirm, und die App bleibt in den zuletzt verwendeten Apps.

Wenn das Netz ausfällt

Ohne Netz zeigt KeplinGo den Hinweis Keine Verbindung, mit dem Button Erneut versuchen. Die Bildschirme kommen vom Server, deshalb gibt es keine lokale Kopie, die angezeigt werden könnte.

Eine App entfernen

  1. Öffnen Sie die Liste Ihre Apps: Tippen Sie auf das KeplinGo-Symbol, oder wählen Sie KeplinGo-Apps im Benutzermenü einer App.
  2. Tippen Sie neben der App auf Weitere Optionen (die drei Punkte) und wählen Sie Entfernen.
  3. Bestätigen Sie mit Entfernen.

Die App wird aus KeplinGo entfernt und ihre Sitzung endet. Android erlaubt KeplinGo nicht, die Verknüpfung auf dem Startbildschirm zu löschen: Die Verknüpfung wird grau, mit dem Hinweis, dass die App entfernt wurde, bis Sie sie von Hand entfernen.

Warum funktioniert … nicht?

  • …der QR-Code? Prüfen Sie, ob KeplinGo auf dem Smartphone installiert ist. Ohne die App öffnet der Link des Codes nichts.
  • …die Verbindung, mit der richtigen Adresse? Das Smartphone muss den Server erreichen. Eine interne Adresse des Unternehmens antwortet außerhalb seines Netzes nicht. Die Adresse muss mit https:// beginnen.
  • …mein Passwort der Plattform? Die Zugangsdaten sind die der App, nicht die derer, die bauen. Wer baut, meldet sich im Browser bei der Plattform an.
  • …ein Bildschirm, den es im Browser gibt? Die Berechtigungen sind dieselben: Ein Bildschirm ohne Zugriff für dieses Konto erscheint nicht. Prüfen Sie seine Rolle in den Berechtigungen der App.
  • …der Name der App in der App-Liste des Smartphones? Android zeigt den Namen, mit dem die App installiert wurde, KeplinGo. Der Name jeder App steht auf ihrer Verknüpfung.
  • …die Verknüpfung auf dem Startbildschirm? Der Dialog wurde abgelehnt, oder der Launcher akzeptiert keine Verknüpfungen. Fordern Sie sie in der Liste erneut an, unter Weitere Optionen ▸ Zum Startbildschirm hinzufügen.