Table of Contents

Geräteeinrichtung

Die Geräteeinrichtung erlaubt Ihnen, das Verhalten der MDE-App auf dem jeweiligen Gerät zu konfigurieren. Anders als die Verbindungseinrichtung betreffen diese Einstellungen nur das aktuelle Gerät und nicht die Verbindung zu Business Central.

Überblick

Einstellungen in der App

Einstellung in der App Gültig für
App Designer BC
Benutzerdefinierter Gerätename ✓
(MDE Geräte Einrichtung)
Logging ✓ ✓
Bildschirmausrichtung
(nur Android)		 ✓ ✓
Layout-Modus ✓
Seitenverhältnis
(nur Windows)		 ✓ ✓
Schriftgröße ✓
Darstellung ✓ ✓
Kamera als Scanner verwenden ✓
(in der Verbindungseinrichtung)		 ✓
Audio & Vibration
(Vibration nur unter Android)		 ✓

Einstellungen im Betriebssystem

Einstellungen im Betriebssystem Gültig für
App Designer
Sprache ✓
Bildschirmausrichtung, wenn in der Geräteeinrichtung Automatisch gewählt wurde
(nur Android)		 ✓ ✓
Darstellung, wenn in der Geräteeinrichtung Systemeinstellung gewählt wurde ✓ ✓

Begriffsabgrenzung: "Designer" und "App"

In der MDE-MAUI-Dokumentation werden zwei zentrale Begriffe verwendet, die unterschiedliche Funktionsbereiche bezeichnen:

  • (MDE) Designer: Der Begriff "Designer" bezieht sich auf alle Funktionen, die nach dem erfolgreichen Aufbau der Verbindung zu Business Central verfügbar sind. Dies umfasst die Darstellung und Bearbeitung der in Business Central hinterlegten Prozesse.

  • App: Der Begriff "App" bezeichnet alle übrigen Funktionsbereiche der Anwendung. Dazu gehören beispielsweise:

    • Der Verbindungsbildschirm
    • Die Geräteeinrichtung
    • Weitere administrative Funktionen außerhalb der Prozessdarstellung

Zugriff auf die Geräteeinrichtung

  1. Öffnen Sie die MDE-App.

  2. Melden Sie sich im Admin-Modus an.

  3. Klicken Sie auf den Button "Geräteeinrichtung".

Hinweis

Die meisten Einstellungen in der Geräteeinrichtung werden sofort gespeichert. Nur Änderungen am Logging erfordern einen Neustart der App.

Übersicht der Einstellungsbereiche

Die Geräteeinrichtung ist in thematische Bereiche unterteilt, die durch visuelle Blöcke voneinander getrennt sind:

  • Geräteidentifikation: Geräte-ID und Name
  • Logging & Telemetrie: Log-Dateien und Performance-Tracking
  • Designer: Layout-Einstellungen für die Benutzeroberfläche
  • Personalisierung: Theme-Auswahl
  • Scanner: Kamera-Konfiguration bei Android
  • Feedback: Töne und Vibration
  • Sicherheit: Admin-Passwort
  • etc.

Geräte-ID und Name

Jedes Gerät erhält eine eindeutige Identifikation, die in Business Central registriert wird.

Feld Beschreibung Hinweise
Geräte-ID Automatisch generierte eindeutige ID Nicht änderbar, ähnlich einer GUID.
Eindeutige Identifikation des Geräts in Business Central
Wird in der BC-Tabelle "MDE Geräteeinrichtung" gespeichert
Ermöglicht gerätespezifische Konfigurationen in BC
Gerätename Frei wählbarer Name für dieses Gerät. Der Gerätename sollte das Gerät beschreibbar machen, besonders wenn Sie mehrere Geräte verwalten. Erleichtert die Identifikation in BC.
Beispiele für sinnvolle Gerätenamen:
Lager-Scanner-01
Tablet-Vorarbeiter
Kommissionierung-Halle-A
Inventur-Gerät-3

Logging & Telemetrie

Die MDE-App erstellt Log-Dateien zur Fehleranalyse und kann Telemetriedaten an Application Insights senden.

