Mit diesem Formular können Sie fehlende, unklare oder fehlerhafte Inhalte in der Dokumentation melden und Verbesserungsvorschläge machen. Ihr Feedback hilft uns, die Qualität und Vollständigkeit kontinuierlich zu verbessern.
Informationen für Entwickler und Designer
MDE Designer
Einrichtungen, welche das Oberflächendesign des Haupt- und Untermenüs betreffen sowie Prozessbeziehungen darstellen, werden mit dem "MDE Designers" umgesetzt. Rufen Sie "MDE Designer Übersicht" über die Suche auf und öffnen Sie eine bestehende Zeile oder erstellen Sie ein neues Design über "Neu".
In dieser Karte erstellen und gestalten Sie die Oberflächen des MDE-Geräts. Die von Ihnen getätigten Eingaben werden Ihnen in einer nebenstehenden Vorschau angezeigt.
Allgemein
| Code | Das Feld identifiziert das Design eindeutig. Das Gerät startet mit dem obersten bzw. ersten Designer; von dort an wird die Einrichtung bzw. Programmierung berücksichtigt. |
| Höhe und Breite | Die Felder "Höhe" und "Breite" stellen die Auflösung des MDE-Gerätes dar. Verwenden Sie unterschiedliche Geräte, sollte die Einrichtung der niedrigsten Auflösung aller Geräte entsprechen. Eine Skalierung auf dem Endgerät erfolgt automatisch. |
| Art | Unterscheidet zwischen einem Menü und einem Prozess. |
| Kategorie Name | Gibt die zugeordnete Kategorie an (dient nur der Übersichtlichkeit). |
Zeilen
Innerhalb der Zeilen geben Sie Steuer- und Anzeigeelemente an, die der unter "Allgemein" angelegten Art zugeordnet sind (Menü oder Prozess). Sie stellen die Benutzersteuerelemente auf dem MDE dar. Wählen Sie im Menü "Start" und "Design Vorlage", um folgende Zeileninhalte hinzuzufügen: Zwei Buttons ("Abmelden" und "Zurück"), sowie ein Nachrichtenfeld für die Ausgabe von Arbeitsanweisungen oder Fehlern. Ergänzen Sie beliebig weitere Zeilen.
Art
Die Zeilen stellen die Benutzersteuerelemente auf dem MDE dar. Wählen Sie ausfolgenden Arten:
| Text | Eine Textbox, die zur Ein- und Ausgabe von Texten dient. |
| Button | Ermöglicht die Auslösung einer bestimmten Aktion. |
| Liste | Tabellarische Darstellung von bis zu zehn Spalten. |
| Option | Sogenannte Combobox. Ähnlich einem Lookup, dem mehrere Werte zur Auswahl hinterlegt werden können. |
| Boolean | Eine Prüfbox zur Eingabe von Ja/Nein-Werten. |
| Label | Textausgabe, unveränderbar, ohne Rahmen. |
| Passwort | Wie Text, nur mit " * " als Maskierung der Eingabe. |
| Tastatur | Bild einer Tastatur. Wird diese angeklickt, öffnet sich die MDE On-Screen-Tastatur. |
| Nachricht | Textausgabe von Arbeitsanweisungen, Warnungen oder Fehlermeldungen. |
| Bild | Anzeige eines Bildes von einem UNC-Pfad oder einer URL. |
| Signatur | Unterschriftenfeld, wird als Bild zurückübermittelt. |
| Fortschrittsbalken | Kann einen prozentualen Wert von 0-100 darstellen. |
| Ampel | Repräsentiert einen runden Button, der als farbiger Indikator dient. |
| Ton | Kann einen von drei auf dem Gerät definierten Tönen abspielen. |
| Kamera | Ermöglicht die Aufnahme von 1-N Bildern. |
| Barcodescanner | Sofern das Gerät dies unterstützt, kann die Kamera als Barcodescanner geöffnet werden. |
| Webbrowser | Kann eine Webseite anzeigen oder HTML-Texte darstellen. |
Weitere Spalten innerhalb der Zeilen (Auszug)
| Datentyp | Per "Datentyp" können Texteingaben beschränkt werden. |
| Editierbar | Gibt an, ob das Steuerelement schreibgeschützt und nur zur Anzeige genutzt werden kann oder ob es eine Eingabe erlaubt. |
| Zu validieren | Gibt an, dass dieses Steuerelement genutzt werden kann, um die Daten an Business Central zu übermitteln. So muss z. B. ein Button validierbar sein, um einen Prozess-Schritt in BC ausführen zu können. Hierbei ist es zwingend notwendig, in der Prozessbeziehung eine Codeunit zu hinterlegen. |
| Pflichtfeld | Werden mehrere Textfelder auf "Zu validieren" gesetzt, können Pflichtfelder erzwungen werden, sodas BC mit der Datenübermittlung beginnt, sobald die Pflichtfelder gefüllt sind. Ausnahmen stellen z. B. ein Zurück- oder Abmelden-Button dar. Diese sollen i. d. R. ebenso funktionieren, wenn die Pflichtfelder nicht gefüllt sind. Mit "Pflichtfeld ignorieren" kann die Einstellung überschrieben werden. |
| Höhe und Breite | Die Felder "Höhe", "Breite", "X-Position" und "Y-Position" ordnen das Element auf Basis der Höhe und Breite im Designkopf an. Hat das anzuzeigende Gerät eine abweichende Auflösung, wird diese entsprechend skaliert. Hinweis: Die Android- und Universal Windows Plattform (UWP)-App können diese Steuerelemente nicht pixelgenau anordnen. Daher werden alle Steuerelemente nebeneinander dargestellt, wenn sie auf der identischen Y-Achse liegen. Die restlichen Steuerelemente werden untereinander dargestellt. Die horizontale und vertikale Ausrichtung richtet sich am entsprechenden Rand aus. Kommt zum Tragen, wenn das Display größer ist, als in BC hinterlegt. |
| Farben | Die Vorder- und Hintergrundfarben geben die Farben der Designer Zeilen an. |
| Tastenkürzel | Im Feld "Tastenkürzel" können Buttons bestimmte Tasten-Codes auf dem Gerät zugeordnet werden. |
| Highlight Berechnung Codeunit | Gibt an, welche Codeunit zur Berechnung der ausstehenden Arbeit genutzt werden soll. |
| Vorgabewert | Gibt den Vorgabewert der Designer Zeile an. |
Prozessbeziehungen
Um ein Steuerelement des MDE-Gerätes mit einer Aktion in unitop zu verknüpfen, wird der Zeile eine Prozessbeziehung in der Untertabelle zugewiesen. Vorausgesetzt ist, dass jene Zeile "Zu validieren" aktiviert hat. Wählen Sie die entsprechende Spalte aus und wählen Sie über den gleichnamigen Menüpunkt die Prozessbeziehungen aus, um diese mithilfe der Prozess-IDs und der Prozess-Codeunits zu definieren.
Hinweis
Mehr zu der Hintergrundlogik und Prozessschritten finden Sie [hier](xref:Kapitel verlinken Prozessschritt-Handling).
Zu berücksichtigen:
Weist ein Menü auf ein weiteres Menü, so ist es ausreichend, die Spalte "Nächster Designer Kopf Code" auszufüllen: Gibt den Designer an, der nach erfolgreicher Ausführung automatisch aufgerufen wird (kann im Code übersteuert werden).
Um aus dem Menü einen Prozess zu starten, ist die "Prozess-ID" und eine auszuführende "Codeunit" zu füllen. Ein Menü-Button darf lediglich eine Zeile in den Prozessbeziehungen haben.
Die MDE-Anwendung verwendet so lange diese Prozess-ID, bis Sie wieder auf ein Menü gelangen. Befinden Sie sich innerhalb eines Prozesses, wird jede Prozessbeziehung auf diese Prozess-ID gefiltert. So ist es möglich, definierte Designer für verschiedene Prozesse wiederzuverwenden.
Beispiel: Der Designer Lagerplatz- und Artikelinformation kann aus den Prozessen Wareneingang, Warenausgang oder Inventur aufgerufen werden. Der "Zurück"-Button verweist, je nach Prozess ID, wieder auf den passenden Designer des Prozesses (Warenausgang, Wareneingang, Inventur). Somit ist eine prozessübergreifende Wiederverwendung von Designern möglich.
Codeunits für Hervorhebungen anstehender Arbeiten (Level 1 bis 3)
Menüpunkte können durch farbige Hinterlegung visuell hervorgehoben werden, um die Orientierung zu erleichtern. Unterschiedliche Farben stellen gleichzeitig eine Priorisierung der Abarbeitung von Tätigkeiten in einem Menüpunkt dar. In jedem Anwendungsfall oder Projekt wird festgelegt, welche Bedeutung die einzelnen Hervorhebungslevel haben. Wo die Hervorhebungen in unitop gepflegt werden, lesen Sie [hier](xref:apitel Einrichtung verlinken MDE Einrichtung – Hervorherbung der anstehenden Arbeit).
Für- Test und Demozwecke kann ein beliebiger Wert zu einem Button in der "MDE Designer Zeile" durch die Hinterlegung der Codeunit 5021652 im Feld "Hightlight Berechnung Codeunit" hinterlegt werden. Wird diese Codeunit verwendet, müssen alle drei Hervorhebungslevel eine eingerichtete Farbe besitzen.
Hinweis
Für die kundenindividuelle Umsetzung in Projekten kann eine eigene Codeunit für die Hervorhebung von Steuerelementen genutzt werden.
Eine individuelle Codeunit muss als Parameter die MDE Designer Zeile verwenden. Die ID der Codeunit wird in der jeweiligen MDE Designer Zeile hinterlegt. In der Codeunit ist die entsprechende MDE Designer Zeile zu modifizieren, z. B.:
Validate(BackColor,’Red‘);
[EventSubscriber(ObjectType::Codeunit, Codeunit::"GOB MDE Pending Work Calc.”, ‘ElseCaseControlName’, ’’, false, false)] local procedure OnElseCaseControlName(var TmpMDEDesignerLine: Record "GOB MDE Designer Line”; var HighlightLevel: Integer; var Handled: Boolean) var ControlNameLibrary: Codeunit "GOB MDE Control Name Library”; begin if TmpMDEDesignerLine.Name = ControlNameLibrary.LoginButton() then HighlightLevel := 3; end;
Alternativ wird in der bestehenden Codeunit 5021652 ein ElseCaseControlName Publisher bereitgestellt.
Einrichtung Vorschau
Initial werden Steuerelemente in der Schriftgröße "10" und Art "Normal", Buttons in "Fett" angezeigt. Die Änderungen der Vorschau werden am MDE-Gerät aktiv, sobald ein Neustart der Anwendung erfolgt.
| Alles anzeigen | Übersteuert die Sichtbarkeit jedes Controls. |
| Schriftart | Ändert die Schriftart der Vorschau. |
| Sprache | Ändert die Sprache für den Design-Modus. |
| Geräte ID | Wählt das Geräte aus, welches zur Vorschau verwendet werden soll. Die App muss auf dem Gerät im Anschluss gestartet werden. |
Übersetzungen in andere Sprachen (Text Code)
Sobald Sie die Sprache Ihres MDE-Gerätes ändern, werden die entsprechenden Übersetzungen ermittelt und ausgegeben. Die "MDE Text Codes" dienen als Platzhalter für die Übersetzungen der Steuerelemente und Arbeitsanweisungen der Standardsprache.
MDE Designer öffnen: Rufen Sie den "MDE Designer" auf, indem Sie aus der "MDE Designer Übersicht" einen Eintrag öffnen.
Bestehende Übersetzung in Zeile hinterlegen: Navigieren Sie innerhalb der Zeilen zu der Spalte "Vorgabewert". Hier können Sie vordefinierte Übersetzungen auswählen und in den Zeilen hinterlegen. Alternativ können Sie die "MDE Text Codes" über die Suche aufrufen oder über die Informationsbox im "MDE Designer".
Neuen Text Code anlegen: Wählen Sie in der Liste "MDE Text Codes" den Menüpunkt "Neu" und vergeben Sie einen Code und eine Beschreibung. In der Liste finden Sie ebenfalls die Anzahl der hinterlegten Übersetzungen.
Übersetzungen einrichten: Wählen Sie im Menü "Text Übersetzungen" und hinterlegen Sie zu Ihrem Vorgabewert verschiedene Übersetzungen, indem Sie einen Sprachcode und die entsprechende Textübersetzung hinterlegen.
Lagerpplatz- oder Artikelinformationen
Um Lagerplatz- oder Artikelinformationen mit dem MDE-Gerät auslesen zu können, ist die Einrichtung im "MDE Designer" notwendig ("BIN-ITEM-INFO" = Hauptbedienung wie die Informationen angezeigt werden, "ITEM_DETAIL" = Artikelbild).