Fiori Guidelines

So arbeitet der Validator

Öffne in den DevTools (F12) das Panel FrontTailor oder das Side-Panel und wähle den Tab Fiori Guidelines. Beim Öffnen holt der Tab nur den letzten Bericht der Seite; die Analyse läuft erst nach deinem Klick. Bewertet wird, was sichtbar ist: die Controls der geöffneten Ansicht mit Klasse, Position, Properties, Labels und Spalten. Die Prüfung stellt keinen Request, Exporte entstehen lokal.

Der UI5 Support Assistant prüft technische Regeln. Der Validator prüft die Design-Guidelines: Floorplan, Platz und Reihenfolge der Aktionen, Titel, Tabellen, Formulare, Meldungen, Navigation und Optik.

Eine Ansicht prüfen

1. Öffne in der App die Ansicht, die du prüfen willst – etwa die Detailseite eines Objekts. Öffne Dialoge oder Tabs, die mit bewertet werden sollen.
2. Wähle im Panel den Tab Fiori Guidelines und klicke Ansicht prüfen.
3. Lies Score und erkannten Floorplan, dann den Score je Kategorie und die Verbesserungsoptionen.
4. Nach einer Änderung oder in einer anderen Ansicht klicke Erneut prüfen.

1. Ansicht prüfen, nach dem ersten Lauf Erneut prüfen.
2. Der Score von 0 bis 100: ab 90 grün, ab 70 orange, darunter rot.
3. Der erkannte Floorplan mit Technologie: Freestyle, Fiori Elements (OData V4) oder Fiori Elements (OData V2).
4. Erkannt an: die Indizien, darunter Enthält: die Teile, etwa die Spalten eines Layouts.
5. In der Seite hervorheben rahmt den Wurzel-Control des Floorplans ein.
6. Guideline zum Floorplan öffnet die Seite der SAP Fiori Design Guidelines.
7. Der Score noch einmal im Kopf der Karte.

Die Prüfung startet auch über die Befehlspalette (Alt+Shift+K, auf dem Mac ⌥+Shift+K) mit dem Befehl Fiori-Design-Guidelines prüfen. Im Launchpad wird nur die App geprüft, nicht die Shell.

Floorplan-Erkennung

FrontTailor erkennt den Floorplan in dieser Reihenfolge und nennt seine Indizien:

Score je Kategorie

1. Eine Kategorie mit Score, Fortschrittsbalken, „5 geprüft · 1 Befunde“.
2. nicht anwendbar: In der Ansicht gab es nichts zu prüfen; die Kategorie zählt nicht zum Score.

Je Kategorie gilt: 100 minus 25 je Verstoß, 10 je Warnung und 3 je Hinweis, mindestens 0. Gleiche Befunde (gleiche Regel, gleiches Control, etwa Klone einer Listenvorlage) zählen einmal. Der Gesamtscore ist der gewichtete, gerundete Mittelwert der Kategorien mit Score. Die Checkliste Manuell prüfen fließt nicht ein.

Verbesserungsoptionen

1. Filter nach Schweregrad: Alle, Verstoß, Warnung, Hinweis.
2. Alle Kategorien oder eine Kategorie.
3. Nach Text, Control oder Regel filtern.
4. Warum die Guideline das verlangt.
5. Verbesserung mit den Werten aus deiner App.
6. Do und Don’t zu dieser Regel.
7. Beispiel als XML-View-Ausschnitt.
8. Guideline öffnen: die Seite der Regel in den SAP Fiori Design Guidelines.
9. Im Inspector zeigen wählt das Control im Inspector aus.
10. In der Seite hervorheben rahmt das Control vier Sekunden lang ein.
11. Als Markdown kopieren nimmt den Befund mit, etwa für ein Ticket.

Kommt das Control aus einem Template von Fiori Elements, steht beim Befund „Fiori Elements: Annotationen oder Manifest anpassen, nicht die erzeugten Controls.“ statt eines XML-Beispiels. Bei Befunden zu Labels und Tooltips führt Im Tab Qualität prüfen zur i18n- und Barrierefreiheitsprüfung.

1. Guideline zum Control: die Guideline-Seite der Control-Klasse, wenn sie eine andere ist als die der Regel.
2. CSV: UTF-8 mit BOM und CRLF, mit Schutz vor Formeln.
3. Markdown: Bericht als Datei.
4. Alles als Markdown kopieren: derselbe Bericht in die Zwischenablage.

Mit der KI-Leiste und deinem eigenen Schlüssel gibt es Floorplan prüfen im Kopf der Prüfung und Befund erklären an jedem Befund. Gesendet wird erst nach Vorschau und Klick.

Die Regeln

Der Validator prüft nur Regeln, die sich zur Laufzeit sicher ablesen lassen. Texte prüft er nicht sprachlich (Verben, Ton, Terminologie).

Dos & Don’ts und „Manuell prüfen“

1. Do: drei Punkte der Guideline zum erkannten Floorplan, sonst allgemeine.
2. Don’t.
3. Ein Punkt der Checkliste Manuell prüfen mit den betroffenen Controls und Guideline öffnen.

Typische Probleme

Die Regeln sind an den drei Demo-Apps von FrontTailor erprobt. Ein Score ersetzt kein Design-Review, er zeigt aber schnell, wo eines lohnt.