Performance-Logging

Das Performance-Logging hilft bei der Analyse von Geschwindigkeitsproblemen.

Einstellung Beschreibung Zweck
Nur Performance-Metriken erfassen Misst Verarbeitungszeiten Ermittelt, ob Probleme im Gerät oder in BC liegen

Wofür wird Performance-Logging benötigt?

Bei Geschwindigkeitsproblemen ist oft unklar, wo die Verzögerung entsteht:

  • Auf dem Gerät: Die App benötigt zu lange für das Rendering.
  • Misst die Zeit ab Anfrage bis Antwort:
    • In BC: Die Verarbeitung der Anfrage in Business Central dauert zu lang.
    • Im Netzwerk: Die Übertragung ist langsam.

Das Performance-Logging misst die Zeiten und protokolliert sie in der Log-Datei.

Tipp

Aktivieren Sie das Performance-Logging temporär, wenn Sie Geschwindigkeitsprobleme analysieren möchten. Deaktivieren Sie es danach wieder, um die Log-Dateien klein zu halten.

Log-Dateien (Dateilogs)

Die App schreibt Log-Informationen in Textdateien und speichert diese im Arbeitsverzeichnis (="Geräteinformationen" → "unitop MDE Ordner öffnen"), sofern die Option "Dateilogs verwenden" aktiviert ist.

  1. Zum Aktivieren öffnen Sie die "Geräteeinrichtung", navigieren Sie zum Bereich "Dateilogs" und nutzen Sie den Schalter "Dateilogs verwenden".

  2. Daraufhin können Sie den "Pfad zum Logging Ordner" und die Speicherdauer ("Log Beibehaltung (Tage)") angeben (i.d.R wird der Pfad autom. gefüllt).

    Einstellung Beschreibung Standardwert
    Log-Level Bestimmt, welche Ereignisse protokolliert werden Warning
    Log-Datei Wird automatisch im Arbeitsverzeichnis erstellt Ja

Verfügbare Log-Level

Die Log-Level sind hierarchisch aufgebaut. Jeder Level schließt alle darüber liegenden Level ein.

Log-Level Was wird geloggt Empfohlen für
Trace Alle Details, sehr ausführlich Tiefgehende Fehleranalyse
Debug Debug-Informationen und alles darüber Entwicklung und Testing
Information Informative Meldungen und alles darüber Detaillierte Protokollierung
Warning Warnungen, Fehler und kritische Events Produktivbetrieb (Standard)
Error Nur Fehler und kritische Events Minimales Logging
Critical Nur kritische Systemfehler Nur schwerwiegende Probleme
Warnung

Je niedriger Sie den Log-Level setzen (z. B. Trace oder Debug), desto größer werden die Log-Dateien. Im Produktivbetrieb sollten Sie bei "Warning" bleiben.

Hinweis

Änderungen am Log-Level werden erst nach einem Neustart der App wirksam.

Wo finde ich die Log-Dateien?

Die Log-Dateien befinden sich im Arbeitsverzeichnis (="Geräteinformationen" → "unitop MDE Ordner öffnen").

Windows:

C:\Users\[Benutzername]\AppData\Local\Packages\[App-Package]\LocalState\

Android:

  • Öffnen Sie den Ordner "Download" und "unitop MDE".

Telemetrie (Application Insights)

Die App kann Telemetriedaten an Microsoft Application Insights senden.

Einstellung/Feld Beschreibung Konfiguration
Application Insights aktivieren Sendet Logs an Azure Erfordert Instrumentation Key
Application Insights Connection String Verbindungsschlüssel zu Application Insights Wird vom Administrator bereitgestellt.

Designer-Einstellungen

Der Designer steuert, wie die Benutzeroberfläche der App dargestellt wird.

Erfahren Sie mehr über das Thema MDE Designer in BC einrichten und nutzen.

Funktionsweise der App nach dem Starten

Layout-Modus

Die App unterstützt zwei grundlegende Layout-Typen:

