Fehlerbehebung
Die häufigsten Meldungen von FrontTailor, ihre Ursache und was du tun kannst. Die Texte in Kursivschrift stehen genau so in der Oberfläche.
- Erkennung
- DOM-Merkmale, höchstens 10 Sekunden
- Verbunden
- nach erfolgreichem Ping, dann alle 5 Sekunden
- Hilfe
- GitHub Issues oder CloudDNA
„Nicht verbunden“ oder „Verbinde…“ bleibt stehen
Das Panel zeigt Verbunden erst, wenn ein Ping bis in die UI5-Seite und zurück geklappt hat. Bleibt es bei „Nicht verbunden“ oder „Verbinde…“, oder zeigen Tabs „Dieser Tab braucht eine verbundene UI5-App.“:
- Prüfen, ob das Popup Freigabe erforderlich zeigt – dann zuerst die Domain freigeben.
- Bei „Fehler“ im Verbindungsstatus Erneut versuchen klicken.
- Die Seite der App neu laden. FrontTailor verbindet sich nach dem Laden von selbst; Panels bauen ihre Verbindung nach einer Unterbrechung selbst neu auf.
- Hast du die Extension als Paket selbst aktualisiert, sie unter
chrome://extensionseinmal neu laden. Ein Neustart des Browsers reicht dafür nicht.
„Keine UI5-App erkannt“
FrontTailor sucht auf jeder Seite nach Merkmalen von SAP UI5, etwa dem Bootstrap-Skript sap-ui-core.js, UI-Bereichen oder dem Theme-Link – höchstens 10 Sekunden lang ab dem Laden. Danach wartet es noch bis zu 10 Sekunden darauf, dass sap.ui bereitsteht.
- Bindet die Seite UI5 erst mehr als 10 Sekunden nach dem Laden ein, findet FrontTailor die Merkmale nicht mehr. Dann die Seite neu laden, sobald die App da ist.
- Auf Seiten ohne UI5 bleibt das Symbol grau – das ist richtig so.
- Liegt die App in einem iframe, siehe iframes.
Freigabe erforderlich oder verweigert
| Meldung | Ursache und Lösung |
|---|---|
| „Freigabe erforderlich“, Symbol blau mit ! | Die Domain ist noch nicht freigegeben. Im Popup Aktivieren klicken und den Browser-Dialog bestätigen (Freigabe). |
| „Der Zugriff wurde nicht erteilt.“ | Der Browser-Dialog wurde abgebrochen. Noch einmal Aktivieren klicken. |
| „Diese Domain ist durch Ihre Administration nicht freigegeben.“ | Die Richtlinie allowedHosts deines Unternehmens lässt den Host nicht zu. Das lässt sich nur in der Richtlinie ändern (Enterprise-Deployment). |
Änderungen sind gesperrt
Editoren sind grau, oder eine Aktion endet mit „Abgelehnt: PROD-System – Laufzeitänderungen sind nicht erlaubt.“ Der Host ist als PROD markiert – durch dein Host-Profil oder durch die Richtlinie prodHosts. Das ist Absicht: Auf PROD sind Live-Edit, Replay, Cache-Reset, Overrides und Fehlersimulation gesperrt (Host-Profile und PROD).
- Ist das Kennzeichen versehentlich gesetzt, im Popup das Häkchen Produktivsystem (PROD) entfernen und Profil speichern klicken.
- Steht darunter „Durch Ihre Administration als PROD markiert.“, kommt es aus der Richtlinie und lässt sich im Popup nicht ändern.
Modul gesperrt oder Lizenz abgelehnt
| Was du siehst | Ursache und Lösung |
|---|---|
| Tab mit Schloss, „… gehört zu FrontTailor Pro“ | Das Modul gehört zu einer höheren Edition. Lizenzschlüssel eintragen (Lizenz und Editionen). In den 7 Tagen der Testphase nach der Installation ist nichts gesperrt. |
| „Signatur ungültig (Schlüssel verändert oder unvollständig).“ oder „Der Lizenzschlüssel ist nicht lesbar (beim Kopieren unvollständig?).“ | Der Schlüssel wurde nicht vollständig kopiert. Ihn noch einmal komplett aus der Lizenz-E-Mail einfügen. |
| „… für ein anderes Produkt … (z. B. iFlow Tailor), nicht für FrontTailor.“ | Ein Schlüssel eines anderen Produkts. Den FrontTailor-Schlüssel verwenden. |
| „Die Lizenz umfasst das SAP-System … nicht. Hier gilt Community.“ | Die Lizenz ist an andere SAP-Systeme gebunden. Auf den lizenzierten Systemen sind die Module frei. |
| „Die Lizenz ist abgelaufen.“ | Lizenz verlängern; bis dahin gilt Community. |
| Ein Tab fehlt ganz | Die Administration hat das Modul per Richtlinie modules abgeschaltet. Das gilt auch mit Lizenz. |
Das Side-Panel öffnet sich nicht
- Chrome öffnet das Side-Panel nur direkt nach einer Nutzeraktion. Kommt die aus der Command Palette oder einem Tastenkürzel nicht durch, öffne es über Side-Panel öffnen im Popup.
- Einen Tab findest du nicht? Im schmalen Side-Panel stehen weitere Tabs unter Weitere. Einige Ansichten, etwa Models, gibt es nur im DevTools-Panel (F12 › FrontTailor).
- Zeigt die Palette im Popup „Palette nicht verfügbar: keine verbundene UI5-App.“, ist der Tab nicht verbunden – siehe oben.
Apps in iframes
FrontTailor läuft in jedem Frame einer Seite und verbindet jeden UI5-Frame einzeln; der Verbindungsstatus zeigt die Zahl der verbundenen Frames. Im Pick-Modus des Inspectors schaltet ein Klick auf ein Control im iframe auf dessen Frame um.
- Liegt die App im iframe auf einer anderen Domain als das Launchpad, braucht auch diese Domain eine Freigabe.
- Sandbox-iframes ohne eigene Origin werden ebenfalls unterstützt.
Das Symbol ist gelb
Gelb mit einer Zahl heißt: Fehler im UI5-Log oder fehlgeschlagene Requests (Status 400 und höher) seit dem Laden der Seite. Ein $batch mit Fehlern in einzelnen Teilen, aber Status 200, zählt hier nicht – den zeigt die OData-Konsole (OData-Konsole). Die letzten Fehler stehen im Popup und im Tab Übersicht (Übersicht & Systemsteckbrief). Neu laden beginnt eine neue Sitzung.
Firefox
Aus denselben Quellen entsteht ein Firefox-Build ab Firefox 140, mit Seitenleiste statt Side-Panel und ohne CPU-Tiefenprofil; der Cache-Reset leert dort den ganzen HTTP-Cache, und FrontTailor wird pro Site im Popup freigeschaltet. Die Einreichung bei Firefox Add-ons steht noch aus – im Moment gibt es FrontTailor für Chrome und Edge.
Weitere Hilfe
Hilft nichts davon, beschreibe das Problem mit dem Systemsteckbrief (Tab Übersicht › Kopieren als Markdown) – als Issue im GitHub-Repository von FrontTailor oder über das Kontaktformular.
Siehe auch
- Doku Erste Schritte
- Doku Host-Profile und PROD
- Doku Lizenz und Editionen
- Belege ADR-0011 · ADR-0032 · ADR-0043 · ADR-0264