Layout-Typ Beschreibung Verwendung Eigenschaften
Absolutes Layout (seit MDE 5.0) Pixelgenaue Positionierung aus BC Standard, optimale Darstellung Nutzt die pixelgenauen Positionsangaben aus dem BC-Designer
Ermöglicht komplexe und optimierte Layouts
Empfohlen für den Produktivbetrieb
Die App ermittelt Größe und Position der Steuerelemente basierend auf den Designerdaten und den technischen Möglichkeiten des Geräts.
Vertikales Layout (Standard MDE 4.0) Einfache Anordnung untereinander Notfall-Option bei Darstellungsproblemen Ordnet alle Steuerelemente einfach untereinander an
Ignoriert Positionsangaben aus BC
Funktioniert immer, auch bei Darstellungsproblemen
Rudimentäres Aussehen
Tipp

Wechseln Sie nur dann zum vertikalen Layout, wenn das absolute Layout auf Ihrem Gerät nicht korrekt funktioniert. Dies kann bei ungewöhnlichen Bildschirmauflösungen oder speziellen Geräten vorkommen.

Seitenverhältnis (nur Windows)

Unter Windows können Sie das Seitenverhältnis des App-Fensters anpassen.

Einstellung Wert Zweck
Seitenverhältnis 9:16 (Standard) Simuliert das Aussehen bzw. die Ansicht von Android-Geräte unter Windows.
Hinweis

Diese Einstellung ist nur unter Windows sichtbar. Android-Geräte nutzen automatisch das Seitenverhältnis des Bildschirms.

Zweck: Die meisten MDE-Handgeräte haben ein Seitenverhältnis von 9:16 (Hochformat). Unter Windows wird dieses Verhältnis simuliert, damit der BC-Designer die Masken für die tatsächlichen Geräte optimieren kann.

Schriftgrößenskalierung

Die Schriftgröße kann geräteunabhängig skaliert werden, indem Sie die Größe in Prozent angeben (100 % = Initialwert).

Tipp

Diese Einstellung ist nützlich, wenn:

  • Mehrere Android-Geräte mit unterschiedlichen Bildschirmgrößen im Einsatz sind
  • Der Text auf einem Gerät zu klein oder zu groß erscheint
  • Benutzer mit Sehschwächen die App nutzen
Hinweis

Die Schriftgröße wird im BC-Designer vorgegeben, aber mit diesem Faktor multipliziert. So müssen Sie nicht für jedes Gerät einen eigenen Designer erstellen.

Personalisierung

Theme-Auswahl

Die App unterstützt verschiedene Darstellungsthemen.

Theme Beschreibung
Hell Heller Hintergrund, dunkle Schrift
Dunkel Dunkler Hintergrund, helle Schrift
System Übernimmt die Einstellung des Betriebssystems

Scanner-Einstellungen

Die App unterstützt Hardware-Scanner oder die Gerätekamera als Scanner. Auf Geräten ohne Hardware-Scanner (Tablets, Smartphones) kann die Kamera als Scanner verwendet werden.

Einstellung Beschreibung Verwendung
Kamera als Scanner aktivieren Ermöglicht das Scannen mit der Kamera Für Geräte ohne Hardware-Scanner
Kameraauswahl Front- oder Rückkamera Je nach Gerätebauart

Audio und Vibration (Feedback-Einstellungen)

Die App kann akustisches und haptisches Feedback geben. Geben Sie Töne für Fehlermeldungen, Unterweisungen, Kamera-Bestätigungen oder Feedbacks (hier noch ergänzen, was sind die Unterschiede????? Feedback 1 bis 3) an.

Android-Geräte können zusätzlich zum akustischen Feedback auch vibrieren, um dem Benutzer taktile Rückmeldungen zu geben.

Admin-Passwort ändern

Im Bereich Sicherheit können Sie das Admin-Passwort für dieses Gerät ändern und speichern. Mehr dazu finden Sie unter Admin-Passwort ändern.

Speicherverhalten

Ein wichtiger Unterschied zur Verbindungseinrichtung:

Sofortige Speicherung

  • Alle Änderungen in der Geräteeinrichtung werden sofort gespeichert
  • Es gibt keinen "Speichern"-Button
  • Änderungen sind unmittelbar wirksam (außer Logging)

Ausnahme: Logging

  • Änderungen am Log-Level erfordern einen Neustart der App
  • Die Einstellung wird zwar sofort gespeichert, aber erst nach Neustart angewendet
Hinweis

Schließen und öffnen Sie die App, um Logging-Änderungen zu aktivieren.

Bildschirmausrichtung

Die App bietet verschiedene Modi für die Bildschirmausrichtung:

  • Automatisch: Die App dreht sich automatisch mit dem Gerät.
  • Hochformat (Standard): Die App bleibt immer im Hochformat, auch wenn das Gerät gedreht wird.
  • Querformat: Die App bleibt immer im Querformat, auch wenn das Gerät gedreht wird.
Warnung

Das Rendering im Querformat funktioniert noch nicht auf allen Android-Versionen zuverlässig. Idealerweise sollten in BC eigene MDE Designer für das Querformat erstellt werden.

Häufig gestellte Fragen

Warum muss ich die App nach Logging-Änderungen neu starten?

Das Logging-System wird beim App-Start initialisiert. Änderungen an der Konfiguration können erst beim nächsten Start übernommen werden.

Kann ich die Geräteeinstellungen auf andere Geräte übertragen?

Nein, die Geräteeinstellungen sind gerätespezifisch und werden lokal gespeichert. Sie müssen auf jedem Gerät individuell konfiguriert werden.

Was passiert, wenn ich versehentlich falsche Einstellungen vornehme?

  • Die meisten Einstellungen können jederzeit geändert werden.
  • Kritische Änderungen (z. B. falscher Log-Level) können durch einfaches Zurücksetzen korrigiert werden.
  • Im Notfall: App deinstallieren und neu installieren (alle Einstellungen gehen verloren).

Gibt es Standardwerte für die Geräteeinrichtung?

Ja, die App startet mit sinnvollen Standardwerten:

  • Log-Level: Warning
  • Layout: Absolut
  • Theme: System
  • Kamera als Scanner: Deaktiviert

Einfluss von Betriebssystem-Einstellungen

Die MDE-App reagiert auf verschiedene Einstellungen des Betriebssystems. Diese Einstellungen werden außerhalb der App im Betriebssystem vorgenommen, beeinflussen aber das Verhalten und Aussehen der App.

Sprache

Die App unterstützt mehrere Sprachen und richtet sich nach der Systemsprache des Gerätes.

Aktuell verfügbare Sprachen:

  • Deutsch
  • Englisch

Sprache unter Windows ändern

  1. Öffnen Sie die Windows-Einstellungen.
  2. Navigieren Sie zu "Zeit und Sprache" > "Sprache".
  3. Ändern Sie die Anzeigesprache.
  4. Starten Sie die App neu.

Sprache unter Android ändern

  1. Öffnen Sie die Android-Einstellungen.
  2. Navigieren Sie zu "System" > "Sprachen & Eingabe" > "Sprachen".
  3. Ändern Sie die Systemsprache.
  4. Starten Sie die App neu.
Hinweis

Die App muss neu gestartet werden, damit die Sprachänderung wirksam wird.

Mehrsprachigkeit erweitern

Die App kann zusätzliche Sprachen unterstützen. Dies erfordert:

  • Bereitstellung einer xliv-Datei mit Übersetzungen
  • Installation der Datei durch den Administrator
  • Kein App-Update notwendig
Hinweis

Für zusätzliche Sprachen wenden Sie sich bitte an Ihren unitop Berater oder den technischen Support.

Best Practices

Tipp

Empfehlungen für die Geräteeinrichtung:

  • Behalten Sie den Log-Level auf "Warning" im Produktivbetrieb.
  • Aktivieren Sie Performance-Logging nur zur Fehleranalyse.
  • Verwenden Sie beschreibende Gerätenamen.
  • Passen Sie die Systemsprache vor der App-Nutzung an.
  • Aktivieren Sie Kamera als Scanner nur auf Geräten ohne Hardware-Scanner.
×
Vergrößertes Bild